Jira - Buscar incidencias (JQL)

↩ Forma parte de la integración Jira.

Descripción

Ejecuta una consulta JQL contra Jira Cloud (POST /search/jql) y devuelve las incidencias que coinciden como un array. Es la puerta de entrada a las automatizaciones por lotes: traer todos los bugs abiertos, todos los tickets de una persona, todo lo creado ayer, y procesarlos uno por uno.

El nodo devuelve el array issues directamente en data, así que se enchufa sin más a un iterador.

Configuración

Campo	Tipo	Requerido	Descripción
`credentials_id`	credencial	Sí	Credencial de Jira
`jql`	área de texto	Sí	Consulta JQL (ej. `project = OPS AND status = "To Do"`)
`max_results`	número	No	Máximo de resultados. Por defecto `50`
`fields`	texto	No	Campos a devolver, separados por coma (ej. `summary,status`)

jql acepta variables dinámicas, así que podés armar la consulta con datos de nodos anteriores. max_results y fields se usan tal cual; fields se parte por comas y se envía como array.

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

data es el array de incidencias (nunca un objeto: si no hay coincidencias, recibís []):

[
  {
    "id": "10042",
    "key": "OPS-123",
    "self": "https://tu-dominio.atlassian.net/rest/api/3/issue/10042",
    "fields": { "summary": "El checkout devuelve 500", "status": { "name": "To Do" } }
  },
  {
    "id": "10043",
    "key": "OPS-124",
    "fields": { "summary": "No se envían los recibos por email", "status": { "name": "To Do" } }
  }
]

Y junto a él, _meta:

{ "moduleVersion": "1.0.0", "success": true, "count": 2, "totalMs": 356 }

Ejemplo de uso

Todo lo abierto en un proyecto

{
  "credentials_id": "jira_ops",
  "jql": "project = OPS AND status = \"To Do\" ORDER BY created DESC",
  "max_results": 50
}

Payload liviano para un informe

{
  "credentials_id": "jira_ops",
  "jql": "project = OPS AND created >= -7d",
  "max_results": 100,
  "fields": "summary,status,assignee"
}

Consulta armada con datos previos

{
  "credentials_id": "jira_ops",
  "jql": "project = OPS AND assignee = \"{{data.account_id}}\" AND resolution = Unresolved"
}

Notas

Usá ORDER BY dentro del JQL para controlar el orden: el nodo no ordena por su cuenta.
max_results limita lo que Jira devuelve en una sola llamada; el nodo no página solo. Para conjuntos grandes, acotá el JQL (por ejemplo, por rango de fechas) y ejecutá el nodo varias veces.
Un JQL inválido vuelve como error de tipo validation con el mensaje propio de Jira, y no se reintenta.
Las comillas dentro del JQL hay que escaparlas cuando el valor se escribe en un campo JSON, como en los ejemplos.

Nodos relacionados

Jira: Leer incidencia — leer una sola incidencia por su clave.
Jira: Actualizar incidencia — actualizar cada resultado mientras iterás.
Jira: Cambiar estado — mover en bloque las incidencias que encontraste.