Transformations

Owned by Julver Petrova
Last updated: Mar 01, 2024
2 min read

Get started with configuration transformations

We’ve built yet another powerful feature into the Cloud Migration Tool - transformations. It's a set of actions designed to fix errors, resolve conflicts, and refine configurations before migrating from Jira Server to Cloud.

With the transformations, you can make changes to how projects, configuration elements, and users from the migration scope will be migrated. No need to leave the migration wizard. The feature eliminates the need for complex navigations to tune and fix Jira Server/Data Center instances and Jira Cloud sites.

The transformations' feature set includes:

  • Inline transformations - an easy way to update project names and keys and rename other specific configuration elements with just a few clicks in the migration wizard. This way, the configurations will be created as new ones or will be mapped to chosen elements on the destination. Learn more about the inline configuration transformations.

  • Downloading configuration mapping - downloading a file holding JSON records for all configuration elements in the migration scope, their details, and the way they’ll be migrated. The file specifies whether configuration elements, including projects and users, will be newly created or mapped to existing destination elements. Learn more about downloading the configuration mapping.

  • Customizing configuration mapping - applying transformations from a JSON file to the migrated configurations. These transformations can come in the form of renaming and remapping configuration elements or changing project keys. Also, you can apply transformations to multiple configuration elements simultaneously. Learn more about customizing the configuration mapping.

  • User transformations - applying transformations from a JSON file to the migrated users. This way, you can merge users, correct emails and names, and choose different mapping between source and destination users. Learn more about user transformations.

  • Context transformations - applying transformations from a JSON file to the custom field contexts being migrated. With that capability, you can correct custom field problems and optimize their contexts on the destination. Learn more about the context transformations.

We’ve developed a group of documents to allow you to easily learn these features and utilize them in your daily migration routines: