Saturn Studio – Jira

Jira es una herramienta de gestión de proyectos diseñada para equipos de desarrollo.
Permite planificar, rastrear y gestionar tareas utilizando metodologías ágiles como Scrum y Kanban.

Descripción de los comandos

Activar al crear una incidencia

Disparador que se activa cuando se crea una nueva incidencia en Jira.(Cómo obtener las credenciales de Jira)

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para monitorear incidencias.Mis credenciales de Jira
Comprobar cada N minutosIntervalo de verificación en minutos.1
ProyectoProyecto que se desea monitorear para detectar nuevas incidencias.PROJ
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“id”:”34567″,”key”:”PROJ-123″,”summary”:”Nueva funcionalidad”,”issueType”:”Bug”,”assignee”:”Alice Johnson”,”reporter”:”Bob Smith”}
variable

Activar al actualizar una incidencia

Disparador que se activa cuando una incidencia es actualizada en Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para monitorear actualizaciones.Mis credenciales de Jira
Comprobar cada N minutosIntervalo de verificación en minutos.1
ProyectoProyecto que se desea monitorear para detectar cambios.PROJ
IncidenciaIncidencia específica a monitorear.MAC-1234
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“id”:”34567″,”key”:”PRJ-210″,”summary”:”Corrección de autenticación API”,”status”:”In Progress”,”assignee”:”John Smith”,”issueType”:”Bug”}
variable

Listar proyectos

Lista todos los proyectos disponibles en Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para listar proyectos.Mis credenciales de Jira
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“projects”:[{“id”:”10100″,”key”:”ALPHA”,”name”:”Alpha Initiative”},{“id”:”10101″,”key”:”BETA”,”name”:”Beta Test Framework”}]}
{var}

Listar incidencias

Lista todas las incidencias de un proyecto en Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para listar incidencias.Mis credenciales de Jira
ProyectoProyecto del cual se listarán las incidencias.MAC
Consulta JQLConsulta JQL para filtrar incidencias.project = MAC AND status = Open ORDER BY priority DESC
Máx. resultadosNúmero máximo de incidencias a devolver (por defecto 50).20
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“issues”:[{“key”:”ODR-140″,”summary”:”Corregir error de inicio de sesión”,”status”:”To Do”,”priority”:”High”}]}
{var}

Listar columnas

Lista todas las columnas o estados disponibles en un proyecto de Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para listar columnas.Mis credenciales de Jira
ProyectoProyecto del cual se listarán las columnas o estados.MAC
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“columns”:[{“id”:”20500″,”name”:”QA-START”,”statusCategory”:{“name”:”In Progress”}}]}
{var}

Listar usuarios

Lista todos los usuarios asignables a un proyecto en Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para listar usuarios.Mis credenciales de Jira
ProyectoProyecto del cual se listarán los usuarios asignables.MAC
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“users”:[{“displayName”:”John Doe”,”emailAddress”:”john@example.com“,”active”:true}]}
{var}

Obtener una incidencia

Obtiene los detalles de una incidencia específica de un proyecto Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para obtener los detalles.Mis credenciales de Jira
ProyectoProyecto que contiene la incidencia.MAC
IncidenciaIdentificador de la incidencia a consultar.MAC-1234
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“issue”:{“key”:”PRJ-456″,”summary”:”Jira Module”,”status”:”In progress”,”priority”:”Medium”}}
{var}

Crear una incidencia

Crea una nueva incidencia o subtarea en un proyecto de Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para crear la incidencia.Mis credenciales de Jira
ProyectoProyecto donde se creará la incidencia.MAC
ResumenTítulo o resumen de la incidencia.Nueva tarea
DescripciónDetalle de la incidencia.Descripción del problema
Tipo de incidenciaTipo de incidencia (tarea, error, subtarea, etc.).Task
IncidenciaIncidencia padre (solo para subtareas).MAC-1234
Asignado aUsuario al que se asignará la incidencia.John Doe
Ruta del archivoRuta local de archivo a adjuntar.image.jpg
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“issue”:{“key”:”ABC-456″,”attachments”:[{“filename”:”error_screenshot.png”}]}}
{var}

Actualizar una incidencia

Actualiza una incidencia existente en Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para actualizar la incidencia.Mis credenciales de Jira
ProyectoProyecto donde se encuentra la incidencia.MAC
IncidenciaIncidencia a actualizar.MAC-1234
ResumenNuevo resumen de la incidencia (opcional).Resumen actualizado
DescripciónNueva descripción (opcional).Descripción actualizada
Asignado aNuevo usuario asignado (opcional).John Doe
Mover a columnaEstado o columna a la que se moverá la incidencia (opcional).In Progress
Ruta del archivoRuta de archivos a adjuntar (opcional).image.jpg
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“issue”:{“key”:”XYZ-789″,”updated”:true}}
{var}

Eliminar una incidencia

Elimina una incidencia existente de un proyecto de Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para eliminar la incidencia.Mis credenciales de Jira
ProyectoProyecto del cual se eliminará la incidencia.MAC
IncidenciaIdentificador de la incidencia a eliminar.MAC-1234
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“message”:”Issue MAC-1234 deleted successfully”}
{var}

Descargar archivos de una incidencia

Descarga todos los archivos adjuntos de una incidencia de Jira.

ParámetroDescripciónEjemplo
CredencialCredencial de Jira necesaria para descargar archivos.Mis credenciales de Jira
ProyectoProyecto que contiene la incidencia.MAC
IncidenciaIncidencia de la cual se descargarán los archivos adjuntos.MAC-1234
Asignar resultado a variableVariable donde se almacenará el resultado.
Ejemplo: {“files”:[{“filename”:”mock-img.png”,”size”:74567,”mimeType”:”image/png”}],”totalAttachments”:2}
{var}