Configurar Workfront con el conector heredado de Adobe Experience Manager

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

table 0-row-2 1-row-2 2-row-2 html-authored no-header
paquete de Adobe Workfront	PRIME o ULTIMATE Workflow Ultimate
Licencias de Adobe Workfront	Estándar Plan
Configuraciones de nivel de acceso	Debe ser administrador de Workfront.

Para obtener más información, consulte Requisitos de acceso en la documentación de Workfront.

Workfront for AEM Assets

Workfront for AEM Assets connector permite que su organización haga lo siguiente:

• Colaborar y administrar contenido creativo vinculando recursos y carpetas de AEM a proyectos, tareas, problemas y solicitudes en Workfront.

  Para obtener más información sobre cómo configurar las integraciones de documentación con aplicaciones de terceros, consulte Configurar integraciones de documentos.

• Integrar con el repositorio AEM Digital Asset Management (DAM), lo que le permite usar Workfront para administrar y compartir recursos digitales almacenados en DAM.

  Para obtener más información sobre la vinculación de documentos y carpetas de recursos, consulte Enlazar documentos a partir de aplicaciones externas.

• Combinar y aplicar metadatos de ambas aplicaciones a un recurso.

• Ver un flujo de comunicación inclusivo para un recurso. Las actualizaciones y los comentarios realizados en un recurso ya sea en Workfront o en AEM Assets se sincronizan con la otra aplicación, lo que establece un historial completo de las comunicaciones realizadas en el recurso.

  Para obtener más información acerca de cómo realizar comentarios en Workfront, consulte Añadir una actualización a un documento.

Requisitos previos para instalar el conector de AEM Assets

Antes de instalar el conector Workfront para AEM Assets, asegúrese de que se cumplan los siguientes requisitos previos:

• AEM Assets está instalado y configurado, versión 6.5 o posterior. Para obtener información sobre la instalación de AEM Assets, consulte la Adobe Experience Manager documentación.
• (Condicional) Si las reglas del cortafuegos no permiten el tráfico tal como esperaba, añada la dirección IP o el dominio del clúster a la lista de permitidos. Para obtener más información, consulte Configuración de la lista de permitidos del firewall.

Instalar el paquete del conector de Workfront for AEM Assets install-the-workfront-for-aem-assets-connector-package

note important
IMPORTANT
Las siguientes instrucciones son para un conector heredado de Workfront with AEM Assets, que ha sido reemplazado por el Workfront for Experience Manager conector mejorado. Póngase en contacto con su representante de cuenta para obtener más información.

Para instalar el conector de Workfront for AEM Assets, debe importarlo en AEM como un paquete mediante el Administrador de paquetes de CRX.

1. En una estación de trabajo en la que ya haya instalado AEM, descargue el archivo de instalación del conector de Workfront for AEM Assets.

   Puede obtener el conector de Workfront for AEM Assets a través de su representante de Workfront.

2. Inicie sesión en AEM con una cuenta de administrador.

3. Haga clic en Herramientas > Implementación > Paquetes. Se abre el Administrador de paquetes de CRX.

4. Haga clic en Cargar paquete.

5. En el cuadro de diálogo Cargar paquete, busque y seleccione el paquete de Conector de Workfront, y luego haga clic en Aceptar. El paquete se muestra en el Administrador de paquetes de CRX.

6. Haga clic en Instalar.

7. En el cuadro de diálogo Paquete, ignore los ajustes avanzados y haga clic en Instalar.

8. (Opcional) Para confirmar que el conector se ha instalado correctamente, asegúrese de que la siguiente instrucción se muestra en el Registro de actividades:

   code language-none
   Package installed in <time>

9. Cierre el Administrador de paquetes de CRX. El conector está instalado y ahora puede configurar AEM Assets para integrarlo con Workfront.

10. Continuar con Configurar AEM Assets para integrar con Workfront.

Configurar AEM Assets para integrarlo con Workfront configure-aem-assets-to-integrate-with-workfront

Después de instalar el conector, importe el paquete del conector en AEM y configure AEM para que se vincule con los documentos de Workfront.

Para obtener información sobre la instalación del conector, consulte Instalar el Workfront for AEM Assets paquete del conector.

• Requisitos previos
• Integrar AEM con Workfront
• Configurar el Externalizador AEM

Requisitos previos prerequisites

Antes de empezar, debe habilitar los permisos para workfront-service:

1. En AEM, vaya a Herramientas > Seguridad > Permisos.
2. En la esquina superior izquierda, elija Usuarios​ en el menú desplegable y escriba workfront-service en el campo Buscar​. Seleccione el usuario workfront-service.
3. En el lado derecho de la pantalla, seleccione Añadir ACE para crear nuevas entradas.
4. En la ventana Agregar nueva entrada​, seleccione el icono de casilla de verificación en el campo Ruta​ y elija la carpeta: /conf
5. En el campo Privilegios, escriba: jcr:read
6. En la esquina superior derecha, seleccione Agregar.
7. (Opcional) Repita los pasos anteriores para crear más entradas.

Integrar AEM con Workfront integrate-aem-with-workfront

1. Inicie sesión en AEM Assets como administrador.

2. Haga clic en Herramientas > Cloud Services > Configuración de integración de Workfront > Global-Workfront.​​

3. (Condicional) Si aún no lo ha hecho, cree un archivo de configuración de nube Workfront:

   1. En la esquina superior derecha de la página Global-Workfront, haga clic en Crear.

   2. En el cuadro URL de Workfront, especifique la URL de la instancia de Workfront.

      Por ejemplo, https://<account>.my.workfront.com, donde <account> es la cuenta que usa para las integraciones con AEM.

   3. En el campo​Carpeta base, seleccione el icono de casilla de verificación.

   4. En el menú desplegable, seleccione la ruta en la que se almacenan los documentos vinculados a Workfront objetos.

   5. En el modal de AEM que aparece, siga la ruta hasta la carpeta con los documentos conectados a objetos Workfront. Elija la carpeta y luego presione Seleccionar en la esquina superior derecha.

      Puede vincular a cualquier carpeta debajo de la raíz /content/dam/.

   6. En el cuadro Clave de API de Workfront, especifique su clave de API de Workfront.

      Para recuperar su clave de API de Workfront:

      1. Abra una pestaña del explorador e inicie sesión en su cuenta de Workfront como administrador de Workfront.

4. Haga clic en el icono Main Menu en la esquina superior derecha de Adobe Workfront o, si está disponible, haga clic en el icono Main Menu en la esquina superior izquierda y, a continuación, haga clic en Setup .

   1. Haga clic en Sistema > Información del cliente.

      Si ya ha generado una clave de API, la clave de API Workfront se muestra en la etiqueta Clave de API del usuario.

   2. (Condicional) Si aún no ha generado una clave de API, debe generar una:

      1. En la sección Configuración de clave de API, asegúrese de que la opción Después de la creación, las claves de API caducan en esté establecida en Ninguno.

         Si selecciona un periodo de caducidad, el conector dejará de funcionar una vez que caduque la clave de API. Luego tendrá que volver a generar una clave de API y actualizar la configuración de Workfront.

      2. En la etiqueta Su clave API de usuario, haga clic en Generar clave API. Se genera y se muestra una clave API para Workfront.

   3. Copie la clave API en el portapapeles.

   4. Abra la pestaña del explorador correspondiente al conector de AEM y, en el cuadro Workfront API Key, pegue la clave de API que ha copiado.

   5. (Condicional) Haga clic en la pestaña Avanzado en la esquina superior izquierda de la página Workfront Configuración de integración y seleccione las siguientes opciones si corresponde:

      Permitir exploración de colecciones: seleccione esta opción si su organización permite que usuarios de Workfront vinculen colecciones de AEM Assets a Workfront objetos.

      Federated ID de usuario: Seleccione esta opción si su organización utiliza Federated ID o un inicio de sesión único (SSO) al iniciar sesión en Workfront.

      Omitir dominio de correo electrónico: seleccione esta opción si los usuarios de AEM no utilizan el nombre de dominio en su identificador de usuario.

      Restringir el acceso: seleccione esta opción para especificar las direcciones IP de Workfront apropiadas que deben añadirse a la lista de permitidos. Para obtener más información acerca de la lista de permitidos, consulte Configuración de la lista de permitidos del cortafuegos.

   6. En la esquina superior izquierda de la página Configuración de integración de Workfront, haga clic en la ficha Básico y, a continuación, haga clic en Conectar.

      note note
      NOTE
      Los cambios pueden tardar un poco en aplicarse. El reinicio del paquete puede acelerar el proceso.

5. (Condicional) Si ya creó un archivo de configuración de nube de Workfront, seleccione Global-Workfront y, a continuación, en la esquina superior izquierda, haga clic en Propiedades.

6. Genere la clave API de AEM haciendo clic en Generar clave, y, a continuación, copie la clave API de AEM en el portapapeles.

   Más adelante necesitará la clave API de AEM para configurar Workfront y que se integre con AEM Assets. Para obtener más información, consulte Configurar Workfront para integrarlo con AEM Assets.

7. En la esquina superior derecha, haz clic en Guardar. Se muestra la ventana Global-Workfront.

   

8. (Opcional) Sincronice la comunicación bidireccional entre AEM y Workfront:

   1. Haga clic en Global-Workfront.

   2. En la esquina superior izquierda de la ventana, haga clic en Propiedades. Se muestra la página WorkfrontIntegration Configuration.

      

   3. (Opcional) Para habilitar la sincronización de comentarios entre AEM Assets y Workfront, haga clic en Habilitar sincronización de comentarios.

      note important
      IMPORTANT
      Debe habilitar Sincronizar documentos para sincronizar los recursos.

   4. (Opcional) Para desactivar la sincronización de comentarios, haga clic en Deshabilitar sincronización de comentarios.

      O

      Elimine la suscripción al evento NOTE CREATE registrada en la instancia de AEM.

      Para obtener información sobre las suscripciones a eventos, consulte API de suscripción a eventos.

9. Continúe con Configure the AEM Externalizer.

Configurar el AEM Externalizer configure-the-aem-externalizer

El AEM Externalizer permite que AEM pase direcciones URL en un formato que se puede usar en Workfront. Si no se configura correctamente, Workfront no puede realizar llamadas a la API de AEM y las direcciones URL que vinculan documentos de AEM en Workfront no funcionarán.

1. En AEM, haga clic en Herramientas > Operaciones > Consola web.

2. Haga clic en OSGI y, a continuación, haga clic en Configuración en el menú desplegable.

3. En la lista de configuración, seleccione​Externalizador de vínculos CQ por día.: se muestra la página Externalizador.

4. En la sección Dominios, asegúrese de que el dominio que aparece en el campo Autor sea el nombre de dominio al que los usuarios de AEM pueden acceder externamente.

   El nombre de dominio en el campo Autor debe coincidir con el dominio que aparece en la línea URL de la instancia de AEM.

   

5. (Condicional) Si es necesario, actualice el dominio en el campo Autor.

6. Haga clic en Guardar. AEM Assets se ha configurado para vincular documentos con Workfront.

7. Continuar con Configurar Workfront para integrar con AEM assets.

Configurar Workfront para integrarlo con AEM assets configure-workfront-to-integrate-with-aem-assets

Después de instalar el conector Workfront for AEM Assets (como se describe en Instalar el paquete del conector Workfront for AEM Assets) y configurar AEM Assets (como se describe en Configurar AEM Assets para integrarlos con Workfront), debe configurar Workfront para vincular documentos entre Workfront y AEM Assets.

1. Inicie sesión en Workfront como administrador.

   note tip
   TIP
   Workfront recomienda crear un administrador de Workfront dedicado exclusivamente a la integración de AEM. Para obtener más información sobre cómo asignar el nivel de acceso de administrador de Workfront a un usuario, consulte Conceder a los usuarios acceso administrativo a determinadas áreas.

2. Haga clic en el icono Main Menu en la esquina superior derecha de Adobe Workfront o, si está disponible, haga clic en el icono Main Menu en la esquina superior izquierda y, a continuación, haga clic en Setup .

3. Haga clic en Documentos > Integración personalizada.

4. Haga clic en Agregar integración personalizada.

5. En el cuadro Nombre, escriba el nombre de la integración personalizada.

   Este es el nombre que ven los usuarios al usar la integración en Workfront.

6. En el cuadro URL de API básica, escriba la URL de la instancia de AEM.

   La dirección URL de API básica consiste en la dirección URL de la instancia de AEM seguida de la ruta: /bin/webhooks/api/

   

7. En el menú desplegable Tipo de autenticación, seleccione ApiKey.

8. En el cuadro Clave de API, pegue la Clave de API de AEM que copió cuando configuró AEM Assets.

9. Haga clic en Guardar.

10. (Opcional) Asegúrese de que la integración esté marcada como Activa.
    

    Workfront ya está configurado para trabajar con AEM Assets.

    Para tener acceso a los recursos en AEM, cada usuario de Workfront que necesite utilizar el conector debe estar configurado como usuario en AEM. Para obtener información sobre cómo crear usuarios, consulte Configurar usuarios para que utilicen el conector.

Configurar usuarios para que utilicen el conector set-up-users-to-use-the-connector

Para que los usuarios puedan acceder al conector, deben tener un perfil de usuario en AEM y pertenecer a un grupo de Workfront con niveles de acceso que incluyan los permisos para Crear y Eliminar.

Para obtener más información sobre los permisos de Workfront, consulte Crear o modificar niveles de acceso personalizados.

• Configurar usuarios en AEM assets

Configurar usuarios en AEM assets set-up-users-in-aem-assets

1. Inicie sesión en AEM Assets como persona con la función de administrador de Workfront.

2. Haga clic en Herramientas > ​​Seguridad > Usuarios.

3. (Condicional) Si el usuario no tiene un perfil de usuario en AEM, cree un un perfil de usuario de AEM.

   1. Haga clic en Crear usuario.

   2. Introduzca la información personal del usuario.

      

      El único campo obligatorio es el campo ID. El identificador AEM del usuario debe coincidir con su identificador de Workfront, que es la dirección de correo electrónico de Workfront del usuario.

      Si seleccionó la opción Ignorar dominio de correo electrónico al configurar la integración de AEM con Workfront, entonces el identificador de AEM no coincidirá con la dirección de correo electrónico de Workfront.

4. (Condicional) Si el usuario tiene un perfil de AEM, abra el perfil de AEM del usuario:

   1. Haga clic en​Usuario. Se muestra la página Administración de usuarios.

   2. Haga clic en el usuario que desee agregar y luego haga clic en Propiedades. Se muestra la página de configuración del usuario.

5. Haga clic en la pestaña Grupos.

   

6. Asegúrese de que el usuario pertenezca al menos a un grupo de Workfront con niveles de acceso que incluyan los permisos para Crear y Eliminar.

   1. Para añadir el usuario a un grupo existente, empiece a escribir el nombre del grupo en el cuadro Escriba el nombre del grupo y, a continuación, seleccione el grupo cuando aparezca en el menú desplegable.

      O

      Para seleccionar un grupo del que el usuario ya es integrante, seleccione un grupo en la sección Grupos a los que pertenece este usuario.

7. Haga clic en Guardar.