[AEM Assets]{class="badge positive" title="AEM Assetsに適用）。"}

Content Advisorのインストールとプロパティ content-advisor-installation-properties

Content Advisorは、Adobe以外（サードパーティ）のアプリケーションとの統合も可能で、Adobeのアプリケーションに留まらず、インテリジェントなアセット検索を実現します。 AIを活用した検索、コンテキストに応じたレコメンデーション、キャンペーン概要ベースの検索、Dynamic Media レンディションへのアクセス、コンテンツフラグメントの検索、フィルター、アセットメタデータなど、同じ豊富な機能セットをサードパーティ統合でサポートしています。

前提条件 prereqs

次の通信方法を確保する必要があります。

Content AdvisorのIMS認証ワークフローが必要な場合は、上記の前提条件を使用します。 または、IMS ワークフローで既に認証されている場合は、代わりに IMS 情報を追加できます。

インストール content-advisor-installation

Content Advisorは、ESM CDN （例：esm.sh/skypack）とUMD バージョンの両方で利用できます。

UMD バージョン​を使用しているブラウザー（推奨）：

<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>

<script>
  const { renderAssetSelector } = PureJSSelectors;
</script>

ESM CDN バージョン​を使用している import maps 対応ブラウザー：

<script type="module">
  import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>

ESM CDN バージョン​を使用している Deno/Webpack Module Federation：

import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'

Content Advisor プロパティ content-advisor-propertiess

コンテンツアドバイザーのプロパティを使用して、コンテンツアドバイザーのレンダリング方法をカスタマイズできます。 次の表に、Content Advisorのカスタマイズと使用に使用できるプロパティを示します。

handleSelection=(assets: Asset[])=> {…}

handleAssetSelection=（assets: Asset[]）=> {…}

ImsAuthProps ims-auth-props

ImsAuthProps プロパティは、Content AdvisorがimsTokenを取得するために使用する認証情報とフローを定義します。 これらのプロパティを設定すると、認証フローの動作を制御し、様々な認証イベントのリスナーを登録できます。

ImsAuthService ims-auth-service

ImsAuthService クラスは、Content Advisorの認証フローを処理します。 これは、Adobe IMS 認証サービスから imsToken を取得する役割を果たします。 imsToken は、ユーザーを認証し、Adobe Experience Manager as a Cloud Service アセットリポジトリへのアクセスを認証するために使用されます。 ImsAuthService は、ImsAuthProps プロパティを使用して認証フローを制御し、様々な認証イベントのリスナーを登録します。 便利なregisterAssetsSelectorsAuthService関数を使用して、ImsAuthService インスタンスをContent Advisorに登録できます。 ImsAuthService クラスでは、次の関数を使用できます。 ただし、registerAssetsSelectorsAuthService 関数を使用している場合は、これらの関数を直接呼び出す必要はありません。

contentFragmentSelectorProps content-fragment-selector-properties

contentFragmentSelectorPropsを使用すると、コンテンツアドバイザー内でコンテンツフラグメントにアクセスして表示する方法を設定できます。 featureSetでコンテンツフラグメント機能を有効にし、必要な設定を指定すると、コンテンツフラグメントの選択をアセットとシームレスに統合できます。 これにより、ユーザーは同じ統合インターフェイス内でコンテンツフラグメントを参照、検索、選択できるようになり、アセットや構造化されたコンテンツをまたいで、一貫性のあるコンテンツ選択エクスペリエンスを実現できます。

const assetSelectorProps = {
     featureSet: [
       'upload',            /* Include upload or other featureSet values to ensure no missing functionality */
       'content-fragments', /* Content Fragments pill will be shown */
     ],
     contentFragmentSelectorProps: {
       /* Configures the Content Fragments Pill experience */
       /* ...props @aem-sites/content-fragment-selector MFE supports */
    }
}

<AssetSelector {...assetSelectorProps} />

contentFragmentSelectorPropsでは、​ コンテンツフラグメントセレクターのプロパティ ​で利用可能なプロパティのいずれかをメンションできます。

Content AdvisorをAngular、React、およびJavaScript アプリケーションと統合する方法については、Content Advisorの統合例を参照してください。