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
Introduzione
Asana è uno strumento completo di gestione del lavoro progettato per aiutare le persone e i team a tenere traccia delle attività, delegare le responsabilità, monitorare i progressi e comunicare in tempo reale. Fornendo una piattaforma centralizzata per la collaborazione, Asana aiuta i team a rimanere organizzati e concentrati, garantendo che i progetti vengano completati in tempo.
Scopo
Con l’aiuto del connettore Tulip - Asana è possibile tenere traccia in modo efficace dei propri progetti, attività e spazi di lavoro di Asana all’interno di un’applicazione Tulip. Inoltre, è possibile modificare qualsiasi informazione relativa alle attività o persino creare nuove schede direttamente dall’app Tulip.
Documentazione API
Le seguenti API Connector Function evidenziate in questo documento hanno utilizzato la documentazione dell’API di Asana.
Prerequisiti
-
Crea un account su Asana.com.
-
Scegli il metodo di autenticazione più adatto alle tue esigenze:
- Token di accesso personale
- Account di servizio
- OAuth
- OpenID Connect
-
Per questo caso d'uso abbiamo preparato un token di accesso personale; genera quindi un PAT a questo link.
Dettagli di connessione a Tulip
Le seguenti informazioni devono essere configurate sul connettore HTTP di Tulip.
Esecuzione su: Cloud Connector HostHost: app.asana.comPorta: 443TLS: SìAutenticazione: OAuth 2.0 (Bearer Token)Prefisso: BearerToken: Inserisci il token di accesso personale generato nel passaggio precedente.
Esempio predefinito Connector Functions
GET - Elenca i progetti in un Workspace
Restituisce i record compatti relativi a un insieme filtrato di progetti. Utilizzare uno o più dei parametri forniti per filtrare i progetti restituiti.
GET - Elenca gli spazi di lavoro
Restituisce i record compatti di tutti gli spazi di lavoro visibili all’utente autorizzato.
GET - Attività multiple per ID progetto
Restituisce i record compatti delle attività per tutte le attività all’interno del progetto specificato, ordinate in base alla loro priorità all’interno del progetto. Le attività possono far parte di più di un progetto alla volta.
GET - Informazioni su un singolo progetto
Restituisce il record completo relativo a un singolo progetto.
GET - Singola attività per ID
Restituisce il record completo di un singolo compito.
GET - Squadre per utente
Restituisce i record sintetici di tutti i team a cui è assegnato l'utente specificato.
POST - Crea nuova attività
Creare una nuova attività è semplicissimo: basta inviare un POST all'endpoint /tasks con un blocco di dati contenente i campi che si desidera impostare per l'attività. I campi non specificati assumeranno i valori predefiniti.
Ogni attività deve essere creata in uno spazio di lavoro specifico e, una volta impostato, tale spazio di lavoro non può essere modificato. Non è necessario impostare esplicitamente lo spazio di lavoro se si specificano invece dei progetti o un'attività padre.
PUT - Modifica dello stato delle attività in "completato"
Un'attività specifica già esistente può essere aggiornata inviando una richiesta PUT all'URL di quell'attività. Verranno aggiornati solo i campi indicati nel blocco di dati; i campi non specificati rimarranno invariati.
Quando si utilizza questo metodo, è consigliabile specificare solo i campi che si desidera modificare, altrimenti si rischia di sovrascrivere le modifiche apportate da un altro utente dall’ultimo recupero dell’attività.
Prossimi passi
- Scopri di più su Asana qui.
- Scopri di più sui connettori qui