Editing a synchronization profile - Cloud Native App

You can edit an already existing profile by clicking cog icon and then Configuration link on the Configuration view.

General settings

In the first step, you provide some basic, general profile properties, such as:

• Profile name
• Jira's project name
• Azure DevOps (ADO) URL, synchronizer user credentials, organization and project.
  
  

Configuration fields

Most of the configuration fields are self-explanatory, but some might need a little explanation, which you will find below.

User credentials

ADO user provided in Synchronization Profile needs to have sufficient privileges for a given project.

Connection testing

A Test Connection feature enables you to verify whether TFS4JIRA Synchronizer is able to connect to Azure DevOps at specified URL using given credentials. Remember that this option tests only if the connection can be established, it doesn't check if given user has sufficient permissions for the project.

Field mappings

Jira issue and Azure DevOps work item are quite different items. Although both share common properties and traits, they differ in many aspects such as default fields sets, workflows and restrictions. TFS4JIRA Synchronizer allows you to configure which issue / work item fields values should be synchronized and how.

A newly created profile comes with an out-of-the box mapping configuration which is a good starting point for further customization.

Field Mappings view

Field Mappings view consists of two sections:

Basic Mappings

Here you will find links to Values Mapping views for some crucial fields/properties, such as: issue type / work item type, issue status / work item state, issue resolution / work item resolved reason. More info about values mapping configuration can be found in the following sections.

Other Mappings

Here you can define additional issue field / work item field pairs that are to be synchronized. In order to define a mapping select Jira field name in the left box and Azure DevOps field name in the right box and click Map button. Previously created mappings can be removed. You can also configure values mappings for a given field mapping by clicking on Values link (see the section below for details).

Values Mapping view

After TFS4JIRA Synchronizer detects modification in one of the mapped fields, it copies the changed value to linked peer item (be it issue or work item). On Values Mapping view you can configure how should the value be mapped.

The Values Mapping view consists of three sections

Mapping Between

This section contains information about each of the fields in the pair to be mapped, such as name and type.

Mapping mode

Copy values

When Copy values mode is selected, TFS4JIRA Synchronizer simply copies a modified value attempting to perform type conversion if needed (for example when a numerical field is mapped to string field). For many field types Copy values is the only available mode.

Map values

This mode is applicable to dictionary-type fields only. When Map values mode is selected, the values pairing panel appears.

In order to define a mapping select Jira field value from the left box and Azure DevOps field value from the right box and click a Map button. A list of already defined mappings is displayed under the boxes. You can remove previously defined pairing by clicking Remove link.

Default value is a value to be set if unmapped value is encountered. 

Mapping direction

You can configure the pair for one-way synchronization (i.e. modifications will be propagated in one direction only) or two-way (modifications at both sides will be propagated).