How-to import Ympact documentation in Confluence

This documents describes how to import Ympact documentation into Confluence and where extra attention is required for.

Step-by-step guide

1. Go to the page where information needs to be published.
   
   
2. Select ...  Import Word Document
   
   
   
3. Select the file to be imported from the drive
   
   
   
   
   
4. Select 'Next' button
   
5. Adjust root page title to new standard: Program name_Environment  - Program description
   Note: letters for the program must be in capital.
   
    
6. select 'Import' Button
   
   
7. Document is saved
   
   
8. Click on the 'Edit' button 
   
   
   
9. Check file for differences with the Word file and adjust it. See Attention points for importing documents from Word.
   
   
10. Save file by clicking on 'Update' button below in the screen
    
11. After saving the page will be visible under the PAGE TREE but not under the correct section.
12. Click on Space tool - reorder pages (below in screen on left side)
    
    
    
13. Space tools will be opened
    
    
    
    
14. Fold all pages to till page is open where the new page need to be stored
    
15. Select the file and drag it to the new page section and drop it 
    
16. Page is now moved to 'Applications'
17.  If page order is not sorted alphabetically use  to reorder the page. ( It is possible that this option is not shown)
    
    
    
    
    
18. Confluence part is now finished
    
    
19. Last step is to move the file from the drive to the Moved to Confluence folder.

Example:

Attention points for importing documents from Word

Table headings

Table headings from Ympact documentation are in most cases with white text, this need to be adjusted to black.

1. Select the header
   
   
   
2. Adjust text color to black (if already set just click on button 
   

Panels

Panels are not imported in a correct way. Ympact has a font style (Courier New) which is not recognized by Confluence.

Some panels are having  links/anchors which increases the line spaces.

There are a few ways of adding an YMPACT panel into Confluence

Below explanation can be found for

1. Single achors/links 
2. Multiple anchors/links 
3. Manual panel creation

Single anchors /links:

• Example WAR300: imported

• Remove all text, only leave anchors

• Open original word document and Copy panel by making a screenshot of panel selection
  
  
• Paste screenshot in Confluence above the panel selection and change the size to Original.
  
• Final view in edit mode in Confluence

Multiple anchors/links

• Select the full panel

• Select , Other macros
• Select Panel (search option for Panel can be required to find it)

• Insert Panel title (same as program panel)
• Click on button 'Insert'

• Selected text will now be visible in a panel selection

• Open original word document and Copy panel by making a screenshot of panel selection
• Paste screenshot in Confluence above the panel selection and change the size to Original.
  
• Final view in edit mode in Confluence

Manual panel creation

This option can be used if you are want to be able to maintain the panel screen by example to add colours, underline etc.

• Copy a YMPACT panel from a screen and paste it into a Word document or take the panel from the original document in Word of an existing document.
  
  
• Add a table of 1 x 1 in a Confluence page
  

• Paste the text from the panel in the Word document in the table

  WAR300D-01                 YCORE Development 14.0           YME152B    16-08-04 NLYAM006               Tracking Enquiry Header              YMEOP      12:22:29                                                                                Unit ID          YAM6210LOT01         +         No. of Claims     2                                                                                           Item Number      OPBOAT             Description Yamarin 6210                   MPL Code         A                  Location    Warehouse                      Customer           3435             Name        Ortwin Pepermans               Start Date       24-05-04           Owner       Ortwin                         End Date          0-00-00           Last User   YMEOP                           Ext. End Date     0-00-00 *         Tracking No xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx                                                                                Select action and press Enter.  1=Select                                       Act Information                       Act Information                              Purchase Order Enquiry                Accounts Payable Enquiry                 Manifest Data                         Customer Order Enquiry                   Accounts Receivable Enquiry           Warranty Registration Details            Warranty Registration History         Inventory Transactions                   List of Claims for Unit ID            Unit ID Notes                            Modification Campaigns                Unit Invoice Inquiry                     Additional Unit Process               YCARE Text (from msgf) (XT570)                                                                                                                     F1=Help  F3=Exit  F4=Prompt

• Select all text in the table and select   - Monospace
  
  

  WAR300D-01                 YCORE Development 14.0           YME152B    16-08-04 NLYAM006               Tracking Enquiry Header              YMEOP      12:22:29                                                                                Unit ID          YAM6210LOT01         +         No. of Claims     2                                                                                           Item Number      OPBOAT             Description Yamarin 6210                   MPL Code         A                  Location    Warehouse                      Customer           3435             Name        Ortwin Pepermans               Start Date       24-05-04           Owner       Ortwin                         End Date          0-00-00           Last User   YMEOP                           Ext. End Date     0-00-00 *         Tracking No xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx                                                                                Select action and press Enter.  1=Select                                       Act Information                       Act Information                              Purchase Order Enquiry                Accounts Payable Enquiry                 Manifest Data                         Customer Order Enquiry                   Accounts Receivable Enquiry           Warranty Registration Details            Warranty Registration History         Inventory Transactions                   List of Claims for Unit ID            Unit ID Notes                            Modification Campaigns                Unit Invoice Inquiry                     Additional Unit Process               YCARE Text (from msgf) (XT570)                                                                                                                     F1=Help  F3=Exit  F4=Prompt

• If needed you can remove the spaces by using backspace and shift + enter

  WAR300D-01                 YCORE Development 14.0           YME152B    16-08-04 NLYAM006               Tracking Enquiry Header              YMEOP      12:22:29                                                                                Unit ID          YAM6210LOT01         +         No. of Claims     2                                                                                       Item Number      OPBOAT             Description Yamarin 6210                   MPL Code         A                  Location    Warehouse                      Customer           3435             Name        Ortwin Pepermans               Start Date       24-05-04           Owner       Ortwin                         End Date          0-00-00           Last User   YMEOP                           Ext. End Date     0-00-00 *         Tracking No xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx                                                                                Select action and press Enter.  1=Select                                       Act Information                       Act Information                              Purchase Order Enquiry                Accounts Payable Enquiry                 Manifest Data                         Customer Order Enquiry                   Accounts Receivable Enquiry           Warranty Registration Details            Warranty Registration History         Inventory Transactions                   List of Claims for Unit ID            Unit ID Notes                            Modification Campaigns                Unit Invoice      Additional Unit Process               YCARE Text (from msgf) (XT570)                                                                                                                    F1=Help  F3=Exit  F4=Prompt

• Links and anchors can be added (copy from the import in Confluence). Note, line space will be increased.

  WAR300D-01                 YCORE Development 14.0           YME152B    16-08-04 NLYAM006               Tracking Enquiry Header              YMEOP      12:22:29                                                                              Unit ID          YAM6210LOT01         +         No. of Claims     2                                                                                          Item Number      OPBOAT             Description Yamarin 6210                   MPL Code         A                  Location    Warehouse                      Customer           3435             Name        Ortwin Pepermans               Start Date       24-05-04           Owner       Ortwin                         End Date          0-00-00           Last User   YMEOP                           Ext. End Date     0-00-00 *         Tracking No xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx                                                                                Select action and press Enter.  1=Select                                       Act Information                       Act Information                              Purchase Order Enquiry                Accounts Payable Enquiry                 Manifest Data                         Customer Order Enquiry                   Accounts Receivable Enquiry           Warranty Registration Details            Warranty Registration History         Inventory Transactions                   List of Claims for Unit ID            Unit ID Notes                            Modification Campaigns                Unit Invoice Inquiry                     Additional Unit Process               YCARE Text (from msgf) (XT570)                                                                                                                    F1=Help  F3=Exit  F4=Prompt

Spaces

Spaces are removed after the import in same cases. 

• Use enter if you want create a new line or to move a line to the next line
• Use shift + enter button to add a new line but without space between the next and previous line.
  
  
• Import in Confluence

• Original file

List numbering

The list numbering is not taken over from the word document. This need to be adjusted manually.

Tips

• Use enter if you want create a new line or to move a line to the next line
• Use shift + enter button to add a new line but without space between the next and previous line.

Related articles

• Page:
  How to use @mentions
• Page:
  How-to troubleshoot incoming mail issues in Jira server
• Page:
  How-to request Elevated User rights - YMPACT YMXXITS1 access
• Page:
  How-to request Elevated User rights - SQL cluster access
• Page:
  How-to articles Confluence