The Polarion Feedback adapter allows you to add work items to your Polarion instance from your Stages process.

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="example.com" ident="polarion" displayName="Polarion">
          <!-- See the section below for how to create a personal access token -->
          <property name="token" value="xxxx"/>
          <!-- Define the polarion project where the work item should be created in -->
          <property name="project" value="xxxx"/>
          <!-- Define the id of the work item type that should be created -->
          <property name="workItemType" value="xxxx"/>
 
          <!-- 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" />
               <attribute ident="categories" type="string" target="categories"/>
               <attribute ident="assignee" type="string" target="assignee"/>
               <attribute ident="hyperlinks" type="string" target="hyperlinks"/>
               <!-- Example for a multi-line custom field. In this case 'myCustomMultiLine' would need to exist in your work item-->
               <attribute ident="myCustomMultiLine" type="text" target="myCustomMultiLine", targetType="multi-line"/>
 
               <!-- Add more fields as needed. Make sure the 'target' value matches the field id in Polarion -->
          </attributes>
     </host>
</feedback-system>
</feedback-systems>
</stages-config>

Officially supported are:

• description
• assignee
• author
• hyperlinks
• dueDate
• integer
• severity

Other simple string-based fields may also work.

• 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.

1. Log in to Polarion as an administrator

2. Navigate to Settings > Administration > User management > Users

3. Select the technical user you want to use for the integration

4. Click on Personal Access Token to create a Token

See Polarion Documentation

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.