Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DTPDEVEL and version 2020.2


  1. Create requirements (e.g., Jira stories) in the requirements tracking system. 
  2. Create a CSV file that maps the source code files for your project to the requirement IDs generated by your ALM system, e.g.:

    FileAssociated Requirement ID




    reqA, reqB, reqC
    titleCreating the File-to-Requirement Map

    The file may be prepared manually by 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.

  3. Add the file-to-requirement association information to the DTP database by checking the source code files into source control and running your Parasoft tool. The tool execution must be run under the specific build ID and project (see the documentation for the tool for instructions on how to specify this metadata).
    • You can also send a POST to the DTP REST API /artifactTypesartifactsTypes endpoint to add the requirements to the DTP database. Choose API documentation from the DTP help menu for additional information.
  4. Run the CSV-scanning script shipped in the <DTP_INSTALL>/grs/extras/traceability directory with the following arguments:

    Code Block
    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.