Item Types - Cloud Native

Owned by Jeff Gleeson
Last updated: Jan 09, 2024
2 min read

Item types overview

TFS4JIRA analyzes the item types currently defined in your Jira and Azure DevOps projects and provides a method to map Jira issue types to Azure DevOps work item types and vice versa. Once mapped, whenever TFS4JIRA detects a change to an item type on one platform, Jira and Azure synchronize, and that change is made to the mapped item type on the other platform. Therefore, it is essential to ensure all item types in Jira and Azure DevOps are correctly mapped.

Configure Item types

  1. Click the In Jira field and select an item type from the list, or enter the item type name and select it when it appears.

  2. Click the In Azure field and select the corresponding work item types from the list, or enter the work item type name and select it when it appears.
    TFS4JIRA can map item types automatically as default item types. When defined, the most common default item types are Task and Epic.

  3. Click Add mapping. Mapped item types are displayed in the Mapped item types list on this page.

  4. To change a mapped item type, locate the item type in the Mapped item types list, click on the Jira or Azure item type, and select another item type from the dropdown list.

  5. To remove a mapped item type, locate the item type in the Mapped item types list and click the Remove mapping icon.

Default values

Set how TFS4JIRA responds during synchronization when it encounters an unmapped item type.

  • Skip - When TFS4JIRA encounters an unmapped item type, it skips over it and continues to the next item type.

  • Raise Error - When TFS4JIRA encounters an unmapped item type, it is recognized as an error. You can review the error in the sync log.

  • Set Item - When TFS4JIRA encounters an unmapped item type, it maps it to a specific value. For example, if Task is selected, all unmapped item types are mapped as tasks.

  1. Click the Jira field and select Skip, Raise Error, or Set Item from the list of options. If you select Set Item, click the field below and select a value.

  2. Click the Azure field and select Skip, Raise Error, or Set Item from the list of options. If you select Set Item, click the field below and select a value.

Click Save and continue to move to Fields.