Modifying data during the export process

Some data can be modified by the tool to facilitate creation of artifacts.

About this task

You use data modifiers on the right side of the equal sign in configuration file entries. Except for the ampersand (&), the notation is similar to a function. You include the name of the modifier and then specify the data in parentheses. This example shows a data modifier: testcase.attachment=Pre(C4).
The data in the parentheses can be defined as with other configuration entries. The modifiers are as follows:
  • Pre() causes the data to be wrapped in an XHTML pre tag. This tells the Quality Management application that the specified data is preformatted; the new lines are preserved.
    Tip: In most circumstances, the export utility automatically converts new lines into XHTML paragraph markers to preserve the formatting.
  • Div() is similar to the Pre() modifier, except that it only wraps the data in the XHTML tag. This modifier preserves the line breaks by replacing them with the XHTML <br> tag.
  • Link() specifies that the content is the ID of an artifact to be linked to. This modifier can be used in several ways: The left side of the equal sign specifies the type of artifact to link to (testcase.testscript=Link(C)) . If the content in the link is formatted to use full notation, the artifact type that is listed to the left of the equal sign is ignored and the data is used raw (testcase.testscript=Link("../requirement/myimportedreq")) . If the content of the data is a list of items to link to separated with new lines, each is converted to a link. The XLSArtifactID keyword is the most common way to create artifacts whose IDs are known so as to be able to reference it using the link modifier.
  • Image() is used to import an image from the defined location. The left side of the equal sign must refer to a rich-text field because the modifier automatically creates an embedded image tag to the new image that is exported, along with adding the image to the list of attachments.
Use the ampersand symbol (&) to add two or more bits of data to the same field. The data can be a mix of items. This example shows the addition of two bits of data to the modifier:
testcase.description=”my description:” & C4 & testscript.description

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki