Building a new PAT

For Word documents: ensure that there is a header with the following items in it: 

• Title for the document
• Project field
• Revision Field - usually a date

Open the doc and make a set of screenshots using the naming convention: 

PAT-###-SS1, PAT-###-SS2. etc.  

Using this convention will mean less work later. If the screenshots change and you upload the new shots using the same numbers, they will automatically appear in the PAT page wothout any additional editing of the images in the page.  

Go to the PAT Database. 

• Note the last used PAT number in the database so you can apply the next number to your new PAT
• Open the PAT-000 - PAT Template Page. This page contains all the structure you will need for the new page. 

Use a Copy command to create a new page. This page will contain a copy of the template page saving a lot of time reconstructing the page structure. 

• be sure to uncheck the option to copy attachments - you will add new ones later

Fix the title of the new page

• remove "Copy of" 
• fix the PAT number
• Replace the title "PAT Template Page" with the new PAT title
• Save the new PAT page
• Check the PAT Database to see that the new page is added

Open the attachments for the new PAT page: 

• Add the new PAT doc into the attachments
• Add the Screenshots into the attachments
• Check the attachments to see that they are all there in the PAT page

Open the page in the editor: 

• For each of the "Unknown Attachment" macros, highlight it and insert the new screenshot. 

  • In the "Excerpt" Panel: 

    • Insert Image macro - use SS1 image
    • Size to 800 pixels
    • Add border
    • Edit Link - point to the doc and save
    • Center the image

  • In the body / Panel insert all screenshots SS1 thru SSx

    • Insert Image macro - use SS1 image
      • Size to 800 pixels
      • Add border
      • Edit Link - point to the doc and save
      • Center the image
    • Repeat these actions for the remaining Screen Shots thru SSx

    
    

• copy the title of the PAT into the 2 Panel macros - one in the excerpt, and the other in the body of the page. 
  • Replace "PAT-000 New Asset" with the new title - Format: PAT-### - Title

• Save the page when done. 

• Check to see that all the screenshots are displayed in the body of the PAT page. 

Open the page again using "Edit Contents" - this will build the database entry

• In Link, paste the URL for the doc - get from doc attachment - "Copy link address"
• In Title, paste a copy of the doc title including the PAT number as a prefix
• In SWE or Topic, add SWE code, category codes,  page codes, or Topic codes for the pages on which the PAT is included
  • use a comma as a separator for the codes
  • use a comma and a space at the end of the string
  • DO NOT HIT A RETURN AFTER THE LAST COMMA. A RETURN WILL BREAK THE FILTER AND THE PAT WILL NOT BE INCLUDED IN ANY REPORTS
• In Origin, put the page code and tab for where the PAT comes from
• In Notes, put page codes for other places where the PAT can be found including and category codes. 
• Save the page when done. 
• Check the entry in the database
  • Open the PAT Database and scroll to the PAT number. The new PAT should be there
  • Ensure that all the fields are properly filled out (compare to other PAT entries)

Edit the target page, at the location of the PAT, make changes in the text preceding
the PAT to properly introduce it: 

• add the title of the PAT in an appropriate spot - make sure title is in bold font
• add a SWEREFN macro after the title to take the user to the Resources page 
  • enter the PAT number in the format "PAT-###" into the SWEREFN macro and hit save. 
• Add any other introductory text , as necessary. 

In the place where the PAT should appear.

• If you want just the first screenshot to appear, insert an "Excerpt-Include" macro 
  • insert the PAT page name with a "SITE:" prefix
  • ensure that the "Remove Surrounding Panel" option is checked
• If you want ALL the screenshots to appear, insert an "Include-Page" macro 
  • insert the PAT page name with a "SITE:" prefix
• Save the page

Check to see that the PAT appears in the location properly.

• Look at the PAT in the location you placed it. 
  • Make sure the introductory text look right
  • Make sure that the superscript link to the Resources page works - click on it to go to the Resources page. 
  • Make sure the excerpt (single screenshot) or include page (all the screenshots) display properly. 
  • click on a screenshot to get into the previewer. check to see that the doc is displayed and you can scroll to all pages. 
  • click on download and make sure that the system offers to download the doc to your hard drive. 
• Fix any problems

On the Resources tab, add a section for "Process Asset Templates" below the Tools entry, if necessary. 

Check the following links to see if a report page exists for the type of page you are adding the PAT to. 

• SWE Reports for Process Asset Templates
• Topic Reports for Process Asset Templates
• Other Reports for Process Asset Templates

If the report page exists, check to make sure that the new PAT appears in the report. 

If there is no report page, build a report page for the PATs in the target page:

• For a SWE target page, go to SWE Reports for Process Asset Templates and
  open one of the pages below it. 
  • Copying the page ensures that a copy is made under SWE Reports for Process Asset Templates
  • Fix the title of the new page so that it points to the proper SWE
  • Edit the report "Text Filter", Include parameter, to contain the right SWE number
  • Save the macro and the page.
  • Check to see that the report contains the appropriate PAT

• For a Topic target page, go to Topic Reports for Process Asset Templates and
  open one of the pages below if. 
  • Copying the page ensures that a copy is made under Topic Reports for Process Asset Templates
  • Fix the title of the new page so that it points to the proper Topic
  • Edit the report "Text Filter", Include parameter, to contain the right Topic number
  • Save the macro and the page.
  • Check to see that the report contains the appropriate PAT
• For an Other target page, go to Other Reports for Process Asset Templates and
  open one of the pages below if. 
  • Copying the page ensures that a copy is made under Other Reports for Process Asset Templates
  • Fix the title of the new page so that it points to the proper page code
  • Edit the report "Text Filter", Include parameter, to contain the right page code
  • Save the macro and the page.
  • Check to see that the report contains the appropriate PAT

Edit the target page, in the Resources tab: 

• In the new Process Asset Template section, add an Include-page macro pointing to the
  new report page you just created. 
• Save the page
• Check to see that the report contains the appropriate PAT

If the PAT should be in an existing Category (see the list in PAT Categories),
just make sure that the category code is entered into the database entry in the "SWE or Topic" field

To add a Category Report to a target page: 

• edit the target page, Resources tab, 
  • Add a new section for the category of PATS
  • Add an "Include-page" to pull in the appropriate category report 
• Save the target page. 
• Check to see that the new report appears in the appropriate place. 

Review the list of categories and codes in the page PAT Categories

• Note that each category page name has an excerpt listed next to it with an
  embedded category code 
• The new category should not be a duplicate of an existing category. Review the
  existing codes to see if any are close to the proposed new code
• Create a new, unique code to go with the new category 

To create a new category, go to PAT Categories:

• Open an existing page
• Copy that page, so that the new report appears under  PAT Categories:
• Fix the title:
  • Remove the "Copy to"
  • Fix the title to remove the old category name and add the new category name
  • Edit the "Text Filter" to replace the old category code with the new category code
  • Edit the "Excerpt" to replace the old category code with the new category code
• Save the report.
• Check to see that the report doesn't display errors.
  • Note that initially, there will be a note in the report that there are no entries to report

For each PAT that belongs in the new category, open that PAT's entry in the PAT Database and
add the category code into the "SWE or Topic" field.

• Verify that the PATs now appear in the new Category Report.