Módulos de Jira Software

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

Estas instrucciones se aplican tanto a los módulos de Jira Cloud como al servidor Jira.

Para obtener instrucciones sobre cómo crear un escenario, vea los artículos en Crear escenarios: índice de artículos.

Para obtener información acerca de los módulos, vea los artículos en Módulos: índice de artículos.

Requisitos de acceso

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

Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
paquete de Adobe Workfront Cualquiera
Licencia de Adobe Workfront

Nuevo: estándar

O

Actual: Trabajo o superior

Licencia de Adobe Workfront Fusion**

Actual: no se requiere licencia de Workfront Fusion.

O

Heredado: Workfront Fusion para la automatización e integración del trabajo

Producto

Nuevo:

  • Seleccione o paquete de Prime Workfront: su organización debe adquirir Adobe Workfront Fusion.
  • Paquete de Ultimate Workfront: Workfront Fusion está incluido.

O

Actual: Su organización debe adquirir Adobe Workfront Fusion.

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

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.

Información de API de Jira

El conector Jira utiliza lo siguiente:

Jira Cloud
Servidor Jira
apiVersion
2
2
apiVersionAgile
1,0
1,0
Etiqueta de API
1.7.29
1.0.19

Conectar Jira Software a Workfront Fusion

El método de conexión se basa en si se 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 Create a connection en Workfront Fusion.

Crear un token de API en Jira

  1. Cree un token de API en Jira.

    Para obtener instrucciones, recomendamos buscar "Crear un token de API" en la documentación de Jira.

  2. Después de crear el token, cópielo en una ubicación segura.

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

    1. Almacene el token generado en un lugar seguro.

  3. Continúe en Configurar el token de API Jira en Workfront Fusion.

Configurar el token de la API Jira en Workfront Fusion

  1. En cualquier módulo de Jira Cloud de Workfront Fusion, haga clic en Add junto al campo connection.

  2. Especifique la siguiente información:

    • Entorno
    • Tipo
    • Service URL: Esta es la URL base que usa para acceder a su cuenta de Jira. Ejemplo: yourorganization.atlassian.net
    • Username
    • API token: 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 Continue 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 cliente, clave privada y URL del servicio. Es posible que deba comunicarse con el administrador de Jira para obtener esta información.

Generación de claves públicas y privadas para su conexión a Jira

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

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

    • 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) al archivo jira_privatekey.pcks8.

    • 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 comando siguiente:

        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 con nombre jira_publickey.pem.

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

Configuración de 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 Jira Settings icono de configuración de Jira > Applications> Application links.

  3. En el campo Enter the URL of the application you want to link, escriba

    code language-none
    https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
    
  4. Haga clic en Create new link. Ignore el mensaje de error “No se ha recibido respuesta de la dirección URL que ha introducido”.

  5. En la ventana Link applications, escriba valores en los campos Consumer key y Shared secret.

    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 tal como se indica a continuación:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Campo Descripción
    Request Token URL <Jira base url>/plugins/servlet/oauth/request-token
    Authorization URL <Jira base url>/plugins/servlet/oauth/authorize
    Access Token URL <Jira base url>/plugins/servlet/oauth/access-token
  8. Seleccione la casilla de verificación Create incoming link.

  9. Haga clic en Continue.

  10. En la ventana Link applications, rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    Consumer Key Pegue la clave del cliente que ha copiado en una ubicación segura.
    Consumer name Introduzca un nombre de su elección. Este nombre es para su propia referencia.
    Public key Pegue la clave pública de su archivo jira_publickey.pem.
  11. Haga clic en Continue.

  12. Continúe para Crear una conexión a Jira Server o a Jira Data Center en Workfront Fusion

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

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

  2. En el panel Create a connection, rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection name Introduzca un nombre para la conexión
    Environment Seleccione si está utilizando un entorno de producción o de no producción.
    Type Seleccione si utiliza una cuenta de servicio o una cuenta personal.
    Consumer Key Pegue la clave del cliente que ha copiado en una ubicación segura de Configurar 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 de Jira.
    Service URL Escriba la URL de instancia Jira. Ejemplo: yourorganization.atlassian.net
  3. Haga clic en Continue para crear la conexión y volver al módulo.

Módulos de Jira Software y sus campos

Al configurar módulos de Jira Software, 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. El 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.

Conmutador Asignar

Activadores

Watch for records

Este módulo de activación inicia un escenario cuando se añade, actualiza o elimina un registro.

Webhook

Seleccione el webhook que desee utilizar para buscar registros.

Para añadir un nuevo webhook:

  1. Haga clic Add

  2. Introduzca 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, consulte Conectar Jira Software a Workfront Fusion en este artículo.

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

    • Comment
    • Issue
    • Project
    • Sprint

Acciones

Add issue to 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.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Jira Software a Workfront Fusion, consulte Conectar Jira Software a Workfront Fusion en este artículo.
Sprint ID
Introduzca o asigne el ID de sprint del sprint al que desea añadir un problema.
Issue ID or Keys
Para cada problema o clave que desee que vea la experiencia, haga clic en Add item e introduzca el identificador o la clave del problema. Puede introducir hasta 50 en un módulo.

Create a Record

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 los campos y valores personalizados a los que accede 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.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Jira Software a Workfront Fusion, consulte Conectar Jira Software a Workfront Fusion en este artículo.
Record Type

Seleccione el tipo de registro que desea que cree el módulo y, a continuación, rellene los demás campos específicos de ese tipo de registro que aparecen en el módulo.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
  • Worklog

Custom API Call

Este módulo de acción le permite realizar una llamada autenticada personalizada a la API Jira Software. Utilice este módulo para 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 petición HTTP que necesita para configurar la llamada de la API. Para obtener más información, vea Métodos de solicitud HTTP.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Jira Software a Workfront Fusion, consulte Conectar Jira Software a Workfront Fusion en este artículo.
URL
Introduzca una ruta relativa a<Instance URL>/rest/api/2/
Method
Headers

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

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

Workfront Fusion añade los encabezados de autorización automáticamente.

Query String

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

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

Body

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.

Delete a record

Este módulo de acción elimina el registro especificado.

Especifique el identificador del registro.

El módulo devuelve el identificador 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.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Jira Software a Workfront Fusion, consulte Conectar Jira Software a Workfront Fusion en este artículo.
Record Type

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

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
ID or Key
Introduzca o asigne el ID o la clave del registro que desea eliminar.

Download an attachment

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

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

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Jira Software a Workfront Fusion, consulte Conectar Jira Software a Workfront Fusion en este artículo.
ID
Introduzca o asigne el ID del archivo adjunto que desea descargar.

Read a record

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

Especifique el identificador del registro.

El módulo devuelve cualquier campo estándar asociado con el registro, junto con los campos y valores personalizados a los que accede 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.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Jira Software a Workfront Fusion, consulte Conectar Jira Software a Workfront Fusion en este artículo.
Record Type

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

  • Attachment
  • Issue
  • Project
  • Sprint
  • User
Outputs
Seleccione las salidas que desea recibir. Las opciones de salida están disponibles según el 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.

Update a record

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

Especifique el identificador del registro.

El módulo devuelve el identificador 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.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Jira Software a Workfront Fusion, consulte Conectar Jira Software a Workfront Fusion en este artículo.
Record Type

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

  • Comment
  • Issue
  • Project
  • Sprint
  • Transition issue
ID or Key
Introduzca o asigne el ID o la clave del registro que desea actualizar y, a continuación, rellene los demás campos específicos de ese tipo de registro que aparecen en el módulo.

Búsquedas

List records

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.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Jira Software a Workfront Fusion, consulte Conectar Jira Software a Workfront Fusion en este artículo.
Record Type

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

  • Comment
  • Issue
  • Project
  • Sprint issue
  • Worklog
Max Results
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.

Search for records

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.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Jira Software a Workfront Fusion, consulte Conectar Jira Software a Workfront Fusion en este artículo.
Record Type

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

  • Issues

  • Issues by JQL (Jira Query Lanuguage)

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

  • Project

  • Project by issue

  • User

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3