Getint: Where every ticket finds it's place.
Support portalCase studiesSchedule a demo
  • Welcome to the Getint Documentation Hub
  • Getting started with Getint
    • About Getint / Concepts
      • How Getint works (how it syncs the data)
      • Onboarding
      • What is a Connection?
      • What Are Runs
      • One-directional / Bi-directional integration
      • Migration vs Integration
      • How Integrations Are Executed By Getint
    • Starting the Free Trial and Accessing the Getint App
      • Selecting the Correct app per license
      • How do I extend the trial of getint.io?
      • Jira Access and User Management
    • Deployment options
      • Getint for Jira Data Center / Jira Server
        • Getint Jira Server / Jira Data Center App (native)
        • Getint for Jira Data Center / Jira Server - Architecture
      • Getint for Jira Cloud
      • Getint On-Premise
        • Architecture
        • Installation
          • How to Install Getint On-Premise in Windows Server
          • On-Premise/Standalone Guide
        • Updating On-Premise
        • Cluster High Availability
    • Prepare for the integration
      • Understanding the difference between platforms you integrate
      • One-to-One, One-to-Many, and Many-to-Many integration
      • Simplifying Workflow Sync with Getint: Jira
    • Connectors
      • Jira
      • Asana
      • Azure DevOps
      • Freshdesk
      • GitLab
      • HubSpot
      • Monday.com
      • Notion
      • Salesforce
      • ServiceNow
      • Zendesk
  • Guides
    • Quickstart
      • Integration
      • Connection
    • Integration Guides
      • How to Map Fields
      • How to create a custom field in all supported software
      • Git Repository integration
        • Git Connector - Azure DevOps
        • Git Connector - GitHub
        • Git Connector - GitLab
      • Azure DevOps Asana integration
      • Jira Airtable integration
      • Jira Asana integration
        • Jira - Asana: Subtasks synchronization
      • Jira Azure DevOps integration
        • How to Setup a Connection with Azure DevOps On-Premise
        • Jira - Azure DevOps: Epics and Subtasks Synchronization
        • Syncing Dependencies between Jira and Azure DevOps using Getint
      • Jira ClickUp integration
      • Jira Freshdesk integration
      • Jira Freshservice integration
      • Jira GitHub integration
      • Jira GitLab integration
        • Attachments Sync in GitLab Integration
      • Jira HubSpot integration
      • Jira Jira integration
        • Jira Jira licensing
        • Time Tracking in Getint – One-Way Synchronization
      • Jira Monday.com integration
        • Synchronizing Attachments in a Monday.com Integration
        • How to Insert Monday.com Items into Specific Groups Using Getint
      • Jira Notion integration
      • Jira Salesforce integration
        • Salesforce OAuth Authentication
      • Jira ServiceNow integration
        • Creating a ServiceNow User for Getint Integration
        • ServiceNow OAuth authentication
        • Creating a Custom Field in ServiceNow
        • How to Restrict "Incident" Data to Specific 3rd Party Companies
        • How to Restrict Access to Specific Tables for Integration
        • REST API requests list
      • Jira Trello integration
      • Jira Wrike integration
      • Jira Zendesk integration
        • How to Manually Provide Zendesk Organization ID and Name
    • Migration Guides
      • Migrating Data with Getint
      • Migration support, and onboarding
      • Jira to Jira migration
      • Asana to Jira migration
      • Azure DevOps to Jira migration
      • GitLab to Jira migration
      • Jira to Monday.com Migration
      • Jira Zendesk migration
  • Using Getint
    • Core Features of Getint
    • Workflows
      • Type Mapping
      • Integrations List
      • Configuring Your Data Sync: Bidirectional and Unidirectional Options
      • Syncing Attachments
      • Hierarchy
      • Assignees (users) mapping
      • Mapping Labels
      • Filtering Items for Integration in Getint
        • Troubleshooting Sync Issues: Unmet Filter Conditions
        • How to Filter Comments
        • Filtering by Assignment Group and Status
      • Shared Mappings in Getint – Centralized Mapping for Efficient Integrations
      • How to Use JQL Filters for Jira Integrations
      • Integration status
      • Storing counterpart link in the task comment
      • Storing Reference IDs/URLs Across Integrations
    • Connections
      • Troubleshooting Getint Integration Connectivity Issues
      • Permissions Issue: Status Code 500
      • Editing Connections for Existing Integrations
      • Changing the URL or Transitioning Between Instances
      • Debugging Connections in Getint: How to Troubleshoot and Resolve Issues
    • Quick Build
    • Reporting
    • Notifications
    • Request type issue on Jira Service Management how to select and work with it
    • Integrating one project with many: Streamlining synchronization across multiple projects.
      • One to Many Project - El Ride Use Case
    • Transition Fields
    • Resync and Hard Resync
    • Synchronizing Existing Items on Both Sides
    • Handling Syncs for Deleted Items
    • Advanced Scripting
    • Platform Release History
      • Getint Version 1.79
      • Getint Version 1.78
      • Getint Version 1.77
      • Getint Version 1.76
      • Getint Version 1.75
    • Settings
      • Data Storage
      • Sharing Access Permission
      • How to Override Getint Behavior Using Custom Properties
  • Support, legal & others
    • FAQ
      • Technical FAQ
      • Security FAQ
    • Troubleshooting Guide for Getint Users
      • Resolving Error 500 in Jira ServiceNow Integration
      • Locating Your Instance ID for Support
      • Connection Error: Certification Path Failed/PKIX Path Building Failed
      • Error: Field '<field-name>' cannot be set. It is not on the appropriate screen, or unknown
      • Connection timed out error
      • Troubleshooting: Integration Task Retrieval Error
      • Upgrade to newest version from version lower than 1.52
      • Debug Requests Feature
      • Troubleshooting: Resolving Hanging Integration Runs in Getint
      • Troubleshooting License Issues in Getint
    • Security and compliance
    • Support / SLA
    • Privacy & Security
      • Data Residency with Getint
    • Procurement & Legal
      • Enhanced Support for Vendor Onboarding and Security Assessments
      • EULA
      • Privacy policy
  • Billing & Services
    • Transparent and User-Friendly Pricing
    • Consulting and Custom Development
    • Understanding Getint Licensing and Pricing
      • How to pay for the apps
      • Migrations
      • Network License
      • Jira-Jira Licensing Model
      • Partners
      • Seamless Transition Offer: Migrate from Competitors to Getint with Exclusive Benefits
  • Use cases
  • Pricing Comparison: Getint vs. Alternatives
  • Battlecards (getint.io vs competitors)
  • Free migration from ConnectAll, Backbone, Exalate, Unito, Workato, TFS4JIRA and other tools
  • Anything missing? Getint is feedback driven
Powered by GitBook
On this page

Was this helpful?

  1. Guides
  2. Integration Guides

How to Map Fields

PreviousIntegration GuidesNextHow to create a custom field in all supported software

Last updated 2 months ago

Was this helpful?

Improve Your Workflow with Precise Field Mappings

Unlock the full potential of integrating work items like tasks, bugs, service requests, and incidents across different platforms with our new Getint Field Mappings feature. This tool is designed to fit your workflow perfectly, making it easier to keep everything in sync. Let's dive into what this feature offers.

Understanding Field Mappings

Field mapping is all about linking important details of your projects, like titles, descriptions, who's in charge, and any attachments, across different tools. Our platform ensures these details match up between all sorts of work items—whether they're tickets, incidents, service requests, bugs, or contacts. This keeps your data in sync almost in real-time.

Here's how you can see this in action on our platform:

Starting with Manual Field Mapping

If you're missing a key piece in your mapping, the + Add field mapping button is there to help you find the right match.

Let’s say you're linking the Assignee field in Jira with the Assigned to field in Azure DevOps. Here's how easy it is:

  1. Begin by selecting Jira.

  1. Choose the Jira field you wish to integrate—Assignee.

  1. Then, select Azure DevOps as the second application, choose the Assigned to field, and click the Add button.

Removing a Field Mapping

To remove a field mapping that's not working for you, just hover over it and click the delete icon. This won’t delete or modify any of your data.

Changing How Data Moves

With Getint, data usually moves back and forth between tools by default. But you can adjust this any way you like. Want to send data only one way? Just click on the arrows to set it up.

Handling Dropdown Fields

You'll see a warning icon for fields like Assignee, Priority, or Status if they need more detail. Hit the cog icon for more options.

  • Map options directly: Link specific options from one field to another, like matching Jack Smith in Jira to Jack Smith in DevOps.

  • Use default mapping: This is great for sending dropdown info to a text field without needing a detailed map. It just turns the dropdown choice into text.

Concatenating Fields

Starting from version 1.75, Getint will now allow the synchronization of multiple fields into a text-based field like the Description or the Title. This will be possible by clicking the Merge fields checkbox above the field mappings.

How to Merge Fields:

  1. Select the side that you want to integrate and tick the merge fields checkbox.

  1. Now, integrate fields into the text-based fields. Click the +Merge here option to integrate your selected field.

In this case, we'll merge the Assignee and Priority fields with the Title (Jira) and the URL field with the Description field. This means that every time a ticket is created or updated, it will transfer the Title from the issue and include the current Assignee and Priority. Additionally, we're merging the Description with the URL, which will bring the URL from the task to the other side of the integration. However, some fields, like the URL from the task, only sync when the item is created, as this is the only time the URL field is triggered for synchronization. We're using a Jira Azure DevOps integration as an example, but this applies to other integrations as well.

Merging fields operate unidirectionally, meaning synchronization occurs from only one side. Consequently, the Title on the opposite side cannot be synced with other fields simultaneously.

  1. You can make different combinations as long as you don’t surpass the character limit for the text field on the other side.

Certain fields, like URL or ID, only sync during creation, as this is the only time when these fields are triggered for synchronization. As a result, updating existing items will not transfer the URL of the issue to the corresponding field you are syncing with.

  1. Click Apply and Save your integration.

Mapping Special Fields

Conclusion

As we've demonstrated, integrating fields in a unidirectional manner allows for smooth and consistent updates. However, it's important to note that certain fields, like URL or ID, only sync during creation, emphasizing the need for careful planning and implementation.

We hope this article has provided valuable insights into the steps of merging and mapping fields. If you have any questions or require further assistance, please do not hesitate to reach out to us. Our team is always ready to help you achieve a more efficient and effective data management system.

Some fields, like the URL or ID, can't be changed directly. To map these, you might need to create a special field on the other side first. Then, you can link them up. Read more in the following article:

Storing Reference IDs/URLs Across Integrations.
We’re using Jira DevOps as an example, but these steps apply to all of our connectors.
Start your integration journey. Schedule a free consultation with our Getint Integration Expert today!