Exporting checklist data for a Cloud Import

You need administrator rights in Jira to perform the tasks on this page.

As of March 2022, the preferred approach to import to Cloud is to use Issue Checklist Pro. Please read https://okapya.atlassian.net/wiki/spaces/CHKCDOC/pages/1333264385 before continuing.

Checklist offers a migration path for users who want to move from a Server instance to a Cloud instance.

Each Checklist custom field context must be exported separately and must be imported in the Cloud version.

Before you begin

  • Ensure that you have the latest version of Checklist installed or at least version 5.2.4, which contains numerous bug fixes and improvements.

  • Read https://herocoders.atlassian.net/wiki/spaces/CD/pages/3260416392/App+Comparison, as migrating to Cloud comes with a number of limitations that you should be aware of before proceeding.

  • For each Checklist custom field context that you want to transfer, if the context is marked “All Projects”, check whether it really is required for all projects or not. Custom fields will often have an All Projects context that only ends up applying to certain projects due to the screens on which it can appear. The issues in which the custom field does not appear will still save global items to the database, which can lead to a lot of useless data that will take time to transfer to the Cloud. By limiting the custom field context to specific projects, this extra data will not be transferred, resulting in a smoother import process.

  • If you are doing a step-by-step migration, you can select only the projects that you want to export. This will not only minimize the data to import, but also prevent errors that would occur if you exported data from projects that have not yet been migrated to Cloud. This only applies if your custom field context already has projects; if it’s set to “All Projects”, a partial migration is not recommended. Note that there are limitations with doing partial migrations, and you should read https://okapya.atlassian.net/wiki/spaces/CHKCDOC/pages/1333264385 first.

Exporting a custom field context from Server

Before Checklist v6.2.0, this feature was disabled by default and had to be enabled before you could proceed with exporting your data. In case you still have a version prior to 6.2.0 installed, you will find the procedure to enable the export feature below. If you have version 6.2.0 or later installed, you can skip to Exporting a custom field context.

Enabling the Checklist Export Feature Action module

required before 6.2.0

  • Go to Administration > Manage apps.

     

  • In the sidebar, go to Atlassian Marketplace > Manage apps.

     

  • Click on Checklist to expand the app details.

     

  • Click on [X] of [X] modules enabled to see all the enabled modules (these numbers will be different for everyone).

    Locate the Checklist Export Feature Action module, hover over Disabled, and click the Enable button that appears.

Exporting a custom field context

Each custom field context must be exported separately.

  1. Go to Administration > Issues.

     

  2. In the sidebar, go to Fields > Custom fields.

     

  3. In the Actions column, click the menu icon for a specific Checklist custom field and click Configure.

     

  4. Scroll to the context you wish to export and click Export.

     

  5. The Checklist Export page that appears will display the destination path and file name of the exported files. To begin the process, click Export. You can also select specific projects to export in case you want to perform a partial migration.

  6. Once the export is complete, a success message will be displayed.


SERVER documentation (On Cloud? Go here.)
Have questions? Contact our Service Desk for help anytime.