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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para monitorear incidencias.	Mis credenciales de Jira
Comprobar cada N minutos	Intervalo de verificación en minutos.	1
Proyecto	Proyecto que se desea monitorear para detectar nuevas incidencias.	PROJ
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para monitorear actualizaciones.	Mis credenciales de Jira
Comprobar cada N minutos	Intervalo de verificación en minutos.	1
Proyecto	Proyecto que se desea monitorear para detectar cambios.	PROJ
Incidencia	Incidencia específica a monitorear.	MAC-1234
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para listar proyectos.	Mis credenciales de Jira
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para listar incidencias.	Mis credenciales de Jira
Proyecto	Proyecto del cual se listarán las incidencias.	MAC
Consulta JQL	Consulta JQL para filtrar incidencias.	project = MAC AND status = Open ORDER BY priority DESC
Máx. resultados	Número máximo de incidencias a devolver (por defecto 50).	20
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para listar columnas.	Mis credenciales de Jira
Proyecto	Proyecto del cual se listarán las columnas o estados.	MAC
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para listar usuarios.	Mis credenciales de Jira
Proyecto	Proyecto del cual se listarán los usuarios asignables.	MAC
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para obtener los detalles.	Mis credenciales de Jira
Proyecto	Proyecto que contiene la incidencia.	MAC
Incidencia	Identificador de la incidencia a consultar.	MAC-1234
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para crear la incidencia.	Mis credenciales de Jira
Proyecto	Proyecto donde se creará la incidencia.	MAC
Resumen	Título o resumen de la incidencia.	Nueva tarea
Descripción	Detalle de la incidencia.	Descripción del problema
Tipo de incidencia	Tipo de incidencia (tarea, error, subtarea, etc.).	Task
Incidencia	Incidencia padre (solo para subtareas).	MAC-1234
Asignado a	Usuario al que se asignará la incidencia.	John Doe
Ruta del archivo	Ruta local de archivo a adjuntar.	image.jpg
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para actualizar la incidencia.	Mis credenciales de Jira
Proyecto	Proyecto donde se encuentra la incidencia.	MAC
Incidencia	Incidencia a actualizar.	MAC-1234
Resumen	Nuevo resumen de la incidencia (opcional).	Resumen actualizado
Descripción	Nueva descripción (opcional).	Descripción actualizada
Asignado a	Nuevo usuario asignado (opcional).	John Doe
Mover a columna	Estado o columna a la que se moverá la incidencia (opcional).	In Progress
Ruta del archivo	Ruta de archivos a adjuntar (opcional).	image.jpg
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para eliminar la incidencia.	Mis credenciales de Jira
Proyecto	Proyecto del cual se eliminará la incidencia.	MAC
Incidencia	Identificador de la incidencia a eliminar.	MAC-1234
Asignar resultado a variable	Variable 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ámetro	Descripción	Ejemplo
Credencial	Credencial de Jira necesaria para descargar archivos.	Mis credenciales de Jira
Proyecto	Proyecto que contiene la incidencia.	MAC
Incidencia	Incidencia de la cual se descargarán los archivos adjuntos.	MAC-1234
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo: {“files”:[{“filename”:”mock-img.png”,”size”:74567,”mimeType”:”image/png”}],”totalAttachments”:2}	{var}