Polarion

Prerequisites

System Prerequisites

• API Enablement:

  • Polarion's REST API must be enabled in the polarion.properties file by setting the following property:

    • com.siemens.polarion.rest.enabled=true

  • You can find this file in Polarion installed directory at:

    • @POLARION_INSTALLATION_PATH@\polarion\configuration

  • Refer Polarion API Reference for more details.

User Privileges

• Create a user in Polarion that is dedicated for OpsHub Integration Manager. This user shouldn't perform any other action from Polarion's user interface.

• Following are the user privileges required:

1. The user must have access to the default SVN repository:

   • To grant user access to the default repository, refer Grant Permission To Access Repository.

2. The user must have the role of 'project_admin' in the project which they are going to configure in OpsHub Integration Manager.

   • To assign this role, refer Assign Role To User.

3. The user must have the following minimal permissions:

Access Level	READ Permissions	WRITE Permissions
Projects	Permission to VIEW	Permission to VIEW
REST API Endpoints	Permission to GET	Permission to GET Permission to PATCH Permission to POST Permission to DELETE (For attachments only)

• To check if the user has above permissions, refer to section Check API Permissions Required

System Configuration

Before you continue with the integration, you must first configure the Polarion system in OpsHub Integration Manager.

Refer to System Configuration for steps on how to configure the system. Refer to the screenshot below:

Polarion System Form Details

Field Name	When is the field visible	Description
System Name	Always	Provide a unique name for the Polarion system.
Instance URL	Always	Provide the Server URL of the Polarion instance. Format: http://[host name]:[port no] or http://[your_domain_name]. Example: http://10.13.27.200:8080.
User Name	Always	Provide the username of the dedicated user for Polarion API communication.
Personal Access Token	Always	Provide the Personal Access Token for the user specified in the "User Name" field. Refer to Access API Token section for details.
Instance Time Zone	Always	Provide the time zone of the host machine where Polarion is installed.
Base URL for Remote Link	Always	Provide a different instance URL of the Polarion instance. This URL will be used for generating the Remote Link. Note: If "Base URL for Remote Link" is empty, it will use default Instance URL to generate remote link if configured on integration.

Mapping Configuration

Map the fields between Polarion and the other system to be integrated to ensure that the data between both systems synchronizes correctly.

Refer to Mapping Configuration for steps on configuring field mappings.

Integration Configuration

Set a time to synchronize data between Polarion and the other system. Define parameters and conditions, if any, for integration.

Refer to Integration Configuration for step-by-step instructions.

Criteria Configuration

If you want to specify conditions for synchronizing an entity between Polarion and the other system to be integrated, you can use the Criteria Configuration feature.

Navigate to Criteria Configuration to learn in detail about Criteria Configuration.

• To configure criteria in Polarion, integration needs to be created with Polarion as the source system. Set the Query as per Polarion's Lucene query syntax.

  • Refer to Polarion API Reference for more details on query format.

• While adding the criteria, user needs to add the internal names of the fields on which the criteria has to be applied.

  • Refer to Access Field Internal Name section for details.

• Given below are the sample snippets of how the Polarion queries can be used as criteria query in OpsHub Integration Manager:

Sample criteria:

Field name	Field internal name	Criteria description	Criteria snippet
Title	title	Sync items with title containing "API"	(title:*API*)
Status	status	Sync items where status equals "Open"	(status:open)
Created Date	created	Sync items created between 1 June 2025 to 30 June 2025	(created:[20250601 TO 20250630])
Status	status	Sync items where status is not reviewed	(NOT status:reviewed)
Severity	severity	Sync items where severity is either normal or blocker	(severity:normal OR severity:blocker)

Target LookUp Configuration

• Provide query in Target Search Query field such that it is possible to search the entity in the Polarion as the target system. In the target search query field, you can provide a placeholder for the source system's field value in the '@'.

• To learn in detail about how to configure Target LookUp, refer to Search in Target Before Sync section on Integration Configuration page.

• Overall, Target LookUp Query is similar to Criteria configuration, except that the value part contains a field name with '@' instead of static value.

• While adding the query, user needs to add the internal names of the fields on which the query is to be applied.

Sample target lookup query:

Field name	Field internal name	Target Lookup use case	Query snippet
Target Item ID	targetItem	Target Lookup on the item having the source entity's id in custom field called 'targetItem'	targetLookup:@oh_internal_id@

Known Behaviors and Limitations

• Comments:

  • Replies to comments or edits in Polarion will be synced as separate comments by OpsHub Integration Manager.

• Project Groups:

  • Project Groups are not visible in the Project mapping list due to API limitations; projects are listed individually.

• Test cases and Unit test cases in Work item:

  • Test Steps and relation with Test Records are not supported currently.

Appendix

Grant Permission To Access Repository

To make sure the user (Example, ID = automationtest) has access to the SVN repository:

• Update the 'access' file located at @POLARION_INSTALLATION_PATH@\data\svn, add the following entries:

  # Append automationtest to existing lists
   [groups]
   user = ..., automationtest
   
   [/]
   automationtest = rw
  
   [repo:/]
   automationtest = rw
  
   [repo:/.polarion/access]
   automationtest = rw

Assign Role To User

To assign user the role of 'project_admin':

1. Log in to your Polarion account as admin.

2. Go to the 'Administration' section by clicking on the settings icon in the top left-hand corner of your screen. Refer to the screenshot below:

   

3. Click 'User Management' -> 'Users' in the left pane. Refer to the screenshot below:

   

4. In 'Project Roles', give the user 'project_admin' role. For example, refer to the screenshot below for Role assigned to the user in Project 'Automation_Unit_Project':

   

Check API Permissions Required

To give user the relevant permissions that allows synchronization of entities:

1. Log in to your Polarion account as admin.

2. Go to the 'Administration' section by clicking on the settings icon in the top left-hand corner of your screen. Refer to the screenshot below:

   

3. Now, go to 'User Management' -> 'Permissions Management' -> 'By Role'. Here, make sure the following permissions are checked.

   

Get API Token

To get the API token for a user:

1. Log in to your Polarion account.

2. Go to the 'My Account' section by clicking on the settings icon in the top left-hand corner of your screen. Refer to the screenshot below:

   

3. Click 'Personal Access Token' in the top pane and copy the token value. Refer to the screenshot below:

   
4. Provide the toke details. Refer to the screenshot below:

   

Note:

• It is recommended to regenerate API token before it expires, to avoid unexpected processing failures in OpsHub Integration Manager.

Access Field Internal Name

To get the field internal names:

1. Log in to your Polarion account.

2. Go to the 'Administration' section by clicking on the settings icon in the top left-hand corner of your screen. Refer to the screenshot below:

   

3. Click 'Work Items' -> 'Custom Fields' in the left pane. Refer to the screenshot below:

   
4. The column named 'ID' contains internal names of the field. Refer to the screenshot below: