Process Feedback Polarion Specific
The Polarion Feedback adapter allows you to add work items to your Polarion instance from your Stages process.
Example Configuration
To enable the following configuration section must be added in the conf/config.xml
:
<?xml version="1.0" encoding="UTF-8" ?> <stages-config> <!-- Insert this block to your stages config.xml file --> <feedback-systems> <feedback-system name="polarion"> <host url="https://polarion.example.com/polarion" ident="polarion" displayName="Polarion Example"> <!-- See the section below for how to create a personal access token --> <property name="token" value="eyJraW..."/> <!-- Define the polarion project where the work item should be created in --> <property name="project" value="drivepilot"/> <!-- Define the id of the work item type that should be created --> <property name="workItemType" value="feedback"/> <!-- The summary field will always be available and is automatically mapped to the work item title --> <!-- See common feedback documentation - The "target" defines the id of the field in --> <attributes> <attribute ident="description" type="text" target="description" /> </attributes> <system-attribute-mappings> <attribute source="elementName" target="stagesElement" /> <attribute source="elementUrl" target="hyperlinks" /> </system-attribute-mappings> </host> </feedback-system> </feedback-systems> </stages-config>
Supported Field Types
Officially supported Polarion standard fields are:
- description
- assignee
- author
- hyperlinks
- severity
- date-type fields (e.g. dueDate)
Supported Polarion Custom Field Types:
- String
- Text and Rich Text (multi-line - see target-types below)
- Integer
- Enum
Example:
<attribute source="stages_link_field" target="hyperlinks" /> <attribute source="stages_date_field" target="dueDate" /> <attribute source="custom_string" target="custom_string" />
Other simple string-based fields may also work.
Special target types
- Add targetType=“multi-line” for custom fields of the types 'Text' and 'Rich Text'.
- Add targetType=“hyperlink-internal” to your hyperlink field, to give all links the 'internal reference' role.
Example:
<attribute source="my_custom_multi_line" target="my_custom_multi_line" targetType="multi-line" />
Create Personal Access Token In Polarion
- Log in to Polarion as an administrator
- Navigate to Settings > Administration > User management > Users
- Select the technical user you want to use for the integration
- Click on Personal Access Token to create a Token
Note: By default, Polarion tokens can be valid for a maximum of 90 days. Newer versions of Polarion allow you to set a longer token lifetime in the polarion.properties
file. See the Polarion documentation for details.