Configuración de Workfront for Experience Manager enhanced connector assets-integration-overview
Un usuario con acceso de administrador en Adobe Experience Manager as a Cloud Service configura el conector mejorado después de instalarlo. Para obtener instrucciones de instalación, consulte Instalar el conector.
-
Adobe requiere la implementación y configuración de Adobe Workfront for Experience Manager enhanced connector solo a través de socios certificados o Adobe Professional Services. Si se implementa y se configura sin un socio certificado o Adobe Professional Services, no es compatible con Adobe.
-
Adobe puede publicar actualizaciones para Adobe Workfront y Adobe Experience Manager que hagan redundante este conector; si esto sucede, es posible que los clientes deban realizar la transición desde el uso de este conector.
-
Adobe admite las versiones 1.7.4 y posteriores del conector mejorado. No se admiten versiones preliminares ni versiones personalizadas anteriores. Para comprobar la versión mejorada del conector, consulte el paso 5(a) de instrucciones mejoradas de instalación del conector.
-
Consulte Examen de certificación de socio para el conector mejorado de Workfront para Experience Manager Assets. Para obtener información sobre el examen, consulte Guía para exámenes.
Configuración de suscripciones a eventos event-subscriptions
Las suscripciones a eventos se usan para notificar a AEM los eventos que tienen lugar en Adobe Workfront. Hay tres características de Workfront for Experience Manager enhanced connector que necesitan suscripciones de evento para funcionar, estas son:
- Creación automática de carpetas vinculadas a proyectos.
- Sincronización de cambios en los valores de formulario personalizados de documentos de Workfront con los metadatos de recursos de AEM.
- Publicación automática de recursos en Brand Portal al finalizar el proyecto.
Para utilizar estas funciones, habilite las suscripciones a eventos.
-
Edite la configuración de Workfront Tools Cloud Services que creó en el paso 5 y seleccione la pestaña Event Subscriptions.
-
Seleccione la integración personalizada de Workfront que creó en la sección 6.
-
Haga clic en Habilitar suscripciones a eventos de Workfront.
Configuración de carpetas vinculadas linked-folders
Para suscribirse a los eventos, siga estos pasos:
- Vaya a la pestaña Suscripciones de eventos en los servicios en la nube.
- Seleccione la integración personalizada creada en Workfront.
- Haga clic en Habilitar suscripciones a eventos de Workfront.
Configuración de estructura de carpetas vinculadas linked-folder-structure
- Vaya a la pestaña Carpetas vinculadas del proyecto en los servicios en la nube.
- Ruta principal de la carpeta vinculada: seleccione una carpeta en DAM en la que desee crear las carpetas vinculadas. Si se deja vacío, el valor predeterminado será /content/dam. Asegúrese de que el esquema de metadatos de Workfront Tools y el esquema de metadatos de la carpeta de carpetas vinculadas de Workfront se hayan aplicado a la carpeta seleccionada.
- Estructura de carpetas vinculadas: introduzca valores separados por comas. Cada valor debe ser
DE:<some-project-custom-form-field>
, Portfolio, Program, Year, Name o algún "Valor de cadena literal" (este último entre comillas). Actualmente está establecido en Portfolio, Programa, Año, DE: Tipo de proyecto, Nombre. - Configurar permisos: agregar permisos de
jcr:all permissions
a/conf/workfront-tools/settings/cloudconfigs
para el grupowf-workfront-users
. - La casilla de verificación Generar título de carpeta vinculado en Workfront mediante los nombres de estructura de carpetas debe activarse si el título de la carpeta en Workfront debe incluir todas las carpetas de la estructura. De lo contrario, es el título de la última carpeta.
- Subcarpetas multicampo permite especificar una lista de carpetas que deben crearse como una carpeta secundaria de la carpeta vinculada.
- Estado del proyecto: seleccione el estado para el que se debe configurar el proyecto para crear la carpeta vinculada.
- Crear una carpeta vinculada en proyectos con portafolio: lista de portafolios a los que debe pertenecer el proyecto para poder crear la carpeta vinculada. Deje esta lista vacía para crear la carpeta vinculada para todo el portafolio de proyectos.
- Crear una carpeta vinculada en proyectos con un campo de formulario personalizado: Campo de formulario personalizado y su valor correspondiente que debe tener el proyecto para poder crear la carpeta vinculada. Esta configuración se ignora si se deja vacía. Seleccione
CUSTOM FORMS: Create DAM Linked Folder
para el campo y escribaYes
para el valor. - Configurar permiso: configure estos permisos,
jcr:all permissions for /conf/workfront-tools/settings/cloudconfigs
parawf-workfront-users group
. - Haga clic en Habilitar la creación automática de carpetas vinculadas. Si vuelve a la pestaña Suscripciones de eventos, verá que ahora hay un evento de creación.
Asignación de esquema de metadatos metadata-schema-mapping
Configurar asignación de metadatos de carpeta folder-metadata-mapping
La asignación de metadatos entre los proyectos de Workfront y las carpetas de AEM se define en los esquemas de metadatos de carpeta de AEM. Los esquemas de metadatos de carpeta deben crearse y configurarse como de costumbre en AEM. Workfront Tools agrega un menú desplegable de autocompletar a la pestaña Configuración de configuración de cada campo del formulario de esquema de metadatos de carpeta. Este menú desplegable de autocompletar le permite especificar a qué campo de Workfront debe asignarse cada propiedad de carpeta de AEM.
Para configurar las asignaciones, siga estos pasos:
-
Agregar permisos de
jcr:read
a/conf/global/settings/dam/adminui-extension/foldermetadataschema
para el grupowf-workfront-users
. -
Vaya a Herramientas > Assets > Esquemas de metadatos de carpeta.
-
Seleccione el formulario de esquema de metadatos de carpeta que desee editar y haga clic en Editar.
-
Seleccione el campo del formulario del esquema de metadatos de la carpeta que desea editar y seleccione la pestaña Configuración en el panel derecho.
-
En el campo Asignado desde el campo de Workfront, seleccione el nombre del campo de Workfront que desea asignar a la propiedad de carpeta de AEM seleccionada. Las opciones disponibles son:
- Campos de formulario personalizados del proyecto
- Campos de Información general del proyecto (ID, nombre, descripción, número de referencia, fecha planificada de finalización, propietario del proyecto, patrocinador del proyecto, Portfolio o programa)
Configuración de la asignación de metadatos de recursos asset-metadata-mapping
La asignación de metadatos entre Documentos de Adobe Workfront y Assets se define en Esquemas de metadatos de AEM. Los esquemas de metadatos deben crearse y configurarse como de costumbre en AEM. Workfront Tools agrega opciones de configuración a la pestaña Configuración de cada campo del formulario de esquema de metadatos. Estas opciones le permiten especificar a qué campo de Workfront debe asignarse cada propiedad de AEM.
Para configurar las asignaciones, siga estos pasos:
-
Vaya a Herramientas > Assets > Esquemas de metadatos.
-
Seleccione el formulario de esquema de metadatos que desee editar y haga clic en Editar o cree un esquema de metadatos desde cero.
-
Seleccione el campo del formulario de esquema de metadatos que desee editar y seleccione la pestaña Configuración en el panel derecho.
-
En Campo de formulario personalizado Workfront, seleccione el nombre del campo Workfront que desea asignar a la propiedad de AEM seleccionada. Las opciones disponibles son:
- Documentar campos de formulario personalizados
- Campos de formulario personalizados del proyecto
- Emitir campos de formulario personalizados
- Campos de formulario personalizados de tarea
- Campos Información general del proyecto (ID, Nombre, Descripción o Número de referencia)
-
En caso de que el campo Workfront seleccionado en Campo de formulario personalizado de Workfront sea un campo de escritura anticipada de usuario de Workfront, es necesario especificar qué campo de usuario de Workfront desea asignar. Para ello, marque Obtener valor del campo de objeto al que se hace referencia en Workfront y, a continuación, especifique el nombre del Campo de formulario personalizado de usuario de Workfront desde el que recuperar el valor que se va a asignar.
Asignar propiedad map-property
Este paso del flujo de trabajo permite que un usuario asigne una propiedad a un formulario personalizado Workfront en un proyecto, tarea, problema o documento. El artefacto Workfront al que afecta este paso se busca usando una ruta relativa desde la carga útil. Las propiedades que se van a asignar se controlan desde la configuración del cuadro de diálogo de pasos.
Tipo: este campo permite seleccionar el tipo de objeto de Workfront al que se deben asignar las propiedades.
Propiedad de ID: este campo permite especificar la ruta al ID del objeto de Workfront al que se deben asignar las propiedades. La ruta especificada en este campo debe ser relativa a la carga útil del flujo de trabajo.
Asignaciones de propiedades: este campo múltiple permite especificar las asignaciones entre las propiedades de AEM y los campos de Workfront. Cada elemento del campo múltiple especificará una asignación. Cada asignación debe tener el formato <workfront-field>=<aem-mapped-property>
.
-
El
workfront-field
puede ser- Campo de formulario personalizado identificado con el prefijo
DE:
. - Campo editable identificado por su nombre. Los nombres de campo se encuentran en Workfront Explorador de API.
- Campo de formulario personalizado identificado con el prefijo
-
El(la)
aem-mapped-property
puede ser:- Un valor literal. Deben ir entre comillas.
- Una propiedad de AEM. Esta referencia debe ser relativa a la carga útil del flujo de trabajo.
- Un valor con nombre. Estos deben ir entre corchetes.
- Una concatenación de los tres elementos anteriores. Especifíquelo usando
{+}
. - Una modificación de los tres elementos anteriores al rodear el valor con
{replace(<value>,"old-char","new-char")}
.
-
Algunos ejemplos son:
status="INP"
DE:Asset Type=jcr:content/metadata/assetType
DE:Path={path}
URL="https://my-aem-author/assets.html"{+}{path}
Definir estado set-status
En el editor de flujo de trabajo, edite las propiedades de Workfront - Set Status en la pestaña Arguments.
Sincronización de comentarios comments-sync
-
En Experience Manager, acceda a Herramientas > Cloud Services > Configuración de herramientas de Workfront, seleccione la configuración y seleccione Propiedades.
-
Seleccione la ficha Suscripciones de eventos, haga clic en Habilitar sincronización de comentarios en la opción Enviar comentarios realizados en Workfront a AEM.
Para probar la sincronización de comentarios de Workfront a AEM, siga estos pasos:
-
Vaya a un documento vinculado en Workfront y añada un comentario en la pestaña Actualizaciones.
-
Vaya al mismo documento vinculado en AEM, seleccione el documento, abra la opción Cronología en el panel de navegación izquierdo y seleccione Comentarios. La barra lateral izquierda muestra los comentarios sincronizados de Workfront.
Versiones de recursos asset-versions
Para mantener el historial de versiones de los recursos en AEM, configure las versiones de los recursos en AEM.
-
En Experience Manager, accede a Herramientas > Cloud Services > Configuración de Workfront Tools y abre la pestaña Avanzadas.
-
Seleccione la opción Almacenar recursos con el mismo nombre que las versiones del recurso existente. Cuando se selecciona, esta opción permite almacenar recursos cargados con el mismo nombre y en la misma ubicación que la versión del recurso existente. Si no se selecciona, se crea un nuevo recurso con un nombre diferente (por ejemplo,
asset-name.pdf
yasset-name-1.pdf
). -
Seleccione la opción Actualizar metadatos del recurso al crear una nueva versión. Cuando se selecciona, esta opción actualiza los metadatos del recurso cada vez que se crea una nueva versión del recurso. Si no se selecciona, el recurso conservará los metadatos que tenía antes de crear la nueva versión.
Adjuntar formularios personalizados attach-custom-forms
Este paso del flujo de trabajo permite a los usuarios adjuntar un formulario personalizado a un artefacto Workfront. Este paso del flujo de trabajo se puede agregar a cualquier modelo de flujo de trabajo. El artefacto Workfront al que afecta este paso se busca usando una ruta relativa desde la carga útil.
En el editor de flujo de trabajo de Experience Manager, edite las propiedades del paso de flujo de trabajo Workfront - Adjuntar formulario personalizado.
Publicar recursos automáticamente auto-publish-assets
-
En Experience Manager, accede a Herramientas > Cloud Services > Configuración de Workfront Tools y abre la pestaña Avanzadas.
-
Seleccione Publicar recursos automáticamente cuando se envíen desde Workfront. Esta opción permite la publicación automática de recursos cuando se envían de Workfront a AEM. Esta función se puede habilitar de forma condicional especificando un campo de formulario personalizado de Workfront y el valor en el que debe establecerse. Siempre que se envía un documento a AEM, si cumple la condición, el recurso se publica automáticamente.
-
Seleccione Publicar todos los recursos del proyecto en Brand Portal al finalizar el proyecto. Esta opción habilita la publicación automática de recursos en Brand Portal cuando el estado del proyecto de Workfront al que pertenecen se cambia a
Complete
.
Actualizaciones de formularios personalizados de documentos de Workfront subscribe-workfront-doc-custom-form-updates
Para suscribirse a los cambios en los formularios personalizados de documento Workfront, seleccione la opción correspondiente en la pestaña Avanzado. Al suscribirse a estas actualizaciones, se actualizan los campos de metadatos asignados de Experience Manager cuando se cambia el campo correspondiente del formulario personalizado del documento Workfront.