Integración de Jira

Si UiPath Automation Hub es el lugar donde puede gestionar de forma centralizada su pipeline de oportunidades de automatización, entonces Jira es muy probablemente el lugar donde sus desarrolladores realizarán el seguimiento de las tareas subyacentes utilizadas en el ciclo de vida de desarrollo de la automatización.

Al vincular las ideas de Automation Hub a los tickets de Jira, obtendrás una imagen más clara del progreso del desarrollo de sus automatizaciones.

La autenticación entre Automation Hub y Jira aprovecha el conector existente Jira Cloud Connector del servicio de integración UiPath.

Configurar la integración de Jira

Los usuarios de Automation Hub con permisos para administrar la integración de Jira pueden configurarla y habilitarla para que los usuarios puedan vincular o crear un ticket de Jira directamente desde una idea de automatización.

Autenticación

La Integración Jira debe ser habilitada y configurada por un usuario del Automation Hub con permisos para gestionar la integración, antes de desplegarla al resto de usuarios.

En esta pestaña, el usuario necesita introducir primero un espacio de trabajo de Jira antes de poder realizar la configuración.

Nota:

• Los administradores deben tener asignado el permiso Gestionar integración de Jira.

• Los roles Propietario de cuenta y Administrador del sistema tienen el permiso asignado de forma predeterminada.

Realice los siguientes pasos para iniciar la configuración:

1. Comienza conectándote a tu espacio de trabajo de Jira

• En Consola de administración > Configuración de la plataforma, seleccione Integración de Jira.

• En la secciónAutenticación, se te pedirá que comiences añadiendo la URL de tu espacio de trabajo de Jura y seleccionando Conectar.

  
  

  

  
  
  La URL del espacio de trabajo de Jira debe respetar el siguiente formato: https://[yourworskpace].atlassian.net

2. Autentícate con Jira.

• Selecciona Abrir autenticador.
• UiPath Integration Service se abre en una nueva ventana desde la que puede seleccionar Añadir conexión.

Más información sobre cómo utilizar conectores en la página Conexiones.

Aparecerá una nueva ventana de Conectar con Jira en la que la URL del sitio y el Ámbito deben rellenarse previamente. Seleccione Conectar.

• Se abrirá la página web de Atlassian, donde deberá confirmar la integración UiPath - Jira. Selecciona Aceptar.

  
  

  

  
  
  Nota:

  Si aún no ha iniciado sesión en Jira, se le pedirá que inicie sesión primero y luego reanude con la integración Uipath - Jira.

  La conexión que el administrador configure a nivel de Servicio de Integración no podrá ser reutilizada por el resto de usuarios que vayan a utilizar la integración. Todos los usuarios tendrán que poseer una conexión existente para utilizar la integración.

• Serás redirigido a la página inicial de Conexión Jira dentro de Automation Hub donde, debajo del botón Abrir autenticación, deberás seleccionar Confirmar, para que la conexión de integración sea exitosa.

  En este punto, su conexión a Jira está en su lugar y puede pasar a los siguientes pasos.

  3. Configura el tipo de incidencia y el nombre del proyecto
• Utilizando el menú desplegable de cada casilla, puedes seleccionar el Nombre del proyecto y el Tipo de incidencia, que se utilizarán cuando se cree un ticket de Jira a partir de una idea de automatización. Selecciona Confirmar.

• Los valores desplegables se obtienen del espacio de trabajo de Jira al que está conectado.

  
  

  

  
  
  4. Selecciona una incidencia existente como plantilla

• Ahora es necesario añadir el enlace a la incidencia, que representa la plantilla del ticket de Jira para tu proyecto. Las secciones de este ticket rellenadas previamente siempre se añaden a los tickets creados por el usuario. Añade la URL del ticket de Jira y selecciona Validar.

  
  

  

  
  

  La edición de la plantilla se validará antes de guardarse para asegurarse de que:

• Es del mismo proyecto que el definido en el paso anterior.
• El tipo de incidencia coincide con el definido en el paso anterior.
• La incidencia existe en el espacio de trabajo de Jira conectado.

• El formato de la URL es correcto: https://yourworskpace.atlassian.net/browse/YOURPROJECTKEY-1111

Ejemplo de configuración de plantilla de incidencia de Jira:

• Se parte de una incidencia existente en el Proyecto Jira https://yourworskpace.atlassian.net/browse/KEY-1111 .
• La incidencia es de tipo Tarea y contiene los campos básicos de Jira y un campo personalizado adicional llamado Validación necesaria.
• El ticket se guarda en la configuración del Automation Hub.

• En la pestaña Mapeo de campos, puede realizar la siguiente configuración:

  • El título de la idea se asigna al Resumen de Jira.
  • La descripción de la idea se asigna a la Descripción de Jira.
• Puedes optar por mapear el campo Jira Validación necesaria a un campo en Automation Hub o puedes hardcodear en la plantilla para que siempre tenga un valor determinado - por ejemplo Sí.
• El toque final puede ser añadir también una etiqueta codificada AUTOMATION_HUB_IDEA en la plantilla Incidencia Jira.

• Usando esta configuración, los tickets de Jira creados desde Automation Hub tendrán la siguiente configuración:

  • Resumen y Descripción obtenidos de los campos correspondientes del Automation Hub.
  • Campo personalizado Validación necesaria codificado como Sí para todas las incidencias.

  • Etiquetas codificadas como AUTOMATION_HUB_IDEA para todas las incidencias.

    Una vez creado el ticket, seguirá el flujo de trabajo definido en Jira para ese tipo de incidencia.

Importante: asegúrate de que la plantilla no se elimina o altera mientras la Conexión Jira está activa y configurada, ya que podría romper el flujo de integración.

5. El último paso en el flujo de conexión te muestra que la conexión está ahora habilitada.

Asignación de campo

En la pestaña Asignación de campos, puede asignar campos de Automation Hub a campos de Jira. Al hacerlo, configurará la forma en que los usuarios con permiso crean los tickets para activar la creación de incidencias de Jira desde Automation Hub.

Cuando se realiza una asignación, los valores del campo de Automation Hub se utilizarán para completar el campo de Jira asignado correspondiente.

De forma predeterminada, se asignan dos campos de Jira después de una conexión exitosa a Jira:

Campo Jira	Campo Automation Hub
Resumen	Nombre de la automatización
Un campo de texto sencillo	Descripción

Se puede agregar un nuevo mapa de campo:

1. Seleccionar +Añadir Asignación.
2. En el campo Jira, seleccione la nueva fila creada y, en el desplegable, seleccione el campo disponible deseado.
3. En el campo Automation Hub, seleccione el campo disponible deseado en la lista desplegable.

Las filas de la tabla de asignación se guardan automáticamente.

Para eliminar una fila, vaya al menú de tres puntos situado a la derecha de la fila y seleccione Eliminar.

Ejemplo de asignación de mapeo:

• Tiene un campo de Jira llamado Razón empresarial.
• También tiene un campo en Automation Hub llamado Razón de negocio (los nombres no tienen que coincidir) que ha definido en una de sus evaluaciones.
• En la pestaña Mapeo de Campos, usted mapea los dos juntos.
• Cuando un usuario seleccione Crear un nuevo ticket de Jira desde Automation Hub, el campo Razón de negocio en Jira recibirá el valor del campo Razón de negocio de la idea de Automation Hub.

Si el campo es nulo o no existe en el Perfil de Automatización de la Idea, la creación se realizará, pero el campo Jira correspondiente tendrá valores nulos.

Eliminar conexión Jira

Al eliminar la Conexión Jira, se borran todos los datos del formulario de Autenticación.

1. En Consola de administración > Configuración de la plataforma, seleccione Integración de Jira.
2. Selecciona Eliminar conexión.

El botón Restablecer conexión se puede utilizar para restablecer el formulario de Autenticación del Administrador de Jira antes de guardar la conexión.