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:
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.
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 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
-
Vaya a https://id.atlassian.com/manage/api-tokens e inicie sesión.
-
Haga clic en Crear token de API.
-
Escriba un nombre para el token, como Workfront Fusion.
-
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.
-
Continuar con Configurar el token de API Jira en Workfront Fusion.
Configurar el token de la API Jira en Workfront Fusion
-
En Workfront Fusion, agregue un módulo Jira a un escenario para abrir el cuadro Crear una conexión.
-
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.
- URL de servicio: Esta es la URL base que usas para acceder a tu cuenta Jira. Ejemplo:
-
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.
-
En su terminal, ejecute los siguientes
opensslcomandos.-
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) en
jira_privatekey.pcks8
archivo. -
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 siguiente comando:
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 de nombre
jira_publickey.pem.
-
-
-
Continúe con Configurar la aplicación cliente como consumidor en Jira
Configurar 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 JiraConfiguración
-
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 -
Haga clic en Crear nuevo vínculo. Ignore el mensaje de error "No se recibió respuesta de la dirección URL que ha introducido".
-
En la ventana Vincular aplicaciones, introduzca valores en los campos Clave de consumidor y Secreto compartido.
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 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-tokenURL de autorización <Jira base url>/plugins/servlet/oauth/authorizeURL de token de acceso <Jira base url>/plugins/servlet/oauth/access-token -
Seleccione la casilla Crear vínculo entrante.
-
Haga clic en Continuar.
-
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. -
Haga clic en Continuar.
-
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
-
En cualquier módulo de Jira Server de Workfront Fusion, haga clic en Agregar junto al campo conexión.
-
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.pcks8que 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 -
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.
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.
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.
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.
<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 agrega 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.
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.
Descargar datos adjuntos
Este módulo de acción descarga un archivo adjunto concreto.
Al configurar este módulo, se muestran los campos siguientes.
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.
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.
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.
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.