サイトカタログを使用した移行の計画 site-catalog-skill

Experience Modernization Agentのサイトカタログには、移行が許可されているサイトのページが一覧表示され、何かがインポートされる前にグループ化されます。 テンプレートからブロックのレイアウトを共有するページ。 ページ間で類似したブロックは、ブロックバリアント（コンテンツ構造や外観が異なるブロックのバージョン）を形成します。 読み込み時に、フィールドが異なるバリアントが、それ自体の🔗 ブロックになります。 このグループ化を使用すると、テンプレートごとに1つのサンプルページを移行してチェックし、残りのテンプレートを一括インポートできます。 カタログが見つけるテンプレート、ブロック、ロケールによって、プロジェクトの見積もりが表示され、そのレポートは、コンソールを使用しない関係者と共有できます。

カタログはソースサイトを読み込み、何もインポートしません。 移行ワークフロー全体については、実稼動サイトの移行を参照してください。

計画の開始 invoking

ソースサイトを読み取る権限があり、コンソールがそのサイトにアクセスできることを確認します。 次に、Experience Modernization Consoleで、次のいずれかの方法で計画を開始します。

計画中に、計画 ビューに、現在の手順、見つかったページ数と読み取られたページ数、経過時間を含む​ 移行の計画 ​が表示されます。 実行完了前に結果を確認できます。

エージェントは発見したページをすべて分析します。 1,000 ページを超えるページが見つかると、分析にかかる時間を大まかに示し、続けることができます。 非常に大きなサイトの場合は、エージェントに移行を分割する方法を提案し、選択したセクションをカタログ化するように依頼します。

実行を停止するには、チャットの停止コントロールを使用します。 計画 ビューには、計画が完了する前に停止したことが表示されます。中断したところから再開するか、最初からやり直すことができます。 チャットスレッドは、停止する前に何が起こったのかを示します。

計画は4つのフェーズに分かれています。

結果とステータス output

実行が完了すると、エージェントはチャットに概要（ページ数、テンプレート数、ブロックバリアント数、ロケールによる分類、実行のステータス）を投稿します。 計画 ビューには、同じステータスが表示されます。

完了​実行しても失敗したページが残っている可能性があるので、失敗したURLを確認してください。 検出されたURLと合意した範囲を比較します。リンクが不要なページは、自分で決定する必要があります。 検出、分析、読み込み、サインオフの各ページの数を維持します。

計画ビュー planning-ui

​ ワークスペースパネル ​の​計画 ビューには、エージェントが識別したテンプレート、ページ、ブロックがスクリーンショットと共に表示され、移行する前に修正できます。 以降のステップでは、このグループ化に基づいて作成されるため、ページを読み込む前にグループ化を確認してください。 このビューは、チャットの​プラン モードとは関係ありません。このモードでは、エージェントは、ファイルを変更する前に1つのリクエストに対するアプローチを提案します。

プランニングビューを開く accessing-planning-ui

現在のプロジェクトでサイトをカタログ化していない場合、ビューでサイトのアドレスを求められるので、計画を開始できます。

このビューには、catalog/ フォルダーのファイルから、コンソール ワークスペースごとに1つの移行プランが表示されます。 複数のプランを並べて管理することはできません。例えば、国ごとのサイトごとに1つずつ管理できます。 サイトを次から次へと計画して移行し、各プランのレポートバンドルをダウンロードして記録しておきます。

ダッシュボード dashboard

ダッシュボードには、カタログ化されたサイトの概要が表示されます。 ヘッダーには、サイトタイトル、実行ステータス ​、分析日が表示されます。 ワークスペースヘッダーの「サイトを開く」を選択して、ソースサイトを新しいタブで開きます。

ダッシュボードカードには次の情報が表示されます。

カードの下のトグルを使用すると、各テンプレートの説明とページ数を含む​ テンプレート ​と、各ブロックとそのバリエーションを含む​ ブロック ​の間でテーブルが切り替わります。 テンプレート名を選択して​ テンプレートの詳細を開くか、バリアントを選択して​ インスタンス ​を表示します。 両方のテーブルを検索して並べ替えることができます。 「テーブルを展開」を選択して、カードを非表示にし、テーブルに余裕を持たせます。

テーブルをブロック blocks-table

ブロック テーブルには、ブロックごとに1つの拡張可能な行が表示され、ブロックのバリエーションが下にネストされます。 各ブロックについて、見つかったバリエーション、ページ、テンプレートの数とコードステータスが表示されます。

各ブロックには、その名前と、その基になるブロックライブラリのブロックのタイプ（例えば、タイプ cardsのcards-story ブロック）が表示されます。 そのバリエーションは、.with-buttonなど、バリエーション クラスの下に表示されます。 クラスのないバリアントは、ブロックのデフォルトです。 ページヘッダー、フッター、プレーン見出しやテキストなどのデフォルトコンテンツは、ブロックとしてリストされません。

Code​列には、ブロックに対してコードが生成されたかどうかが表示されます。

Ready​は、コードが存在することのみを意味します。 作成者がブロックを編集できるかどうか、およびブロックが機能するかどうかが、リリース 🔗前の チェックの一部です。

Confidence​列は、ブロック バリアントが正しくグループ化および分類されていることをエージェントがどのように確認しているかを示します。

サンプルコンテンツでコードを生成した後、ブロックのアクションメニューで「サンプルを表示」を選択して、プレビューでブロックのサンプルページを開きます。

テンプレートとページの詳細には、そのテンプレートまたはページに限定された、同じブロックテーブルが表示されます。

テンプレート詳細 template-details

テンプレートを選択すると、テンプレートを使用するすべてのページと、ページパス、タイトル、ブロック数が表示されます。 ページパスを選択して、​ ページの詳細を開きます。 テンプレートが使用するブロックに切り替えるには、ページ / ブロック​の切り替えスイッチを使用します。

テンプレートのページを移行すると、テンプレートにはインポートされたページ数と失敗したページ数が表示され、各ページにはインポートのステータスが表示されます。 インポートの実行中にステータスが更新されます。

ダッシュは、ページのテンプレートが現在の移行に含まれていないことを意味します。

ページ詳細 page-details

ページの詳細ページに表示されるブロックと、分析の詳細（セクション数やブロック数など）が一覧表示されます。 ヘッダーの「スクリーンショットを表示」を選択して、ページ全体のスクリーンショットを表示します。 ブロックのバリエーションで​ ページ ​の場所を選択すると、そのブロックがハイライト表示されたスクリーンショットが表示されます。

バリアントインスタンス variant-instances

ブロックのバリエーションを選択すると、そのインスタンスごとに、サイト上に表示されるインスタンス数、ページ数、テンプレート数が表示されます。 不適切なグループのインスタンスが目立つ。

各インスタンスのアクションメニューを使用すると、スクリーンショットを表示したり、ページ上でスクリーンショットを見つけたり、ページの詳細を開いたり、ソースページを開いたりできます。

グループ化を修正するには、1つ以上のインスタンスを選択し、次のいずれかのアクションを選択します。

少なくとも1つのインスタンスが元のバリアントに残っている必要があります。 バリエーションのすべてのインスタンスを移動するには、このバリエーションに独自のブロックを追加​するか、バリエーション上の別のブロック​のバリエーションを作成します。 カタログを再生成すると、分割および移動の変更は保持されます。

失敗したURL failed-urls

失敗したURL リストには、分析できなかった各ページとその理由と時間が表示されます。 画像やドキュメントなど、ページ以外のファイルはスキップされ、個別にカウントされ、リストには表示されません。

カタログの確認 review-catalog

プランニングが完了すると、エージェントは​ スコープ結果のレビュー ​を提案します。 特に大規模なサイトの場合、カタログをチェックする出発点として使用します。

レビューでは、カタログのみが変更されます。 ページをインポートしたり、コードを生成したりすることはありません。

サイト移行を開始​すると、一度に1つのテンプレートが移行されます。 エージェントはどのテンプレートから始めるかを尋ね、カタログのページとブロックを使用します。 次のテンプレートに進む前に、テンプレートのページを確認し、一部を修正することを期待してください。

カタログの絞り込み planning-actions

アクション メニュー（…）を開きます テンプレート、ページ、ブロック、バリエーションのいずれかを選択し、AI アクション​を選択して、使用可能なアクションを表示します。 また、最大20個のアイテムを選択して同時に操作することもできます。

アクションを選択すると、コンソールは選択した項目をリクエストを含むチャットに追加します。 確認する前に、その範囲と提案された変更を確認してください。 また、チャットに追加​を選択し、変更すべきものや、エージェントがコンテンツをアップロードできるかどうかを含め、独自のプロンプトを作成することもできます。

一部のアクションは、その適用場所のみを示します。 例えば、ブロックコードを生成​および​ ブロック名を変更 ​は、型が分類されたブロックにのみ使用でき、このバリエーションには、バリエーションのクラスを持つバリエーションにのみ独自のブロック​を割り当てます。

ページをAEM​に移行し、テンプレートをAEM​に移行する場合、AEM​はコンソールに接続されたプロジェクトを参照します。 読み込まれたコンテンツは、ドキュメントベースのプロジェクトの場合はExperience Workspaceに、Experience Manager オーサリングの場合はオーサーインスタンスにアップロードするまで、コンソールワークスペースに残ります。

グループ化と名前の変更は、既に読み込んだページではなく、カタログを変更します。 ブロックコードを生成​するとコードが変更され、移行アクションによってコンテンツが読み込まれるので、出力を個別に確認します。 カタログ内の構造的リファクタリングは、ブロックコードのリファクタリングではありません。詳しくは、結果を変更せずにリファクタリング ​を参照してください。

フェーズを再実行 additional-prompts

フェーズを再実行するには、例えばソースサイトが変更された後に、エージェントに名前でフェーズを繰り返すように依頼します。

repeat block cataloging

また、エージェントは後のフェーズごとに再実行し、前のフェーズも保持します。 Planning ビューで行った変更（分割や移動ブロックインスタンスなど）は保持されます。

Planning ビューに​ ブロックカタログが古い ​と表示されている場合、カタログは現在のバージョンで読み取れない以前の形式で作成されました。 scope siteさんとサイトのアドレスとのチャットから、もう一度計画を実行します。 計画が終了する前に計画が停止した場合、計画 ビューの​ 開始回数 ​でも、同じサイトに対する新しい実行が開始されます。

一括読み込みワークフロー bulk-import

テンプレート別に完全なサイトテンプレートを移行するには：

テンプレートの出力が正しくない場合は、サンプルページで修正してから、さらにページを読み込みます。 分析が失敗した場合は、失敗したURLを確認し、ソースアクセスを修正して、それらのページを再試行してください。 ページを再度読み込むと、作成者がそのページに加えた編集内容が上書きされます。​ バッチでの読み込みを参照してください。

カタログファイル catalog-files

ほとんどのユーザーには、計画ビューのみが必要です。 オフライン レポートを共有したり、他のツールでデータを使用したりするには、プロジェクトのcatalog/ フォルダーで生の出力を見つけます。

フォルダーには、ページごとの分析と.pages/のスクリーンショット、および.blocks/のバリアントごとのメタデータを含む中間ファイルも含まれます。

制限事項 limitations

分析を引き継ぐには、その日付、ソーススコープ、レポート、修正、未解決のURL、​ プロジェクトの引き継ぎでチェックしたサンプルページを記録します。