Skip to main content
Adobe Experience Manager(AEM)アカウントを接続すると、Profound Agents で次のノードが利用できるようになります。これらのノードを使用して、AEM の Content Fragment を検索、読み取り、作成、更新できます。すべての操作は接続された AEM Author 環境に対して実行され、OAuth 認証情報のテクニカルアカウントに割り当てられた権限が使用されます。

利用可能なノード

List Content Fragments

接続された Author 環境から Content Fragment を取得します。

必須の入力

  • AEM Instance — 接続された Author 環境

任意の入力

  • Folder — 一覧を /content/dam 配下の承認済みフォルダーに限定します
  • References — リンクされたフラグメントを返すかどうか、またハイドレートするかどうかを制御します
  • Limit — 返す結果の数。デフォルトは 25、最大は 50 です
  • Cursor — 前の List ノードまたは Search ノードの出力に含まれるページネーションカーソル。次のページの結果を取得するために使用します
  • Projection — 概要データのみが必要な場合は summary を使用します

出力

出力には、条件に一致する Content Fragment と、さらに結果がある場合は次のページ用のページネーションカーソルが含まれます。

主な概念

AEM Instance

接続された AEM Author 環境です。モデル、フォルダー、フラグメントを選択する前に選択してください。

Content Fragment Model

フラグメントのフィールド、型、必須値、許可されるコンテンツを定義する AEM のスキーマです。モデルは有効化されており、保存先フォルダーのポリシーで許可されている必要があります。

DAM パス

Content Fragment のフォルダーには、/content/dam 配下のリポジトリパスが使用されます。Profound が読み取りや変更を行えるコンテンツは、フォルダーの権限とポリシーによって制御されます。

Content Fragment ID

AEM API の操作では、Content Fragment を UUID で識別します。Profound のピッカーは検索可能なフラグメント情報を表示し、UUID をノードに渡します。

ETag

ETag は、Content Fragment のデータの特定バージョンを示す一意の識別子です。Get Content Fragment ノードから Update Content Fragment ノードに ETag を渡すことで、フラグメントの読み取り後に行われた変更をワークフローが気付かないうちに上書きしてしまうことを防げます。

ページネーション

List ノードと Search ノードは、1 回のリクエストにつき最大 50 件のフラグメントを返します。出力にカーソルが含まれている場合は、それを次の List ノードまたは Search ノードに渡して、次のページの結果を取得します。

ハイドレートされた Content Fragment

基本的な ID や URL だけでなく、すべてのフィールド値を含む Content Fragment です。

References

References は、リンクされたフラグメントをどのように含めるかを制御します。ハイドレートモードやすべての参照を含むモードでは、レスポンスが大きくなる可能性があるため、ワークフローでリンクされたコンテンツが必要な場合にのみ使用してください。

トラブルシューティング

フォルダー、フラグメント、モデルのピッカーが無効または空になっている

最初に AEM Instance を選択してください。それでもピッカーが空の場合は、OAuth 認証情報のテクニカルアカウントが該当するモデル、フォルダー、フラグメントを読み取れることを確認してください。詳しくはセットアップのトラブルシューティングガイドをご覧ください。

検索で無効なクエリのエラーが返される

Folder フィルターを /content/dam に戻すか、別のフィルターを追加してください。Raw Query を使用する場合は、空でない JSON オブジェクトを指定し、Adobe がサポートするフィルターフィールドと並べ替えフィールドを使用してください。

Create ノードが不明なフィールドまたは無効な値を報告する

可能な場合は、モデルを選択して Structured 形式を使用してください。Raw JSON 形式を使用する必要がある場合は、各キーが AEM モデルのフィールド名と一致していることを確認し、モデルが想定する型と多重度の値を指定してください。

Update ノードが変更なしと報告する

Title、Description、またはモデルのフィールド値を少なくとも 1 つ入力してください。空の入力では現在のコンテンツが維持されます。

Update ノードが競合を報告する

AEM が ETag を発行した後にフラグメントが変更されています。Get Content Fragment ノードを再度実行し、最新のコンテンツを確認してから、新しい ETag を使用して更新を適用してください。

ノードが権限エラーを返す

テクニカルアカウントのサービスグループに、その操作と DAM パスに対する権限があることを確認してください。読み取りアクセスは成功しても、Create や Update がブロックされたままになる場合があります。AEM 環境内の特定のフォルダーやファイルに権限を追加するには、Adobe の Product Profile and Services user group permission management ガイドに従ってください。

結果の最初のページしか返されない

List ノードまたは Search ノードが返したカーソルを、次のリクエストの Cursor として使用してください。各ページに含まれる結果は最大 50 件です。

関連リソース