Resolve configuration duplication in Jira migrations

Jira データを Data Center から Cloud に段階的に移行する場合や、複数の Jira インスタンスを統合する場合、同じ設定が複数の場所に存在することがあります。たとえば、移行のあるフェーズで「Customer ID」カスタム フィールドを移行したとします。その後、別のフェーズで再び「Customer ID」を移行すると、移行先の Cloud サイトに「Customer ID」カスタム フィールドの重複が発生する可能性があります。

While migrating with Jira Cloud Migration Assistant, it currently creates new copies in your cloud site with suffixes such as “Customer ID(migrated)”, “Customer ID(migrated 1)”, “Customer ID(migrated 2)”, and so on. This can lead to a large number of duplicate configurations and increase the manual cleanup load after migration. Read how Jira Cloud Migration Assistant links your data

改良された Jira Cloud Migration Assistant の移行前チェックでは、移行前に重複の可能性を事前に特定し、重複による競合を解決するための体系的な方法を提供します。

機能の仕組み

移行前チェックの一環として、段階的な移行中に重複してしまう構成が検出されます。これには以下が含まれます。

• カスタム フィールド

• カスタム フィールド スキーム

• カスタム フィールド オプション

• FieldLayout

• FieldLayoutScheme

• 課題タイプ スキーム (Cloud では作業タイプ スキーム)

• 課題タイプ (Cloud では作業タイプ)

• Issue status (Status in Cloud)

• 画面

• 課題タイプ画面スキーム (Cloud では作業タイプ画面スキーム)

• Project roles (Space roles in Cloud)

• 画面スキーム

• ワークフロー

• ワークフロースキーム

この機能により、可能な場合は構成の競合が自動的に解決されます。安全に解決できない競合については、顧客にオプションの選択を求めます。

次の 4 つのアクションのいずれかで解決できます。

• 移行先の構成を使用する

• 移行元の構成で上書きする

• 構成をマージする

• 新しい構成を作成する

はじめる前に

移行前チェックを実行する前に、以下を行う必要があります。

1. Understand what the Jira Cloud Migration Assistant is and how your data is migrated.

2. Install or update the migration assistant.

3. Complete the mandatory tasks in the pre-migration checklist.

4. 移行に向けてアプリとユーザーを評価する。

   • 移行に向けたアプリの評価方法を確認

   • ユーザーを評価して移行に備える方法を確認

構成の重複を解決する手順

Step 1: Find the Update rules for configuration entities card

1. Follow the steps to create a migration plan. Select the projects, boards, filters, users, and groups you wish to move.

2. [Save and run pre-migration checks (保存して移行前チェックを実行)] を選択します。

3. During pre-migration checks, look for the Update rules for configuration entities card. Select Download CSV file.

4. You’ll see the available options for each configuration. Edit the CSV file as required. Select Upload CSV file to upload the edited CSV file back.

Step 2: Run a check on the uploaded CSV

1. Select Run check to validate the changes.

2. If the check fails, download the CSV file containing errors and try to resolve the errors that you see. Select Run check again. Contact support if the check continues to fail.
   Select Upload CSV file to upload the edited CSV file back.

Step 3: Download the Effective configuration CSV

1. Once the check is complete, download the Effective configuration CSV to review the configurations that were automatically resolved. Read how the configurations are determined

   1. Refer to the selected_choice column to validate the auto-selected choice for each entity, and the Notes column for additional information about the entity.

   2. このファイルは参照用です。変更やアップロードは行わないでください。

Step 4: Download the Conflicted configuration entities CSV

1. Download the Conflicted configuration entities CSV to view entities that require you to manually select the required configurations.

   1. CSV の各行には、エンティティ タイプ、その移行元と移行先、および利用可能な構成の選択肢に関する情報が含まれています。

   2. The Choices column contains information in the format: 

      choiceId|remediationStrategy|name|databaseId|availableWhenconditions

   3. Copy the choice ID of your selection from the Choice column and paste it in the Customer_selected_choice_id column.

   4. We recommend that you use the CSV utility tool to make your selections. Install the tool by selecting Download the JAR above the Effective configuration CSV section. See how to use the CSV tool

2. Select Upload CSV file to upload the edited CSV file back, and the system will validate your choices.

3. Once you’ve reviewed and fixed the remaining pre-migration checks, select Review migration.

   Follow the usual steps to complete your migration. Read how to review your migration

Use the CSV utility tool

The CSV utility tool is helpful in making edits in bulk in the CSV.

To use the tool:

1. Upload the Conflicted configuration entities CSV in the Upload CSV file section.

2. Optionally, you can also upload:

   1. A Conflicted configuration entities CSV from a previous migration or test migration in the Reuse Reference CSV section in order to reuse choices from that CSV instead of manually making choices.

   2. A read-only Effective configuration CSV in the Effective configuration CSV section to see the entities that have been auto-resolved.

3. Select Upload and continue.

4. Select the Auto-resolved tab to see entities that will be automatically resolved. Information from the uploaded Effective configuration CSV will be shown here. No action is required here.

5. The Your Decisions tab will show you entities that require action. Choices from the previous migration/test migration CSV will be auto-filled. Check and select the required entities from the dropdown in the Choices column.

6. Select Save all choices to save your selections.

• Select Download CSV to download the updated CSV file.

You can upload this CSV back into the Pre-migration checks screen and proceed with your migration.