Saturn Studio – Asana

image_pdfimage_print

Asana es una plataforma de gestión de trabajo y productividad que permite organizar tareas, proyectos y objetivos en un solo lugar. Su integración facilita la coordinación de equipos, el seguimiento de plazos y la centralización de la información para mejorar el rendimiento colectivo.

¿Cómo obtener las credenciales? Haz clic aquí

Descripción de los Comandos

Listar Espacios de Trabajo (List Workspaces)

Enumera todos los espacios de trabajo disponibles en la cuenta vinculada de Asana.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para listar los espacios de trabajo.credential
Assign result to variableVariable donde se almacenará el resultado. Ejemplo: {“Workspaces”:[{“id”:”9034647833″, “gid”:”9034647833″, “name”:”SaturnStudio”}]}{var}

Listar Todas las Tareas (List All Tasks)

Muestra todas las tareas contenidas en un espacio de trabajo o proyecto específico.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para listar las tareas.credential
WorkspaceEspacio de trabajo desde el cual se listarán las tareas.My Workspace
ProjectProyecto desde el cual se listarán las tareas (opcional).Marketing Project
Task StatusPermite filtrar las tareas según su estado de finalización.
Assign result to variableVariable donde se almacenará el resultado. Ejemplo: [{“id”:”12034567890″,”name”:”name”,”completed”:”true”, “due_on”:”2023-12-31″, “assignee”:”John Doe”, “assignee_id”:”1122334455″}]{var}

Obtener Espacio de Trabajo (Get Workspace)

Recupera los detalles técnicos de un espacio de trabajo específico.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para obtener los detalles.credential
Workspace IDID único del espacio de trabajo que se desea consultar.9034647833
Assign result to variableVariable donde se almacenará el resultado. Ejemplo: {“id”:”9034647833″,”name”:”SaturnStudio”,”is_organization”: “false”, “archived”:”false”}{var}

Obtener Proyecto (Get Project)

Obtiene la información detallada de un proyecto mediante su identificador.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para obtener los detalles del proyecto.credential
Project IDID del proyecto del cual se desea obtener la información.12034567890
Assign result to variableVariable donde se almacenará el resultado. Ejemplo: {“id”:”12034567890″,”name”:”Project”,”archived”:”false”, “owner”:”John Doe”}{var}

Crear Tarea (Create Task)

Genera una nueva tarea dentro de un espacio de trabajo o proyecto definido.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para crear la tarea.credential
WorkspaceEspacio de trabajo donde se creará la tarea.My Workspace
ProjectProyecto donde se alojará la tarea.Marketing Project
AssigneeUsuario a quien se le asignará la tarea.nombre_usuario
Task NameNombre de la tarea a crear.Revisar diseño de la interfaz
DescriptionDescripción detallada de las acciones a realizar en la tarea.Revisar el diseño de la nueva interfaz
Due DateFecha de vencimiento (Formato YYYY-MM-DD o DD-MM-YYYY).31-12-2026
Custom FieldsCampos personalizados en formato JSON.mi_valor
Assign result to variableVariable donde se almacenará el resultado de la creación.{var}

Obtener Campos Personalizados de Proyecto (Get Project Custom Fields)

Extrae los campos personalizados configurados para un proyecto en particular.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para la consulta.credential
WorkspaceEspacio de trabajo desde donde se obtendrán los campos.My Workspace
ProjectProyecto del cual se extraerán los campos personalizados.Marketing Project
Assign result to variableVariable donde se almacenará el resultado. Ejemplo: [{“name”:”Priority”, “id”:”12034567890″,”type”:”enum”, “options”:[{“id”:”111″,”name”:”High”}]}]{var}

Obtener Tarea (Get Task)

Recupera los detalles completos de una tarea específica mediante su ID.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para obtener los detalles.credential
Task IDID único de la tarea a consultar.12034567890
Assign result to variableVariable donde se almacenará el resultado. Ejemplo: {“id”:”12034567890″,”name”:”Nombre de la tarea”,”notes”:”descripción”, “due_on”:”2023-12-31″, “assignee”:”John Doe”, “assignee_id”:”1122334455″, “project_id”:”9988776655″}{var}

Eliminar Tarea (Delete Task)

Borra de forma permanente una tarea de la plataforma.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para eliminar la tarea.credential
Task IDID de la tarea que se desea borrar.12034567890
Assign result to variableVariable donde se almacenará el resultado. Ejemplo: {“success”:true, “task_id”:”12034567890″, “message”:”Tarea eliminada con éxito”}{var}

Listar Usuarios (List Users)

Obtiene el listado de todos los usuarios vinculados a un espacio de trabajo.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para listar los usuarios.credential
WorkspaceEspacio de trabajo desde el cual se listarán los usuarios.My Workspace
ProjectProyecto desde el cual se listarán los usuarios (opcional).Marketing Project
Assign result to variableVariable donde se almacenará el resultado. Ejemplo: {“id”:”1122334455″,”name”:”John Doe”}{var}

Actualizar Tarea (Update Task)

Modifica los datos de una tarea ya existente.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para la actualización.credential
Task IDID único de la tarea a modificar.1212531686562092
Task NameEl nuevo nombre para la tarea.Nuevo nombre de tarea
WorkspaceEspacio de trabajo donde se ubica la tarea.My Workspace
ProjectProyecto donde se encuentra la tarea.Marketing Project
AssigneeNuevo usuario asignado a la tarea.nombre_usuario
DescriptionNueva descripción para la tarea.Nueva descripción
Due DateNueva fecha de vencimiento (Formato DD-MM-YYYY).31-12-2026
Custom FieldsCampos personalizados en formato JSON.mi_valor
Mark as CompletedMarca la tarea como completada automáticamente.
Assign result to variableVariable donde se almacenará el resultado de la actualización.{var}

Cargar Archivo Adjunto a Tarea (Upload Attachment to Task)

Sube un archivo local y lo adjunta a una tarea específica en Asana.

ParámetroDescripciónEjemplo
CredentialCredencial de Asana necesaria para cargar el archivo.credential
Task IDID de la tarea a la cual se le subirá el adjunto.12034567890
WorkspaceEspacio de trabajo donde se ubica la tarea.My Workspace
ProjectProyecto donde se encuentra la tarea.Marketing Project
Local FileArchivo local que se desea cargar como adjunto.seleccionar archivos
Assign result to variableVariable donde se almacenará el resultado. Ejemplo: {“id”:”1212461679463197″, “resource_type”: “attachment”, “name”: “Nombre del archivo”}{var}