Resolution
This article describes how to synchronize the resolution field between Jira projects. There are three methods of configuring this field:
- Passthrough Mapping: if the resolution should be always be the same in both synchronized issues
- Correlation Mapping: if the resolution shouldn't always be the same in both synchronized issues
- Resolution To Text Mapping: if you only want to synchronize the resolution to a text field
Requirements
In order to use a passthrough or correlation mapping for synchronizing the resolution, you have to setup a workflow mapping in your configuration. Resolutions are dependent on the workflow status of an issue. Therefore, Backbone will determine when a resolution is synchronized based on the workflow mapping. Backbone will only update a resolution together with changing the status of an issue. Thus, make sure to add the resolution field to the transition screen in order to update it.
Backbone will not automatically remove the resolution - this needs to be done by using a post function in your workflow.
Passthrough Mapping
The Passthrough setting always maps the same resolution between projects. You should only use this when both projects have the exact same resolution field values, otherwise you'll get an error.
To configure the mapping:
- In the Backbone resolution field mapping configuration, select Passthrough
- Click next, and do the same for the other project
Now, the same resolution value will be synced between projects.
Correlation Mapping
The Correlation setting lets you map certain resolution values in one project to certain resolution values in the other. You should use this when the projects have different resolution field values.
To configure this mapping:
- In the Backbone resolution field mapping configuration, select Correlation
- In the Resolution Mapping section, select which resolution should be mapped to which. The resolutions with the same numbers will be mapped, e.g. here, 'Done' and 'Duplicate' will be mapped to 'Won't Do' and 'Duplicate':
- Select a default resolution – this is the resolution that should be applied in case one certain resolution hasn't been mapped
- Click Save
Resolution To Text Mapping
The To Text setting lets you map the resolution value to a text field.
In order to use this mapping, you have to
- create a new advanced field mapping,
- select Resolution on one side,
- select a text field on the other side,
- set the synchronization direction from the Resolution field to the text field.
The following steps are only necessary if you're using Backbone version 4.1.3 or before. If you're using a newer version, please skip this part.
Deprecated: Create a global looped workflow transition
Before you can configure the resolution field mapping, you firstly have to create a global looped workflow transition in the workflows being used by the projects that the resolution field is being synchronized to.
A global looped transition is a transition from any status to itself. It's necessary to create one because to change the resolution field, Jira must also trigger a workflow change – and if this workflow change is the global looped transition, then you can change the resolution without always having to transition to a new workflow state.
Create the global looped transition
- Define a new screen
- Assign the resolution field to it
- Create a new global looped transition for the workflow you are using in this project. Click to Workflows > Edit for the workflow you are using > Add transition > in the From status field, enter 'Any status' > In the To status field, enter 'Itself' > assign a name > assign the new screen from step 1 > click Add
- Get the ID of the global looped transition by clicking Text, then finding the global looped transition's name in the Transitions (id) column. The ID is in brackets next to the name – make a note of it
- Optionally, if you want to hide this new transition from your users:
- Assign your Backbone synchronization user to a group that only it belongs to
- Make the global looped transition only visible to users in that group by navigating to Workflows > Edit for the relevant workflow > click the global looped transition > Conditions > Add condition > select User Is In Group > select the group with only the Backbone synchronization user in it
Now, you can configure the resolution field mapping.
Deprecated: Passthrough Mapping via Transition
The Passthrough (Deprecated) via Transition setting always maps the same resolution between projects. You should only use this when both projects have the exact same resolution field values, otherwise you'll get an error.
To configure the mapping:
- In the Backbone resolution field mapping configuration, select Passthrough (Deprecated)
- In the Transition ID field, enter the ID of the global looped transition (if you haven't got this set up, see the steps in the first part of this article) in the project's workflow:
- Click next, and do the same for the other project
Now, the same resolution value will be synced between projects.
Deprecated: Correlation Mapping via Transition
The Correlation (Deprecated) via Transition setting lets you map certain resolution values in one project to certain resolution values in the other. You should use this when the projects have different resolution field values.
To configure this mapping:
- In the Backbone resolution field mapping configuration, select Correlation (Deprecated)
- In the Resolution Mapping section, select which resolution should be mapped to which. The resolutions with the same numbers will be mapped, e.g. here, 'Done' and 'Duplicate' will be mapped to 'Won't Do' and 'Duplicate':
- Select a default resolution – this is the resolution that should be applied in case one certain resolution hasn't been mapped
- In the Transition ID field, enter the ID of the global looped transition in the relevant project's workflow (if you haven't got this set up, see the steps in the first part of this article)
- Click Next and enter the ID of the global looped transition in the relevant project's workflow
- Click Save