Configure un activador web de Jira para ejecutar una acción cada vez que ocurra un evento en el proyecto de Jira. En este ejemplo, se muestra cómo crear un Bot de tarea con un activador web de Jira para enviar un correo electrónico a un buzón del Microsoft 365 Outlook cuando el usuario especificado cree un problema en el proyecto específico de Jira.

El activador web de Jira monitorea un proyecto de Jira llamado ABC en busca de nuevos problemas (evento Problema creado) que cree un usuario llamado XYZ. Cuando el usuario crea un problema, el activador inicia las siguientes acciones del Microsoft 365 Outlook que envían un correo electrónico al buzón del Microsoft 365 Outlook. Este correo electrónico incluye el resumen y la descripción de Jira con el ID del problema de Jira como asunto.

Antes de empezar

Asegúrese de que cumpla con los siguientes requisitos previos:
  • Requisitos previos mencionados en Requisitos previos para los activadores web de Jira.
  • Secreto de cliente de Jira y nombre de usuario almacenado de Microsoft 365 en la Credential Vault.
  • Una conexión de ‌OAuth para la instancia de Jira en la que el proyecto está disponible y la cuenta de Microsoft 365 Outlook.
  • Una variable de registro llamada TriggerData.

Procedimiento

  1. Realice los siguientes pasos para crear un Bot de tarea
    1. En el panel izquierdo, haga clic en Automatización.
    2. Haga clic en Crear > Task Bot.
      Aparece el asistente Crear Bot de tareas.
    3. Ingrese un nombre apropiado para el bot en el campo Nombre.
      Todos los bots se almacenan en la carpeta <\Bots> por defecto.
    4. Opcional: Agregue una descripción para el bot en el campo Descripción.
    5. Opcional: Haga clic en Elegir y siga las indicaciones para guardar el bot en una carpeta diferente.
    6. Haga clic en Crear y editar.
      El bot está creado y aparece la página Editor de bot.
  2. Realice los siguientes pasos para agregar y configurar el activador web Jira.
    1. Haga clic en Activadores > Jira , luego haz doble clic o arrastra Activador web para agregar el activador web a la sección Activadores.
    2. Seleccione Problema creado desde el menú desplegable Escuchar evento.
    3. Configure los criterios de filtro de eventos en Criterios de filtro mediante una de las siguientes opciones:
      • Consulta: Ingrese la siguiente consulta JQL project= "ABC" AND reporter= "XYZ".
      • Condición: Realice los siguientes pasos para crear una condición de filtro mediante el generador de condiciones.
        1. Seleccione Y > Agregar condición.
        2. Configure la primera condición con ID como Tipo de condición, Igual a como Seleccionar operación, y ABC como Valor.
        3. Haga clic en Agregar para agregar la condición.
        4. Haga clic en Agregar condición.
        5. Configure la segunda condición con Reportero como Tipo de condición, Igual a como Seleccionar operación, y XYZ como Valor.
        6. Haga clic en Agregar para agregar la segunda condición.
      Consulte la sección Criterios de filtro (opcional) en Activadores web de Jira para obtener más información sobre cómo crear criterios de filtro.
    4. Haga clic en Seleccionar para elegir la conexión ‌OAuth preconfigurada desde el modal Seleccionar una conexión OAuth.
    5. Seleccione Secreto del cliente para verificar el evento recibido > Credenciales > Elegir y siga las indicaciones en el modal Elegir una credencial para seleccionar el Secreto del cliente de Jira que esté disponible en la Credential Vault.
    6. Seleccione TriggerData en la lista desplegable Respuesta (opcional).
      Esta variable de registro captura los datos de respuesta del activador. Los datos de respuesta del activador contienen toda la información sobre el evento en el que ocurrió el cambio en un formato de par clave-valor.
  3. Realice los siguientes pasos para agregar y configurar la acción Conectar de Microsoft 365 Outlook.
    1. Haga clic en Acciones > Microsoft 365 Outlook , luego haga doble clic en la acción Conectar o arrástrela para agregarla a la sección Acciones.
    2. Nube de Azure: Seleccione Azure Global.
      Si tiene una versión gubernamental del Microsoft 365 Outlook, seleccione Azure US GCC High.
    3. Seleccione Gestionado por la Control Room en el menú desplegable Modo de autenticación OAuth2.
    4. Haga clic en Elegir en Conexión y siga las indicaciones en el modal Elegir una conexión OAuth para seleccionar la conexión ‌OAuth para la cuenta de Microsoft 365 Outlook.
    5. Haga clic en Credencial > Elegir en Nombre de usuario y siga las indicaciones en el modal Elegir una credencial para seleccionar el nombre de usuario de Microsoft 365.
    6. Opcional: Ingrese un nombre de sesión apropiado en Crear sesión de Microsoft 365 Outlook.
      El sistema establece Microsoft365OutlookSession como el nombre de la sesión de forma predeterminada.
  4. Realice los siguientes pasos para agregar y configurar la acción Enviar de Microsoft 365 Outlook.
    1. Haga clic en Acciones > Microsoft 365 Outlook , luego haga doble clic en la acción Enviar o arrástrela para agregarla a la sección Acciones.
    2. Ingrese el nombre de sesión que ingresó al configurar la acción Conectar.
      Si se mantiene el nombre predeterminado, el sistema completa automáticamente Microsoft365OutlookSession como la sesión de Microsoft 365 Outlook.
    3. Ingrese el ID de correo electrónico al que el sistema debe reenviar los detalles de Jira en Para.
    4. Ingrese $TriggerData{"issue.key"}$ en Asunto.
      La clave de incidencia de Jira se establece como el asunto del correo electrónico.
    5. Seleccione el código HTML e ingrese Resumen: Summary - $TriggerData{"issue.fields.summary"}$. Descripción: $TriggerData{"issue.fields.description"}$ en Tipo de cuerpo de correo electrónico.
      El resumen y la descripción de Jira se establecen como el cuerpo del correo electrónico.
  5. Haga clic en Guardar para guardar la automatización.
Cuando hace clic en Ejecutar > Ejecutar con activadores, el sistema activa el activador y este comienza a escuchar el evento Problema creado en el proyecto de Jira monitoreado. Cuando el usuario XYZ crea un nuevo problema en el proyecto Jira ABC, el activador inicia las acciones configuradas. El buzón de correo de Microsoft 365 Outlook recibe un correo electrónico que contiene el resumen y la descripción de Jira, con el ID del problema de Jira como asunto.