本番インスタンスにアップグレード前のアクティビティを実装する

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:10分
  • 本番インスタンスでアップグレードエクスペリエンスを正常に行うには、アップグレード前のタスクを完了します。

    始める前に

    注:
    ステップごとに、ステップをスキップするか、完了としてマークしてから次のガイド付きアップグレードステップに進むかを選択できます。

    必要なロール:admin

    手順

    1. アップグレード計画を選択します。
      アップグレード計画を選択するには、2 つのオプションがあります。
      • 既存のものを選択:更新セットをインポートして、アップグレードのアップグレード計画を適用または結合できます。このオプションがデフォルトで選択されています。
        既存のアップグレード計画を適用するには、次のオプションがあります。
        • 更新セットのインポート:既存のアップグレード計画を選択する前に、まず更新セットをインポートする必要があります。
          1. [ 更新セットをインポート ] を選択して、更新セットをインポートします。[更新セットを取得] リストが表示されます。
          2. [XML から更新セットをインポート] 関連リンクを選択して、インポートする更新セットを選択します。[XML のインポート] ページが表示されます。
          3. [ ファイルを選択 ] を選択し、[ アップロード] を使用して既存の更新セットを選択します。

            選択した更新セットが現在のアップグレード計画にアップロードされます。現在のアップグレード計画が [更新セットを取得] リストに表示されます。

          4. [更新セットを取得] リストから計画を選択します。[更新セットを取得] フォームに、関連するすべての顧客アップデートが表示されます。
          5. [更新セットのプレビュー] を選択します。[更新セットプレビュー] モーダルが表示されます。
          6. 更新セットのプレビューが正常に完了したら、[ 更新セットのコミット] を選択します。[更新セットのコミット] モーダルが表示されます。
            注:
            このオプションは、更新セットのプレビューが正常に完了した後にのみ表示されます。
        • 既存のアップグレード計画を選択:インポートされた計画を表示して選択することも、複数の計画を選択するか、それらを 1 つの計画に結合することもできます。
          注:
          このオプションにより、アップグレード計画のやり直しが大幅に削減され、精度が維持され、アップグレードプロセスがシームレスになります。

          [アップグレード計画を選択] を選択すると、次のモーダルが表示されます。その後、1 つまたは複数のアップグレード計画を選択して結合し、現在のアップグレードに適用することができます。

          注:
          [ 適用] オプションは、現在のアップグレードに適用するアップグレード計画を 1 つ選択した場合にのみ表示されます。

          注:
          [結合して適用] オプションは、複数のアップグレード計画を選択した場合にのみ表示されます。アップグレード計画の名前は、選択したアップグレード計画に応じて変更されます。

          複数のアップグレード計画を結合する場合、複数の計画に表示されるアップグレード計画アイテムは、結合された計画で最新バージョンで使用されます。これにより、一貫性が確保され、結果としてマージされた計画のバージョンの競合が回避されます。

      • 新規作成:インスタンスアップグレードの新しい計画の作成を開始できます。
        • アップグレード計画の作成:[ 計画の作成 ] を選択して、新しいアップグレード計画の作成を開始します。成功メッセージバナーから [アップグレード計画] リンクを選択して、作成されたアップグレード計画を表示します。
          注:
          成功メッセージバナーは、[ 計画を作成 ] を選択してアップグレード計画が作成された直後に生成され、ページが再ロードされるまで表示されたままになります。

          計画の作成後に [ 計画を作成 ] オプションを再度選択すると、次のメッセージが表示されます。

          注:
          アップグレード計画アイテムのない最新のアップグレード計画のみが保持されます。たとえば、最新のアップグレード計画がアップグレード計画アイテムなしで作成された場合、アップグレード計画アイテムも含まれていない以前のアップグレード計画が自動的に上書きされます。アップグレード計画アイテムには複数のアップグレード計画が存在する場合があります。
          [アップグレード計画] リストには、アップグレード計画アイテムを含む複数のアップグレード計画と、アップグレード計画アイテムのない最近のアップグレード計画のみが存在する場合があります。
          注:
          プランにアップグレード計画アイテムが含まれているかどうかに関係なく、インスタンスは一度に 1 つのアクティブなアップグレード計画のみを設定できます。最新のアップグレード計画のみが現在のアップグレードに自動的に適用されるため、アクティブステータスになります。
        • 生成されたアップグレード計画の表示:これは、最近作成されたアップグレード計画を表示する別の方法です。このオプションは、ページをリロードしたときに成功メッセージバナーが表示されなくなる場合に便利です。
          注:
          このオプションは、アップグレード計画が作成された後にのみ表示されます。
      アップグレード計画が最終的に選択されると、[ アップグレード計画を選択 ] オプションと [新しいプランを作成 ] オプションが無効になります。
    2. アプリケーションのアップグレードをプレビューします。

      インスタンスのすべてのストアアプリケーションとその更新をプレビューできます。アップグレードプレビューの生成が進行中の場合は、実行トラッカーリンクを使用して追跡できます。

      • 選択したアプリ:次の情報を確認できます
        • カスタマイズ済みアプリ:カスタマイズされたアプリの数
        • インストールする新規アプリ:アップグレードのためにインストールされる新規アプリの合計数
        • アップグレードするアプリ:バージョンをアップグレードする必要がある既存のアプリの合計数
          注:
          以前に [ストアアプリケーションを最新バージョンにアップグレード] を無効にした場合、アップグレードするアプリの値は [ストアアプリケーションのアップグレード] セクションの手動選択によって異なります。
      • ストアアプリケーションをアップグレード
        • アプリケーション:アプリケーションの名前
        • 現行バージョン:インスタンス上のアプリケーションの現在のバージョン
        • 最新バージョン:利用可能な最新バージョンのアプリケーション
        • アップグレードバージョン:アップグレードするアプリケーションの選択されたバージョン
        • ステータス:アップグレード用に選択したバージョンに基づくアプリケーションのステータス。互換性があるかどうかは、選択したバージョンに基づいて [ 互換性 ] または [互換性を確認 ] のいずれかが表示されます。
        • ステータス メッセージ: [アプリの互換性の確認] を実行した後にエラーが発生した場合は、アプリの互換性に関する詳細情報を提供します。
          注:
          以前に自動アップグレードオプションを選択した場合、アプリケーションはデフォルトで最新バージョンにアップグレードされます。

          以前に自動アップグレードオプションを選択していない場合は、アップグレード先のアプリケーションのバージョンを選択するオプションが表示されます。

        アップグレードするアプリの数は、選択したバージョンのアプリの手動選択に応じて更新されます。たとえば、すべてのアプリケーションで [すべてを最小バージョンに設定 ] を選択した場合、アップグレードするアプリの数は変更されません。すべてのアプリケーションを利用可能な最新バージョンに更新する場合は、[ すべて最新に設定 ] を選択します。アプリの 互換性の確認を選択して、バージョンを選択した後、アプリの互換性を確認してください。アプリケーションに互換性がない場合は、次の手順に進む前に、バージョンを変更して互換性を持たせてください。
        注:
        アプリケーションの互換性を確認した後にのみ、アップグレードプロセスの次のステップに進むことができます。

        [選択したアプリ] セクションで [ アップグレード計画を表示 ] を選択すると、このステップの最後にアップグレード計画に追加されるすべてのアイテムと、選択したバージョンが表示されます。

        完了とマークした後でも 、[ステップを編集 ] を選択すると、このステップを編集できます。
        注:
        [ ステップの編集] オプションは、このステップを完了としてマークし、アップグレードをスケジュールまたは開始する前にのみ使用できます。[ステップの編集] を選択すると、アップグレード前のプロセスの次の手順がリセットされます。アプリケーションの互換性を確認した後にのみ、アップグレードプロセスの次のステップに再度進むことができます。

      自動アップグレードがオプトインされていない場合は、アップグレードするアプリケーションのバージョンを手動で選択できます。すべてのアプリケーションを利用可能な最新バージョンに更新する場合は、[ すべて最新に設定 ] を選択します。アプリの 互換性の確認を選択して、バージョンを選択した後、アプリの互換性を確認してください。アプリケーションに互換性がない場合は、次の手順に進む前に、バージョンを変更して互換性を持たせてください。

    3. スキップされると予測されるレコードを確認します。
      スキップされたレコードは、インスタンスのカスタマイズにより、アップグレード中に特定のファイルが自動的に更新されない場合に発生します。
      • アップグレードプレビュー:このセクションでは、アップグレードの現在のバージョンとプレビューバージョンを表示できます。アップグレードがスケジュールされているかどうかを確認することもできます。
      • スキップされたレコードサマリー:次の情報を表示できます。

        • 変更された合計レコード数:前回のアップグレード以降に変更されたレコードの合計数を示します。[変更のレビュー] リンクを選択して、変更されたレコードのリストを表示します。
        • スキップされたレコードの合計:解決済みのスキップされたレコードの数、レビューが必要なスキップされたレコードの合計、および既にレビュー済みのスキップされたレコードの数を表示します。
        • テストのないスキップされたレコード:テストのあるスキップされたレコードの合計数を示します。[スキップされたレコード] セクションの [リンクされたテスト] リンクは、テストが関連付けられているスキップされたレコードのテストのリストを指します。
      • スキップされると予測されるレコード:スキップされると予測されるレコードの合計数を表示します
        • 名前:スキップされたレコードの名前
        • 製品:スキップされたレコードが属するレコードの名前
        • 優先度:
        • ステータス:スキップされたレコードのステータス (解決済み、レビュー済み、またはレビューが必要かどうか)。
        • 予測処理:選択したアップグレード中にスキップされたレコードに対して実行されると予測されるアクション。
          • 予測挿入:新しいレコードが挿入されると予測されます。
          • 予測更新:このレコードが更新されると予測されます。
          • 復元済み:このレコードはベースバージョンに戻され、次のアップグレードではスキップされません。
          • 予測スキップ:カスタマイズを保持するためにこのレコードは変更されません。
          • 予測スキップ (手動結合):更新には手動での介入が必要なため、このレコードは変更されません。
          • 予測スキップ (1 回適用):1 回適用フォルダー内の xml ファイルから更新が既に適用されているため、このレコードはスキップされます。
        • プラグイン:スキップされたレコードが見つかったアプリ ID
      • スキップされたレコードルールエディター:スキップされたレコードルールエディターを使用して、設定された条件に基づいてスキップされたレコードルールを作成し、アップグレード後のカスタマイズを定義します。
        注:
        このステップは、「スキップされると予測されるレコードのレビュー」ステップ内で完了します。

        本番インスタンスでスキップされたレコードルールエディターを示すスクリーンショット

        スキップされたレコードルールエディターで設定された条件に一致するスキップされたレコードは、以前に選択したアクションを実行します。[ 最新のアップグレード履歴を表示 ] を選択して、以前のアップグレードに応じて設定するアクションと条件を決定します。
        スキップされたレコードルールには、インスタンスでスキップされたレコードルールのリストが表示されます。
        • 名前:ルールの名前
        • アクティブ:ルールがアクティブかどうかを示します
        • 条件:スキップされたレコードをフィルタリングするためにルールによって設定された条件
        • アクション:特定のルールに対して以前に選択されたアクション
        • 順序:ルールがソートされる順序

        スキップされるレコードルールを追加で作成する場合は、[ ルールの作成 ] を選択します。

      このアップグレード前のアクティビティでは、次の操作を実行できます。
      • プレビューモジュールでスキップされると予測されるレコードのリストを確認し、保持するファイルのバージョンを決定します。
      • 一部のカスタマイズをベースバージョンに戻すことを選択して、スキップせずにアップグレードプロセス全体を実行できます。
      • アップグレード後に、スキップされたレコードのリストを必ず確認して更新してください。
      • スキップされたレコードのレビューが完了したら、アップグレード前のプロセスで必要な次のアクティビティを完了します。