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
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:
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:
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
-
Cree un token de API en Jira.
Para obtener instrucciones, recomendamos buscar "Crear un token de API" en la documentación de Jira.
-
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.
-
Continúe en Configurar el token de API Jira en Workfront Fusion.
Configurar el token de la API Jira en Workfront Fusion
-
En cualquier módulo de Jira Cloud de Workfront Fusion, haga clic en Add junto al campo connection.
-
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.
-
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.
-
En su terminal, ejecute los comandos
opensslsiguientes.-
openssl genrsa -out jira_privatekey.pem 1024Este comando genera una clave privada de 1024 bits.
-
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365Este comando crea un certificado X509.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8Este comando extrae la clave privada (formato PKCS8) al archivo
jira_privatekey.pcks8. -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pemEste 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:-
En el terminal, ejecute el comando siguiente:
openssl x509 -pubkey -noout -in jira_publickey.cer -
Copie la salida de terminal, incluidos
-------BEGIN PUBLIC KEY--------y-------END PUBLIC KEY--------. -
Pegue la salida de terminal en un archivo con nombre
jira_publickey.pem.
-
-
-
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
-
Inicie sesión en su instancia de Jira.
-
En el panel de navegación izquierdo, haga clic en Jira Settings
-
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 -
Haga clic en Create new link. Ignore el mensaje de error “No se ha recibido respuesta de la dirección URL que ha introducido”.
-
En la ventana Link applications, escriba valores en los campos Consumer key y Shared secret.
Puede elegir los valores de estos campos.
-
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.
-
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-tokenAuthorization URL <Jira base url>/plugins/servlet/oauth/authorizeAccess Token URL <Jira base url>/plugins/servlet/oauth/access-token -
Seleccione la casilla de verificación Create incoming link.
-
Haga clic en Continue.
-
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. -
Haga clic en Continue.
-
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
-
En cualquier módulo de Jira Server de Workfront Fusion, haga clic en Add junto al campo connection.
-
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.pcks8que 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 -
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.
Activadores
Watch for records
Este módulo de activación inicia un escenario cuando se añade, actualiza o elimina un registro.
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.
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.
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.
<Instance URL>/rest/api/2/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.
Añada la consulta para la llamada de API en forma de objeto JSON estándar.
Por ejemplo: {"name":"something-urgent"}
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.
Download an attachment
Este módulo de acción descarga un archivo adjunto concreto.
Al configurar este módulo, se muestran los campos siguientes.
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.
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.
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.
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.