Appending and Maintaining Document Attachments for Test Objects

Use

You can append document attachments to test objects, and maintain them. In addition to the conventional option of creating a SAPscript file as documentation for a test configuration, you can also append various types of external document as a file or a link to test configurations and variants.

Procedure

To view the list of appended documents, and access the functions for adding and maintaining attachments, select the Start of the navigation pathAttributes Next navigation step AttachmentsEnd of the navigation path tabs in the relevant test configuration. For a description of the individual list columns, see Documentation of Test Objects. The attachment list toolbar contains functions for assigning attachments to test objects, maintaining attachments, and deleting assignments.

Assigning Attachments

You can assign documentation to a test object as either a SAPscript document, a link (URL/file path), or an external file. The various types of assignment are described below:

  • Assigning a SAPscript document

    Even if you have not yet appended an attachment to the test configuration, you still see a default entry for a SAPscript attachment in the attachment list (it does not yet have a file name). This is because the conventional option for creating documentation for test configurations using SAPscript is still available. To use this option, simply double-click the default SAPscript line or choose the documentation icon in the eCATT toolbar. You can then create your SAPscript documentation as before. If the Default Attachment indicator is selected, the document is also displayed in the Test Workbench for this test object.

  • Assigning attachments using links

    To assign attachments as a link, that is, as a URL or file path, proceed as follows:

    1. In the attachment list, choose the Insert Row option from the toolbar.

    2. In the new row, enter the name of the attachment and select Link as the attachment type.

    3. In the File Name/File Path field, enter the URL or path to the central location of the file.

    4. In the eCATT Object Type column, select whether to assign the link to a test configuration or to a variant.

    5. In the Linked to eCATT Object field, enter the object name. A dropdown list of the objects you can use is available to help you.

    6. If required, set the Default Attachment indicator. If the Default Attachment indicator is selected, the document is also displayed in the Test Workbench for this test object.

    7. Save your entries.

  • Uploading and assigning files

    You can also upload local files to the central eCATT repository and then assign them as attachments. Proceed as follows:

    1. Choose the icon for uploading in the list toolbar.

      The Upload Attachment window appears. If you click the folder icon to the right of the File Path field, File Explorer opens, where you can select the required files in the relevant local folders. The default directory opened by File Explorer is sapworkdir.

    2. Select your file or files.

      The File Path field now displays the directory path and the Attachment Name field contains the name of the file to be uploaded. If you are uploading more than one file, the names of the files are separated by a semicolon. You still have chance to change the names before uploading.

    3. Confirm your selection.

      If you attempt to upload a file when a file with the same name already exists in the attachment list, a dialog box is displayed. You can choose whether to rename and upload the file, overwrite the existing uploaded file, or cancel the operation. If you decide to rename the file, the system proposes a new name (comprising the original name, the date, and the time). You can change this proposal if you wish.

    4. Once the attachments have been uploaded, they are displayed in the attachment list.

      You can now assign the relevant test objects, and select an entry as the default attachment, if necessary.

  • Assigning an attachment to a variant

    To assign an attachment to a variant, you have two options: You can assign an attachment to a variant in the attachment list, in the eCATT Object Type column. If you have assigned an attachment to a variant in this way, an icon is displayed in the test configuration on the Variants tab, in the Attachment column. You can use this icon to open the document. Alternatively, you can assign an attachment to a variant directly, on the Variants tab. To do this, the document must be uploaded to the relevant field of the variant in the Attachment column.

Maintaining/downloading attachments

To maintain or change an uploaded document, it must first be downloaded again. This ensures that nothing is overwritten by mistake. To download attachments, proceed as follows:

  1. Select the files to be downloaded in the attachment list, and then choose the download icon in the attachment list toolbar.

    File Explorer opens, where you can select the folder to which you want to download the file(s). If a file with the same name already exists, you are asked if you want to overwrite it. If you do not, you can rename the file. You can also cancel the operation.

  2. Save the file.

Deleting attachments

To delete an attachment, you select the relevant list entry and then choose the Delete Attachment icon in the list toolbar. If you are deleting an attachment with an external document, you are asked whether you want to download the file before it is deleted. If the default attachment is deleted, the SAPscript document is automatically flagged as the default document.

Other Operations

All other operations such as saving, refreshing, renaming, copying, and deleting are coupled to the existing eCATT functionality and are executed at the test configuration level. If, for example, you are copying a test configuration, the attachments are copied as well.