Connecteur Asana

Introduction

Asana est un outil complet de gestion du travail conçu pour aider les individus et les équipes à suivre leurs tâches, à déléguer des responsabilités, à surveiller l’avancement des projets et à communiquer en temps réel. En fournissant une plateforme centralisée de collaboration, Asana aide les équipes à rester organisées et concentrées, garantissant ainsi que les projets soient menés à bien dans les délais.

Objectif

Grâce au connecteur Tulip - Asana, vous pouvez suivre efficacement vos projets, tâches et espaces de travail Asana dans une application Tulip. De plus, vous pouvez modifier toutes les informations pertinentes relatives aux tâches, voire créer de nouvelles cartes depuis une application Tulip.

Documentation de l’API

Les « Connector Function » (exemples de code) présentés dans ce document s’appuient sur la documentation de l’API Asana.

Prérequis

1. Créez un compte sur Asana.com.

2. Choisissez la méthode d'authentification qui vous convient le mieux :

   1. Jeton d'accès personnel
   2. Compte de service
   3. OAuth
   4. OpenID Connect

3. Pour ce cas d'utilisation, nous avons préparé un jeton d'accès personnel ; générez donc un PAT via ce lien.

Détails de connexion à Tulip

Les informations suivantes doivent être configurées sur le connecteur HTTP de Tulip.

Exécution sur : Cloud Connector Hôte : app.asana.com Port : 443 TLS : Oui Authentification : OAuth 2.0 (jeton Bearer) Préfixe : Bearer Jeton : insérez le jeton d'accès personnel généré à l'étape précédente.

Exemple de requête GET pré-construite Connector Functions

GET - Liste des projets dans un espace de travail

Renvoie les enregistrements de projet condensés pour un ensemble filtré de projets. Utilisez un ou plusieurs des paramètres fournis pour filtrer les projets renvoyés.

GET - Liste des espaces de travail

Renvoie les enregistrements condensés de tous les espaces de travail visibles par l’utilisateur autorisé.

GET - Tâches multiples par ID de projet

Renvoie les fiches de tâches condensées pour toutes les tâches d'un projet donné, classées par ordre de priorité au sein du projet. Une tâche peut appartenir à plusieurs projets à la fois.

GET - Informations sur un projet unique

Renvoie l'enregistrement complet d'un projet unique.

GET - Tâche unique par ID

Renvoie la fiche complète d'une tâche unique.

GET - Équipes par utilisateur

Renvoie les fiches abrégées de toutes les équipes auxquelles l'utilisateur donné est affecté.

POST - Créer une nouvelle tâche

Pour créer une nouvelle tâche, il suffit d’envoyer une requête POST vers le point de terminaison /tasks avec un bloc de données contenant les champs que vous souhaitez définir pour la tâche. Les champs non spécifiés prendront leurs valeurs par défaut.

Chaque tâche doit être créée dans un espace de travail spécifique, et cet espace de travail ne peut pas être modifié une fois défini. Il n'est pas nécessaire de définir explicitement l'espace de travail si vous spécifiez à la place des projets ou une tâche parente.

PUT - Marquer une tâche comme terminée

Une tâche spécifique existante peut être mise à jour en effectuant une requête PUT sur l’URL de cette tâche. Seuls les champs fournis dans le bloc de données seront mis à jour ; tous les champs non spécifiés resteront inchangés.

Lorsque vous utilisez cette méthode, il est préférable de ne spécifier que les champs que vous souhaitez modifier, sinon vous risquez d’écraser les modifications apportées par un autre utilisateur depuis votre dernière consultation de la tâche.

Étapes suivantes

• Pour en savoir plus sur Asana, cliquez ici.
• Pour en savoir plus sur les connecteurs, cliquez ici