Usar microservicios de recursos y perfiles de procesamiento

Los microservicios de recursos proporcionan un procesamiento escalable y flexible de los recursos que utilizan aplicaciones nativas de la nube (también denominadas trabajadores). Adobe administra los servicios para una gestión óptima de los distintos tipos de recursos y opciones de procesamiento.

Los microservicios de recursos le permiten procesar una amplia gama de tipos de archivo que abarca más formatos predeterminados de lo que es posible con versiones anteriores de Experience Manager. Por ejemplo, la extracción en miniatura de los formatos PSD y PSB ahora es posible que antes se necesitaban soluciones de terceros como ImageMagick.

El procesamiento de recursos depende de la configuración de Procesamiento de perfiles. Experience Manager proporciona una configuración predeterminada básica y permite que los administradores agreguen una configuración de procesamiento de recursos más específica. Los administradores crean, mantienen y modifican las configuraciones de los flujos de trabajo posteriores al procesamiento, incluida la personalización opcional. La personalización de los flujos de trabajo permite a los desarrolladores ampliar la oferta predeterminada.

Una vista de alto nivel del

NOTA

El procesamiento de recursos descrito aquí reemplaza el modelo de flujo de trabajo DAM Update Asset que existe en las versiones anteriores de Experience Manager. La mayoría de los pasos estándar de generación de representación y relacionados con los metadatos se sustituyen por el procesamiento de los microservicios de recursos, y los pasos restantes, si los hay, se pueden sustituir por la configuración del flujo de trabajo posterior al procesamiento.

Comprender las opciones de procesamiento de recursos

Experience Manager permite los siguientes niveles de procesamiento.

Opción Descripción Casos de uso cubiertos
Configuración predeterminada Está disponible tal cual y no se puede modificar. Esta configuración proporciona una capacidad de generación de representaciones muy básica.
  • Miniaturas estándar utilizadas por la interfaz de usuario Assets (48, 140 y 319 píxeles)
  • Vista previa grande (representación web - 1280 píxeles)
  • Metadatos y extracción de texto.
Configuración personalizada Configurado por los administradores a través de la interfaz de usuario. Proporciona más opciones para la generación de representación ampliando la opción predeterminada. Amplíe la opción predeterminada para proporcionar diferentes formatos y representaciones.
  • Representación de FPO.
  • Cambiar el formato de archivo y la resolución de las imágenes
  • Se aplican condicionalmente a los tipos de archivo configurados.
Perfil personalizado Configurado por los administradores a través de la interfaz de usuario para utilizar código personalizado mediante aplicaciones personalizadas para llamar al Servicio de Asset compute. Admite requisitos más complejos en un método nativo de la nube y escalable. Consulte casos de uso permitidos.

Formatos de archivo compatibles

Los microservicios de recursos admiten una amplia variedad de formatos de archivo para procesar, generar representaciones o extraer metadatos. Consulte formatos de archivo compatibles para obtener una lista completa de los tipos MIME y la funcionalidad admitida para cada tipo.

Configuración predeterminada

Algunos valores predeterminados están preconfigurados para garantizar que estén disponibles las representaciones predeterminadas necesarias en Experience Manager. La configuración predeterminada también garantiza que las operaciones de extracción de metadatos y de extracción de texto estén disponibles. Los usuarios pueden empezar a cargar o actualizar recursos inmediatamente, y el procesamiento básico está disponible de forma predeterminada.

Con la configuración predeterminada, solo se configura el perfil de procesamiento más básico. Este perfil de procesamiento no está visible en la interfaz de usuario y no se puede modificar. Siempre se ejecuta para procesar los recursos cargados. Este perfil de procesamiento predeterminado garantiza que el procesamiento básico requerido por Experience Manager se complete en todos los recursos.

Configuración estándar

Experience Manager proporciona funciones para generar representaciones más específicas para formatos comunes según las necesidades del usuario. Un administrador puede crear Perfiles de procesamiento adicionales para facilitar la creación de dichas representaciones. A continuación, los usuarios asignan uno o más de los perfiles disponibles a carpetas específicas para realizar el procesamiento adicional. Por ejemplo, el procesamiento adicional puede generar representaciones para la web, móviles y tabletas. El siguiente vídeo ilustra cómo crear y aplicar Perfiles de procesamiento y cómo acceder a las representaciones creadas.

  • Anchura y altura de representación: La especificación de anchura y altura de representación proporciona tamaños máximos de la imagen de salida generada. Los microservicios de recursos intentan producir la representación más grande posible, cuya anchura y altura no son mayores que la anchura y la altura especificadas, respectivamente. Se conserva la relación de aspecto, la misma que la original. Un valor vacío significa que el procesamiento de recursos asume la dimensión de píxeles del original.

  • Reglas de inclusión de tipo MIME: Cuando se procesa un recurso con un tipo MIME específico, primero se comprueba el tipo MIME con el valor de tipos MIME excluidos para la especificación de representación. Si coincide con esa lista, esta representación específica no se genera para el recurso (lista de bloqueados). De lo contrario, el tipo MIME se compara con el tipo MIME incluido y, si coincide con la lista, se genera la representación (lista de permitidos).

  • Representación especial de FPO: Cuando se colocan recursos de gran tamaño Experience Manager en Adobe InDesign documentos, un profesional creativo espera un tiempo considerable después de colocar un recurso. Mientras tanto, el usuario no puede utilizar InDesign. Esto interrumpe el flujo creativo y afecta negativamente a la experiencia del usuario. Adobe permite colocar temporalmente representaciones de pequeño tamaño en documentos InDesign para empezar, que se pueden reemplazar con recursos de resolución completa bajo demanda más adelante. Experience Manager proporciona representaciones que se utilizan solo para la colocación (FPO). Estas representaciones de FPO tienen un tamaño de archivo pequeño, pero tienen la misma proporción de aspecto.

El perfil de procesamiento puede incluir una representación de FPO (solo para ubicación). Consulte Adobe Asset Link documentación para saber si debe activarla para su perfil de procesamiento. Para obtener más información, consulte Adobe Asset Link complete documentation.

Crear un perfil estándar

Para crear un perfil de procesamiento estándar, siga estos pasos:

  1. Los administradores acceden a Herramientas > Recursos > Perfiles de procesamiento. Haga clic en Crear.

  2. Proporcione un nombre que le ayude a identificar el perfil de forma única al aplicar a una carpeta.

  3. Para generar representaciones de FPO, en la pestaña Standard, habilite Crear representación de FPO. Introduzca un valor Quality entre 1 y 100.

  4. Para generar otras representaciones, haga clic en Agregar nuevo y proporcione la siguiente información:

    • Nombre de archivo de cada representación.
    • Formato de archivo (PNG, JPEG, GIF o WebP) de cada representación.
    • Anchura y altura en píxeles de cada representación. Si no se especifican los valores, se utiliza el tamaño de píxeles completo de la imagen original.
    • Calidad en porcentaje de cada representación JPEG y WebP.
    • Se han incluido y excluido tipos MIME para definir la aplicabilidad de un perfil.

    processing-profiles-adding

  5. Haga clic en Guardar.

Perfil personalizado y casos de uso

El Asset Compute Service admite una variedad de casos de uso, como el procesamiento predeterminado, el procesamiento de formatos específicos de Adobe, como archivos Photoshop, y la implementación de un procesamiento personalizado o específico de la organización. La personalización del flujo de trabajo de los recursos de actualización de DAM requerida en el pasado se gestiona automáticamente o mediante la configuración de perfiles de procesamiento. Si estas opciones de procesamiento no satisfacen las necesidades del negocio, Adobe recomienda desarrollar y utilizar Asset Compute Service para ampliar las funcionalidades predeterminadas. Para obtener una descripción general, consulte comprender la extensibilidad y cuándo utilizarla.

NOTA

Adobe recomienda utilizar una aplicación personalizada solo cuando los requisitos comerciales no se puedan cumplir con las configuraciones predeterminadas o el perfil estándar.

Puede transformar formatos de imagen, vídeo, documento y otros archivos en distintas representaciones, incluidas miniaturas, texto extraído y metadatos, y archivos.

Los desarrolladores pueden usar Asset Compute Service para crear aplicaciones personalizadas para los casos de uso admitidos. Experience Manager puede llamar a estas aplicaciones personalizadas desde la interfaz de usuario utilizando perfiles personalizados que los administradores configuran. Asset Compute Service admite los siguientes casos de uso de invocar servicios externos:

  • Utilice la Adobe Photoshop ImageCutout API y guarde el resultado como representación.
  • Llame a sistemas de terceros para actualizar datos, por ejemplo, un sistema PIM.
  • Utilice la API Photoshop para generar diversas representaciones basadas en la plantilla de Photoshop.
  • Utilice la API de Lightroom de Adobe para optimizar los recursos ingeridos y guardarlos como representaciones.
NOTA

No se pueden editar los metadatos estándar mediante las aplicaciones personalizadas. Solo se pueden modificar metadatos personalizados.

Crear un perfil personalizado

Para crear un perfil personalizado, siga estos pasos:

  1. Los administradores acceden a Herramientas > Recursos > Perfiles de procesamiento. Haga clic en Crear.

  2. Haga clic en la pestaña Personalizado. Haga clic en Agregar nuevo. Proporcione el nombre de archivo deseado para la representación.

  3. Proporcione la siguiente información.

    Haga clic en Guardar.

Las aplicaciones personalizadas son aplicaciones Project Firefly sin encabezado. La aplicación personalizada obtiene todos los archivos proporcionados si están configurados con un perfil de procesamiento. La aplicación debe filtrar los archivos.

ATENCIÓN

Si la aplicación Firefly y la cuenta Experience Manager no pertenecen a la misma organización, la integración no funciona.

Un ejemplo de perfil personalizado

Para ilustrar el uso del perfil personalizado, consideremos un caso de uso para aplicar texto personalizado a las imágenes de campaña. Puede crear un perfil de procesamiento que aproveche la API de Photoshop para editar las imágenes.

La integración del servicio de asset compute permite que el Experience Manager pase estos parámetros a la aplicación personalizada mediante el campo Service Parameters. A continuación, la aplicación personalizada llama a la API de Photoshop y pasa estos valores a la API. Por ejemplo, puede pasar el nombre de la fuente, el color del texto, el peso del texto y el tamaño del texto para agregar el texto personalizado a las imágenes de campaña.

custom-processing-profile

Figura: Utilice el campo Parámetros de servicio para pasar información añadida a los parámetros predefinidos incorporados en la aplicación personalizada. En este ejemplo, cuando se cargan imágenes de campaña, las imágenes se actualizan con Jumanji texto en Arial-BoldMT fuente.

Usar perfiles de procesamiento para procesar recursos

Cree y aplique perfiles de procesamiento personalizados adicionales a carpetas específicas para que el Experience Manager pueda procesar los recursos cargados o actualizados en estas carpetas. El perfil de procesamiento estándar predeterminado e integrado siempre se ejecuta, pero no es visible en la interfaz de usuario. Si agrega un perfil personalizado, ambos perfiles se utilizan para procesar los recursos cargados.

Aplique perfiles de procesamiento a las carpetas mediante uno de los métodos siguientes:

  • Los administradores pueden seleccionar una definición de perfil de procesamiento en Tools > Assets > Processing Profiles y utilizar la acción Apply Profile to Folder(s). Abre un navegador de contenido que le permite desplazarse a carpetas específicas, seleccionarlas y confirmar la aplicación del perfil.
  • Los usuarios pueden seleccionar una carpeta en la interfaz de usuario de Assets, utilizar la acción Properties para abrir la pantalla de propiedades de la carpeta, hacer clic en la pestaña Processing Profiles y, en la lista emergente, seleccionar el perfil de procesamiento adecuado para esa carpeta. Para guardar los cambios, haga clic en Guardar y cerrar.
    Aplicar perfil de procesamiento a una carpeta desde la ficha Propiedades del recurso
CONSEJO

Solo se puede aplicar un perfil de procesamiento a una carpeta. Para generar más representaciones, agregue más definiciones de representación al perfil de procesamiento existente.

Después de aplicar un perfil de procesamiento a una carpeta, todos los recursos nuevos cargados (o actualizados) en esta carpeta o en cualquiera de sus subcarpetas se procesan con el perfil de procesamiento adicional configurado. Este procesamiento se suma al perfil predeterminado estándar.

NOTA

Un perfil de procesamiento aplicado a una carpeta funciona para todo el árbol, pero se puede sobrescribir con otro perfil aplicado a una subcarpeta. Cuando los recursos se cargan en una carpeta, el Experience Manager comprueba si hay un perfil de procesamiento en las propiedades de la carpeta contenedora. Si no se aplica ninguno, se comprueba la existencia de un perfil de procesamiento en una carpeta principal de la jerarquía.

Para comprobar que los recursos se procesan, previsualice las representaciones generadas en la vista Representaciones en el carril izquierdo. Abra la vista previa del recurso y abra el carril izquierdo para acceder a la vista Representaciones. Las representaciones específicas del perfil de procesamiento, para las que el tipo de recurso específico coincide con las reglas de inclusión de tipo MIME, deben ser visibles y accesibles.

representaciones adicionales

Figura: Ejemplo de dos representaciones adicionales generadas por un perfil de procesamiento aplicado a la carpeta principal.

Flujos de trabajo posteriores al procesamiento

En un caso en el que se requiera un procesamiento adicional de los recursos que no se pueda lograr con los perfiles de procesamiento, se pueden añadir flujos de trabajo adicionales posteriores al procesamiento a la configuración. Esto permite agregar un procesamiento totalmente personalizado además del procesamiento configurable mediante microservicios de recursos.

Los flujos de trabajo posteriores al procesamiento, si están configurados, los ejecuta automáticamente Experience Manager una vez finalizado el procesamiento de los microservicios. No es necesario añadir los iniciadores de flujo de trabajo manualmente para almacenar en déclencheur los flujos de trabajo. Los ejemplos incluyen:

  • Pasos personalizados del flujo de trabajo para procesar recursos.
  • Integraciones para agregar metadatos o propiedades a recursos de sistemas externos, por ejemplo, información de productos o procesos.
  • Procesamiento adicional realizado por servicios externos.

Para agregar una configuración de flujo de trabajo posterior al procesamiento a Experience Manager, siga estos pasos:

  • Cree uno o varios modelos de flujo de trabajo. Estos modelos personalizados se denominan modelos de flujo de trabajo posteriores al procesamiento en esta documentación. Estos son modelos de flujo de trabajo Experience Manager normales.
  • Añada los pasos de flujo de trabajo necesarios a estos modelos. Revise los pasos del flujo de trabajo predeterminado y añada todos los pasos predeterminados necesarios al flujo de trabajo personalizado. Los pasos se ejecutan en los recursos en función de una configuración de modelo de flujo de trabajo. Por ejemplo, si desea que el etiquetado inteligente se produzca automáticamente al cargar los recursos, agregue el paso al modelo de flujo de trabajo personalizado posterior al procesamiento.
  • Agregue el paso DAM Update Asset Workflow completado del proceso al final. Añadir este paso garantiza que el Experience Manager sepa cuándo termina el procesamiento y el recurso se puede marcar como procesado, es decir, que New se muestra en el recurso.
  • Cree una configuración para el Servicio de ejecución de flujo de trabajo personalizado que permita configurar la ejecución de un modelo de flujo de trabajo posterior al procesamiento mediante una ruta (ubicación de carpeta) o una expresión regular.

Creación de modelos de flujo de trabajo posteriores al procesamiento

Los modelos de flujo de trabajo posteriores al procesamiento son modelos de flujo de trabajo Experience Manager normales. Cree diferentes modelos si necesita un procesamiento diferente para diferentes ubicaciones de repositorios o tipos de recursos.

Los pasos de procesamiento deben agregarse según las necesidades. Puede utilizar los pasos admitidos disponibles, así como cualquier paso de flujo de trabajo personalizado.

Asegúrese de que el último paso de cada flujo de trabajo posterior al procesamiento sea DAM Update Asset Workflow Completed Process. El último paso ayuda a garantizar que el Experience Manager sepa cuándo se completa el procesamiento de recursos.

Configurar la ejecución del flujo de trabajo posterior al procesamiento

Para configurar los modelos de flujo de trabajo posteriores al procesamiento para que se ejecuten en los recursos cargados o actualizados en el sistema después de que termine el procesamiento de los microservicios de recursos, es necesario configurar el servicio de ejecución de flujo de trabajo personalizado.

El Adobe CQ DAM Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) es un servicio OSGi y proporciona dos opciones de configuración:

  • Flujos de trabajo posteriores al procesamiento por ruta (postProcWorkflowsByPath): Se pueden enumerar varios modelos de flujo de trabajo basados en diferentes rutas de repositorio. Las rutas y los modelos deben separarse con dos puntos. Las rutas de repositorio simples son compatibles y deben asignarse a un modelo de flujo de trabajo en la ruta /var . Por ejemplo: /content/dam/my-brand:/var/workflow/models/my-workflow.
  • Flujos de trabajo posteriores al procesamiento por expresión (postProcWorkflowsByExpression): Se pueden enumerar varios modelos de flujo de trabajo basados en diferentes expresiones regulares. Las expresiones y los modelos deben separarse con dos puntos. La expresión regular debe señalar directamente al nodo Asset y no a una de las representaciones o archivos. Por ejemplo: /content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow.
NOTA

La configuración de Custom Workflow Runner es una configuración de un servicio OSGi. Consulte implementar en Experience Manager para obtener información sobre cómo implementar una configuración OSGi.
La consola web OSGi, a diferencia de las implementaciones de servicios locales y administrados de Experience Manager, no está disponible directamente en las implementaciones de servicios en la nube.

Para obtener más información sobre qué paso de flujo de trabajo estándar se puede utilizar en el flujo de trabajo posterior al procesamiento, consulte pasos de flujo de trabajo en flujo de trabajo posterior al procesamiento en la referencia del desarrollador.

Prácticas recomendadas y limitaciones

  • Tenga en cuenta sus necesidades para todos los tipos de representaciones al diseñar flujos de trabajo. Si no prevé la necesidad de una representación en el futuro, elimine su paso de creación del flujo de trabajo. Las representaciones no se pueden eliminar de forma masiva posteriormente. Las representaciones no deseadas pueden ocupar mucho espacio de almacenamiento después de un uso prolongado de Experience Manager. Para recursos individuales, puede eliminar las representaciones manualmente desde la interfaz de usuario. Para varios recursos, puede personalizar Experience Manager para eliminar representaciones específicas o eliminar los recursos y volver a cargarlos.
  • Actualmente, la compatibilidad se limita a la generación de representaciones. No se admite la generación de recursos nuevos.
  • Actualmente, el límite de tamaño de archivo para la extracción de metadatos es de aproximadamente 10 GB. Al cargar recursos muy grandes, a veces se produce un error en la operación de extracción de metadatos.

En esta página