General Settings - Cloud Native

Owned by Jeff Gleeson
Last updated: Jan 30, 2024
3 min read

General Settings overview

General Settings is made up of three parts:

  • Connections - Select a previously defined Azure DevOps connection or add a new connection. Determine the direction of the Jira / Azure synchronization.

  • Projects - Select the Jira and Azure projects you want to synchronize.

  • Synchronize - Include or exclude comments and attachments in your synchronization.

General Settings must be completed before completing the other synchronization profile steps.

tfs-gen-set.png

Currently, TFS4JIRA does not support multiple languages. Default values only work in English.

Connections

To get data from your Jira and Azure projects, TFS4JIRA needs to connect to your instances. Once the connections have been established, you can select the Jira and Azure projects to synchronize.

Connect to the Azure instance

Select the connections needed and the direction of the synchronization.

  • Jira - This is the Jira instance that TFS4JIRA was installed on. The Jira instance information is automatically entered in this field and cannot be changed.

  • Azure - The Azure DevOps instance that contains the project you want to synchronize with Jira. The dropdown contains all previously created Azure connections.

Select Azure, then select an Azure DevOps connection from the list or select Add Connection to create a new Azure connection. Refer to Create a new Azure Connection for instructions.

  • Direction - Between the Jira and Azure fields is the Direction icon .
    Synchronization can be:

    • Both directions - synchronize data in both directions. Synchronizing in both directions is often used when an organization maintains projects in both Jira and Azure and wants to keep both of them up-to-date.

    • Jira To Azure - synchronize data in a single direction, from Jira to Azure. This is often used to migrate your content from a Jira project to an Azure project.

    • Azure to Jira - synchronize in a single direction, from Azure to Jira. This is often used to migrate your content from an Azure project to a Jira project.

Click the Direction icon and select a synchronization direction from the list.

Projects

Once connections to your Jira and DevOps instances have been established, you can select the Jira and Azure DevOps projects you want to synchronize.

If you want to create a new project or make changes to an existing project, select Manage projects from the Jira or Azure fields to go to that platform.

  1. Click in the Jira field and select a project from the list.

  2. Click in the Azure field and select a project from the list.

You cannot select an Azure DevOps project unless valid Azure connection has been selected.

Synchronize

Jira and Azure DevOps work items can contain comments and attachments.

Work item comments can provide additional information necessary for successfully completing the task presented in the item.

Attachments can be a file like an image or pdf.

TFS4JIRA gives you the option of including or excluding these comments and attachments from your synchronization.

  1. Select the Comments and Attachments options to include or exclude comments or attachments associated with any Jira or Azure items from the synchronization.

  2. Click Save and continue to move to Item types.