This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Asana to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.
To download the app, visit: [connectors](https://tulip.co/library/<span translate=)/asana-connector/">Library
Introducción
Asana es una herramienta integral de gestión del trabajo diseñada para ayudar a personas y equipos a realizar un seguimiento de las tareas, delegar responsabilidades, supervisar el progreso y comunicarse en tiempo real. Al proporcionar una plataforma centralizada para la colaboración, Asana ayuda a los equipos a mantenerse organizados y centrados, garantizando que los proyectos se completen a tiempo.
Objetivo
Con la ayuda del conector Tulip - Asana, puedes realizar un seguimiento eficaz de tus proyectos, tareas y espacios de trabajo de Asana en una aplicación de Tulip. Además, puedes modificar cualquier información relevante de las tareas o incluso crear nuevas tarjetas desde una aplicación de Tulip.
Documentación de la API
Los siguientes « Connector Function » destacados en este documento se han elaborado a partir de la documentación de la API de Asana.
Requisitos previos
-
Regístrate para obtener una cuenta en Asana.com.
-
Decide qué método de autenticación te conviene más:
- Token de acceso personal
- Cuenta de servicio
- OAuth
- OpenID Connect
-
Para este caso de uso hemos preparado un token de acceso personal, por lo que debes generar un PAT en este enlace.
Datos de conexión de Tulip
Es necesario configurar la siguiente información en el conector HTTP de Tulip.
Ejecutándose en: Cloud Connector HostHost: app.asana.comPuerto: 443TLS: SíAutenticación: OAuth 2.0 (token de portador)Prefijo: BearerToken: Introduce el token de acceso personal generado en el paso anterior.
Ejemplo preconfigurado Connector Functions
GET - Listar proyectos en un espacio de trabajo
Devuelve los registros compactos de un conjunto filtrado de proyectos. Utiliza uno o varios de los parámetros proporcionados para filtrar los proyectos devueltos.
GET - Listar espacios de trabajo
Devuelve los registros compactos de todos los espacios de trabajo visibles para el usuario autorizado.
GET - Varias tareas por ID de proyecto
Devuelve los registros compactos de todas las tareas de un proyecto determinado, ordenadas por su prioridad dentro del proyecto. Las tareas pueden pertenecer a más de un proyecto a la vez.
GET - Información de un único proyecto
Devuelve el registro completo de un único proyecto.
GET - Tarea individual por ID
Devuelve el registro completo de una tarea concreta.
GET - Equipos por usuario
Devuelve los registros resumidos de todos los equipos a los que está asignado el usuario indicado.
POST - Crear una nueva tarea
Crear una nueva tarea es tan sencillo como enviar una solicitud POST al punto final /tasks con un bloque de datos que contenga los campos que desees configurar en la tarea. Los campos no especificados adoptarán los valores predeterminados.
Cada tarea debe crearse en un espacio de trabajo específico, y este espacio de trabajo no se puede cambiar una vez establecido. No es necesario establecer el espacio de trabajo de forma explícita si, en su lugar, se especifican proyectos o una tarea principal.
PUT: cambiar el estado de una tarea a «completada»
Una tarea específica ya existente se puede actualizar realizando una solicitud PUT a la URL de dicha tarea. Solo se actualizarán los campos proporcionados en el bloque de datos; los campos no especificados permanecerán sin cambios.
Al utilizar este método, es recomendable especificar únicamente aquellos campos que desee modificar; de lo contrario, podría sobrescribir los cambios realizados por otro usuario desde la última vez que recuperó la tarea.
Próximos pasos
- Más información sobre Asana aquí.
- Más información sobre los conectores aquí