Uso de 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 un amplia gama de tipos de archivo cubre más formatos predeterminados de los posibles Experience Manager. Por ejemplo, la extracción en miniatura de los formatos PSD y PSB ahora es posible, pero anteriormente se requieren soluciones de terceros como ImageMagick.

El procesamiento de recursos depende de la configuración de Perfiles de procesamiento. 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 procesamiento de recursos

NOTA

El procesamiento de recursos descrito aquí reemplaza a la variable DAM Update Asset modelo de flujo de trabajo 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 Assets interfaz de usuario (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 a través de aplicaciones personalizadas para llamar a 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 la lista completa de 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 completa 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 para facilitar la creación de dicha representación. 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: Al colocar recursos de gran tamaño desde Experience Manager into Adobe InDesign documentos, un profesional creativo espera un tiempo considerable después de colocar un recurso. Mientras tanto, se bloquea el uso del usuario InDesign. Esto interrumpe el flujo creativo y afecta negativamente a la experiencia del usuario. Adobe permite colocar temporalmente representaciones de tamaño pequeño en InDesign para empezar, que se pueden sustituir por activos 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 activarlo para su perfil de procesamiento. Para obtener más información, consulte Adobe Documentación completa de Asset Link.

Creación de un perfil estándar

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

  1. Acceso de los administradores 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 sección Imagen ficha, habilitar Crear representación de FPO. Entrada a Calidad 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 JPEG y representación 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

La variable 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 comerciales, Adobe recomienda desarrollar y usar Asset Compute Service para ampliar las funciones 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 utilizar el Asset Compute Service a 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:

  • Uso Adobe Photoshop's API de ImageCutout y guarde el resultado como representación.
  • Llame a sistemas de terceros para actualizar datos, por ejemplo, un sistema PIM.
  • Uso Photoshop API para generar diversas representaciones basadas en la plantilla de Photoshop.
  • Uso API de Adobe Lightroom para optimizar los recursos ingestados 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. Acceso de los administradores Herramientas > Recursos > Perfiles de procesamiento. Haga clic en Crear.

  2. Haga clic en Personalizado pestaña . 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 no tienen encabezado Proyecto Firefly aplicaciones. 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.

PRECAUCIÓN

Si la aplicación Firefly y Experience Manager no son de la misma organización, la integración no funciona.

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 Parámetros de servicio campo . 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: Uso Parámetros de servicio para pasar información añadida a parámetros predefinidos integrados 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.

Uso de 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 Herramientas > Recursos > Perfiles de procesamiento y utilice Aplicar perfil a carpetas acción. 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 y utilizar Propiedades acción para abrir la pantalla de propiedades de la carpeta, haga clic en el botón Procesamiento de recursos y en la Perfil de procesamiento seleccione 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

  • Los usuarios pueden seleccionar carpetas o recursos específicos en la interfaz de usuario de Assets para aplicar un perfil de procesamiento y, a continuación, seleccionar icono de reprocesamiento de recursos Volver a procesar recursos en las opciones disponibles en la parte superior.

SUGERENCIA

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 han procesado, previsualice las variantes de representación generadas en la Representaciones en el carril izquierdo. Abra la vista previa del recurso y abra el carril izquierdo para acceder al Representaciones vista. 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. El procesamiento posterior le permite añadir un procesamiento completamente personalizado además del procesamiento configurable mediante los microservicios de recursos.

Flujos de trabajo posteriores al procesamiento o Flujo de trabajo de inicio automático, si está configurado, se ejecutan automáticamente por 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 añadir 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 habituales Experience Manager modelos de flujo de trabajo.
  • 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.
  • Agregar Flujo de trabajo de recursos de actualización DAM completado 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, Nuevo 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.

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 del flujo de trabajo en el flujo de trabajo posterior al procesamiento en la referencia del desarrollador.

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

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

Los pasos de procesamiento se añaden según sea necesario. Puede utilizar ambos, los pasos admitidos que están 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

Una vez que los microservicios de recursos completan el procesamiento de los recursos cargados, puede definir el flujo de trabajo posterior al procesamiento para procesar los recursos. Para configurar el posprocesamiento mediante modelos de flujo de trabajo, puede realizar una de las siguientes acciones:

Aplicación de un modelo de flujo de trabajo a una carpeta

Para casos de uso típicos posteriores al procesamiento, considere la posibilidad de utilizar el método para aplicar un flujo de trabajo a una carpeta. Aplicación de un modelo de flujo de trabajo en la carpeta Propiedades, siga estos pasos:

  1. Cree un modelo de flujo de trabajo.

  2. Seleccione una carpeta, haga clic en Propiedades en la barra de herramientas y, a continuación, haga clic en Procesamiento de recursos pestaña .

  3. En Flujo de trabajo de inicio automático, seleccione el flujo de trabajo necesario, proporcione un título para el flujo de trabajo y, a continuación, guarde los cambios.

    Aplicación de un flujo de trabajo posterior al procesamiento a una carpeta en sus propiedades

Configurar el servicio Workflow Runner personalizado

Puede configurar el servicio de ejecución de flujo de trabajo personalizado para las configuraciones avanzadas que no se pueden cumplir fácilmente aplicando un flujo de trabajo a una carpeta. Por ejemplo, un flujo de trabajo que utiliza una expresión regular. El ejecutor de flujo de trabajo personalizado de Adobe CQ DAM (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) es un servicio OSGi. Proporciona las dos opciones de configuración siguientes:

  • Flujos de trabajo posteriores al procesamiento por ruta (postProcWorkflowsByPath): Se pueden enumerar varios modelos de flujo de trabajo basados en diferentes rutas de repositorio. Separe las rutas y los modelos utilizando dos puntos. Se admiten rutas de repositorio simples. Asigne estos elementos a un modelo de flujo de trabajo en la variable /var ruta. 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.

Para saber cómo implementar una configuración OSGi, consulte implementar a Experience Manager.

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

Cuando no sea necesario posprocesar, cree y utilice un modelo de flujo de trabajo "vacío" en la Flujo de trabajo de inicio automático selección.

Creación del modelo de flujo de trabajo de inicio automático desactivado
  1. Vaya a Herramientas > Flujo de trabajo > Modelos
  2. Select Crear > Crear modelo desde la barra de acciones superior
  3. Proporcione un título y un nombre para el nuevo modelo de flujo de trabajo, por ejemplo:
    • Título: Desactivar flujo de trabajo de inicio automático
    • Nombre: disable-auto-start-workflow
  4. Select Listo para crear el modelo de flujo de trabajo
  5. Select y Editar el modelo de flujo de trabajo recién creado
  6. En el editor Modelo de flujo de trabajo, seleccione Paso 1 de la definición del modelo y elimínelo
  7. Abra el Panel lateral y seleccione Pasos
  8. Arrastre el Flujo de trabajo de recursos de actualización de DAM completado paso a la definición del modelo
  9. Seleccione el Información de la página (junto al botón Panel lateral alternar) y seleccionar Abrir propiedades
  10. En el Básico , seleccione Flujo de trabajo transitorio
  11. Select Guardar y cerrar desde la barra de acciones superior
  12. Select Sincronización en la barra de acciones superior
  13. Cierre del editor del modelo de flujo de trabajo
Aplicar el modelo de flujo de trabajo de inicio automático desactivado

Siga los pasos descritos en aplicación de un modelo de flujo de trabajo a una carpeta y establezca la variable Desactivar flujo de trabajo de inicio automático como el Flujo de trabajo de inicio automático para las carpetas no es necesario posprocesar los recursos.

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 variantes de representación no deseadas pueden ocupar mucho espacio de almacenamiento tras el 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 15 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