Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Align
aligncenter


Auiprogress
step3

Auiprogressstepstatic
titlePlan Out Your Migration
urlStep 1 - Plan Out Your Migration

Auiprogressstepstatic
titleExporting Data from the Classic Connector
urlStep 2 - Exporting Data from the Classic Connector

Auiprogressstepstatic
titleImporting to the New Connector
urlStep 3 - Importing to the New Connector

Auiprogressstepstatic
titleConfiguring Salesforce
urlStep 4 - Configuring Salesforce

Auiprogressstepstatic
titleCompleting the Setup
urlStep 5 - Completing the Setup


In this step, you will import the zip file created into the new Connector. This is potentially the most time-consuming step in the series.

...

At the end of this step, you will have:

  • Imported an export zipped file into the new Salesforce & JIRA Cloud Connector.

  • Migrated the data from the Classic Connector to the New Connector. This includes connections, mappings and mapping schemes (into bindings and mappings), field mappings and field value mappings.

Prerequisites

  • You have completed Step 2 - Exporting Data from the Classic Connector.

  • You have administrator access to JIRA Cloud.

  • You have administrator access to Salesforce.

  • You have the new Salesforce & JIRA Cloud Connector installed. If your Classic Connector license has been migrated, the New Connector should have already been automatically installed. Otherwise, please install from the Atlassian Marketplace.

Guide

  1. Log in to JIRA Cloud.

  2. From the

...

  1. gear icon ⚙, select Add-ons.

  2. In the sidebar, under Salesforce, select Migration.

    Image Modified

...

  1. If you do not see the Migration menu, enter the following URL in your web browser:

Code Block
https://<your-jira-cloud-name>.atlassian.net/plugins/servlet/ac/com.servicerocket.jira.salesforce/migration
  1. If you are not new to the new Connector (i.e. already have test data or configuration) it is necessary to reset the new Connector and start from scratch.
    This step is optional but is necessary if you already have existing data in the New Connector.

  2. It's time to import the zip file.
    Click the Browse button, specify the zip file and click Upload.

...

  1. Image Added
  2. The migrator will then start importing your zip file.
    Click the refresh icon to fetch the latest status.

...

  1. Image Added


    Note that it may take a few seconds (or up to a few minutes, depending on the size of your instance) to complete. 

  2. Once the migration has completed, you will be required to authorize the imported connection(s).
    In the sidebar, under Salesforce, click on Connections.

  3. Select the connections you want to authorize then click on Authorize.

  4. You will be asked to Import Compact Layouts.
    You may proceed by doing it now or saving it for later.

  5. When your Connection configuration has been updated successfully, return to the Migration screen.
    In the sidebar, under Salesforce, click on Migration.

  6. Click on the newly appeared Import Connections Configuration button.

...

  1. Image Added
  2. And then you can also choose to Import Bindings.

...

  1. Image Added
  2. If you choose to Import Bindings, you will be asked to choose between inbound and outbound value mappings.

...

  1. Image Added

  2. After you have imported your bindings, you now have the option to Import Associations.
    But before proceeding, ensure you have Edit Issues permission for all issues in projects that were using the old Classic Connector.
    If so, click Import Associations and continue.

...

  1. Image Added
  2.  After Associations have been imported successfully, your migration will be complete.

...

  1. Image Added

Testing the configuration

At this point, you might want to try Associating a Salesforce Object from Jira.

...