Edit a Sync Profile

Edit an existing profile by going to the Sync Profiles page and selecting the sync profile you want to edit.

Sync profiles should be updated anytime a change is made to the Jira or Azure DevOps (ADO) project structure. For example, if a new item type is added, or a field is removed, the sync profile associated with those projects should be updated so the synchronization picks up the changes.

Open Sync Profiles

1. Click the Settings cog and select Apps. When the Apps page opens, select Get Started or Cloud Native synchronizer from the Apps left sidebar menu.

2. From the Cloud Native Synchronizer - TFS4JIRA landing page, click Configure to open the TFS4JIRA Synchronizer page.

3. When the TFS4JIRA Synchronizer page opens, click Sync profiles in the Jira-Azure Synchronizer menu. This takes you to the Synch Profiles page.

4. Select the Sync profile you want to edit from the available profiles.

   Open

   

The Sync Profile page appears nearly identical to the page presented when creating a new profile.

General Settings

Update connections, projects, and the synchronization direction.

1. Connections - Select a different Azure DevOps connection, or add a new Azure DevOps connection.

2. Projects - Select a different Jira or Azure DevOps project, or select Manage projects for either platform to open that platform’s Projects page and make any necessary changes.

3. Synchronize - Select or remove Comments or Attachments to include or exclude them from synchronization.

4. Click Save settings to save your changes.

Refer to General Settings for more information.

Item types

1. Item types - To map additional items to the sync profile, click in the In Jira field and select an item from the To be mapped list. Click the In Azure field and select an item from the to be mapped list.

2. Mapped item types - Review or remove existing mapped item types. To remove a previously mapped item, locate the item in the Mapped item types list and click the Remove mapping icon.

3. Default values - To change how cases not covered by the mappings are handled, click the Jira and Azure fields and select Skip, Raise Error, or Set Item from the Actions list.

4. Hierarchy - Enable hierarchy mapping for the mapped item types. Hierarchy mapping ensures that relationships between items—such as epics and their child stories—are maintained across both systems.

5. Custom setup - Enable synchronization of non-standard parent-child relationships between Jira and Azure.

6. Click Save settings to save your changes.

Refer to Item Types for more information.

Fields

Update which fields should be synchronized between Jira and Azure DevOps.

1. Reload Jira and Azure data - ensure any fields recently added to Jira or Azure are included in the To be mapped lists.

2. Mapped item types - Review or remove existing mapped item types. To remove a previously mapped item, locate the item in the Mapped item types list and click the Remove mapping icon.

3. Click Save settings to save your changes.

Refer to Fields and Fields Data Value Mapping for more information.

Users

Update the user mapping to use as the default matching method for user fields.

1. Manual user map - Click Mapping for Sync Profiles, enter the user for Jira and Azure, and click Add mapping. These mappings have priority over the general matching rule. Click Save settings to save your changes.

2. Default values - To change how cases not covered by the mappings are handled, click the Jira and Azure fields and select Skip, Raise Error, or Set Item from the Actions list.

3. Click Save settings to save your changes.

Refer to Users for more information.

Workflows

Update the mapping of states and statuses between systems.

1. Workflows - Click In Jira and select a workflow from the list. Click in Azure and select a workflow from the list. Click Add mapping to add to the Mapped statuses list.

2. Default values - To change how cases not covered by the mappings are handled, click the Jira and Azure fields and select Skip, Raise Error, or Set Item from the Actions list.

3. Click Save settings to save your changes.

Refer to Workflows for more information.

Filters

Synchronization filters further define the scope of issues or work items to be synchronized.

1. Filter Jira items uses Jira Query Language (JQL) to limit the scope of the sync.

2. Filter Azure items uses Work Item Query Language (WIQL)to limit the scope of the sync.

Refer to Filters for more information.

Links

The Links configuration allows you to map links between issues relations such as parent/child, relates to/related to between Jira and Azure DevOps.

1. Mapped Links - Click the In Jira field and select an item from the To be mapped list. Click the In Azure field and select an item from the To be mapped list.

2. Click Add mapping to add it to the Mapped links list. Change the number of items displayed and switch between list pages.

3. Click the Switch icon to change the orientation of the Azure mapping. For example, switching Affected By / Affects to Affects / Affected By.

Refer to Links for more information.