Type Mapping

Work Item Type Mapping in Getint

When setting up your integration, you must define the synchronization logic between work item types. Since platforms like Jira, Azure DevOps, and ServiceNow use different structures, Getint allows you to map these types specifically.

Key Features

• Directional Logic: Specify which item type to create based on the source (for example, a Jira Task creating an Azure DevOps Bug).
• Mapping Flexibility: Configure individual mappings to handle corner cases, ensuring the same work item type can sync differently depending on the source.
• Workflow Consistency: Manage unique fields and status transitions for each type to maintain data integrity across systems.

Example of type mapping, where Jira has Task mapped twice to cover specific corner cases.

Type Mapping Configurations

For every Type Mapping you can configure:

1. Fields

• Map fields 1 to 1 from both mapped work item types. If one of your work item types has specific fields that are not shared across the other work item types, you can map a fixed value to these fields, or create a custom field counterpart on the other software to track this field data accordingly.

Left-hand side fields are from Jira, right-hand side fields are from Azure DevOps.

2. Status Transition

• If one of your work item types has a specific status transition, you can map transition fields for that specific work item mapping so that the status is synchronized accordingly. One example where status transition mapping may take place is when you have transition fields for your Jira status workflow:

In the above example, updating a Jira task status from In Progress to Done will trigger a transition screen, where specific information must be filled before actually updating the status.

• Status transition for type mapping can be configured on the STATUS tab:

• To make sure that status can be synced, please map available status options between both apps (each app can use different statuses, and that's why Getint requires mapped options to know what status to set when syncing an item to the other app):

• Once you map status options together, they will appear on a list.
• You can click the trash icon to delete a mapping or the cog icon to configure transition fields:

We have an in-depth guide about transition fields and how to fully configure them here: Transition Fields | Getint: Where every ticket finds it's place.

3. Comments

• You can configure the synchronization logic of each mapped work item type through the Comments & Attachments tab (depending on the connector, it might be displayed only as Comments if attachments aren't supported):

Comments synchronization settings for Task to Task type mapping.

4. Attachments

• If supported by your connector, you can also configure the synchronization logic for attachments of your mapped work item types through the Comments & Attachments tab:

Scroll down the "Comments & Attachments“ screen to visualize the Synchronize Attachments setting.

• You can then configure the Comments synchronization settings for that specific item type mapping:

5. Hierarchy

This feature is available for mostly all type mappings when building an integration. However, it is important to note that not all apps support hierarchy in the same way as Jira, Asana, Monday, or Azure DevOps, to name a few.

At its core, it revolves around different types of issues, such as:

• Epics: Represent high-level initiatives or large work items.
• Stories/Tasks: Individual units of work that contribute to an epic.
• Subtasks: Manageable tasks required to complete a story.

For example, this would be the standard hierarchy levels in a Jira to Jira integration.

To enable Hierarchy settings for your mapped work item types, go to your integration and open the corresponding type mapping. For stories/tasks/bugs that you would like to sync the Epic link, you’ll need to go to Hierarchy > enable Synchronize Epic relationship > display the dropdown and select the Parent Link (NextGen projects).

For subtasks, open the corresponding type mapping > enable the Synchronize Subtasks relationship > display the dropdown, and select the Parent Link.

We have an in-depth guide about Hierarchy settings and configuration here: Hierarchy | Getint: Where every ticket finds it's place.

If you require additional assistance, don't hesitate to get in touch with our support team at our Help Center.

Start your integration journey. Schedule a free consultation with our Getint Integration Expert today!