Esta página detalla la configuración para queRootly escriba en Jira.
La acciónCrear Incidencia en Jirase utiliza para crear un nuevo ticket en Jira. Para crear una incidencia en Jira, debes seleccionar el proyecto específico en el que se creará el ticket (campoProject Key
) y seleccionar elIssue Type
para crear el ticket.
Esta acción de flujo de trabajo se puede utilizar para crear tickets de Jira tanto paraincidentescomo paraelementos de acción. Se recomienda que uses Crear Subtarea de Jira para elementos de acción. Sin embargo, si tus equipos de proyecto no utilizan subtareas, puedes usar esta acción para crear incidencias de Jira también.
La acciónActualizar Incidencia de Jirase utiliza para actualizar un ticket existente en Jira. Para actualizar una incidencia existente en Jira, debes hacer referencia a ella en el campoJira Issue to Update
utilizando la variable{{ incident.jira_issue_id }}
.
Este flujo de trabajo solo funcionará si has creado inicialmente una incidencia de Jira para el incidente o elemento de acción.
La acciónCrear Subtarea de Jirase utiliza para crear una subtarea bajo una incidencia de Jira existente. Para crear una subtarea para una incidencia de Jira existente, debes hacer referencia a la incidencia de Jira original en el campoParent Jira Issue
utilizando la{{ incident.jira_issue_id }}
variable. La Project Key
ingresada aquí debe ser la misma que se utilizó en la acción original de Crear Incidencia de Jira.
Esta acción de flujo de trabajo está destinada a ser utilizada para action items o sub-incidents.
Jira tiene un campo nativo llamado Labels. La sintaxis para establecer este campo es diferente a la utilizada para establecer un campo personalizado del tipo etiquetas.
Jira tiene un campo nativo llamado Team
, pero se almacena como un “campo personalizado”. Además, solo permite seleccionar un único equipo. Para mapear a este campo en Jira, necesitarás usar el siguiente formato de sintaxis:
Las Default
pestañas en cada una de las acciones de flujo de trabajo anteriores te permitirán establecer campos predeterminados de Jira. Si tienes campos personalizados definidos en tu proyecto de Jira o deseas establecer campos de Jira dinámicamente, necesitarás hacerlo a través de un mapeo personalizado en la Advanced
pestaña.
Es muy probable que tus proyectos de Jira contengan campos personalizados. La pestaña predeterminada en las acciones de flujo de trabajo anteriores no será suficiente para mapear estos campos personalizados. Necesitarás ingresar la sintaxis personalizada en el Custom Fields Mapping
campo en la Advance
pestaña de configuración.
Para mapear a campos personalizados en Jira, necesitarías conocer la siguiente información:
El custom field id en Jira
El field type en Jira
La incident property desde la que deseas mapear
Este Atlassian article te mostrará cómo encontrar el id del campo personalizado de Jira.
Estos son los field types que puede tener un campo personalizado de Jira.
Las variables Liquid para las propiedades de incidentes de Rootly se pueden encontrar here.
Mapear a un campo personalizado de Jira de tipo text o paragraph.
Mapear al tipo de campo personalizado de Jira single select.
Mapear al tipo de campo personalizado de Jira multi-select.
Mapear al tipo de campo personalizado de Jira labels.
Mapear al tipo de campo personalizado de Jira number.
Mapear al tipo de campo personalizado de Jira datetime.
Mapear al tipo de campo personalizado de Jira user.
Establecer dinámicamente el campo de prioridad de Jira basado en la severidad del incidente.
Agregar comment a una incidencia existente de Jira.
Vincular incidencia de Jira creada para el action item a la incidencia existente creada para el incidente.
Establecer el campo nativo de Jira Labels en Jira. Dado que este es un campo nativo en Jira, se puede actualizar a través del campo de Carga útil de API.
Establecer el campo predeterminado Components en Jira. Dado que este es un campo predeterminado en Jira, deberá actualizarse a través del campo de Carga útil de API.
Típicamente, a los equipos les gusta usar el campo Services en Rootly para representar Components en Jira. El ejemplo a continuación muestra este escenario común. También puedes usar otros campos de selección múltiple de Rootly para representar Components en Jira, solo asegúrate de ajustar el código a continuación para hacer referencia a la propiedad de Rootly que estás utilizando.
Para que esto funcione, DEBES asegurarte de que el nombre del Service en Rootly coincida EXACTAMENTE con el nombre de los Components en Jira.
A continuación se presentan errores comunes que podrías encontrar durante tu proceso de configuración. Para ver la respuesta de error, puedes localizar el flujo de trabajo específico que estás tratando de depurar, seleccionar … > View Runs > View.
Error | Comentario |
---|---|
issue_id cannot be null. | Razón del error… Esto sucede a menudo en la acción Actualizar Incidencia de Jira. Significa que la incidencia de Jira de referencia que estás intentando actualizar no existe. Cómo solucionarlo… Asegúrate de que tu flujo de trabajo no se ejecute hasta DESPUÉS de que se haya creado una incidencia de Jira y se haya vinculado al incidente. |
"customfield_12345": "Custom Field is required." | Razón del error… Esto significa que el campo personalizado especificado está configurado como un campo obligatorio en el proyecto de Jira y tu flujo de trabajo no le está pasando ningún valor. Cómo solucionarlo… Puedes agregar un mapeo de campos personalizados para mapear al campo específico o configurar el proyecto de Jira para hacer que el campo sea opcional. |
unexpected token at '{ "customfield_10032": }' | Razón del error… Tu sintaxis de mapeo personalizado es incorrecta. Cómo solucionarlo… Corrige tu sintaxis de mapeo. |
Specify a valid project ID or key | Razón del error… Esto significa que la Clave de Proyecto de Jira que has seleccionado en la acción no está disponible en la instancia de Jira seleccionada. Cómo solucionarlo… Vuelve a seleccionar la Instancia de Jira y luego vuelve a seleccionar la Clave del Proyecto. |
The issue type selected is invalid. | Razón del error… Esto significa que el Tipo de Incidencia de Jira que has seleccionado en la acción no está disponible en el proyecto de Jira seleccionado. Cómo solucionarlo… Vuelve a seleccionar la Clave del Proyecto y luego vuelve a seleccionar el Tipo de Incidencia. |
Si necesitas ayuda o más información sobre esta integración, por favor contacta a support@rootly.com o inicia un chat navegando a Help > Chat with Us.