This site is moving soon to become part of an integrated Appfire documentation and information site for our apps. This site will remain available during the transition to our new and improved site. Once this site is moved over, this banner will be updated with the new site link for easy access.
How can Jira apps integrate with Configuration Manager?
The various apps which augment Jira's functionalities can integrate with Configuration Manager for Jira. This type of integration ensures that the app configurations can be exported and imported automatically and seamlessly between two Jira instances (server or data center).
There are two types of app integrations:
Built-in integrations (shipped with Configuration Manager).
You can see the list of apps that have integration with Configuration Manager in our List of Integrated Apps document.
Configuration Manager for Jira has built-in support for some of the most widely used apps across the Jira ecosystem.
What does built-in support mean?
Apps may provide custom conditions, validators, or post functions. Each of those may reference other objects in Jira - custom fields, users, groups, statuses, etc. These references are persisted as properties, usually containing the id of the referenced object.
Configuration Manager for Jira exports references to such objects in an instance-independent manner, thus guaranteeing that the workflow will behave the same way when deployed in another Jira instance (even if the custom field does not exist at all).
Integrations supplied by vendors
Our team developed and provides additional integration points, which the rest of the app vendors can use to integrate with Configuration Manager. This way, they extend Configuration Manager to handle the entire configuration of the specific app.
If you need Configuration Manager to move the configuration of a specific app not currently integrated, please contact the app vendor with a request for integration.
A page called App Integrations shows the apps on your system which have integration with Configuration Manager and tracks their integration status. Learn more
There are several integration points provided by Configuration Manager through the Service Provider Interface that apps can implement: Custom field, Project, Workflow, Dashboard,Global Configuration, App Data, and Issue Data. These integration points allow Configuration Manager to migrate automatically any custom configuration provided by the app. Also, all references to other configuration elements within the app configuration will be correctly resolved even if identifiers are different between instances.
Specific custom field configurations provided by the app will be automatically migrated.
Specific attached to a project configuration provided by the app will be automatically migrated.
Custom conditions, validators, and post-functions, provided by the app will be automatically migrated.
Custom dashboard gadgets provided by the app will be automatically migrated.
If an app has integration with Configuration Manager using one or more of the integration points Custom field, Project, Workflow, and Dashboard, when you create a snapshot, the relevant configuration will be included automatically.
Configuration Manager will automatically migrate the global app configuration if you included the app in the snapshot. Learn more
If an app has integration with Configuration Manager using Global integration point, the global app configuration will be included on demand when you create configuration snapshots of your Jira.
Configuration Manager will automatically migrate the app data if you included the app in the snapshot. Learn more
If an app has integration with Configuration Manager using the App Data integration point, you will be able to include custom app data on demand when you create project snapshots.
When issues are moved from one Jira instance to another, Configuration Manager will automatically migrate additional issue data stored in the app if you’ve included this app in the snapshot. This SPI integration point helps with this process by allowing apps to migrate their data without compromising its integrity.
If an app has integration with Configuration Manager using the Issue Data integration point, the issue data stored in the app will be included in configuration snapshots of your Jira.