Jira - Crear incidencia

↩ Forma parte de la integración Jira.

Descripción

Crea una incidencia en un proyecto de Jira Cloud (POST /issue). Le pasás la clave del proyecto, un título y, si querés, una descripción y los campos extra que exija la pantalla del proyecto.

La descripción la escribís en texto plano y el nodo la convierte a Atlassian Document Format (ADF) antes de enviarla, como pide la API v3.

Configuración

Campo	Tipo	Requerido	Descripción
`credentials_id`	credencial	Sí	Credencial de Jira
`project_key`	texto	Sí	Clave del proyecto (ej. `OPS`)
`issue_type`	texto	No	Tipo de incidencia (`Task`, `Bug`, `Story`…). Por defecto `Task`
`summary`	texto	Sí	Título de la incidencia
`description`	área de texto	No	Descripción en texto plano; se convierte a ADF
`extra_fields`	json	No	Campos extra que se fusionan en `fields`, ej. `{"priority":{"name":"High"}}`

project_key, summary y description aceptan variables dinámicas. extra_fields no: se parsea como JSON tal cual (si no es JSON válido, se ignora en silencio).

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 objeto que devuelve Jira al crear la incidencia:

{
  "id": "10042",
  "key": "OPS-123",
  "self": "https://tu-dominio.atlassian.net/rest/api/3/issue/10042"
}

Y junto a él, _meta:

{ "moduleVersion": "1.0.0", "success": true, "key": "OPS-123", "id": "10042", "totalMs": 412 }

Ejemplo de uso

Tarea simple

{
  "credentials_id": "jira_ops",
  "project_key": "OPS",
  "issue_type": "Task",
  "summary": "Revisar el informe mensual de facturación"
}

Bug alimentado desde un formulario

{
  "credentials_id": "jira_ops",
  "project_key": "OPS",
  "issue_type": "Bug",
  "summary": "{{data.asunto}}",
  "description": "Reportado por {{data.email}}\n\n{{data.detalle}}"
}

Con prioridad y etiquetas

{
  "credentials_id": "jira_ops",
  "project_key": "OPS",
  "issue_type": "Bug",
  "summary": "El checkout devuelve 500",
  "description": "Se reproduce en el paso de pago.",
  "extra_fields": { "priority": { "name": "High" }, "labels": ["checkout", "urgente"] }
}

Notas

Si issue_type queda vacío, se usa Task.
Cada salto de línea de description se convierte en un párrafo ADF distinto.
Los nombres de campo dentro de extra_fields tienen que coincidir con los de tu instancia de Jira (los campos personalizados usan ids del estilo customfield_10011).
Un 400 suele significar que falta un campo obligatorio de la pantalla de creación del proyecto, o que ese tipo de incidencia no existe ahí. Estos errores no se reintentan: corregí el dato y volvé a ejecutar.

Nodos relacionados

Jira: Leer incidencia — leer la incidencia que acabás de crear.
Jira: Comentar incidencia — agregar contexto a la incidencia.
Jira: Cambiar estado — moverla a otro estado.