OpenAPI 機能を備えた Dynamic Media の統合 integrate-asset-selector-dynamic-media-open-apis

アセットセレクターを使用すると、様々なアドビアプリケーションを統合して、シームレスに連携できます。

前提条件 prereqs-polaris

アセットセレクターと、OpenAPI 機能を備えた Dynamic Media の統合には、次の前提条件を使用します。

OpenAPI 機能を備えた Dynamic Media の統合 adobe-app-integration-polaris

アセットセレクターと Dynamic Media OpenAPI プロセスの統合には、カスタマイズされた Dynamic Media URL の作成や、Dynamic Media URL を選択する準備など、様々な手順が含まれます。

OpenAPI 機能を備えた Dynamic Media とのアセットセレクターの統合 integrate-dynamic-media

OpenAPI 機能を備えた Dynamic Media では、rootPath プロパティと path プロパティを使用しないでください。代わりに、aemTierType プロパティを設定できます。設定の構文を以下に示します。

aemTierType:[1: "delivery"]

この設定により、すべての承認済みアセットをフォルダーなしで表示したり、フラットな構造として表示したりできます。詳しくは、アセットセレクターのプロパティの aemTierType プロパティを参照してください。

承認済みアセットからの動的配信 URL の作成 create-dynamic-media-url

アセットセレクターを設定すると、オブジェクトのスキーマを使用して、選択したアセットから動的配信 URL が作成されます。
例えば、アセットの選択時に受信されるオブジェクトの配列からの 1 つのオブジェクトのスキーマは次のようになります。

{
"dc:format": "image/jpeg",
"repo:assetId": "urn:aaid:aem:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"repo:name": "image-7.jpg",
"repo:repositoryId": "delivery-pxxxx-exxxxxx.adobe.com",
...
}

すべての選択済みアセットは、JSON オブジェクトとして機能する handleSelection 関数によって実行されます。例えば、JsonObj のようになります。動的配信 URL は、以下のキャリアを組み合わせて作成されます。

承認済みアセット配信 API 仕様 approved-assets-delivery-api-specification

URL 形式：
https://<delivery-api-host>/adobe/dynamicmedia/deliver/<asset-id>/<seo-name>.<format>?<image-modification-query-parameters>

ここで、

承認済みアセット配信 API approved-assets-delivery-api

動的配信 URL の構文は次のとおりです。
https://<delivery-api-host>/adobe/assets/deliver/<asset-id>/<seo-name>、ここで、

動的配信 URL を選択する準備の完了 ready-to-pick-dynamic-delivery-url

すべての選択済みアセットは、JSON オブジェクトとして機能する handleSelection 関数によって実行されます。例えば、JsonObj のようになります。動的配信 URL は、以下のキャリアを組み合わせて作成されます。

JSON オブジェクトをトラバースする 2 つの方法を以下に示します。

上記のスクリーンショットでは、PDF が必要でサムネールは不要な場合は、PDF の元のレンディションの配信 URL をターゲットエクスペリエンスに組み込む必要があります。例えば、https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/original/as/algorithm design.pdf?accept-experimental=1 のように指定します。

カスタムフィルターの設定 configure-custom-filters-dynamic-media-open-api

OpenAPI 機能を備えた Dynamic Media のアセットセレクターを使用すると、カスタムプロパティとそれに基づくフィルターを設定できます。このようなプロパティを設定するには、filterSchema プロパティを使用します。カスタマイズは、metadata.<metadata bucket>.<property name>. として公開され、それに対してフィルターを設定できます。ここで、

設定では、jcr:content/metadata/ レベルで定義されているプロパティが、設定するフィルターの metadata.<metadata bucket>.<property name>. として公開されます。

例えば、OpenAPI 機能を備えた Dynamic Media のアセットセレクターでは、フィルター設定のために asset jcr:content/metadata/client_name:market のプロパティが metadata.embedded.client_name:market に変換されます。

名前を取得するには、1 回限りのアクティビティを実行する必要があります。アセットの検索 API 呼び出しを行って、プロパティ名（基本的にはバケット）を取得します。

OpenAPI 機能を備えた Dynamic Media のアセットセレクターのユーザーインターフェイス interface-dynamic-media-open-api

アドビのマイクロフロントエンドアセットセレクターと統合すると、Experience Manager アセットリポジトリで使用可能なすべての承認済みアセットの、アセットのみの構造を表示できます。