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.
| Info |
|---|
General Settings must be completed before completing the other synchronization profile steps. |
| Info |
|---|
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.
Click in the Jira field and select a project from the list.
Click in the Azure field and select a project from the list.
| Info |
|---|
You cannot select a project unless a 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.
| Info |
|---|
The Comments and Attachment options are selected by default. |
| Info |
|---|
Make sure that:
|
Select the Comments and Attachments options to include or exclude comments or attachments associated with any Jira or Azure items from the synchronization.
Click Save and continue to move to Item types.
Contents
|