Jira - Cambiar estado

↩ Forma parte de la integración Jira.

Descripción

Ejecuta una transición del workflow sobre una incidencia (POST /issue/{key}/transitions). Es así como se mueve un ticket de To Do a In Progress, o se cierra como Done.

Podés pasarle el id numérico de la transición o su nombre. Si le pasás un nombre, el nodo primero llama a GET /issue/{key}/transitions, busca la transición que corresponde al estado actual de esa incidencia y usa su id.

Configuración

Campo	Tipo	Requerido	Descripción
`credentials_id`	credencial	Sí	Credencial de Jira
`issue_key`	texto	Sí	Clave de la incidencia (ej. `OPS-123`)
`transition`	texto	Sí	Id de transición (ej. `31`) o nombre (ej. `In Progress`)

Tanto issue_key como transition aceptan variables dinámicas.

Credenciales

Este módulo necesita una credencial Jira (Atlassian):

Campo	Descripción
`base_url`	URL del sitio, ej. `https://tu-dominio.atlassian.net`
`email`	Email de la cuenta Atlassian
`api_token`	API token generado en id.atlassian.com

Salida

Jira devuelve el cuerpo vacío, así que el nodo devuelve un objeto de confirmación con el id que efectivamente usó:

{
  "key": "OPS-123",
  "transitioned": true,
  "transitionId": "31"
}

Y junto a él, _meta:

{ "moduleVersion": "1.0.0", "success": true, "key": "OPS-123", "transitionId": "31", "totalMs": 520 }

Ejemplo de uso

Por nombre (recomendado)

{
  "credentials_id": "jira_ops",
  "issue_key": "OPS-123",
  "transition": "In Progress"
}

Por id (una llamada menos)

{
  "credentials_id": "jira_ops",
  "issue_key": "OPS-123",
  "transition": "31"
}

Guiado por datos anteriores

{
  "credentials_id": "jira_ops",
  "issue_key": "{{data.key}}",
  "transition": "{{data.estado_destino}}"
}

Notas

Los ids de transición dependen del proyecto. Salen del esquema de workflow de cada proyecto, así que un id que funciona en OPS puede no existir en DEV. Usar el nombre es más seguro si trabajás con varios proyectos.
La comparación por nombre no distingue mayúsculas y también acepta el nombre del estado destino (t.to.name), así que según tu workflow pueden resolver tanto Done como la transición etiquetada Cerrar incidencia.
Si el nombre no está entre las transiciones disponibles de esa incidencia, el mensaje de error lista las válidas: es la forma más rápida de descubrir la etiqueta correcta.
Solo son válidas las transiciones disponibles desde el estado actual de la incidencia. Un ticket que ya está en Done no se puede volver a pasar a Done.
Lo que la pantalla de transición marque como obligatorio (una resolución, un comentario) hay que dejarlo cargado antes: este nodo envía únicamente la transición, sin campos extra.

Nodos relacionados

Jira: Leer incidencia — mirar el estado actual antes de transicionar.
Jira: Actualizar incidencia — cargar los campos que pida la pantalla de transición.
Jira: Buscar (JQL) — encontrar de una sola vez todas las incidencias a mover.