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.80
      • Getint Version 1.79
      • Getint Version 1.78
      • Getint Version 1.77
      • Getint Version 1.76
      • Getint Version 1.75
      • Getint Version 1.74
    • 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
  • Supported Fields for Shared Mappings
  • What Are Shared Mappings?
  • How Shared Mappings Work

Was this helpful?

  1. Using Getint
  2. Workflows

Shared Mappings in Getint – Centralized Mapping for Efficient Integrations

In Getint, shared mappings offer a powerful and efficient way to streamline the integration process, especially when managing users, sprints, and other fields across multiple integrations. Shared mappings allow you to define and manage mappings in one central location and reuse them across various integrations. This approach simplifies the synchronization of frequently used fields, making your integration process more efficient and scalable.

This guide will explain how shared mappings work, how to configure them, and the benefits and limitations of using shared mappings, particularly in Jira to Azure DevOps integrations. We’ll also provide a table of supported fields and how to manage potential errors and considerations when working with shared mappings across different projects.


Supported Fields for Shared Mappings

Field

Jira

Azure DevOps

Assignee

Supported

Supported

Sprint

Supported

Not Applicable

Fix Version

Supported

Not Applicable

Iteration Path

Not Applicable

Supported

Custom Dropdowns

Not Applicable

Supported

At present, only the fields listed above support shared mappings in Getint. This means that for these fields, you can create centralized mappings that can be reused across multiple integrations.


What Are Shared Mappings?

Shared mappings are reusable mappings that allow you to centralize the configuration of certain fields—such as assignees, sprints, and iteration paths—across multiple integrations. Instead of configuring the same field mappings for every integration individually, you can create a shared mapping once and apply it across multiple integrations.

Shared mappings are particularly useful when:

  • You have multiple integrations involving the same users, teams, or project structures.

  • You want to ensure consistency across different projects by reusing the same mappings for fields like Assignees, Sprints, and Iteration Paths.

  • It is necessary to manage field mappings efficiently across large projects with many integrations.


How Shared Mappings Work

1. Creating Shared Mappings:

  • When setting up your integration, you can configure fields manually or convert them to shared mappings. For example, when mapping Assignees between Jira and Azure DevOps, you can create a shared mapping to handle this centrally.

  • Navigate to the field you want to map (e.g., Assignees, Sprints, or Iteration Paths) and select the Shared Mapping option:

  • Name the shared mapping and click Create:

  • The shared mapping will now appear as a centrally managed resource for that field, which you can edit or convert back to standard mapping if needed.

  • To edit or add new assignees, you may either select the option to Edit Shared Mappings or go to Workflows → Shared Mappings in the menu tab to access the mappings:

2. Reusing Shared Mappings:

  • Once a shared mapping is created, it can be reused across multiple integrations. For instance, if you have mapped an assignee from Jira to Azure DevOps, that shared mapping can be applied to other integrations using the same users.

  • To do that, go to the integration, select the field, in this case Assignee, and click on Convert to shared mapping. Using the dropdown menu, select the already created Shared Mapping and click on Done. Apply and save the integration.

  • As soon as shared mappings are applied and saved, any changes made to the mapping will automatically propagate across all integrations using that shared mapping. This makes it easy to manage changes centrally without the need to update each integration individually.

  • Example – Mapping Sprints and Iteration Paths:

Consider a scenario where you're mapping Sprints in Jira to Iteration Paths in Azure DevOps. You can create a shared mapping between these fields, but it will only apply to integrations where you've specifically converted the field mappings to shared mappings and chosen that particular shared mapping from the list. This means the shared mapping won't automatically apply to all integrations involving sprints and iteration paths—only to those where it has been manually selected and reused.

When new sprints or iteration paths are added, the shared mapping will update centrally, ensuring that all integrations using the shared mapping are updated automatically.

  • Handling Assignees:

Similarly, you can map Assignees across different integrations. By using shared mappings for assignees, you can easily manage user assignments across projects. If a new user joins the team, you can update the shared mapping in one place, and it will be reflected in all integrations using that mapping.


Key Benefits of Shared Mappings

  • Centralized Management: Instead of configuring mappings for every individual integration, shared mappings allow you to manage your field mappings from one central location.

  • Efficiency: Shared mappings save time by eliminating the need to repeat the same configurations for each integration.

  • Consistency: By using shared mappings, you ensure consistency across all integrations, especially when dealing with fields like Sprints, Assignees, or Priorities.

  • Scalability: As your integrations grow, shared mappings enable you to scale efficiently by managing field mappings globally.


Potential Limitations and Considerations

  • Field Availability Across Projects:

    • If the mapped option (e.g., a sprint or user) is not available in the other system or project, the integration will throw an error. To avoid this, ensure that the required options exist in both systems before setting up shared mappings.

  • Project-Specific Fields:

    • Some fields, such as Sprints and Iteration Paths, are project-specific and may not work well with shared mappings if the same projects are not part of multiple integrations. For example, if a sprint exists in one project but not in another, reusing the shared mapping could cause conflicts.

    • You need to carefully manage which shared mappings are applied to which projects, particularly when fields are specific to individual projects.

  • Error Handling:

    • If an option mapped in the shared mapping does not exist in the target project (e.g., a user or sprint), the integration will fail, and an error will be logged. It is important to monitor these errors and make adjustments as needed.

    • For example, if you map an assignee that doesn't exist in Azure DevOps, the system will return an error, and you may need to create the missing user in the target system.


Important Notes

  • Auto-Propagation: Any updates to a shared mapping will automatically be reflected across all integrations that use that shared mapping. For example, if a new user is added, all integrations using the shared mapping for assignees will automatically update with the new user.

  • Global Access: Shared mappings are controlled globally, but only users with access to the connections involved can modify them. If a user doesn’t have access to the connection, they won’t be able to update or use the shared mapping.

  • Field-Specific Mapping: Not all fields are suitable for shared mappings. Fields like Sprints and Iteration Paths may be project-specific, whereas Assignees can typically be managed globally across projects.


Conclusion

Shared mappings are a powerful feature within Getint, designed to streamline the integration process and improve efficiency across multiple integrations. By centralizing the mapping of frequently used fields like Assignees or Sprints, you save time and maintain consistency across your integrations.

However, it’s essential to be mindful of the potential limitations, especially when working with project-specific fields. Always ensure that the mapped options exist on both sides of the integration to avoid errors during synchronization.

PreviousFiltering by Assignment Group and StatusNextHow to Use JQL Filters for Jira Integrations

Last updated 7 months ago

Was this helpful?

For further assistance on using shared mappings or resolving issues, please visit our .

Help Center