This chapter describes how to associate requirements with files so that the JIRA Traceability Report can show static analysis violations and build reviews within the context of the analyzed source files.
The following workflow describes how to enable requirements traceability for a specific build ID. You must repeat the steps for each additional build ID you want to view requirements traceability information for.
A special CSV file that maps files to requirements is prepared, e.g.:
|File||Associated Requirement ID|
|reqA, reqB, reqC|
The file may be prepared manually be team members or it can be automated with a script. For example, the script could scan the source control repository for requirements markers added by developers and generates the CSV file accordingly.
Run the CSV-scanning script shipped in the DTP_HOME\grs\extras\traceability directory with the following arguments:
groovy fileReqAssoc.groovy -csv <CSV_FILE_NAME> -build <BUILD_ID> -dtp <DTP_HOST_INC_PROTOCOL> -user <DTP_USERNAME> -password <DTP_PASSWORD>
This is an example script intended to demonstrate a sequence of API calls that should be performed to associate files with artifacts in DTP. You can use this example script as a starting point for implementing a more advanced solution.
The script is written in Groovy, but the directory also contains a JAR file that you can run with the same arguments.
The script scans the CSV file prepared in step #2 and feeds the DTP database with the information about requirements to files mapping. See the README.txt file for details how to run the script.
After the script finishes, the traceability data for the specific filter ID and build ID will be stored in the database. The data can now be viewed using one of the following methods: