DocumentaciónAEM as a Cloud ServiceGuía del usuario

Integración de Dynamic Media con funciones de OpenAPI integrate-asset-selector-dynamic-media-open-apis

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Administrador
  • Usuario
Prácticas recomendadas de búsqueda
Prácticas recomendadas de metadatos
Centro de contenido
Dynamic Media con funciones OpenAPI
Documentación para desarrolladores de AEM Assets

El Selector de recursos le permite integrarse utilizando varias aplicaciones de Adobe para permitirles trabajar juntos sin problemas.

Requisitos previos prereqs-polaris

Utilice los siguientes requisitos previos si integra el Selector de recursos con Dynamic Media con las funciones de OpenAPI:

  • Métodos de comunicación

  • Para acceder a Dynamic Media con las funciones de OpenAPI, debe tener licencias para:

    • Repositorio de Assets (por ejemplo, Experience Manager Assets as a Cloud Service).
    • AEM Dynamic Media.

  • Solo hay recursos aprobados disponibles para usar, lo que garantiza la coherencia de la marca.

Integración de Dynamic Media con funciones de OpenAPI adobe-app-integration-polaris

La integración del Selector de recursos con el proceso OpenAPI de Dynamic Media implica varios pasos que incluyen la creación de una URL de medios dinámicos personalizada o una URL lista para elegir, etc.

Integre el Selector de recursos para Dynamic Media con las funciones de OpenAPI integrate-dynamic-media

Las propiedades rootPath y path no deben formar parte de Dynamic Media con capacidades OpenAPI. En su lugar, puede configurar la propiedad aemTierType. A continuación se muestra la sintaxis de la configuración:

aemTierType:[1: "delivery"]

Esta configuración le permite ver todos los recursos aprobados sin carpetas o como una estructura plana. Para obtener más información, vaya a la propiedad aemTierType en Propiedades del selector de recursos.

Creación de una URL de envío dinámico a partir de recursos aprobados create-dynamic-media-url

Una vez configurado el Selector de recursos, se utiliza un esquema de objetos para crear una URL de envío dinámico a partir de los recursos seleccionados.
Por ejemplo, un esquema de un objeto de una matriz de objetos que se recibe al seleccionar un recurso:

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

La función handleSelection que actúa como objeto JSON lleva todos los recursos seleccionados. Por ejemplo, JsonObj. La URL de envío dinámico se crea combinando los siguientes operadores:

Objeto
JSON
Host
assetJsonObj["repo:repositoryId"]
Raíz API
/adobe/dynamicmedia/deliver
asset-id
assetJsonObj["repo:assetId"]
seo-name
assetJsonObj["repo:name"].split(".").slice(0,-1).join(".")
formato
.jpg

Especificación de API de entrega de recursos aprobados approved-assets-delivery-api-specification

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

Donde,

  • El host es https://delivery-pxxxxx-exxxxxx.adobe.com
  • La raíz de API es "/adobe/dynamicmedia/deliver"
  • <asset-id> es el identificador del recurso
  • <seo-name> es el nombre de un recurso
  • <format> es el formato de salida
  • <image modification query parameters> es compatible con la especificación de API de entrega de recursos aprobados

API de entrega de recursos aprobada approved-assets-delivery-api

La dirección URL de envío dinámico tiene la siguiente sintaxis:
https://<delivery-api-host>/adobe/assets/deliver/<asset-id>/<seo-name>, donde,

  • El host es https://delivery-pxxxxx-exxxxxx.adobe.com
  • La raíz de la API para la entrega de la representación original es "/adobe/assets/deliver"
  • <asset-id> es el identificador de recurso
  • <seo-name> es el nombre del recurso que puede tener o no una extensión

Listo para elegir la URL de envío dinámico ready-to-pick-dynamic-delivery-url

La función handleSelection que actúa como objeto JSON lleva todos los recursos seleccionados. Por ejemplo, JsonObj. La URL de envío dinámico se crea combinando los siguientes operadores:

Objeto
JSON
Host
assetJsonObj["repo:repositoryId"]
Raíz API
/adobe/assets/deliver
asset-id
assetJsonObj["repo:assetId"]
seo-name
assetJsonObj["repo:name"]

A continuación se muestran las dos formas de atravesar el objeto JSON:

URL de envío dinámico

  • Miniatura: Las miniaturas pueden ser imágenes y recursos de PDF, vídeo, imágenes, etc. Sin embargo, puede utilizar los atributos de altura y anchura de la miniatura de un recurso como representación de envío dinámico.
    Se puede utilizar el siguiente conjunto de representaciones para los recursos de tipo PDF:
    Una vez que se selecciona un pdf en la barra de tareas, el contexto de selección ofrece la siguiente información. A continuación se muestra la forma de atravesar el objeto JSON:

    Puede hacer referencia a selection[0].....selection[4] para la matriz de vínculos de representación desde la captura de pantalla anterior. Por ejemplo, las propiedades clave de una de las representaciones de miniaturas incluyen:

    code language-none 
    {
    "height": 319,
    "width": 319,
    "href": "https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/as/algorithm design.jpg?accept-experimental=1&width=319&height=319&preferwebp=true",
    "type": "image/webp"
}

En la captura de pantalla anterior, la dirección URL de entrega de la representación original del PDF debe incorporarse a la experiencia de destino si se requiere PDF y no su miniatura. Por ejemplo, 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

  • Vídeo: Puede usar la URL del reproductor de vídeo para los recursos de tipo de vídeo que usan un iFrame incrustado. Puede utilizar las siguientes representaciones de matrices en la experiencia de Target:

    code language-none 
    {
    "height": 319,
    "width": 319,
    "href": "https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/as/asDragDrop.2.jpg?accept-experimental=1&width=319&height=319&preferwebp=true",
    "type": "image/webp"
}

    Puede hacer referencia a selection[0].....selection[4] para la matriz de vínculos de representación desde la captura de pantalla anterior. Por ejemplo, las propiedades clave de una de las representaciones de miniaturas incluyen:

    El fragmento de código de la captura de pantalla anterior es un ejemplo de un recurso de vídeo. Incluye la matriz de vínculos de representaciones. El selection[5] del extracto es el ejemplo de una miniatura de imagen que puede utilizarse como marcador de posición de una miniatura de vídeo en la experiencia de destino. selection[5] en la matriz de representaciones es para el reproductor de vídeo. Esto sirve a un HTML y se puede establecer como src del iframe. Admite flujo de velocidad de bits adaptable, que es una entrega del vídeo optimizada para la web.

    En el ejemplo anterior, la dirección URL del reproductor de vídeo es https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/play?accept-experimental=1

Configuración de filtros personalizados configure-custom-filters-dynamic-media-open-api

El Selector de recursos para Dynamic Media con capacidades OpenAPI le permite configurar propiedades personalizadas y los filtros basados en ellas. La propiedad filterSchema se usa para configurar dichas propiedades. La personalización puede exponerse como metadata.<metadata bucket>.<property name>., en función de la cual se pueden configurar los filtros, donde,

  • metadata es la información de un recurso
  • embedded es el parámetro estático utilizado para la configuración, y
  • <propertyname> es el nombre de filtro que está configurando

Para la configuración, las propiedades definidas en el nivel jcr:content/metadata/ se exponen como metadata.<metadata bucket>.<property name>. para los filtros que desea configurar.

Por ejemplo, en el Selector de recursos para Dynamic Media con capacidades OpenAPI, una propiedad de asset jcr:content/metadata/client_name:market se convierte en metadata.embedded.client_name:market para la configuración de filtros.

Para obtener el nombre, se debe realizar una actividad única. Realice una llamada a la API de búsqueda para el recurso y obtenga el nombre de la propiedad (el contenedor, en esencia).

Interfaz de usuario del Selector de recursos para Dynamic Media con funciones de OpenAPI interface-dynamic-media-open-api

Después de la integración con el selector de recursos de Micro-Front-end del Adobe, podrá ver la estructura de recursos solamente de todos los recursos aprobados disponibles en el repositorio de recursos de Experience Manager.

Dynamic Media con la interfaz de usuario de funciones OpenAPI

Related Articles
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab