Integración Jira Software n8nAutomatiza Jira Software con n8n.

Cada edición deja una línea en el historial de la incidencia, y esta operación trae ese historial al flujo: qué campo se movió y en qué momento.

• Issue Key: la referencia tal como se ve en Jira, del tipo OPS-12, muchas veces {{ $json.key }} cuando la aporta un trigger.
• Return All: marcado, n8n recorre todas las páginas del historial; sin marcar, Limit pone el tope de entradas.

Deja una incidencia nueva en un proyecto y la devuelve con la clave que Jira acaba de asignarle, la que reutilizan los nodos siguientes.

• Project: elegido de la lista o indicado por su ID, decide dónde aterriza la incidencia.
• Issue Type: se elige igual, entre los tipos que ofrece ese proyecto.
• Summary: la línea que acaba siendo el título.
• Additional Fields: ahí viven Description, Assignee, Priority, Parent Issue Key y Custom Fields cuando el título no basta.

Borrar es definitivo, y el nodo obliga a decidir qué pasa con las subtareas en vez de resolverlo por su cuenta.

• Issue Key: la incidencia que se va.
• Delete Subtasks: requerido aquí, de manera que el flujo diga en voz alta qué ocurre con las hijas y no lo deje en manos de un valor por defecto.

Cuando el flujo solo tiene la clave a mano, lo normal justo después de un webhook, esta operación va a buscar el resto en JSON.

• Issue Key: la clave de la incidencia que se lee.
• Simplify: devuelve una versión aligerada de la respuesta en lugar de la carga bruta, y las expresiones posteriores se leen mejor.
• Fields: en Additional Fields, una lista separada por comas para recortar la respuesta; *all lo trae todo y un campo con un menos delante queda fuera.

Aquí no hace falta ninguna clave: la consulta define el conjunto y vuelven todas las incidencias que encajan.

• JQL: en Options, la expresión en el lenguaje de búsqueda de Jira que delimita el lote, la misma sintaxis de la barra de búsqueda.
• Return All: marcado para un export completo, sin marcar para pararse en Limit.
• Expand: añade bloques a cada incidencia, como changelog o transitions, cuando la lista sola se queda corta.

El correo lo manda Jira: la operación deja una notificación sobre una incidencia en la cola de correo de Jira, dirigida a quien tú indiques.

• Issue Key: la incidencia de la que va el correo.
• Notification Recipients: quién lo recibe, con Reporter, Assignee, Watchers, Voters, User Names or IDs y Group Names or IDs, o en JSON cuando JSON Parameters está activado.
• Subject: en Additional Fields, junto a Text Body y HTML Body; vacío, Jira usa la clave y el resumen de la incidencia.

Antes de mover una incidencia hay que saber adónde tiene permiso de ir. Esto devuelve las transiciones disponibles según el estado en que está.

• Issue Key: la incidencia que se inspecciona.
• Transition ID: en Additional Fields, para preguntar por una transición concreta en vez de por la lista entera.
• Expand: acepta transitions.fields, que describe los campos de cada pantalla de transición, sin los que están ocultos.

Edita campo a campo y deja el resto intacto, que es lo que la hace segura sobre incidencias en las que hay gente trabajando.

• Issue Key: la incidencia que se modifica.
• Update Fields: la colección con Summary, Description, Assignee, Priority, Labels, Issue Type, Parent Issue Key y Custom Fields.
• Status: también dentro de Update Fields, y por ahí es por donde un flujo hace avanzar una incidencia, ya que no hay operación de transición aparte.

Los ficheros circulan por n8n como datos binarios, y esta operación sube uno de ellos a una incidencia.

• Issue Key: la incidencia que recibe el fichero.
• Input Binary Field: el nombre del campo binario del item de entrada que contiene el fichero, tal como lo bautizó el nodo anterior.

Un solo fichero, localizado por su propio identificador: la incidencia de la que cuelga no entra en la llamada.

• Attachment ID: el ID del adjunto, normalmente arrastrado desde un paso anterior.
• Download: requerido, y va de la mano del campo de salida de abajo.
• Put Output File in Field: el nombre del campo binario de salida donde se coloca el fichero.

Visto desde la incidencia esta vez: todo lo que lleva colgado vuelve en una sola llamada.

• Issue Key: la incidencia cuyos adjuntos se listan.
• Download y Put Output File in Field: los dos requeridos, y el segundo nombra el campo binario de salida donde caen los ficheros.
• Return All: marcado para el lote entero, sin marcar para quedarse en Limit.

No pide nada más que el identificador del fichero: la incidencia a la que pertenecía sigue en su sitio y solo se va el adjunto.

• Attachment ID: el ID del adjunto que se retira.

El comentario es donde una automatización habla con las personas de la incidencia. Esta operación publica uno debajo.

• Issue Key: la incidencia a la que se engancha el comentario.
• Comment: el texto en sí.
• Document Format (JSON): con JSON Parameters activado, el cuerpo entra en formato Atlassian Document Format en lugar de texto plano.
• Use Wiki Markup: en Options, interpreta la sintaxis wiki del comentario; se queda en falso mientras no lo cambies.

Releer un comentario concreto pide los dos identificadores: el de la incidencia y el del comentario que hay dentro.

• Issue Key: el ID o la clave de la incidencia que lo contiene.
• Comment ID: el ID del comentario que se lee.
• Expand: en Options, acepta Rendered Body, que devuelve el comentario renderizado en HTML y no tal como está guardado.

Todo el hilo de una incidencia en un único array, que es justo la materia prima de un paso de resumen.

• Issue Key: el ID o la clave de la incidencia cuyo hilo se lee.
• Order By: Created Ascending o Created Descending, según quieras la respuesta más reciente arriba o abajo.
• Return All: marcado para un hilo largo, sin marcar para pararse en Limit.

Quitar un comentario no tiene vuelta atrás, y a diferencia de la versión de adjuntos hacen falta los dos identificadores.

• Issue Key: el ID o la clave de la incidencia.
• Comment ID: el ID del comentario que se retira.

Reescribir en el sitio evita apilar correcciones y mantiene legible un hilo donde la misma línea de estado se refresca varias veces al día.

• Comment ID: el comentario que se reescribe, junto al Issue Key bajo el que está.
• Comment: el texto que sustituye al anterior.
• Document Format (JSON): la variante en Atlassian Document Format, para cuando JSON Parameters está activado.

La llegada de una persona puede terminar dentro de Jira: el nodo abre la cuenta en lugar de dejarla en una lista de tareas administrativas.

• Username, Email Address y Display Name: los tres campos requeridos, y un campo marcado como requerido detiene la ejecución del nodo mientras siga vacío.
• Password: en Additional Fields; vacío, se genera una contraseña aleatoria.
• Notification: manda el correo de confirmación.

El espejo de la salida, con una sorpresa: no hay ningún campo requerido y quien identifica la cuenta es un campo opcional.

• Account ID: el identificador de la cuenta que se borra, el único campo que lee la operación.

Un identificador de cuenta por un lado, una persona por el otro: nombre visible, correo y, si lo pides, los grupos a los que pertenece.

• Account ID: el identificador de la cuenta que se recupera.
• Expand: en Additional Fields, groups añade todos los grupos de esa persona y applicationRoles añade las aplicaciones a las que accede.