移行評価
Commerceの移行評価は、既存のAdobe Commerceの導入を自動的に分析するものです。 Adobeのツールは、Commerceのコードベースをスキャンし、構築、カスタマイズ、変更されたあらゆる要素を一覧表示する構造化レポートを生成します。 次に、コードベースに対して行われたカスタマイズが、Adobe Commerce as a Cloud Serviceへの移行にどのような影響を与えるかを示します。
処理済みの移行評価レポートは、https://experience.adobe.com/@<ims-org-name>/commerce-migration-assessment/shared-assessmentsからアクセスできます。 本番環境へのアクセスは必要ありません。ただし、最初にプロジェクトコードベースを共有する必要があります。
評価で提供される:
- ストア内の各カスタムモジュールを、タイプ別および影響レベル別に整理した包括的なインベントリ
- リスク予測指標から計算された移行の複雑さの評価(高、Medium、低)
- 移行計画が必要なバックエンドとストアフロントの領域で、最も効果の高いビューを優先的に表示
- AdobeのAI開発ツールの直接入力として使用できる各カスタムモジュールの説明
移行評価レポートについて
レポートは、Summary、Module Reports、Report Reliabilityの3つのタブに分かれています。
「概要」タブ
「Summary」タブには、次の領域に整理された主要シグナルの概要が表示されます。
- 移行の複雑さ
- ファイル形式の分類
- 最も効果の高いモジュール
- 移行ドライバー
- カスタマイズの分類
移行の複雑さ
「移行の複雑さ」セクションには、ストア全体の評価の評価が含まれます。 スコアの計算方法を説明し、主なリスク要因を明らかにします。
移行の複雑さと複雑さのスコア
重み付けスコア、主なリスク要因、および主要指標を示す
複雑さスコアは、各入力を移行するのが難しいかどうかによって重み付けします。 スコアは、固定しきい値を使用して移行の複雑さの評価にマップされます。
カスタムモジュール比率
特に実装用に構築されたモジュールの割合。 比率が高いほど、より多くのカスタムコードを監査および移行する必要があります。 お客様のカスタムモジュールの平均比率は約62%です。
ファイルタイプの分類
コードベース内のファイルの数をタイプ別に整理したリスト。
最も効果の高いモジュール
移行に最も配慮が必要なストア内の特定のモジュールの厳選されたリスト。 こうしたモジュールは、多くの場合、チェックアウト、決済、注文管理などを扱うモジュールです。 影響の大きいモジュールごとに、独自の移行計画が必要です。 このリストは、テクニカルチームと話をするための最適な出発点となります。
ストアフロントの複雑さ
カスタムテーマ名前空間、合計ブロック数、レイアウト XML ファイル、コアハンドルの上書き、実用的なシグナルを示す
「ストアフロントの複雑さ」セクションでは、ストアのフロントエンドのプレゼンテーション層を移行するために必要な労力を表示します。 このワークストリームは、バックエンドのコード移行とは異なるワークストリームであり、フロントエンド開発者が対応し、通常は個別のプランニング会話が必要です。
-
カスタムテーマ – ストアのカスタムテーマの名前空間(BrandName_Themeなど)。 カスタムテーマが存在する場合、Adobe Commerce as a Cloud Serviceには完全なテーマの再構築が必要です。 カスタムテーマ名前空間を持つ評価されたすべてのストアでは、専用のフロントエンド移行ワークストリームを計画する必要があります。
-
合計ブロック – ストア内のブロックとテンプレート (.phtml) ファイルの数。 ブロックは主要なサーバーサイドのレンダリングアーティファクトで、それぞれ個別の移行タスクを表します。
移行ドライバー
「移行ドライバー」セクションには、複雑さの評価の主な要因が表示されます。
各ドライバーは、High、Medium、またはLowの労力で表示されます。 スコーピングとプランニングの際は、最初に最も評価の高いドライバーに対応しましょう。
データモデル
カスタムテーブル、コアテーブルの変更、重要なEAV属性の数を示す
「データモデル」セクションには、カスタムテーブルの数、コアデータベーステーブル Adobe Commerceへの変更、およびクリティカルエンティティ属性値(EAV)属性が表示されます。
コアテーブルの変更は、特定のプラットフォームスキーマバージョンに依存し、複雑さスコアの式に大きな影響を与えるため、移行が最も困難なカテゴリです。
カスタマイズの分類
「カスタマイズの分類」セクションには、ストア内のカスタマイズのあらゆるカテゴリをまたいで詳細な指標が表示されます。
レイアウト XML
Layout XML ファイルの数とその合計操作数。 Layout XMLは、表示されるブロック、表示されるコンテナ、下にあるページタイプなど、すべてのページの構造を定義します。
操作が多いファイル数が多い場合は、ページ構造を大幅にカスタマイズする必要があり、その場合は再構築する必要があります。
コアハンドルの上書き
レイアウト XMLがコア Adobe Commerce ページハンドルを上書きする場所の数(例:checkout_cart_indexまたはcatalog_product_view)。 コアハンドルのオーバーライドは、プラットフォームレベルでページ構造を変更し、明示的な再構築を必要とするため、最もリスクの高いレイアウト信号です。
ブロック
ストア内のブロックとテンプレート (.phtml) ファイルの数。 ブロックは、主要なサーバーサイドのレンダリングアーティファクトです。 各ブロックは、個別の移行タスクを表します。
高リスクのブロック
チェックアウトレンダリング、カート表示、類似のフロントエンドサーフェスなど、主要なレンダリングパスに触れるブロックを提供します。 リスクの高いブロックの場合は、スケジュールを設定する前に個別の移行評価が必要です。
テーマとメールテンプレート
ストアのカスタムテーマの名前空間(例:BrandName_Theme)。 カスタムテーマの存在は、完全なテーマの再構築が必要であることを意味します。 カスタムテーマ名前空間を持つ評価されたすべてのストアでは、専用のフロントエンド移行ワークストリームを計画する必要があります。
テンプレートの上書き(コア変更)
上書きされたコア Adobe Commerce .phtml テンプレートの数。 各コアテンプレートの上書きは、そのテンプレートの特定のバージョンに対する依存関係を作成します。 テンプレートを変更するプラットフォームの更新により、上書きがサイレントに解除されます。
ドロップインの移行が必要
Adobe Commerce as a Cloud Serviceは、チェックアウト、買い物かご、商品詳細など、ストアフロントサーフェスにモジュール式のドロップインコンポーネントアーキテクチャを使用しています。 これらのサーフェスに対するカスタマイズは、ドロップインコンポーネントとして再構築する必要があります。 これらのカスタマイズでは、カスタムチェックアウトステップの追加、カート表示ロジックの変更、製品詳細ページの拡張など、幅広い機能に対応します。
Drop-in migration required フィールドは、ドロップインの再構築が必要なストアフロント領域を示します。
「モジュールレポート」タブ
「Module Reports」タブには、ストア内のすべてのカスタムモジュールの専用エントリが含まれています。 この情報をテクニカルチームと共有します。
モジュールごとに、次のレポートが表示されます。
ワークフロー
-
最初に 影響の大きい 個のモジュールにフィルタリングします。 移行に要する労力とコストを最も多く削減できます。
-
カスタムモジュールごとに、次の質問に対する回答を決定します。
- このモジュールはまだ積極的に使用されていますか?
- モジュールをネイティブ Adobe Commerce as a Cloud Service機能に置き換えることはできますか?
- モジュールを再構築する必要がある場合、その代わりにどのような機能が必要ですか?
-
廃止または置き換え可能なカスタムモジュールを特定します。 コードを記述する前に、移行の範囲を削減します。
-
各カスタムモジュールの説明を、再構築移行の推奨事項と共にコピーします。 これらの説明は、AdobeのAI デベロッパーツールに直接与えることができます。詳しくは、Commerce拡張性のAI デベロッパーツール を参照してください。
参考:主な用語
COMMERCEの拡張性に対応するAI開発ツール
AdobeのAI デベロッパーツールのプロンプトとして、Module Reports タブのモジュール説明を使用できます。 このツールは、Adobe Commerce as a Cloud Serviceと互換性のある代替拡張機能の構築とデプロイに役立ちます。
ツールの機能
AdobeのCommerce拡張機能向けAI開発ツール には、主にふたつの機能が含まれています。
- Adobe Commerce App Builder MCP サーバー – AI コーディング アシスタントをAdobe Commerceのドキュメント、API、およびApp Builder開発パターンに直接接続するモデル コンテキスト プロトコル (MCP)統合。 開発者は何を構築したいのかを記述でき、MCP サーバーはCommerce対応のコード生成、アーキテクチャガイダンス、デプロイメントオートメーションをIDE内で提供します。
- エージェントのスキル - REST API、チェックアウト拡張機能、ストアフロントコンポーネント、イベント駆動型の統合など、Adobe Commerceの一般的な拡張性パターンをカバーする事前定義済みのAI スキル。 スキルは、Adobe Commerce as a Cloud ServiceおよびApp Builderに固有のアーキテクチャ、実装、テスト、デプロイメントの手順を通じてAIを導きます。
AI ツールのインストール
詳しい手順と特定のIDE設定については、AI開発者ツールのインストール を参照してください。
前提条件: Node.js 22.x、npm 9.0.0以降、Adobe I/O CLI
Install コマンドを実行します。
aio commerce extensibility tools-setup
評価レポートからのプロンプトの作成
この評価により、開発の設計図が得られますが、AI ツールにより、完全な移行計画が確定する前に、すぐにチームは構築を開始することができます。
- 「Module Reports」タブを開き、再構築の推奨事項が記載されたインパクトの大きいモジュールを見つけます。
- モジュールの説明を読みます。例:
Manages custom shipping rate calculations based on customer account tier and order weight thresholds.
- GitHub Copilot、Cursor、ClaudeなどのIDEを開き、Commerce拡張機能MCP サーバーを有効にします。
- モジュールの説明を使用して、AI エージェントにプロンプトを表示します。
- スキャフォールドされたApp Builder アプリケーションを確認し、エージェントで繰り返し実行して、実装を調整します。
次のステップ
- 「Summary」タブを開きます。 移行の複雑さと最も影響の大きいモジュールを確認し、「カスタマイズの分類」サブセクションを確認します。 ストアにカスタムテーマ、高リスクのブロック、チェックアウトドロップインがリストされている場合は、バックエンドの移行と並行して、フロントエンドのワークストリームを計画します。
- 技術チームまたは開発パートナーとModule Reports タブを共有します。 アクティブに使用されなくなったカスタムモジュールや、Adobe Commerce as a Cloud Service機能に置き換えられる可能性があるカスタムモジュールにフラグを付けるように依頼します。
- カスタマイズの作成を開始します。 モジュールの説明をAI ツール入力として使用して、互換性のある拡張機能の基礎モードを開始します。
- Adobe アカウントチームとのウォークスルー電話を予約する。 Adobeで調査結果を確認し、特定のモジュールやストアフロントシグナルに関する質問に回答します。また、複雑なプロファイルのために移行アプローチをマッピングするのにも役立ちます。
リソース
-
Adobe Commerce as a Cloud Service
-
拡張機能
-
ストアフロント開発