Configurar Adobe Workfront for Jira
Puede utilizar Adobe Workfront for Jira para integrar sus sistemas Jira y Workfront.
Después de instalar el complemento, puede definir flujos de trabajo que creen problemas de Jira automáticamente cuando se creen elementos de trabajo de Workfront. Los elementos de ambas aplicaciones se vinculan y parte de su información se actualiza automáticamente en ambos sistemas.
Todos los usuarios de Workfront y Jira pueden beneficiarse de esta integración. Solo necesitan una licencia para el sistema en el que más trabajan, y no para ambos sistemas.
Este complemento está disponible para las versiones de Server y OnDemand (o Cloud) del software Jira.
Para obtener una lista de versiones de Jira que Workfront for Jira admite actualmente, consulte Workfront for Jira en el Atlassian Marketplace.
Requisitos de acceso
Debe tener lo siguiente:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront plan |
Nuevo: cualquiera o Actual: Pro o superior |
| Adobe Workfront licencia |
Nuevo: Standard o Actual: Plan |
| Jira Acceso del |
Acceso de administrador del sistema Importante: recomendamos crear cuentas de administrador del sistema independientes en Jira y Workfront para dedicarlas a esta integración, en lugar de utilizar las existentes que podrían estar adjuntas a los usuarios. |
| Configuraciones de nivel de acceso | Debe ser administrador de Workfront. |
Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación de Workfront.
Requisitos previos
Antes de poder configurar Workfront for Jira, debe:
- Instalar Workfront for Jira.
Para obtener instrucciones sobre la instalación de Workfront for Jira, consulte Instalar Adobe Workfront for Jira.
Configurar Workfront for Jira
Si configura Workfront for Jira, podrá:
- Defina los activadores que crearán elementos de Jira cuando se creen elementos de Workfront.
- Especifique qué campos deben sincronizarse entre los elementos vinculados entre Jira y Workfront.
- Después de configurar Workfront for Jira en su entorno de Jira, todos los usuarios de Jira verán un panel derecho de Workfront en todos los elementos de Jira. El panel contiene información sobre los elementos que podrían vincularse desde Workfront o especifica que no hay elementos de Workfront vinculados a elementos de Jira.
- Al utilizar la instalación de Jira Server, solo se muestran en el panel Workfront los problemas asociados con los proyectos identificados como activadores para la integración de Workfront. Para obtener más información acerca de la configuración de activadores para el flujo de trabajo de Workfront to Jira, consulte Configuración de activadores para vincular automáticamente elementos entre Jira y Workfront.
Para configurar Workfront for Jira:
-
Inicie sesión en Jira como administrador de Jira.
-
Haga clic en Configuración en el menú principal de Jira.
-
Haga clic en Complementos y luego haga clic en Administrar complementos.
-
Expanda el complemento de Workfront.
-
Haga clic en Configurar.
-
Siga las indicaciones para iniciar sesión en Workfront.
note note NOTE El usuario debe tener un(a) apiKeyválido(a) en Workfront para crear una conexión correcta.Debe iniciar sesión en Workfront como administrador de Workfront para continuar con la configuración.
note note NOTE - Workfront se conecta a Jira mediante OAuth 2.0, un estándar utilizado por la mayoría de las integraciones basadas en la web para la autenticación y autorización de usuarios.
- Cuando se le pida que introduzca el dominio de su cuenta de Workfront, escríbalo con este formato: eldominiodesucompañía.my.workfront.com. El dominio de su empresa suele ser el nombre de su empresa.
- La autenticación mejorada no está disponible hasta que un administrador de Workfront la habilite para esta integración.
-
En Jira, seleccione la pestaña Activadores para configurar la creación automática de Jira elementos a medida que se creen elementos nuevos de Workfront.
Para obtener más información sobre la configuración de activadores para el flujo de trabajo de Workfront a Jira, consulte Configuración de activadores para vincular automáticamente elementos entre Jira y Workfront.
-
Seleccione la ficha Configuración para configurar la sincronización de campos entre los elementos vinculados Jira y Workfront.
Para obtener más información acerca de cómo configurar la sincronización de campos entre Jira y Workfront, consulte Configurar la sincronización de campos entre Jira y Workfront Elementos.
note note NOTE Después de definir los activadores y la sincronización de campos entre las dos aplicaciones, cualquier usuario de Workfront que pueda crear tareas o problemas podría crear un activador para la creación de un elemento en Jira. El usuario puede crear un elemento si los criterios del elemento que crea coinciden con los activadores de Jira, aunque el usuario no tenga una licencia de Jira. Además, cualquier usuario de Jira puede empezar a trabajar inmediatamente en el elemento de Jira y sus actualizaciones son visibles en Workfront, sin que tenga una licencia de Workfront. Cualquier actualización de Workfront también está visible en los elementos de Jira. -
(Opcional) Seleccione la ficha Registro de actividad para revisar los errores que puedan haberse producido durante la integración.
Para obtener más información sobre el Registro de actividad, consulte Ver el Jira registro de actividad.
Configurar activadores para vincular automáticamente elementos entre Jira y Workfront
Como administrador del sistema de Jira, puede definir activadores que creen problemas automáticamente en Jira cuando un elemento de Workfront cumpla determinados criterios.
Tenga en cuenta lo siguiente al configurar y activar la creación de elementos de Jira a medida que se crean elementos de Workfront:
- La integración es unidireccional: solo puede crear elementos de activadores que cree en Workfront para que se creen automáticamente en Jira. No se pueden activar elementos creados en Jira para que se creen automáticamente en Workfront.
- No hay límite en cuanto a la cantidad de activadores que puede tener.
- Si un elemento que crea en Workfront coincide con más de uno de los activadores, solo se creará un elemento en Jira. El elemento se crea en Jira según el primer activador (en el orden en que se definieron en Jira). El resto de activadores se ignoran.
- Solo un elemento de Workfront se puede vincular a un elemento de Jira. Nunca puede vincular un elemento de Workfront a varios problemas de Jira, ni un problema de Jira a varios elementos de Workfront.
Para configurar activadores para crear automáticamente elementos en Jira:
-
Inicie sesión en Jira como administrador del sistema.
-
Haga clic en Configuración en el menú principal de Jira.
-
Haga clic en Complementos y luego en Administrar complementos.
-
Expanda el complemento de Workfront.
-
Haga clic en Configurar.
-
Inicie sesión en Workfront como administrador del sistema.
La pestaña Activadores está seleccionada de forma predeterminada en Jira.
-
Haga clic en Añadir activador para añadir un activador nuevo.
-
En el campo equipo/usuario/función de Workfront, especifique el nombre de un equipo, usuario o función de Workfront y, a continuación, haga clic para seleccionarlo cuando se muestre en la lista.
note note NOTE No puede tener varios activadores para el mismo equipo, usuario o función. Cuando alguien crea una tarea o un problema y lo asigna a una de estas entidades, se crea automáticamente un problema en Jira.
-
En el campo proyecto de Jira, empiece a escribir el nombre de un proyecto de Jira y, a continuación, haga clic en para seleccionarlo cuando se muestre en la lista.
Cuando se crea el problema de Jira, se coloca en el proyecto que eligió aquí.
-
Seleccione un Tipo de problema en el menú desplegable.
Indica el tipo de problema que se crea en Jira cuando se cumplen las condiciones de este activador, en función de la configuración de ese proyecto específico en Jira.
-
Haga clic en Guardar.
Con esta configuración, cada vez que un usuario de Workfront crea un elemento que coincide con los activadores especificados, se crea un nuevo problema en Jira.
Configurar la sincronización de campos entre elementos de Jira y Workfront
Como administrador de Jira, puede definir qué campos se deben sincronizar automáticamente en los elementos vinculados entre Workfront y Jira. Algunos campos se pueden sincronizar desde Workfront al elemento de Jira, mientras que otros se sincronizan desde Jira a Workfront.
Para definir qué campos deben sincronizarse automáticamente en los elementos vinculados entre las dos aplicaciones:
-
Inicie sesión en Jira como administrador de Jira.
-
Haga clic en Configuración en el menú principal de Jira.
-
Haga clic en Complementos y luego en Administrar complementos.
-
Expanda el complemento de Workfront.
-
Haga clic en Configurar.
-
Inicie sesión en Workfront como administrador de Workfront.
-
En Jira, haga clic en la pestaña Configuración.
-
En la sección Sincronizar de Workfront a Jira, seleccione los campos que desee actualizar en Jira cuando se actualicen en Workfront.
-
Seleccione cualquiera de las siguientes frecuencias con las que se sincronizan los campos:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header On Creation Los campos que especifique se sincronizan entre los elementos vinculados de Workfront y Jira cuando el elemento se crea en Workfront. Always Los campos que especifique se sincronizan entre los elementos vinculados de Workfront y Jira cuando los campos se actualizan en Workfront. Never Los campos que especifique nunca se sincronizan entre los elementos vinculados Workfront y Jira. No hay ninguna indicación en Jira de que el campo se haya actualizado en Workfront. -
Seleccione cualquiera de las siguientes opciones para sincronizar los campos de Workfront a Jira:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Name El nombre de una tarea o un problema de Workfront se convierte en el nombre del problema al que está vinculado en Jira.
Nota:Cuando se crean nuevos elementos en Jira automáticamente, el nombre de Workfront siempre se actualiza en el elemento de Jira, independientemente de si este campo está habilitado aquí o no. Cuando un elemento de Jira se vincula manualmente a un elemento de Workfront, el nombre del elemento de Workfront solo se actualiza en Jira cuando selecciona Sincronizar siempre este campo.Para obtener más información sobre la vinculación de elementos manual o automática, consulte Vinculación de elementos entre Adobe Workfront y Jira.
Description La descripción de una tarea o un problema en Workfront se convierte en la descripción del problema al que está vinculado en Jira. Documentos Los documentos adjuntos a una tarea o a un problema en Workfront también se adjuntan al problema al que está vinculado en Jira. Las nuevas versiones de Workfront se añaden como documentos independientes a Jira y se anexan con _v<número de versión> para indicar la versión numerada en Workfront.
Por ejemplo, si el nombre de un documento de Workfront es Anuncio principal y le añade una nueva versión en Workfront, la nueva versión se transfiere a Jira como un documento nuevo con el nombre Anuncio principal_v2.
Importante:
Tenga en cuenta lo siguiente al sincronizar documentos:
-
Los documentos de más de 5 MB no se sincronizan. Si falla la sincronización de un documento porque es demasiado grande, se registra un error en el registro de actividades.
Para obtener más información sobre el registro de actividad, consulte Ver el registro de actividad de Jira.
-
Los documentos vinculados a tareas y problemas de servidores externos no se transfieren a los elementos de Jira. Solo los documentos cargados directamente en la tarea o el problema de Workfront se transfieren al problema vinculado en Jira.
-
Para crear una prueba a partir de un documento, debe generar la prueba en Workfront.
Para obtener más información sobre cómo generar una prueba, consulte Crear una prueba para un documento existenteen Crear una prueba para un documento.
Planned Completion Date La Planned Completion Date de una tarea o un problema en Workfront se convierte en la Due Date del problema al que está vinculado en Jira.
Nota: Asegúrese de mostrar Due Date en los problemas de Jira para que este valor se sincronice.
-
-
-
En la sección Sincronizar de Jira aWorkfront, seleccione los campos que desea actualizar en Workfront cuando se actualicen en Jira.
-
Seleccione cualquiera de las siguientes frecuencias con las que se sincronizan los campos:
table 0-row-2 1-row-2 layout-auto html-authored no-header Always Los campos que especifique siempre se sincronizan entre los elementos vinculados de Workfront y Jira cuando los campos se actualizan en Jira. Never Los campos que especifique nunca se sincronizan entre los elementos vinculados de Workfront y Jira. No hay ninguna indicación en Workfront de que el campo se haya actualizado en Jira.
Nota: cuando selecciona Nunca, los campos de Workfront aún se pueden actualizar manualmente desde Jira en el panel izquierdo de Workfront del problema de Jira. Estas actualizaciones aparecen solamente en elementos de Workfront en Jira y Workfront, y no en elementos de Jira.
-
Seleccione sincronizar cualquiera de los siguientes campos de Jira a Workfront:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Status El Status de un problema en Jira se convierte en el Status de la tarea o problema al que está vinculado en Workfront.
Para obtener más información acerca de los estados de Workfront, consulte Crear o editar un estado.Assignee El Assignee de un problema en Jira se convierte en el Assignee de la tarea o problema al que está vinculado en Workfront.
Importante: Cuando se asigna un elemento de Jira a un usuario que no tiene una cuenta de Workfront, la integración crea un nuevo usuario activo en Workfront solo cuando Crea automáticamente un usuario en Workfront si el usuario de Jira no tiene una cuenta de Workfront se establece en Always. Este usuario no ocupa una licencia de Workfront.Los usuarios activos se pueden asignar a elementos de trabajo en Workfront, pero no se pueden incluir en las actualizaciones.
Attachments Los archivos adjuntos de un problema en Jira también se adjuntan a la tarea o problema al que está vinculado en Workfront. Comments También se publicó un comentario sobre un problema de Jira en el elemento de Workfront vinculado en el área de Updates. Por el contrario, un comentario publicado en el área de Updates para una tarea o un problema de Workfront se sincroniza con el flujo de comentarios nativo de Jira para el problema vinculado.
De forma predeterminada, se establece en Always. Si selecciona Never aquí, aún puede publicar comentarios manualmente sobre un elemento vinculado en Workfront o en Jira.
-
-
En la sección OTHER, seleccione qué campos adicionales deben actualizarse entre los elementos vinculados.
-
Seleccione una opción para determinar si los campos que especifique Siempre o Nunca se actualizan en Jira o Workfront cuando se modifican.
-
Seleccione entre los siguientes campos y actualizaciones:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Copy Workfront Custom Data in the right panel in Jira Muestra los datos personalizados de Workfront de un elemento en el panel derecho de Workfront.
Nota: Las secciones de formulario personalizado se muestran en el panel derecho de Workfront con el nivel de acceso del administrador del sistema Workfront.
Copy Workfront Priority in the right panel in Jira Muestra la prioridad de Workfront de un elemento en el panel derecho de Workfront. Add an update in the Workfront Updates tab about Due Date changes in Jira Se añade un comentario en la ficha Update del elemento de Workfront cuando la Due Date cambia en el elemento vinculado de Jira. Automatically create a user in Workfront if the Jira user does not have a Workfront account Se dan los siguientes escenarios:
-
Al seleccionar Always, habilita la integración para crear un nuevo usuario de Workfront cada vez que un usuario de Jira sin una cuenta de Workfront realice las siguientes acciones en un problema de Jira vinculado:
-
Se ha asignado a un problema de Jira
-
Registra el tiempo en un problema de Jira
Este nuevo usuario no ocupa una licencia de Workfront. El valor predeterminado es Siempre. El usuario creado de esta manera en Workfront tiene “Jira" añadido a su nombre.
-
-
Cuando selecciona Never, sucede lo siguiente:
- No puede ver ninguna asignación de Jira en los elementos de Workfront. En este caso, solo se muestran las asignaciones realizadas en Workfront en los elementos de Workfront.
- El tiempo que un usuario sin cuenta de Workfront ha registrado en un problema de Jira vinculado no se transfiere automáticamente al elemento de Workfront vinculado. Todavía puede registrar tiempo en el elemento Workfront del panel derecho del problema de Jira.
-
-
-
Haga clic en Guardar.
Ahora, cada vez que un usuario actualiza cualquiera de los campos especificados en esta configuración en un elemento de Jira o Workfront, también se actualiza el elemento vinculado en la otra aplicación.
Resolución de problemas
No se pueden crear elementos en Jira porque los campos del activador están marcados como “No se encontraron”
Problema
Cuando se produce un error con la aplicación Workfront for Jira, Workfront deshabilita los activadores para evitar mayores complicaciones. Cuando estos activadores están deshabilitados, se muestran como “No se pudo encontrar”.
Solución
Busque el error que deshabilitó los activadores. Puede encontrar el error en el Workfront for Jira Registro de actividad de .
La causa más común de este comportamiento es el error “No se puede establecer el campo duedate. No aparece en la pantalla adecuada o es desconocido”.
Este error significa que está intentando sincronizar la “Fecha planificada de finalización” de Workfront a Jira. Para ello, debe asegurarse de que los objetos de Jira tengan un campo denominado “Fecha de vencimiento”. Si no tiene este campo, Workfront no puede sincronizar la fecha planificada de finalización de Workfront y deshabilita los activadores.
Para resolver este error, intente una de las siguientes acciones:
- Pida al administrador de Jira que actualice los objetos de Jira afectados para asegurarse de que tengan un campo de fecha de vencimiento.
- Deshabilite la sincronización de la fecha planificada de finalización de Workfront en la página Configuración de Workfront.