AEMaaCS:無効なフラグメントが原因でコンテンツフラグメント公開APIが失敗する
✨ このコンテンツはAIが生成したもので、不正確である可能性があります。 生成AI用語
この記事では、AEM as a Cloud Service /adobe/sites/cf/fragments/publish APIを使用してコンテンツフラグメントを公開する際に、検証エラーが原因でフラグメントがパブリッシュツリーから削除される場合のエラーを解決する方法について説明します。
説明 description
環境
Adobe Experience Manager as a Cloud Service(AEMaaCS)、すべてのバージョン。
症状
/adobe/sites/cf/fragments/publish APIを使用してコンテンツフラグメントを公開しようとすると、フラグメントをプレビュー環境または公開環境にプッシュできません。 エラーログに次の警告が表示されます。
フラグメント ’
フラグメントは公開されず、それに依存するコンテンツページはレンダリングに失敗し、リリースの準備状況に影響を与える可能性があります。 この問題は、他のフラグメントまたはアセットを参照するフラグメントに固有です。 エラーは、検証に失敗したフィールドまたはルールを指定しません。 その他のフラグメントは、正常に公開されるか、「無効な参照」などの異なるメッセージで失敗する可能性があります。
原因
フラグメントは、文字制限の超過、無効な列挙値、必須フィールドの欠落、許可されていない参照モデルなど、1つ以上のフィールドレベルの問題により、コンテンツフラグメントモデルに対する検証に失敗しました。 パブリッシュワークフローは、パブリッシュツリーから無効なフラグメントを削除し、一貫性のないコンテンツのデプロイメントを防ぎます。
解決策 resolution
問題を解決するには、次の手順に従います。
-
オーサー環境で
/adobe/sites/cf/fragments/<fragment-uuid>へのGET リクエストを実行します。 -
検証に失敗したフィールドの詳細については、応答の
validationStatusセクションを参照してください。 -
または、コンテンツフラグメントエディターでフラグメントを開き、マスターバリエーションとすべてのバリエーションの両方で検証エラーを確認します。
-
次のようなフラグ付きフィールドに対応します。
- 1行のテキストフィールドが255文字を超えています(モデルで設定されていない場合のデフォルトの制限)。
– 現在のモデルで許可されていない値を含むドロップダウン(列挙)フィールド。
– 必須フィールドは、任意のバリエーションで空のままです。
-
モデルで許可されていない項目を含むフィールド。 - アセットまたはまたは画像パス。
-
モデル 5} - モデル 0000000000000000000000000000000000000000000000000000000000field.
– 現在のモデルで定義されなくなったフィールドデータ (例:モデル変更後)。
-
修正を行った後、フラグメントを保存します。
-
/adobe/sites/cf/fragments/publish APIまたはAEM UIを使用して、フラグメントを再公開します。
-
フラグメントがプレビュー/パブリッシュ環境で使用可能になり、依存コンテンツが期待どおりにレンダリングされることを確認します。