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 abarcan más formatos listos para usar que los que son posibles con 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 que existe en las 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 la interfaz de usuario Assets (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 una lista completa de los 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 complete en todos los recursos.
Configuración estándar standard-config
Experience Manager proporciona funciones para generar representaciones más específicas de formatos comunes según las necesidades del usuario. Un administrador puede crear Perfiles de procesamiento adicionales para facilitar la creación de representaciones. 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 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 de Experience Manager en Adobe InDesign documentos, un profesional creativo espera un tiempo considerable después de colocar un recurso. Mientras tanto, se ha bloqueado 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 más adelante con recursos de resolución completa bajo demanda. Experience Manager proporciona representaciones que se utilizan únicamente para la 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 necesita activarla para su 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:
-
Los administradores tienen acceso a 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 FPO, en la ficha Imagen, habilite Crear representación FPO. Escriba un valor Quality entre 1 y 100.
-
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í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 de Adobes 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 capacidades 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 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 mediante perfiles personalizados que configuran los administradores. Asset Compute Service admite los siguientes casos de uso de invocación a servicios externos:
- Use la API de ImageCutout de Adobe Photoshop y guarde el resultado como representación.
- Llame a sistemas de terceros para actualizar datos como, por ejemplo, un sistema PIM.
- Utilice la API Photoshop para generar diversas representaciones basadas en una plantilla de Photoshop.
- Utilice la 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:
-
Los administradores tienen acceso a Herramientas > Assets > Perfiles de procesamiento. Haga clic en Crear.
-
Haga clic en la ficha Personalizado. Haga clic en Agregar 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.
- 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.
- Agregue parámetros de servicio a pase 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 son aplicaciones Project App Builder sin encabezado. 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 permite al Experience Manager pasar estos parámetros a la aplicación personalizada mediante el campo Parámetros de servicio. 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.
Figura: Utilice el campo Parámetros de servicio para pasar información agregada a los parámetros predefinidos generados en la aplicación personalizada. En este ejemplo, cuando se cargan imágenes de campaña, las imágenes se actualizan con el texto Jumanji en la fuente Arial-BoldMT.
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 usar la acción Aplicar perfil a las carpetas. 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, usar la acción Propiedades para abrir la pantalla de propiedades de la carpeta, hacer clic en la pestaña Procesamiento de recursos y, en la lista Perfil de procesamiento, seleccionar 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 la opción
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, obtenga una vista previa de las representaciones generadas en la vista Representaciones del carril izquierdo. Abra la vista previa del recurso y abra el carril izquierdo para acceder a la vista Representaciones. 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.
Experience Manager ejecuta automáticamente los flujos de trabajo de posprocesamiento o flujo de trabajo de inicio automático, si están configurados, 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 agregar una configuración de flujo de trabajo de procesamiento posterior 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. Son modelos de flujo de trabajo de 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 el recurso, agregue el paso al modelo de flujo de trabajo de posprocesamiento personalizado.
- Agregar el proceso completado del flujo de trabajo del recurso de actualización DAM 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 de 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 para desarrolladores.
Creación de modelos de flujo de trabajo de posprocesamiento create-post-processing-workflow-models
Los modelos de flujo de trabajo de posprocesamiento son Experience Manager modelos de flujo de trabajo normales. 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 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.
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 Properties, siga estos pasos:
-
Cree un modelo del flujo de trabajo.
-
Seleccione una carpeta, haga clic en Propiedades en la barra de herramientas y, a continuación, haga clic en la ficha Procesamiento de Assets.
-
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.
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 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 de posprocesamiento por ruta (
postProcWorkflowsByPath): se pueden enumerar varios modelos de flujo de trabajo, según diferentes rutas de repositorio. Separe las rutas y los modelos con dos puntos. Se admiten rutas de repositorio simples. Asignarlos a un modelo de flujo de trabajo en la ruta de acceso/var. 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 según 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 saber 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 la selección Flujo de trabajo de inicio automático.
Creación del modelo de flujo de trabajo de inicio automático desactivado
-
Vaya a Herramientas > Flujo de trabajo > Modelos
-
Seleccione Crear > Crear modelo en 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
-
Seleccione 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 paso Flujo de trabajo de recursos de actualización DAM completado a la definición del modelo
-
Seleccione el botón Información de la página (junto al botón de alternancia Panel lateral) y seleccione Abrir propiedades
-
En la ficha Básico, seleccione Flujo de trabajo transitorio
-
Seleccione Guardar y cerrar en la barra de acciones superior
-
Seleccione Sincronizar 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 establezca Deshabilitar flujo de trabajo de inicio automático como Flujo de trabajo de inicio automático para carpetas no requiere el procesamiento posterior 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
- Traducir recursos
- API HTTP de recursos
- Formatos de archivo compatibles con recursos
- Buscar recursos
- Recursos de red
- Informes de recurso
- Esquemas de metadatos
- Descarga de recursos
- Administración de metadatos
- Facetas de búsqueda
- Administrar colecciones
- Importación masiva de metadatos
- Publicación de recursos en AEM y Dynamic Media