Experience Modernization Agentのトラブルシューティング troubleshooting

症状を見つけて、そのセクションに従ってください。 ほとんどの問題は、ソースサイトへのアクセス、Adobe Experience Manager Edge Delivery Services サイトにコードとコンテンツを書き込むアカウント、コンソールワークスペースとGitおよびコンテンツソースに保存される内容との違いによるものです。

症状
セクション
読み込みが失敗するか、キャプチャしたページにエラーまたはサインインページが表示されます。
読み込みに失敗
検出後にURLが見つからないか、ソースサイトがHTTP 403、429、または503を返します。
​ ボット保護を備えたSource サイト ​
変更を加えても表示されません。
Aの変更がありません
コンソールのプレビューがプレビューサイトと一致しません。
​ コンソールプレビューがサイトと異なる
アップロード、プル、または転送が失敗する。
​ コンテンツの書き込みに失敗しました
コンソールにリポジトリが一覧表示されないか、リポジトリにプッシュできません。
Git接続の問題
コンソールでワークスペースの準備を続行します。
Workspaceの設定に時間がかかるか、失敗する
ログイン後にプロジェクトが終了しました。
​ プロジェクトが見つかりません
メッセージを送信できませんでした。 もう一度やり直してください。
​ メッセージの送信に失敗しました
インポートしたページを削除する必要があります。
​ ページの削除

何かをリセット、破棄、置換、または上書きする前に、影響を受ける作業を保持します。 コードとコンテンツは個別に復元されます。​ リリース、復元、引き継ぎを参照してください。

このページで問題が解決しない場合は、コンソールで​ サポートをリクエスト ​するか、自動モードページで​ ヘルプを取得 ​を選択します。

読み込みに失敗する import-fails

エラーと正確なソース URLを保持し、URLがブラウザーで開くことを確認します。 ページにサインインが必要な場合、またはキャプチャでコンテンツではなくサインインページが表示される場合は、保護されたサイト認証を設定します。 ソース サイトが自動アクセスをブロックする場合は、​ ボット保護を備えたSource サイト ​を参照してください。 ソースに到達できる場合は、エージェントにエラーを与え、そのページの読み込みを修正するように依頼します。 バッチを繰り返す前に、影響を受けたページを1つ再試行してください。

Source Sitesとボット保護 bot-protection

コンテンツ配信ネットワーク(CDN)またはweb アプリケーションファイアウォール(WAF)のボット保護は、URL検索、サイトカタログ、ページキャプチャ、インポートなど、あらゆるワークフローでソースサイトに対するエージェントのリクエストをブロックまたは拒否できます。 一般的な兆候は、HTTP 403、429、503などのアクセス拒否エラー、検出後にURLが見つからない、ページが失敗した、ページコンテンツの代わりにキャプチャされたチャレンジまたは検証ページなどです。

移行できるのは、自分が所有するサイト、または移行が許可されているサイトのみです。 保護を回避せずに、サイトの管理者とのアクセスを調整します。

  1. 例えば、CDNまたはWAFで​ バックエンドアドレス ​を許可リストに加えるして、移行期間のアクセスを許可するように管理者に依頼します。
  2. 代わりに、秘密鍵リクエストヘッダーなどの資格情報を保護が受け入れる場合は、コンソール設定の保護サイト認証など、ワークフローで提供される認証制御に資格情報を入力します。 スコープ付きの資格情報を使用し、移行が完了したら削除します。
  3. 管理者が同じコンテンツを持つアクセス可能なステージングまたはオリジンホストを提供する場合は、それをソースとして使用し、そのコンテンツの取得元のホストを記録します。
  4. 検出のみがブロックされている場合は、移行するページ URLのリストを代わりに指定します。

カタログまたはバッチ実行を開始する前に、画像やその他のアセットを含む1つのページを確認します。 アクセスの変更後、失敗したページを再試行し、コンテンツを受け入れる前に、チャレンジまたはアクセス拒否されたページのキャプチャを確認します。

・IP アドレスの許可リストに加える allowlist-ip-addresses

ソースサイト管理者の承認を得て、ソース抽出のために次のバックエンドアドレスを許可リストに加えるします。

  • 34.228.136.112
  • 54.90.51.39
  • 3.224.194.242

許可リストに加えるでは、ネットワーク アクセスのみが可能です。ソースは引き続きインターネット経由でアクセス可能である必要があり、保護されたページには保護サイト認証が必要です。

変更がありません missing-change

コードとコンテンツは異なる場所に保存されるので、コンソールワークスペース、アップロードされたコンテンツ、プッシュされたブランチ、プレビューされたページのそれぞれを確認します。 再インポートではローカルのコンテンツ変更が上書きされるため、ページを再インポートする前に編集をアップロードするか調整します。 コンソールプレビューとプレビューサイトを比較するには、​ コンソールプレビューとサイト ​の違いを参照してください。

コンソールプレビューがサイトと異なる preview-differs

コンソールプレビューとプレビューサイトでは、コンテンツとコードの異なるコピーがレンダリングされます。どの結果を表示しているかを確認で説明します。 次のいずれかの原因を探します。

  • コンテンツがアップロードされていません: コンソールで変更されたページは、Experience Workspaceにまだ含まれていません。 Sync > Push > Content​でアップロードします。
  • 他の場所で編集されたコンテンツ : Experience Workspaceで変更された ページは、まだコンソールワークスペースにありません。 Sync > Pull > Content​でそれらをプルすると、これらのページのローカル編集が上書きされます。Refresh​では、レンダリングが再読み込みされます。
  • 異なるコード: コードがプッシュされないか、プレビューURLで別のブランチが使用されています。 コードをプッシュし、それを持つブランチのプレビューURLを開きます。
  • 幅が異なります: コンソールのプレビューは、デフォルトでパネルに表示されます。 ビューポート メニューを使用して、同じ幅で比較します。
  • プレビューサイトが削除するマークアップ: Edge Delivery Servicesはセクション、ブロック、デフォルトコンテンツのみを保持するため、ページマークアップ内でのスタイル設定は失われます。 担当者に、プロジェクトのCSSに移動するように依頼します。 ​ プレビューの仕組みを参照してください。

コンテンツの書き込みが失敗する write-errors

コードとコンテンツは異なるアカウントを使用します。 コードは、GitHub接続または他のGit ホストのCloud Manager接続でプッシュされます。 コンテンツは、ログインしたAdobe アカウントを使用してExperience Workspaceに書き込まれます。 したがって、コンテンツのアップロードが失敗した場合、または逆の方法でコードプッシュを成功させることができます。

アップロード、取り込み、または転送によって、ドキュメント作成セッションの有効期限が切れていることが判明した場合は、もう一度ログインして再試行してください。 セッションは有効ですが、Adobe アカウントにサイトのコンテンツへの書き込みアクセス権がない場合、コンソールに同じメッセージが表示されます。 問題が解決しない場合は、サイトの管理者に、コンソールで使用するメールアドレスと組織を使用して、Experience Workspaceでサイトに書き込むことができることをサイトの管理者に確認してもらいます。 Adobe Admin ConsoleでのExperience Managerへのアクセスだけでは、サイトのコンテンツへの書き込みアクセス権を付与することはできません。 コンソールにレート制限があると表示された場合は、少し待ってからもう一度試してください。

Git接続の問題 git-connection

各GitHub アプリの機能については、​ リポジトリから開始を参照してください。

問題
実行内容
組織またはリポジトリが一覧表示されていません。
AEM Code Connector アプリが組織またはアカウントに見つからない、他の選択したリポジトリのみをカバーしている、または組織オーナーの承認を待っている。 「​ リポジトリから開始」の説明に従って追加します。 個人用アクセストークンを使用すると、コンソールにはプッシュ可能なリポジトリのみが一覧表示されます。
リポジトリの​への書き込みアクセス権がありません。
接続にはプッシュアクセスが必要です。 リポジトリ管理者に書き込みアクセス権の付与を依頼するか、別のリポジトリを接続します。
コンソールでプレビューURLを確認できません。
リポジトリにAEM Code Syncが含まれていない場合、サイトにはプレビューURLがありません。 アプリが存在し、URLがパターン https://{branch}--{site}--{organization}.aem.pageに従っていることを確認してください。
AEM Code Connector アプリがインストールされるまでプッシュは無効になります、または​AEM Code Connectorが必要です。
コンソールはリポジトリを読み取ることができますが、書き込みはできません。AEM Code Syncを使用すると、Edge Delivery Servicesはコードを読み取り、AEM Code Connectorのみがコンソールに変更を加えることができます。 AEM Code Connectorをリポジトリに追加します。
無効または期限切れのトークン、またはトークンにユーザーの読み取りアクセス権がありません。
新しいトークンを作成します。 クラシックトークン、またはユーザーアカウントを読み取り、リポジトリのコンテンツに書き込むことができる、きめ細かいトークンを使用します。
LLMが自分のGit資格情報を使用することを許可する​が設定にありません。
設定はまだ利用できません。 エージェントは引き続きコンソールワークスペースでコードを変更できます。同期 > プッシュ > コード​で自分でプッシュします。
プッシュが拒否されました:Cloud Manager​でDeployment Manager ロールが必要です。
Cloud Managerを介して接続されたリポジトリの場合は、管理者にCloud Managerでのデプロイメントマネージャーの役割を依頼します。

変更と保護されたブランチの競合については、​ プッシュコードの変更を参照してください。

Workspaceの設定に時間がかかるか失敗する workspace-setup

ワークスペースの準備には、初めてログインしたときにリセット後に最大10分かかります。 すべてのワークスペースが使用中の場合は、コンソールに通知され、使用可能なワークスペースが利用可能になったらすぐに設定が開始されます。再試行する必要はありません。 早く必要な場合は、「サポートをリクエスト」を選択してください。 設定が失敗した場合、コンソールは再試行を提供します。 エラーが引き続き発生する場合は、設定画面の「サポートをリクエスト」リンクを使用します。 コンソールでアカウントが使用できないというメッセージが表示された場合は、Adobe アカウントチームにお問い合わせください。 ワークスペースが一時停止されていることを示すワークスペースについては、​ エクスペリエンス最新化コンソールを開くを参照してください。

プロジェクトがありません missing-workspace

複数のAdobe組織に属している場合、プロジェクトは別の組織の​ コンソールワークスペース ​にある可能性があります。 ログアウトしてから同じアカウントでログインし、以前に使用した組織のプロファイルを選択します。 調査中に​ ワークスペースをリセットしないでください:リセットすると、プッシュしていない作業が削除されます。 プロジェクトがまだ見つからない場合は、​ プロジェクト名とプレビューURLでサポートをリクエスト ​してください。 プッシュされたコードとアップロードされたコンテンツは、いずれにしてもGit リポジトリとコンテンツソースで安全です。

メッセージを送信できませんでした send-failed

メッセージを送信できませんでした。 もう一度やり直してください。 コンソールがプロンプトをエージェントに配信できなかったことを意味します。 メッセージが原因で問題が発生しません。原因は、ネットワーク接続、期限切れのサインイン、一時的なサービスの問題などが考えられます。

  1. ネットワーク接続を確認し、もう一度プロンプトを送信します。 コンソールが自動的に再試行されない。
  2. 再度失敗した場合は、プロンプトをコピーし、ページを再読み込みして、必要に応じてログインします。 チャット履歴は保存されます。
  3. それでも数分後に失敗する場合は、設定で​ サポートをリクエスト ​し、エラーの時間とプロジェクト名を指定します。

代わりに、コンソールが処理可能であると表示される場合は、Workspaceの設定に時間がかかるか、失敗するを参照してください。

ページを削除 remove-pages

コンソールのセーフガードは、移行されたコンテンツが誤って削除されないように、エージェントがプロジェクトのコンテンツフォルダー内のファイルを削除するのを防ぎます。 したがって、エージェントにページの削除を依頼しても機能しません。 彼らが存在する各場所でそれらを自分で削除します:

  • コンソールワークスペース: ​ コンテンツビューで、ページを選択し、削除 (1 ページずつ)を使用します。 これにより、コンソール ワークスペースのコピーのみが削除されます。
  • コンテンツソース: Experience Workspaceまたはオーサーインスタンスでアップロードしたページを削除します。 これを行うまで、コンソールで削除したページが、クラウドアイコン付きのコンテンツビューで再度表示されます。
  • プレビューサイトとライブサイト: AEM Sidekickでプレビューおよび公開されたページを非公開または削除します。

ページが間違ったパスに読み込まれた場合は、正しいパスにページを再び読み込んで確認し、間違ったパスにあるコピーを削除します。

recommendation-more-help
experience-manager-cloud-service-help-main-toc