This is an old revision of the document!


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="example.com" ident="polarion" displayName="Polarion">
          <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 column id in Polarion -->
          </attributes>
     </host>
</feedback-system>
</feedback-systems>
</stages-config>

Supported Field Types

Officially supported are:

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

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.

Host Properties

token *
  • The token (personal access token) is needed to connect to your Polarion instance.
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
project *
  • The project id of the Polarion project you want to send work items to.
workItemType *
  • The id of the work item type you want to create.