Intégration de Dynamic Media aux fonctionnalités OpenAPI integrate-asset-selector-dynamic-media-open-apis

Le sélecteur de ressources vous permet de les intégrer à l’aide de diverses applications Adobe afin de leur permettre de travailler ensemble en toute transparence.

Prérequis prereqs-polaris

Utilisez les conditions préalables suivantes si vous intégrez le sélecteur de ressources à Dynamic Media avec des fonctionnalités OpenAPI :

Intégration de Dynamic Media aux fonctionnalités OpenAPI adobe-app-integration-polaris

L’intégration du sélecteur de ressources avec le processus OpenAPI Dynamic Media implique différentes étapes, notamment la création d’une URL Dynamic Media personnalisée ou l’obtention d’une URL Dynamic Media prête à être sélectionnée, etc.

Intégrer le sélecteur de ressources pour Dynamic Media aux fonctionnalités OpenAPI integrate-dynamic-media

Les propriétés rootPath et path ne doivent pas faire partie de Dynamic Media avec les fonctionnalités OpenAPI. Vous pouvez plutôt configurer la propriété aemTierType . Voici la syntaxe de la configuration :

aemTierType:[1: "delivery"]

Cette configuration vous permet d’afficher toutes les ressources approuvées sans dossiers ou sous la forme d’une structure plate. Pour plus d’informations, accédez à aemTierType propriété sous Propriétés du sélecteur de ressources.

Création d’une URL de diffusion dynamique à partir de ressources approuvées create-dynamic-media-url

Une fois que vous avez configuré le sélecteur de ressources, un schéma d’objets est utilisé pour créer une URL de diffusion dynamique à partir des ressources sélectionnées.
Par exemple, le schéma d’un objet d’un tableau d’objets reçu lors de la sélection d’une ressource :

{
"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",
...
}

Toutes les ressources sélectionnées sont transportées par handleSelection fonction qui agit comme un objet JSON. Par exemple, JsonObj. L’URL de diffusion dynamique est créée en combinant les opérateurs ci-dessous :

Spécification de l’API de diffusion des ressources approuvées approved-assets-delivery-api-specification

Format de l'URL :
https://<delivery-api-host>/adobe/assets/<asset-id>/as/<seo-name>.<format>?<image-modification-query-parameters>

Où,

API de diffusion de rendu d’origine des ressources approuvées approved-assets-delivery-api

L’URL de diffusion dynamique possède la syntaxe suivante :
https://<delivery-api-host>/adobe/assets/<asset-id>/original/as/<seo-name>, où,

Prêt à choisir l’URL de diffusion dynamique ready-to-pick-dynamic-delivery-url

Toutes les ressources sélectionnées sont transportées par handleSelection fonction qui agit comme un objet JSON. Par exemple, JsonObj. L’URL de diffusion dynamique est créée en combinant les opérateurs ci-dessous :

Vous trouverez ci-dessous les deux façons de parcourir l’objet JSON :

Dans la capture d’écran ci-dessus, l’URL de diffusion du rendu original PDF doit être incorporée dans l’expérience cible si PDF est requis, et non sa miniature. Par exemple, https://delivery-pxxxxx-exxxxx.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/original/as/algorithm design.pdf.

Configuration de filtres personnalisés configure-custom-filters-dynamic-media-open-api

Le sélecteur de ressources pour Dynamic Media avec les fonctionnalités OpenAPI vous permet de configurer des propriétés personnalisées et des filtres basés sur celles-ci. La propriété filterSchema est utilisée pour configurer ces propriétés. La personnalisation peut être exposée en tant que metadata.<metadata bucket>.<property name>. par rapport auxquelles les filtres peuvent être configurés, où,

Pour la configuration, les propriétés définies au niveau de l’jcr:content/metadata/ sont exposées comme metadata.<metadata bucket>.<property name>. pour les filtres que vous souhaitez configurer.

Par exemple, dans le sélecteur de ressources pour Dynamic Media avec les fonctionnalités OpenAPI , une propriété sur asset jcr:content/metadata/client_name:market est convertie en metadata.embedded.client_name:market pour la configuration des filtres.

Pour obtenir le nom, une activité unique doit être effectuée. Effectuez un appel API de recherche pour la ressource et obtenez le nom de la propriété (le compartiment, essentiellement).

Interface utilisateur du sélecteur de ressources pour Dynamic Media avec les fonctionnalités OpenAPI interface-dynamic-media-open-api

Après l’intégration au sélecteur de ressources micro front-end d’Adobe, vous ne pouvez voir que la structure de toutes les ressources approuvées disponibles dans le référentiel de ressources Experience Manager.