Edit a Sync Profile

Owned by Jeff Gleeson
Last updated: Nov 27, 2023
4 min read

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 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.

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. 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.

Hierarchy

The Hierarchy feature allows you to map the item hierarchy configuration of one platform to the other.

  1. Epics - Select the Epics checkbox to synchronize epics and map the corresponding epic items in both systems.

  2. Other levels - Click the Other levels checkbox to select the corresponding Jira link type. Select the Jira link type to associate with the Parent / Child.

  3. Subtasks - Click the Subtasks checkbox to map Jira subtasks to Azure item types. Select an item type from the In Azure dropdown list.

Refer to Hierarchy 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.