...

DTP interfaces that display and track traceability are enabled by deploying the External Application Traceability Report artifact to your DTP environment using Extension Designer. Verify shipped with the Traceability Pack. The Traceability Pack also includes the Sending Test Data to External Application flow, which automates part of the requirements traceability workflow. Refer to the Traceability Pack documentation for additional information about the pack.

Use DTP Extension Designer to deploy the External Application Traceability Report and the Sending Test Data to External Application flow to your environment. Verify that DTP is connected to Polarion as described in the Connecting DTP to Polarion ALM Server section before deploying the artifact.

Installing the

...

Traceability Pack

The first step is to install the External Application Traceability Report artifactPack. The artifact is a collection of configuration files and assets that enable traceability.  

1. Choose Extension Designer from the settings menu (gear icon).
   
2. Click the Configuration tab to open Artifact Manager.
3. Click Upload Artifact and browse for the external-app-the traceability-reportpack-<version>.zip archive (also see Downloading and Installing Artifacts).
4. Click Install and a collection of assets and configuration files for enabling traceability will be installed. 

Deploying the External Application Traceability Report

Deploy the report components to your DTP environment External Application Traceability Report after installing the External Application Traceability Report artifactPack. 

1. Open Extension Designer and click on the Services tab.
2. Choose an existing service to deploy the artifact or create a new service in the DTP Workflows category. Refer to Working with Services for additional information on organizing services and artifacts.
   
3. If you are adding the artifact to an existing service, add a new Flow tab (see Working with Flows) and choose Import> Library> Workflows> External Application Traceability Report> External Pack>  External Application Traceability Report from the vertical ellipses menu.
   Image RemovedImage Added
4. Click inside the Flow tab to drop the nodes into the service and click Deploy. 

Deploying the External Application Traceability Report adds new widgets to Report Center, as well as a drill-down report. See Viewing the Traceability Report for instructions on adding the widgets and viewing the report.  

Deploying the Sending Test Data to External Application Flow

This artifact sends test data to Polarion when DTP Data Collector retrieves test results from a Parasoft tool. Before deploying the flow, verify that the DTP Enterprise Pack connection is to DTP is configured with the host name of the server running DTP.

Image Added

By default, Enterprise Pack points to localhost. See Server Settings for additional information.

1. Open Extension Designer and click on the Services tab.
2. Choose an existing service to deploy the artifact or create a new service in the DTP Workflows category. Refer to Working with Services for additional information on organizing services and artifacts.
3. If you are adding the artifact to an existing service, add a new Flow tab (see Working with Flows) and choose Import> Library> Workflows> Traceability Pack> Sending Test Data to External Application  from the vertical ellipses menu.
4. Click inside the Flow tab to drop the nodes into the service and click Deploy. 

Usage

After configuring the integration with Polarion, developers, testers, and other users can leverage the functionality enabled by the integration.

...

1. Create work items in Polarion ALM that will be associated with tests executed by Parasoft C/C++test, dotTEST, or Jtest.
2. In your test file, add the Polarion test case or requirement IDs using the @test or @req annotation. See the C/C++test, dotTEST, or Jtest documentation for details on adding annotations.
   • Use the @test <Polarion unit test case ID> annotation in your tests to associate them with Polarion unit test cases. 
   • Use the @req <Polarion software/system requirement ID> annotation in your tests to associate them with Polarion software or system requirements. 
3. Execute your tests as part of the CI process. You can also manually execute the tests from the C/C++test desktop. 
4. As part of the test execution, C/C++test will tag the results with the filter and build IDs and send the data to DTP. You can verify the results in DTP by adding Test Widgets to your DTP dashboard and setting the filter and build ID. C/C++test developers can download the test execution data from DTP into their IDEs so that they can address any failed tests.

5. Send If you deployed the Sending Test Data to External Application flow (see Deploying the Sending Test Data to External Application Flow), then unit and functional testing results will automatically be sent to Polarion when Data Collector receives the data from the Parasoft tool.
   You can also manually send a POST request to the DTP REST API endpoint to send results from the DTP database to Polarion. Pass the DTP filter and build IDs as URL parameters in the API call:
   

   No Format
   https://<host>:<port>/grs/api/v1.7/linkedApps/configurations/1/syncTestCases?filterId=<filterID>&buildId=<buildID>

   The filter and build IDs are available in the Test Explorer URL:

   

6. DTP will locate the test results that match the filterId and buildId parameters and send the data to the Polarion unit test cases or requirements. You should expect the following response:

   • When DTP locates results with an @test <ID>, it will search for unit test cases with a matching ID in Polarion and update the item. No action will be taken if the unit test case IDs do not exist in Polarion.

   • When DTP locates results with an @req <ID>, it will search for requirements with a matching ID in Polarion and update associated children unit test cases. If no unit test cases exist for the requirement IDs, unit test cases will be created. Unit test cases will also be created if the requirement IDs are not found.  

After DTP processes the report and sends results to Polarion, you should expect a response similar to the following:

{
  "createdTestSession": "DTPP-521",
    "created": [
        "DTPP-519, testName = testBagSumAdd"
    ],
    "updated": [
        "DTPP-519, testName = testBagSumAdd",
        "DTPP-518, testName = testBagSimpleAdd"
    ],
    "ignored": [
        "MAGD-567, testName = testBagNegate",
        "QAP-512, testName = testTryThis3",
        "QAP-512, testName = testTryThis4",
        "MAGD-567, testName = testBagMultiply"
    ]
}

...