The configuration is performed by the Parasoft administrator and only needs to be set up once. 

Connecting DTP to Polarion ALM Server

  1. Choose Report Center Settings from the settings (gear icon) menu.
  2. Choose External System, click Edit Settings, and choose Polarion from the System type menu.
  3. Enable the Enabled option.
  4. Enter a name for your instance of Polarion in the Name field. The name is required but does not affect the connection settings or render in any other interfaces.
  5. Enter the Polarion server in the Application URL field. The URL should include the protocol, host, and port number. Do not include paths or parameters.
  6. The Display URL field defines the URL which is displayed in Parasoft DTP pages when links to your Polarion system are presented in a web browser. Typically, this should be the same as the above Application URL field. However, it might be different, for example, when you work in a reverse proxy environment and links to Polarion from the user's local web browser with Parasoft DTP are different than from the Parasoft DTP server. 
  7. Enter login credentials in the Username and Password/API Tokens fields. The login must have sufficient privileges to create issues in the Polarion projects specified in the Project Associations section.
  8. Click Test Connection to verify your settings and click Confirm.

Associating Parasoft Projects with Polarion Projects

Associating a Parasoft project with a Polarion project enables you to create defects from the Violations or Test Explorer views that are linked to the correct project in Polarion. The association is also important when using the the Sending Test Data to External System flow. You can associate multiple projects in DTP with a project in Polarion, but you cannot associate the same DTP project with more than one Polarion project.

  1. Click Create Project Association and choose a project from the DTP Project menu in the overlay. 
  2. Enter the name of a Polarion project in the External Project field, then click Create to save the association.

Click the trash icon to remove a project association. Deleting the project association does not remove links to defects in Polarion from the explorer view. If a new association is created, existing links between violations and Polarion issues will be reactivated. 

You can reconfigure an existing association between DTP and Polarion projects:

  1. Click the pencil icon and choose either a different DTP project from the menu or specify the name of a different Polarion project in the External Project field.
  2. Click Save

Advanced Configuration

You can modify the ExternalSystemSettings.properties configuration file located in the <DTP_DATA_DIR>/conf directory to change the default behavior of the integration. DTP's out-of-the-box integration with Polarion is configured to use default or commonly used fields and work item types. If you customized your Polarion system, however, then you can configure the settings detailed below to align data in DTP with your custom configuration.  

Please note that ExternalSystemSettings.properties is expected to use ISO 8859-1 (Latin1) character encoding. Any character not supported by ISO 8859-1 must be represented in keys and elements using Unicode escape sequences, which is to say a backslash (\) and a lowercase u, followed by the four-digit hexadecimal code for the character. For example, the "En Dash" (–) character (not to be confused with the "Hyphen-Minus" character (-)) is not supported by ISO 8859-1, so it must be represented by its Unicode escape sequence \u2013. As a result, something like example.property.value=Foo – Bar would need to be entered as example.property.value=Foo \u2013 Bar.

polarion.workItemType.requirementIds

Specifies a comma-separated list of Polarion work item types that should take the role of requirements in Parasoft. The work items are also used in the Traceability Report.

Go to Polarion Administration > Work Items > Types for the IDs in the Polarion UI to access the work item IDs in your Polarion system. 

Default:

polarion.workItemType.requirementIds=softwarerequirement,systemrequirement,requirement,userstory 

polarion.workItemType.testId

Specifies the Polarion work item type that should take the role of tests in Parasoft. 

Go to Polarion Administration > Work Items > Types for the IDs in the Polarion UI to access the work item IDs in your Polarion system.

Default:

polarion.workItemType.testId=unittestcase 

polarion.workItemType.issueSpecifies the type of work item to create in Polarion when creating new issues from the DTP Violation Explorer and Test Explorer. This enables you to associate custom issue trackers you may have configured in Polarion with work items created from DTP. 

By default, the property is not set. As a result, issue work items created in DTP are associated with issue work items in Polarion.

polarion.workItem.Type.taskSpecifies the type of work item to create in Polarion when creating new tasks from the DTP Violation Explorer and Test Explorer. This enables you to associate custom task trackers you may have configured in Polarion with work items created from DTP. 

By default, the property is not set. As a result, task work items created in DTP are associated with task work items in Polarion.

polarionIssueUrl

Specifies the URL template for linking work items created in the DTP Violation Explorer and Test Explorer to work items in Polarion.

Default:

polarionIssueUrl=<POLARION_URL>/polarion/redirect/project/<PROJECT>/workitem?id=<ID> 

polarion.hyperlinkRole

Specifies the role of hyperlinks as configured in your Polarion system. The hyperlink role is used when creating work items from the DTP Violations Explorer and Test Explorer.

Go to Polarion Administration > Enumerations > hyperlink-role-enum.xml in Polarion to access the hyperlink role.

Default:

polarion.hyperlinkRole=ref_ext

polarion.requirementStatus.verified

Specifies the relationship between the tests sent from DTP and the requirements in Polarion. Go to Polarion Administration > Enumerations > workitem-link-role-enum.xml in Polarion to view the current relationship configurations.

Default:

polarion.requirementStatus.verified=verifies 

polarion.testCase.workItemLinkRole=

Specifies IDs of roles which should be treated as "WorkItem-Test" relation types. Go to Polarion Administration > Enumerations > workitem-link-role-enum.xml in Polarion to view the current relationship configurations. The values should be a list of IDs separated with ",". When field is empty all role types are accepted.

Used in Parasoft C/C++ and SOAtest Requirements View to present Polarion test cases associated with Polarion requirements.

Default:

polarion.testCase.workItemLinkRole=depends_on,verifies,relates_to

  • No labels