Page History

The L2 requirements are tracked within the respective Jira projects for the DMS groups. In order to import these into the Cameo project execute the following steps:

1. Log into open-jira.nrao.edu and search for issues using the Export L2 Requirements filter.
   1. Ensure that only the Key, Summary, and Description columns are displayed, and that they are in that order.
2. In the open-jira interface under the Export tools select CSV (Current Fields).
   1. Choose a Comma as the delimter in the dialog box that pops up.
3. Using a text editor remove the first line (column headers) from the downloaded CSV file.
4. Download the two resource files from the right. These are a Java program that will do the translation from CSV to ReqIf format and the specification file.
5. Execute the java program usage is: java -jar <relative path to downloaded jar file> <import specification xml> <CSV file> <Output filename.reqif>
6. Use a text editor to modify the output ReqIf file changing the xmlns:ns2="http://... to xmlns="http://...
7. Start the Cameo Program and open the SRDP System Architecture project.
   1. Recursively lock the Requirements Allocation package
8. Import the .reqif file under File>> Import From >> Requirements Interchange Format
   1. Select the file in the dialog
   2. If prompted select the correct wave based requirements package within the Requirements Allocation package. If you are not asked, then no new requirements are updated (although existing requirements have been updated).
9. Select all imported tests, right click and select "Element Numbering"
   1. Set numbering scheme to consecutive, and reset the prefix to "ARCH-"
10. Create the correct hierarchy among any newly created requirements.
11. Remove the lock on the requirements allocation package (committing the changes to the server).

Resources

• Java program to create ReqIF file
• L2 Import Format Specification (XML)

The Verification tests are tracked within the Jira Architecture project for the DMS groups. In order to import these into the Cameo project execute the following steps:

1. Log into open-jira.nrao.edu and search for issues using the Export Verification Tickets filter.
   1. Ensure that only the Key, Summary, and Description, Test Procedure, Status, and Test Report columns are displayed, and that they are in that order.
2. In the open-jira interface under the Export tools select CSV (Current Fields).
   1. Choose a Comma as the delimiter in the dialog box that pops up.
3. Using a text editor remove the first line (column headers) from the downloaded CSV file.
4. Download the two resource files from the right. These are a Java program that will do the translation from CSV to ReqIf format and the specification file.
5. Execute the java program usage is: java -jar <relative path to downloaded jar file> <import specification xml> <CSV file> <Output filename.reqif>
6. Use a text editor to modify the output ReqIf file changing the xmlns:ns2="http://... to xmlns="http://...
7. Start the Cameo Program and open the SRDP System Architecture project.
   1. Recursively lock the Requirements Allocation package
8. Import the .reqif file under File>> Import From >> Requirements Interchange Format
   1. Select the file in the dialog
   2. If prompted select the Verification package. If you are not asked, then no new requirements are updated (although existing requirements have been updated).
9. Create the correct hierarchy among any newly created requirements.
10. Link the tests to the verified requirements through a verifies relation.
11. Remove the lock on the requirements allocation package (committing the changes to the server).

Resources

• Java program to create ReqIF file
• Verification Import Format Specification (XML)

Resources

• Java program to create ReqIF file

Importing from a CSV file to Jira was used in Wave 1 for the creation of the verification test tickets. The script to the right handles the import and does the linking between Tests and Sub-Tests. A few comments about the CSV file:

The CSV file MUST contain the following columns with the exact text in a header row at the top:

• description: The long description of the test.
• summary: A short description, this will become the ticket title
• issuetype: Should either be Test or Sub-Test. Sub-Tests are assumed to be linked to the most recent Test ticket in the file.

The python script usage can be determined by "./importTestToJira -h"

Resources

• Python Script to Import Tests