Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Importing Checklists Between Jira Cloud Instances

...

Note

Templates
Templates are not migrated in the process described here and will have to be added manually. If you have a large number of templates and are performing a single Jira-Jira migration (so project IDs did not change), please contact us for assistance. 

Note

Merging Multiple Jira Instances
Merging multiple Jira Cloud instances is often performed by temporarily moving all issues to a server instance, in which case all issue IDs will be changed. Follow the process below to ensure that checklist data is preserved/merged into the new destination instance.

Source Jira Cloud Instance

  1. Enable the Save checklist data to Jira custom fields global setting. This will ensure that all checklist data will be stored in Jira custom fields and migrated automatically with the other Jira data. Note that the initial save might require a few hours if the setting was previously disabled.

  2. Export the issues from Jira

...

  1. to a CSV file using the Backup Jiramethod. Checklist data will be preserved in the Checklist Text field.

Target Jira Cloud Instance

  1. Install Issue Checklist if it is not already installed.

  2. Ensure that the Save checklist data to Jira custom fields global setting is enabled.

  3. Find and note the custom field ID of the Checklist Text field.

  4. Import the Jira data using the External System Import wizard. This will create checklist custom fields. On the Fields page, select Checklist Text as the corresponding Jira Field for the Checklist Text field in the CSV file, but leave the Map field value checkbox unchecked. This will ensure that to the field values are imported exactly as stored in CSV file.

    Image Modified

  5. The Checklist Text field will now be populated with data from the import. However, an automation rule needs to be run in order to re-sync the Checklist Text field with the UI. Go to Project Settings > Automation and click Create rule.

  6. Create an automation rule:

    1. Trigger: Select Scheduled.(The scheduled time does not matter – the rule will be manually ran once and then disabled.) Check the Run a JQL search and execute actions for each issue in the query checkbox and enter an expression that returns the imported issues (ex: project = AK AND key > AK-10 AND key < AK-24 ).

    2. Action Edit issues, select Checklist Text as the field to be updated and enter (where 10039 is the custom field ID of the Checklist Text field.

      Code Block
      {{issue.customfield_10039}}
      ---
    3. Save and Run the rule.

    4. After confirming that the issues were updated, disable the rule.