Synchronization Filters - Cloud Native

Synchronization filters offer the ability to further define the scope of issues or work items to be synchronized. The first step is to define which project in Jira and Azure DevOps (formerly VSTS) to connect, followed by selecting all fields and field types from each project and mapping data values as needed. 

Example Jira to Azure DevOps

As a support manager, I want to synchronize only items needing development assistance in Jira to Azure DevOps when Label is set to “development”, so that developers can track which issues from support are added to the backlog. 

1. In Jira Manage apps, select “TFS4JIRA” -  “Cloud Native Synchronizer”
2. Select “Configure mappings”, and the Profile you would like to define filters
3. Select the “Filters” tab
4. In the Filters page, select “Filter Jira items” and define the filter as required for this example.

Notes:

• Filters are based on Jira Query Language. For more information, please refer to Advanced search with Jira Query Language
• Filters are additional parameters added to JQL. In other words, the project and item types that have already been defined during configuration. In the example above, when clicking on See in Jira, you would see the following:
• project = 'TFS4JIRA' AND issuetype in ('Epic','Task','Bug','Story') AND (Labels = development)
• Project and issue type can only be modified through Profile configuration
• “Test query” will test the entire JQL and will return execution results. Testing the filter query is run as a normal query, without any impact to current or future synchronizations. 
• Saving filters will only be possible for filters that were successfully executed

Example Azure DevOps to Jira

As a business manager, I want to synchronize all work approved through development to Jira so that I can properly manage the progress of projects. 

• In Jira Manage apps, select TFS4JIRA Cloud Native Synchronizer
• Select Configure mappings, and select the Profile you would like to define filters, then select the Filters tab
• In the Filters page, select Filter Azure items and define the filter

Notes:

• Filters are based on Work Item Query Language (Wiql). For more information, please refer to Azure DevOps (WIQL) syntax reference
• Filters are additional parameters to limit the scope of the data to be synchronized. Project and item types have already been defined during configuration, and can only be changed through Profile configuration. 
• “Test query” will test the entire Wiql and will return execution results. Testing the filter query is run as a normal query, without any impact to current or future synchronizations. 
• Saving filters will only be possible for filters that were successfully executed