Map workflow statuses and states
Click In Jira and select a workflow from the list. Click In Azure and select a workflow from the list.
Click Add mapping. The mapping is added the mapping to the Mapped statuses list.
Info |
---|
Workflows in Jira and Azure DevOps should be as similar as possible to reduce the chance of an error in the synchronization. |
Map multiple statuses and states
It is also possible to map more than one Jira status to an Azure DevOps state and vice versa. For example, if you wanted to synchronize the Jira status Done to two Azure states Closed and Removed.
Click In Jira and select a status from the list. Click In Azure and select a state from the list. The order that you select the status and state is important, as the first pair selected is how the synchronization occurs for the single status or state.
Click In Jira or In Azure and select the same state as the previous step. For Select the other side, select the second state to map to and click Add mapping for the other side. You can continue adding additional states depending on how many are needed.
The first mapping is the default. The arrow between them is bidirectional, indicating that synchronization goes both ways. For additional mappings to the same state the arrow only points toward the single state, indicating that synchronization occurs in one direction, but not the other.
Default values
Set how TFS4JIRA responds during synchronization when it encounters an unmapped status or state.
Skip - When TFS4JIRA encounters an unmapped state, it skips over it and continues to the next state.
Raise Error - When TFS4JIRA encounters an unmapped state, it is recognized as an error. You can review the error in the sync log.
Set ItemStatus - When TFS4JIRA encounters an unmapped state, it maps it to a specific value. For example, if you select To Do, all unmapped values will be set to a To Do state.
Click the Jira field and select Skip, Raise Error, or Set Item from the list of options. If you select Set Item, click in the field below and select a value.
Click the Azure field and select Skip, RaiseError, or Set Item from the list of options. If you select Set Item, click in the field below and select a value.
Click Save and continue.
Click Save settings to finish creating the sync profile.
Example workflow
This example describes how to map mapping a simple Jira workflow to an Azure DevOps workflow, including mapping a single Jira status to two Azure states.
The Jira workflow uses To Do, In Progress, and Done, while the Azure workflow uses New, Active, Resolved, and Closed. Resolved and Closed will be mapped to the Done state in Jira. Resolved is the default state, meaning that after synchronization, all Jira items with the Done status will be represented in Azure with a Resolved state , rather than Closed.
Default values will be skipped for Jira and Azure.
Click In Jira and select To Do from the list. Click In Azure and select New from the list.
Click Add mapping. The mapping appears in the Mapped statuses list.
Do this again using In Progress for Jira and Active for Azure and click Click In Jira and select In Progress from the list. Click In Azure and select Active from the list. Click Add mapping.
Click In Jira and select Done from the list. Click In Azure and select Resolved from the list and click . Click Add mapping.
Click In Jira and select Done again. Click In Azure and select Closed from the list and click Add Mapping.
Done now appears in the Mapped Statuses list. The arrow between Done and Resolved is bidirectional, indicating that synchronization goes both ways. For Azure’s Closed state, the direction points towards Jira, indicating that Closed will synchronize with Done, but not the other way aroundvice versa.Jira and Azure default values remain are at Skip Set Status for this example. Any unmapped values will be skipped designated To Do and New during the synchronization.
Click Save settings.
Once all the sync profile sections have been successfully configured, the You’re Ready to sync! panel appears at the top of any sync profile page with links to enable the synchronization and sync initial items. Go to Ready to Synchronize for details.