Configurar Adobe Workfront for Jira

Puede usar Adobe Workfront for Jira para integrar sus sistemas Jira y Workfront.

Después de instalar el complemento, puede definir flujos de trabajo que creen Jira problemas automáticamente cuando se creen Workfront elementos de trabajo. 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 Jira versiones que Workfront for Jira admite actualmente, consulte Workfront for Jira en Atlassian Marketplace.

Requisitos de acceso

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

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 access

Acceso de administrador del sistema

Importante: Se recomienda crear cuentas de administrador del sistema independientes en Jira y Workfront para dedicarlas a esta integración, en lugar de usar las existentes que podrían adjuntarse 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

Para poder configurar Workfront for Jira, debe:

Configurar Workfront for Jira

Si configura Workfront for Jira, podrá:

  • Defina los déclencheur que crearán Jira elementos cuando se creen Workfront elementos.
  • Especifique qué campos deben sincronizarse entre los elementos vinculados entre Jira y Workfront.
NOTE
  • Después de configurar Workfront for Jira en su entorno 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 Workfront vinculados a Jira elementos.
  • Al utilizar la instalación de Jira Server, solo se muestran en el panel Workfront los problemas asociados con los proyectos identificados como déclencheur para la integración de Workfront. Para obtener más información acerca de la configuración de déclencheur para el flujo de trabajo Workfront to Jira, consulte Configuración de déclencheur para vincular automáticamente elementos entre Jira y Workfront.

Para configurar Workfront for Jira:

  1. Inicie sesión en Jira como administrador de Jira.

  2. Haga clic en Configuración en el menú principal de Jira.

  3. Haz clic en Complementos y luego haz clic en Administrar complementos.

  4. Expanda el complemento Workfront.

  5. Haga clic en Configurar.

  6. Siga las indicaciones para iniciar sesión en Workfront.

    note note
    NOTE
    El usuario debe tener un(a) apiKey vá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: yourCompany'sDomain.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.
  7. En Jira, seleccione la ficha Déclencheur para configurar la creación automática de Jira elementos a medida que se creen Workfront elementos nuevos.

    Para obtener más información sobre la configuración de déclencheur para el flujo de trabajo de Workfront a Jira, consulte Configuración de déclencheur para vincular automáticamente elementos entre Jira y Workfront.

  8. Seleccione la ficha Setup 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, vea Configurar la sincronización de campos entre Jira y Workfront Elementos.

    note note
    NOTE
    Después de definir los déclencheur y la sincronización de campos entre las dos aplicaciones, cualquier usuario de Workfront que pueda crear tareas o problemas podría crear un déclencheur 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 déclencheur 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 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 Jira elementos.
  9. (Opcional) Seleccione la pestaña Registro de actividad para revisar los errores que puedan haberse producido durante la integración.

    Para obtener más información sobre Registro de actividad, consulte Ver el Jira Registro de actividad.

Configurar déclencheur para vincular automáticamente elementos entre Jira y Workfront

Como administrador del sistema de Jira, puede definir déclencheur que crearían problemas automáticamente en Jira cuando un elemento de Workfront cumpla determinados criterios.

NOTE
La integración podría tardar hasta 10 minutos en crear nuevos problemas en Jira.

Tenga en cuenta lo siguiente al configurar y activar la creación de Jira elementos a medida que se crean Workfront elementos:

  • La integración es unidireccional: solo puede crear elementos de déclencheur que cree en Workfront para que se creen automáticamente en Jira. No puede almacenar en déclencheur elementos que cree en Jira para que se creen automáticamente en Workfront.
  • No hay límite en cuanto a la cantidad de déclencheur que puede tener.
  • Si un elemento que crea en Workfront coincide con más de uno de los déclencheur, sólo se creará un elemento en Jira. El elemento se crea en Jira según el primer déclencheur (en el orden en que se definieron en Jira). El resto de déclencheur 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 déclencheur para crear automáticamente elementos en Jira:

  1. Inicie sesión en Jira como administrador del sistema.

  2. Haga clic en Configuración en el menú principal de Jira.

  3. Haz clic en Complementos y luego en Administrar complementos.

  4. Expanda el complemento Workfront.

  5. Haga clic en Configurar.

  6. Inicie sesión en Workfront como administrador del sistema.

    La ficha Déclencheur está seleccionada de forma predeterminada en Jira.

  7. Haga clic en Agregar déclencheur para agregar un déclencheur nuevo.

  8. En el campo equipo/usuario/función de Workfront, especifique el nombre de un equipo, usuario o función de trabajo de Workfront y, a continuación, haga clic en para seleccionarlo cuando se muestre en la lista.

    note note
    NOTE
    No puede tener varios déclencheur para el mismo equipo, usuario o rol.

    Cuando alguien crea una tarea o un problema y lo asigna a una de estas entidades, se crea automáticamente un problema en Jira.

  9. En el campo Jiraproyecto, empiece a escribir el nombre de un proyecto Jira y, a continuación, haga clic en para seleccionarlo cuando se muestre en la lista.

    Cuando se crea el problema Jira, se coloca en el proyecto que eligió aquí.

  10. Seleccione un Itipo de problema en el menú desplegable.

    Indica el tipo de problema que se crea en Jira cuando se cumplen las condiciones de este déclencheur, en función de la configuración de ese proyecto específico en Jira.

  11. Haga clic en Guardar.

    Con esta configuración, cada vez que un usuario de Workfront crea un elemento que coincide con los déclencheur especificados, se crea un nuevo problema en Jira.

Configurar la sincronización de campos entre Jira y Workfront elementos

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 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:

  1. Inicie sesión en Jira como administrador de Jira.

  2. Haga clic en Configuración en el menú principal de Jira.

  3. Haz clic en Complementos y luego en Administrar complementos.

  4. Expanda el complemento Workfront.

  5. Haga clic en Configurar.

  6. Inicie sesión en Workfront como administrador de Workfront.

  7. En Jira, haga clic en la ficha Configuración.

  8. En la sección Sincronizar de Workfront a Jira, seleccione los campos que desee actualizar en Jira cuando se actualicen en Workfront.

    1. 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
      Al Crear Los campos que especifique se sincronizan entre los elementos vinculados de Workfront y Jira cuando el elemento se crea en Workfront.
      Siempre Los campos que especifique se sincronizan entre los elementos vinculados de Workfront y Jira cuando los campos se actualizan en Workfront.
      Nunca 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.
    2. 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
      Nombre

      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 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 cómo vincular elementos de forma manual o automática, vea Vincular elementos entre Adobe Workfront y Jira.

      Descripción 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 agregan 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 agrega 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 Jira elementos. Solo los documentos cargados directamente en la tarea o el problema de Workfront se transfieren al problema vinculado en Jira.

      • Para crear una revisión a partir de un documento, debe generar la revisión en Workfront.

        Para obtener más información sobre cómo generar una revisión, consulte Crear una revisión para un documento existenteen Crear una revisión para un documento.

      Fecha planificada de finalización

      La Fecha planificada de finalización de una tarea o un problema en Workfront se convierte en la Fecha de vencimiento del problema al que está vinculado en Jira.

      Nota: Asegúrese de mostrar Fecha de vencimiento en Jira problemas para que este valor se sincronice.

  9. En la sección Sincronizar de Jira aWorkfront, seleccione los campos que desea actualizar en Workfront cuando se actualicen en Jira.

    1. 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
      Siempre Los campos que especifique siempre se sincronizan entre los elementos vinculados Workfront y Jira cuando los campos se actualizan en Jira.
      Nunca

      Los campos que especifique nunca se sincronizan entre los elementos vinculados Workfront y Jira. No hay ninguna indicación en Workfront de que el campo se haya actualizado en Jira.

      Nota: cuando selecciona Nunca, Workfront campos aún se pueden actualizar manualmente desde Jira en el panel izquierdo Workfront del problema Jira. Estas actualizaciones aparecen solamente en Workfront elementos de Jira y Workfront, y no en Jira elementos.

    2. 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
      Estado El Estado de un problema en Jira se convierte en el Estado de la tarea o problema al que está vinculado en Workfront.
      Para obtener más información acerca de Workfront estados, vea Crear o editar un estado.
      Asignado

      El asignado de un problema en Jira se convierte en el asignado de la tarea o problema al que está vinculado en Workfront.

      Importante: Cuando 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.

      Archivos adjuntos Los archivos adjuntos de un problema en Jira también se adjuntan a la tarea o problema al que está vinculado en Workfront.
      Comentarios

      También se publicó un comentario sobre un problema de Jira en el elemento 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.

  10. En la sección OTHER, seleccione qué campos adicionales deben actualizarse entre los elementos vinculados.

    1. Seleccione una opción para determinar si los campos que especifica Siempre o Nunca se actualizan en Jira o Workfront cuando se modifican.

    2. 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
      Copiar Workfront datos personalizados en el panel derecho de Jira

      Muestra los datos personalizados Workfront de un elemento en el panel derecho 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.

      Copiar prioridad Workfront en el panel derecho de Jira Muestra la prioridad Workfront de un elemento en el panel derecho Workfront.
      Agregar una actualización en la ficha Workfront actualizaciones acerca de los cambios de fecha de vencimiento en Jira Agrega un comentario en la ficha Actualización del elemento Workfront cuando Fecha de vencimiento cambia en el elemento Jira vinculado.
      Crear automáticamente un usuario en Workfront si el usuario Jira no tiene una cuenta de Workfront

      Existen 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 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" agregado a su nombre.

      • Cuando selecciona Nunca, suceden las siguientes cosas:

        • 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 Workfront elementos.
        • 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 Jira.
  11. 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 debido a campos de déclencheur marcados como "No se encontraron"

Problema

Cuando se produce un error con la aplicación Workfront for Jira, Workfront deshabilita los déclencheur para evitar complicaciones adicionales. Cuando estos déclencheur están deshabilitados, se muestran como "No se pudo encontrar".

Solución

Busque el error que deshabilitó las déclencheur. Puede encontrar el error en Workfront for Jira Registro de actividad.

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 las déclencheur.

Para resolver este error, intente una de las siguientes acciones:

  • Pida al administrador de Jira que actualice los objetos 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.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43