Jira Software módulos

En un escenario de Adobe Workfront Fusion, puede automatizar los flujos de trabajo que utilizan Jira Software, así como conectarlo a varias aplicaciones y servicios de terceros.

Si necesita instrucciones para crear un escenario, consulte Crear un escenario en Adobe Workfront Fusion.

Para obtener información acerca de los módulos, vea Módulos en Adobe Workfront Fusion.

Requisitos de acceso

Debe tener el siguiente acceso para utilizar la funcionalidad de este artículo:

Adobe Workfront plan*
Pro o superior
Adobe Workfront licencia*
Plan, Trabajo
Adobe Workfront Fusion licencia**

Requisito de licencia actual: no se requiere licencia de Workfront Fusion.

O

Requisito de licencia heredado: Workfront Fusion para automatización e integración de trabajo

Product

Requisito de producto actual: si tiene el plan Select o Prime Adobe Workfront, su organización debe adquirir Adobe Workfront Fusion así como Adobe Workfront para utilizar la funcionalidad descrita en este artículo. Workfront Fusion está incluido en el plan Workfront de Ultimate.

O

Requisito de productos heredados: su organización debe comprar Adobe Workfront Fusion y Adobe Workfront para utilizar la funcionalidad descrita en este artículo.

Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.

Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias

Requisitos previos

Para usar módulos de Jira, debe tener una cuenta de Jira.

Conectar Jira Software a Workfront Fusion

El método de conexión se basa en si está usando Jira Cloud o Jira Server.

Conectar Jira Cloud a Workfront Fusion

Conectar Jira Cloud a Workfront Fusion

Para conectar Jira Software a Workfront Fusion, debe crear un token de API e insertarlo junto con la URL de servicio y el nombre de usuario en el campo Crear una conexión en Workfront Fusion.

Crear un token de API en Jira

  1. Vaya a https://id.atlassian.com/manage/api-tokens e inicie sesión.

  2. Haga clic en Crear token de API.

  3. Escriba un nombre para el token, como Workfront Fusion.

  4. Copie el token con el botón Copiar al portapapeles.

    note important
    IMPORTANT
    No puede volver a ver el token después de cerrar este cuadro de diálogo.

    1. Almacene el token generado en un lugar seguro.

  5. Continuar con Configurar el token de API Jira en Workfront Fusion.

Configurar el token de la API Jira en Workfront Fusion

  1. En Workfront Fusion, agregue un módulo Jira a un escenario para abrir el cuadro Crear una conexión.

  2. Especifique la siguiente información:

    • URL de servicio: Esta es la URL base que usas para acceder a tu cuenta Jira. Ejemplo: yourorganization.atlassian.net
    • Nombre de usuario
    • Token de API: Este es el token de API que creó en la sección Crear un token de API en Jira de este artículo.
  3. Haga clic en Continuar para crear la conexión y volver al módulo.

Conectar Jira Server a Workfront Fusion

Para autorizar una conexión entre Workfront Fusion y Jira Server, necesita su clave de consumidor, clave privada y dirección URL del servicio. Es posible que deba ponerse en contacto con el administrador de Jira para obtener esta información.

Generar claves públicas y privadas para la conexión Jira

Para adquirir una clave privada para la conexión de Workfront Fusion Jira, debe generar claves públicas y privadas.

  1. En su terminal, ejecute los siguientes openssl comandos.

    • openssl genrsa -out jira_privatekey.pem 1024

      Este comando genera una clave privada de 1024 bits.

    • openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365

      Este comando crea un certificado X509.

    • openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8

      Este comando extrae la clave privada (formato PKCS8) en jira_privatekey.pcks8
      archivo.

    • openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem

      Este comando extrae la clave pública del certificado al archivo jira_publickey.pem.

      note note
      NOTE
      Si utiliza Windows, es posible que tenga que guardar manualmente la clave pública del archivo jira_publickey.pem:
      1. En el terminal, ejecute el siguiente comando:

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. Copie la salida de terminal (incluidos -------BEGIN PUBLIC KEY-------- y -------END PUBLIC KEY--------

      3. Pegue la salida de terminal en un archivo de nombre jira_publickey.pem.

  2. Continúe con Configurar la aplicación cliente como consumidor en Jira

Configurar la aplicación cliente como consumidor en Jira

  1. Inicie sesión en su instancia de Jira.

  2. En el panel de navegación izquierdo, haga clic en JiraConfiguración > Aplicaciones> Vínculos de aplicación.

  3. En el campo Escriba la dirección URL de la aplicación que desea vincular, escriba

    code language-none
    https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
    
  4. Haga clic en Crear nuevo vínculo. Ignore el mensaje de error "No se recibió respuesta de la dirección URL que ha introducido".

  5. En la ventana Vincular aplicaciones, introduzca valores en los campos Clave de consumidor y Secreto compartido.

    Puede elegir los valores de estos campos.

  6. Copie los valores de los campos Consumer key y Shared secret en una ubicación segura.

    Necesitará estos valores más adelante en el proceso de configuración.

  7. Rellene los campos de la dirección URL como se indica a continuación:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Campo Descripción
    URL de token de solicitud <Jira base url>/plugins/servlet/oauth/request-token
    URL de autorización <Jira base url>/plugins/servlet/oauth/authorize
    URL de token de acceso <Jira base url>/plugins/servlet/oauth/access-token
  8. Seleccione la casilla Crear vínculo entrante.

  9. Haga clic en Continuar.

  10. En la ventana Vincular aplicaciones, rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    Clave de consumidor de Pegue la clave de consumidor que ha copiado en una ubicación segura.
    Nombre de consumidor Escriba un nombre de su elección. Este nombre es para su propia referencia.
    Clave pública Pegue la clave pública desde el archivo jira_publickey.pem.
  11. Haga clic en Continuar.

  12. Continuar a Crear una conexión con Jira Server o Jira Data Center en Workfront Fusion

Crear una conexión con Jira Server o Jira Data Center en Workfront Fusion

NOTE
Use la aplicación Jira Server para conectarse a Jira Server o Jira Data Center.
  1. En cualquier módulo de Jira Server de Workfront Fusion, haga clic en Agregar junto al campo conexión.

  2. En el panel Crear una conexión, rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Nombre de conexión Escriba un nombre para la conexión
    Clave de consumidor de Pegue la clave de consumidor que ha copiado en una ubicación segura de Configure la aplicación cliente como consumidor en Jira
    Private Key Pegue la clave privada del archivo jira_privatekey.pcks8 que creó en Generar claves públicas y privadas para la conexión Jira.
    Service URL Escriba la URL de instancia Jira. Ejemplo: yourorganization.atlassian.net
  3. Haga clic en Continuar para crear la conexión y volver al módulo.

Jira Software módulos y sus campos

Al configurar Jira Software módulos, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse Jira Software campos adicionales, según factores como el nivel de acceso en la aplicación o el servicio. Un título en negrita en un módulo indica un campo obligatorio.

Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro en Adobe Workfront Fusion.

Déclencheur

Observar registros

Este módulo de déclencheur inicia un escenario cuando se agrega, actualiza o elimina un registro.

Webhook

Seleccione el webhook que desee utilizar para buscar registros.

Para agregar un nuevo webhook:

  1. Haga clic en Agregar

  2. Escriba un nombre para el webhook.

  3. Seleccione la conexión que desea utilizar para su webhook.

    Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.

  4. Seleccione el tipo de registro que desea que vea el software:

    • Comentario
    • Problema
    • Proyecto
    • Sprint

Acciones

Agregar problema al sprint

Este módulo de acción añade uno o más problemas a un sprint.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.
Sprint ID
Introduzca o asigne el ID de sprint del sprint al que desea agregar un problema.
Id. de problema o claves
Agregue un ID o una clave de problema para cada problema que desee agregar al sprint.

Crear un registro

Este módulo de acción crea un nuevo registro en Jira.

El módulo devuelve cualquier campo estándar asociado con el registro, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.
Tipo de registro

Seleccione el tipo de registro que desea que cree el módulo. Al seleccionar un tipo de registro, en el módulo aparecen otros campos específicos de dicho tipo de registro.

  • Datos adjuntos
  • Comentario
  • Problema
  • Proyecto
  • Sprint
  • Registro de trabajo

Llamada de API personalizada

Este módulo de acción le permite realizar una llamada autenticada personalizada a la API Jira Software. De este modo, puede crear una automatización del flujo de datos que no puedan realizar los otros Jira Software módulos.

Al configurar este módulo, se muestran los campos siguientes.

Seleccione el método de solicitud HTTP que necesita para configurar la llamada de API. Para obtener más información, vea Métodos de solicitud HTTP en Adobe Workfront Fusion.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.
URL
Introduzca una ruta relativa a<Instance URL>/rest/api/2/
Método
Encabezados

Añada los encabezados de la solicitud en forma de objeto JSON estándar.

Por ejemplo, {"Content-type":"application/json"}

Workfront Fusion agrega los encabezados de autorización automáticamente.

Cadena de consulta

Añada la consulta para la llamada de API en forma de objeto JSON estándar.

Por ejemplo: {"name":"something-urgent"}

Cuerpo

Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.

Nota:

Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.

Eliminar un registro

Este módulo de acción elimina un registro en particular.

Especifique el ID del registro.

El módulo devuelve el ID del registro y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.
Tipo de registro

Seleccione el tipo de registro que desea que elimine el módulo.

  • Datos adjuntos
  • Comentario
  • Problema
  • Proyecto
  • Sprint
ID o clave
Introduzca o asigne el ID o la clave del registro que desea eliminar.

Descargar datos adjuntos

Este módulo de acción descarga un archivo adjunto concreto.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.
ID
Introduzca o asigne el ID del archivo adjunto que desea descargar.

Leer un registro

Este módulo de acción lee datos de un único registro de Jira Software.

Especifique el ID del registro.

El módulo devuelve cualquier campo estándar asociado con el registro, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.
Tipo de registro

Seleccione el tipo de registro Jira que desea que lea el módulo.

  • Datos adjuntos
  • Problema
  • Proyecto
  • Sprint
  • Usuario
Salidas
Seleccione las salidas que desee recibir. Las opciones de salida están disponibles en función del tipo de registro seleccionado en el campo "Record Type".
ID
Escriba o asigne el identificador único Jira Software del registro que desea que lea el módulo.

Actualizar un registro

Este módulo de acción actualiza un registro existente, como un problema o un proyecto,.

Especifique el ID del registro.

El módulo devuelve el ID del registro y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.
Tipo de registro

Seleccione el tipo de registro que desea que actualice el módulo. Al seleccionar un tipo de registro, en el módulo aparecen otros campos específicos de dicho tipo de registro.

  • Comentario
  • Problema
  • Proyecto
  • Sprint
  • Problema de transición
ID o clave
Introduzca o asigne el ID o la clave del registro que desea actualizar.

Búsquedas

Enumerar registros

Este módulo de búsqueda recupera todos los elementos de un tipo específico que coinciden con la consulta de búsqueda

Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.
Tipo de registro

Seleccione el tipo de registro que desea que enumere el módulo. Al seleccionar un tipo de registro, en el módulo aparecen otros campos específicos de dicho tipo de registro.

  • Comentario
  • Problema
  • Proyecto
  • Sprint issue
  • Registro de trabajo
Resultados máximos
Introduzca o asigne el número máximo de registros que desea que el módulo recupere durante cada ciclo de ejecución de escenario.

Buscar registros

Este módulo de búsqueda busca registros en un objeto de Jira Software que coincidan con la consulta de búsqueda especificada.

Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Jira Software a Workfront Fusion, vea Conectar Jira Software a Workfront Fusion en este artículo.
Tipo de registro

Seleccione el tipo de registro que desea que busque el módulo. Al seleccionar un tipo de registro, en el módulo aparecen otros campos específicos de dicho tipo de registro.

  • Problemas

  • Issues by JQL (Jira Query Language)

    Para obtener más información sobre JQL, consulte JQL en el sitio de ayuda de Atlassian.

  • Proyecto

  • Proyecto por problema

  • Usuario

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43