Uso de microservicios de recursos y perfiles de procesamiento get-started-using-asset-microservices
Los microservicios de recursos proporcionan un procesamiento escalable y flexible de los recursos mediante aplicaciones nativas de la nube (también denominadas trabajadores). Adobe administra los servicios para un manejo óptimo de diferentes tipos de recursos y opciones de procesamiento.
Los microservicios de recursos le permiten procesar una amplia gama de tipos de archivos que cubren más formatos listos para usar que los posibles de las versiones anteriores de Experience Manager. Por ejemplo, ahora es posible extraer miniaturas de los formatos PSD y PSB, pero se requerían 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 configuraciones de procesamiento de recursos más específicas. Los administradores crean, mantienen y modifican las configuraciones de 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.
DAM Update Asset modelo de flujo de trabajo que existe en versiones anteriores de Experience Manager. La mayoría de los pasos estándar relacionados con la generación de representaciones y los metadatos se sustituyen por el procesamiento de microservicios de recursos y los pasos restantes, si los hay, se pueden reemplazar por la configuración del flujo de trabajo posterior al procesamiento.Comprender las opciones de procesamiento de recursos get-started
Experience Manager permite los siguientes niveles de procesamiento.
- Miniaturas estándar utilizadas por Assets interfaz de usuario (48, 140 y 319 píxeles)
- Vista previa grande (representación web: 1280 píxeles)
- Extracción de metadatos y texto.
- Representación de FPO.
- Cambiar el formato de archivo y la resolución de las imágenes
- Aplicar condicionalmente a los tipos de archivo configurados.
Formatos de archivo compatibles supported-file-formats
Los microservicios de recursos son compatibles con 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 default-config
Algunos valores predeterminados están preconfigurados para garantizar que las representaciones predeterminadas requeridas en Experience Manager estén disponibles. La configuración predeterminada también garantiza que las operaciones de extracción de metadatos y 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 es 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 standard-config
Experience Manager proporcione funciones para generar representaciones más específicas para formatos comunes según las necesidades del usuario. Un administrador puede crear más Perfiles de procesamiento para facilitar la creación de la representación. A continuación, asigne uno o más perfiles disponibles a carpetas específicas para realizar el procesamiento adicional. Por ejemplo, el procesamiento adicional puede generar representaciones para la web, dispositivos 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 la representación proporciona los 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 altura especificadas, respectivamente. Se conserva la relación de aspecto, es decir, la misma que la original. Un valor vacío significa que el procesamiento de recursos supone la dimensión en píxeles del original.
-
Reglas de inclusión de tipo MIME: Cuando se procesa un recurso con un tipo MIME específico, el tipo MIME se comprueba primero 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 comprueba 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 en Adobe InDesign documentos, un profesional creativo espera un tiempo considerable después de que colocar un recurso. Mientras tanto, se bloquea al usuario el uso de InDesign. Esto interrumpe el flujo creativo y afecta negativamente a la experiencia del usuario. El Adobe permite colocar temporalmente representaciones de pequeño tamaño en InDesign documentos 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 ubicación (FPO). Estas representaciones de FPO tienen un tamaño de archivo pequeño, pero son de 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 el perfil de procesamiento. Para obtener más información, consulte Documentación completa de Adobe Asset Link.
Creación de un perfil estándar create-standard-profile
Para crear un perfil de procesamiento estándar, siga estos pasos:
-
Acceso de administradores Herramientas > Assets > Perfiles de procesamiento. Haga clic en Crear.
-
Proporcione un nombre que le ayude a identificar el perfil de forma exclusiva al aplicarlo a una carpeta.
-
Para generar representaciones de FPO, en Imagen pestaña, habilitar Crear representación de FPO. Entrada a Calidad valor entre 1 y 100.
-
Para generar otras representaciones, haga clic en Añadir 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íxel 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.
-
Haga clic en Guardar.
Casos de uso y perfil personalizados custom-config
El Asset Compute Service admite una variedad de casos de uso, como procesamiento predeterminado, procesamiento de formatos específicos del Adobe, como archivos Photoshop, e implementación de procesamiento personalizado o específico de la organización. La personalización del flujo de trabajo de 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 empresariales, Adobe recomienda desarrollar y utilizar Asset Compute Service para ampliar las funciones predeterminadas. Para obtener una descripción general, consulte comprender la extensibilidad y cuándo utilizarla.
Puede transformar los 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 hasta creación de aplicaciones personalizadas para los casos de uso admitidos. Experience Manager Puede llamar a estas aplicaciones personalizadas desde la interfaz de usuario mediante perfiles personalizados que configuran los administradores. Asset Compute Service admite los siguientes casos de uso de invocar servicios externos:
- Uso Adobe Photoshopde API ImageCutout y guarde el resultado como representación.
- Llame a sistemas de terceros para actualizar datos como, 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 ingeridos y guardarlos como representaciones.
Creación de un perfil personalizado create-custom-profile
Para crear un perfil personalizado, siga estos pasos:
-
Acceso de administradores Herramientas > Assets > Perfiles de procesamiento. Haga clic en Crear.
-
Clic Personalizado pestaña. Clic Añadir nuevo. Proporcione el nombre de archivo deseado para la representación.
-
Proporcione la siguiente información.
- Nombre de archivo de cada representación y una extensión de archivo compatible.
- Dirección URL de punto final de una aplicación personalizada de App Builder. La aplicación debe pertenecer a la misma organización que la cuenta de Experience Manager.
- Añadir parámetros de servicio a pasar información o parámetros adicionales a la aplicación personalizada.
- Se han incluido y excluido tipos MIME para limitar el procesamiento a algunos formatos de archivo específicos.
Haga clic en Guardar.
Las aplicaciones personalizadas no tienen encabezado Generador de aplicaciones de proyecto aplicaciones. La aplicación personalizada obtiene todos los archivos proporcionados si se configuran con un perfil de procesamiento. La aplicación debe filtrar los archivos.
Ejemplo de perfil personalizado custom-profile-example
Para ilustrar el uso de un perfil personalizado, consideremos un caso de uso para aplicar texto personalizado a las imágenes de la campaña. Puede crear un perfil de procesamiento que utilice la API de Photoshop para editar las imágenes.
La integración del servicio de asset compute de permite al Experience Manager pasar estos parámetros a la aplicación personalizada mediante Parámetros de servicio field. 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, el peso y el tamaño del texto para añadir el texto personalizado a las imágenes de campaña.
Imagen: uso Parámetros de servicio para pasar información añadida a parámetros predefinidos creados 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 use-profiles
Cree y aplique perfiles de procesamiento adicionales personalizados a carpetas específicas para que el Experience Manager los procese para los recursos cargados o actualizados en estas carpetas. El perfil de procesamiento estándar integrado y predeterminado 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 > Assets > Perfiles de procesamiento y utilice Aplicar perfil a las carpetas acción. Se abre un explorador de contenido que le permite navegar 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; utilice Propiedades acción para abrir la pantalla de propiedades de la carpeta, haga clic en Procesamiento de recursos y en la pestaña Perfil de procesamiento , seleccione el perfil de procesamiento adecuado para esa carpeta. Para guardar los cambios, haga clic en Guardar y cerrar.
-
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
Después de aplicar un perfil de procesamiento a una carpeta, todos los recursos nuevos cargados (o actualizados) en esta o en cualquiera de sus subcarpetas se procesan con el perfil de procesamiento adicional configurado. Este procesamiento se suma al perfil predeterminado estándar.
Para comprobar que los recursos se procesan, previsualice las representaciones generadas en la Representaciones vista en el carril izquierdo. Abra la previsualización de recursos y abra el carril izquierdo para acceder a Representaciones vista. Las representaciones específicas en el perfil de procesamiento, para las que el tipo del recurso específico coincide con las reglas de inclusión de tipo MIME, deben ser visibles y accesibles.
Imagen: ejemplo de dos representaciones adicionales generadas por un perfil de procesamiento aplicado a la carpeta principal.
Flujos de trabajo de posprocesamiento post-processing-workflows
En una situación en la que se requiera un procesamiento adicional de recursos que no se pueda lograr con los perfiles de procesamiento, se pueden agregar flujos de trabajo posteriores al procesamiento a la configuración. El posprocesamiento le permite agregar un procesamiento completamente personalizado sobre el procesamiento configurable mediante microservicios de recursos.
Flujos de trabajo de posprocesamiento o Flujo de trabajo de inicio automático, si está configurado, los ejecuta automáticamente Experience Manager una vez finalizado el procesamiento de los microservicios. No es necesario añadir manualmente iniciadores de flujo de trabajo para almacenar en déclencheur los flujos de trabajo. Los ejemplos incluyen:
- Pasos personalizados del flujo de trabajo para procesar recursos.
- Integraciones para añadir metadatos o propiedades a recursos de sistemas externos como, por ejemplo, información de productos o procesos.
- Procesamiento adicional realizado por servicios externos.
Para añadir una configuración de flujo de trabajo de posprocesamiento 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 de posprocesamiento en esta documentación. Esos son regulares 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 el recurso, agregue el paso al modelo de flujo de trabajo de posprocesamiento personalizado.
- Añadir Proceso completado de flujo de trabajo de recursos de actualización DAM paso al final. Añadir este paso garantiza que el Experience Manager sepa cuándo termina el procesamiento y que el recurso se pueda marcar como procesado, es decir, Nuevo se muestra en el recurso.
- Cree una configuración para el servicio de flujo de trabajo personalizado que permita configurar la ejecución de un modelo de flujo de trabajo de posprocesamiento por una ruta (ubicación de carpeta) o por una expresión regular.
Para obtener más información sobre qué paso del flujo de trabajo estándar se puede utilizar en el flujo de trabajo de posprocesamiento, consulte pasos del flujo de trabajo en el flujo de trabajo de posprocesamiento en la referencia del desarrollador.
Creación de modelos de flujo de trabajo de posprocesamiento create-post-processing-workflow-models
Los modelos de flujo de trabajo de posprocesamiento son regulares 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 tanto los pasos compatibles disponibles como cualquier paso del flujo de trabajo implementado de forma personalizada.
Asegúrese de que el último paso de cada flujo de trabajo de posprocesamiento 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.
Configuración de la ejecución del flujo de trabajo posterior al procesamiento configure-post-processing-workflow-execution
Una vez que los microservicios de recursos completen el procesamiento de los recursos cargados, puede definir un flujo de trabajo de posprocesamiento para procesar aún más los recursos. Para configurar el posprocesamiento mediante modelos de flujo de trabajo, puede realizar una de las siguientes acciones:
Aplicar un modelo de flujo de trabajo a una carpeta apply-workflow-model-to-folder
Para los casos de uso habituales del posprocesamiento, considere la posibilidad de utilizar el método para aplicar un flujo de trabajo a una carpeta. Para aplicar un modelo de flujo de trabajo en la carpeta Propiedades, siga estos pasos:
-
Cree un modelo del flujo de trabajo.
-
Seleccione una carpeta y haga clic en Propiedades en la barra de herramientas y haga clic en Procesamiento de recursos pestaña.
-
En Flujo de trabajo de inicio automático, seleccione el flujo de trabajo necesario, proporcione un título para el flujo de trabajo y guarde los cambios.
Configurar el servicio Workflow Runner personalizado configure-custom-workflow-runner-service
Puede configurar el servicio del ejecutor de flujo de trabajo personalizado para las configuraciones avanzadas que no se pueden completar 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 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 de posprocesamiento por ruta (
postProcWorkflowsByPath): Se pueden enumerar varios modelos de flujo de trabajo en función de diferentes rutas de repositorio. Separe las rutas y los modelos con dos puntos. Se admiten rutas de repositorio simples. Asigne estos elementos a un modelo de flujo de trabajo en/varruta. Por ejemplo:/content/dam/my-brand:/var/workflow/models/my-workflow. - Flujos de trabajo de posprocesamiento por expresión (
postProcWorkflowsByExpression): Se pueden enumerar varios modelos de flujo de trabajo basados en distintas 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 obtener información sobre cómo implementar una configuración OSGi, consulte implementar en Experience Manager.
Deshabilitar 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 Flujo de trabajo de inicio automático selección.
Creación del modelo de flujo de trabajo de inicio automático desactivado
-
Vaya a Herramientas > Flujo de trabajo > Modelos
-
Seleccionar Crear > Crear modelo desde la barra de acciones superior
-
Proporcione un título y un nombre para el nuevo modelo de flujo de trabajo, por ejemplo:
- Título: Deshabilitar el flujo de trabajo de inicio automático
- Nombre: disable-auto-start-workflow
-
Seleccionar Listo para crear el modelo de flujo de trabajo
-
Seleccionar y Editar el modelo de flujo de trabajo creado
-
En el editor del Modelo de flujo de trabajo, seleccione Paso 1 de la definición del modelo y elimínelo
-
Abra el Panel lateral y seleccione Pasos
-
Arrastre el Flujo de trabajo del recurso de actualización DAM completado paso a la definición del modelo
-
Seleccione el Información de página botón (junto al Panel lateral alternar) y seleccione Abrir propiedades
-
En el Básico pestaña, seleccione Flujo de trabajo transitorio
-
Seleccionar Guardar y cerrar desde la barra de acciones superior
-
Seleccionar Sincronización en la barra de acciones superior
-
Cierre el editor del modelo de flujo de trabajo
Aplicar el modelo de flujo de trabajo de inicio automático deshabilitado
Siga los pasos descritos en aplicar un modelo de flujo de trabajo a una carpeta y configure el Deshabilitar flujo de trabajo de inicio automático como el Flujo de trabajo de inicio automático para carpetas no requieren el posprocesamiento de recursos.
Prácticas recomendadas y limitaciones best-practices-limitations-tips
- Tenga en cuenta las necesidades de 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 por lotes posteriormente. Las representaciones no deseadas pueden ocupar una gran cantidad de espacio de almacenamiento después de un uso prolongado de Experience Manager. Para los 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 cargarlos de nuevo.
- Actualmente, la compatibilidad se limita a generar representaciones. No se admite la generación de nuevos recursos.
- 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 la operación de extracción de metadatos falla.
Consulte también