Módulos Jira

NOTE
Estas instrucciones se aplican a la nueva versión del conector Jira, que simplemente se denomina Jira. Para obtener instrucciones sobre los conectores heredados de Jira Cloud y Jira Server, consulte Módulos de software de Jira.

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

El conector Jira se puede utilizar tanto para Jira Cloud como para Jira Data Server.

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 comprar 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 las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.

Requisitos previos

Para utilizar módulos Jira, debe tener una cuenta Jira.

Conexión de Jira a Workfront Fusion

Crear las credenciales necesarias

Para crear conexiones a Jira, necesitará lo siguiente:

Tipo de conexión
Tipo de cuenta
Credenciales necesarias
OAuth 2
Cualquiera
ID de cliente y secreto de cliente
Básico
Jira Cloud
Token de API de Jira
Básico
Centro de datos de Jira
Token de acceso personal de Jira (PAT)

Para obtener instrucciones sobre cómo crear cualquiera de estos, consulte la documentación de Jira.

Al crear estas credenciales, necesitará la siguiente información:

  • Para OAuth 2:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Centro de datos Fusion Dirección URL de redireccionamiento
    US https://app.workfrontfusion.com/oauth/cb/workfront-jira2
    UE https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira2
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira2
  • Para tokens de acceso personal (PAT):

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Centro de datos Fusion Dirección URL de redireccionamiento
    US https://app.workfrontfusion.com/oauth/cb/workfront-jira
    UE https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira
    note important
    IMPORTANT
    Para utilizar una ruta de acceso, debe habilitar lo siguiente en los archivos jira/bin/WEB-INF/classes, en el archivo jira-config.properties:
    • jira.rest.auth.allow.basic = true
    • jira.rest.csrf.disabled = true
    Si este archivo no existe, debe crearlo.

Creación de la conexión con Jira en Workfront Fusion

Para crear la conexión en Workfront Fusion:

  1. En cualquier módulo Jira, haga clic en Agregar junto al campo Conexión.

  2. Configure los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto html-authored no-header
    Tipo de conexión Seleccione si va a crear una conexión básica o una conexión OAuth 2.
    Nombre de conexión Introduzca un nombre para la nueva conexión.
    URL de servicio Introduzca la URL de instancia de Jira. Esta es la URL que usa para acceder a Jira.
    Tipo de cuenta de Jira Seleccione si desea conectarse a Jira Cloud o al centro de datos de Jira.
    Id. de cliente Si está creando una conexión OAuth 2, introduzca su ID de cliente de Jira
    Secreto de cliente Si está creando una conexión OAuth 2, introduzca el Secreto del cliente Jira
    Correo electrónico Si está creando una conexión básica con Jira Cloud, escriba su dirección de correo electrónico.
    Token de API Si está creando una conexión básica con Jira Cloud, introduzca su token de API.
    Token de acceso personal Si está creando una conexión básica con el centro de datos de Jira, introduzca su token de acceso personal.
    Versión de API Seleccione la versión de la API de Jira a la que desea conectarse esta conexión.
  3. Haga clic en Continuar para crear la conexión y volver al módulo.

Módulos Jira y sus campos

Al configurar los módulos Jira, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, pueden mostrarse campos Jira 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

Buscar registros

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 o cree uno nuevo.

Para crear un nuevo webhook:

  1. Haga clic en Agregar

  2. Introduzca un nombre para el webhook.

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

    Para obtener instrucciones sobre cómo conectar tu cuenta de Jira a Workfront Fusion, consulta Conectar Jira a Workfront Fusion en este artículo.

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

    • Problema
    • Comentario
    • Registro de trabajo
    • Proyecto
    • Sprint
    • Archivos adjuntos
  5. Seleccione uno o varios tipos de eventos que almacenarán este escenario en déclencheur.

  6. Introduzca un filtro de idioma de consulta Jira para este módulo.

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

  7. Haga clic en Guardar para guardar el webhook.

Acciones

Añadir problema al sprint

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

Conexión
Para obtener instrucciones sobre cómo conectar tu cuenta de Jira a Workfront Fusion, consulta Conectar Jira a Workfront Fusion en este artículo.
ID de Sprint
Introduzca o asigne el ID de sprint del sprint al que desea añadir un problema.
ID de problema o claves
Para cada problema o clave que desee agregar al sprint, haga clic en Agregar elemento e introduzca el identificador o la clave del problema. Puede introducir hasta 50 en un módulo.

Crear un registro

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

Conexión
Para obtener instrucciones sobre cómo conectar tu cuenta de Jira a Workfront Fusion, consulta Conectar Jira a Workfront Fusion en este artículo.
Tipo de registro

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

  • Archivos adjuntos
  • Comentario
  • Problema
  • Proyecto
  • Sprint
  • Registro de trabajo
  • Usuario
  • Tablero
  • Categoría
  • Filtro
Otros campos
Rellene los demás campos. Los campos están disponibles en función del tipo de registro seleccionado.

Llamada de API personalizada

Este módulo de acción le permite realizar una llamada autenticada personalizada a la API de Jira.

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.

Conexión
Para obtener instrucciones sobre cómo conectar tu cuenta de Jira a Workfront Fusion, consulta Conectar Jira 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 añade los encabezados de autorización para usted.

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.

Eliminación de un registro

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

Conexión
Para obtener instrucciones sobre cómo conectar tu cuenta de Jira a Workfront Fusion, consulta Conectar Jira a Workfront Fusion en este artículo.
Tipo de registro

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

  • Comentario
  • Problema
  • Proyecto
  • Sprint
  • Registro de trabajo
  • Archivos adjuntos
  • Tablero
  • Categoría
  • Filtro
(Tipo de registro)ID
Introduzca o asigne el ID o la clave del registro que desea eliminar.

Descargar un archivo adjunto

Este módulo de acción descarga el archivo adjunto especificado.

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

Leer un registro

Este módulo de acción lee datos del registro especificado en Jira.

Conexión
Para obtener instrucciones sobre cómo conectar tu cuenta de Jira a Workfront Fusion, consulta Conectar Jira a Workfront Fusion en este artículo.
Tipo de registro

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

  • Archivos adjuntos
  • Comentario
  • Problema
  • Proyecto
  • Sprint
  • Registro de trabajo
  • Usuario
  • Tablero
  • Categoría
  • Filtro
Salidas
Seleccione las salidas que desea recibir. Las opciones de salida están disponibles en función del tipo de registro seleccionado en el campo "Tipo de registro".
ID (Tipo de registro)
Introduzca o asigne el ID de Jira único 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.

Conexión
Para obtener instrucciones sobre cómo conectar tu cuenta de Jira a Workfront Fusion, consulta Conectar Jira 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 aparecerán otros campos específicos de dicho tipo de registro.

  • Comentario
  • Problema
  • Proyecto
  • Sprint
  • Problema de transición
  • Categoría
  • Filtro
ID o clave
Introduzca o asigne el ID o la clave del registro que desea actualizar.
Otros campos
Rellene los demás campos. Los campos están disponibles en función del tipo de registro seleccionado.

Búsquedas

Búsqueda de registros

Este módulo de búsqueda busca registros en un objeto de Jira 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 sobre cómo conectar tu cuenta de Jira a Workfront Fusion, consulta Conectar Jira 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 aparecerán otros campos específicos de dicho tipo de registro.

  • Problema
  • Proyecto
  • Usuario
  • Sprint
  • Tablero
  • Registro de trabajo
  • Comentario
  • Problema de transición
  • Categoría
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.
Desplazamiento
Introduzca o asigne el ID del primer elemento para el que desea recuperar detalles. Esta es una forma de paginar los registros. Si introduce el elemento 5000 como desplazamiento, el módulo devolverá los elementos 5000-9999.
Otros campos
Rellene los demás campos. Los campos están disponibles en función del tipo de registro seleccionado.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3