You can edit an already existing profile by clicking cog icon and then Configuration link on the Configuration view.
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.
Most of the configuration fields are self-explanatory, but some might need a little explanation, which you will find below.
ADO user provided in Synchronization Profile needs to have sufficient privileges for a given project.
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.
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:
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.
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).
Only modifications made to mapped fields will trigger synchronization and only these values will be synchronized. TFS4JIRA Synchronizer ignores modifications made to unmapped fields.
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
This section contains information about each of the fields in the pair to be mapped, such as name and type.
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.
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.
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).
A new profile is created as disabled, so it won't run automatically. After you've finished configuring the profile, you can enable it on on the Configuration view. There is no limit on the number of created profiles.
This page has no comments.