Aller au contenu principal

Toolkit Asana

Le Toolkit Asana permet à vos workflows d'interagir avec Asana — récupération de projets, tâches, utilisateurs et espaces de travail, ainsi que création et mise à jour des tâches.

Authentification​

Tous les outils Asana nécessitent une connexion de compte Asana. Chaque outil inclut un sélecteur Compte Asana avec deux options :

OptionDescription
Utiliser mon compte AsanaUtilise votre compte Asana personnel connecté.
Utiliser le compte d'équipeUtilise un compte Asana d'équipe partagé configuré pour le projet.

Si aucun compte n'est connecté, cliquez sur Connecter un compte Asana pour vous authentifier.

Outils​

Obtenir les projets Asana​

Récupère tous les projets accessibles au compte Asana connecté.

ChampObligatoireDescription
Compte AsanaOuiSélectionnez votre compte Asana personnel ou d'équipe.

Obtenir les utilisateurs Asana​

Récupère tous les utilisateurs dans l'espace de travail Asana connecté.

ChampObligatoireDescription
Compte AsanaOuiSélectionnez votre compte Asana personnel ou d'équipe.

Obtenir les espaces de travail Asana​

Récupère tous les espaces de travail accessibles au compte Asana connecté.

ChampObligatoireDescription
Compte AsanaOuiSélectionnez votre compte Asana personnel ou d'équipe.

Obtenir les champs personnalisés Asana​

Récupère les définitions de champs personnalisés configurées pour un projet Asana spécifique.

ChampObligatoireDescription
Compte AsanaOuiSélectionnez votre compte Asana personnel ou d'équipe.
Project IdOuiL'ID du projet pour lequel obtenir les définitions de champs personnalisés. Tapez @ pour sélectionner une variable.

Obtenir les tâches Asana​

Récupère les tâches d'un projet Asana spécifique avec des filtres optionnels pour le responsable, l'espace de travail et la pagination.

ChampObligatoireDescription
Compte AsanaOuiSélectionnez votre compte Asana personnel ou d'équipe.
Project IdOuiL'ID du projet pour lequel récupérer les tâches. Tapez @ pour sélectionner une variable.
LimitNonNombre maximum de tâches à retourner par requête API. La valeur par défaut est 50.
AssigneeNonFiltrez les tâches par ID d'utilisateur ou email du responsable. La valeur par défaut est null.
WorkspaceNonFiltrez les tâches par ID d'espace de travail. Utilise l'espace de travail par défaut si non fourni. La valeur par défaut est null.
OffsetNonToken de décalage de départ pour la pagination. Généralement non nécessaire car cela récupère toutes les pages. La valeur par défaut est null.

Obtenir les tâches de l'utilisateur Asana​

Récupère toutes les tâches assignées à un utilisateur spécifique dans Asana.

ChampObligatoireDescription
Compte AsanaOuiSélectionnez votre compte Asana personnel ou d'équipe.
AssigneeOuiL'ID d'utilisateur ou l'adresse email pour lequel obtenir les tâches. Tapez @ pour sélectionner une variable.
WorkspaceNonID de l'espace de travail à rechercher. Utilise l'espace de travail par défaut si non fourni. La valeur par défaut est null.
LimitNonNombre maximum de tâches à retourner par requête API. La valeur par défaut est 50.
OffsetNonToken de décalage de départ pour la pagination. Généralement non nécessaire car cela récupère toutes les pages. La valeur par défaut est null.

Créer une tâche Asana​

Crée une nouvelle tâche dans un projet Asana spécifié.

ChampObligatoireDescription
Compte AsanaOuiSélectionnez votre compte Asana personnel ou d'équipe.
Project IdOuiL'ID du projet dans lequel créer la tâche. Tapez @ pour sélectionner une variable.
NameOuiLe nom ou titre de la tâche. Tapez @ pour sélectionner une variable.
NotesNonDescription ou notes pour la tâche. La valeur par défaut est null.
AssigneeNonEmail ou ID de la personne à qui assigner la tâche. La valeur par défaut est null.
Due DateNonDate d'échéance au format ISO (YYYY-MM-DD) ou tout format de date analysable. La valeur par défaut est null.
TagsNonTableau de noms de balises ou de GID de balises à assigner à la tâche. La valeur par défaut est null.
Custom FieldsNonChamps personnalisés sous forme de dictionnaire. Format : {\"field_gid\": \"value\"} ou {\"field_name\": \"value\"}. Pour les champs enum, utilisez le GID ou le nom de l'option enum. La valeur par défaut est null.

Mettre à jour une tâche Asana​

Met à jour une tâche Asana existante par son ID.

ChampObligatoireDescription
Compte AsanaOuiSélectionnez votre compte Asana personnel ou d'équipe.
Task IdOuiL'ID de la tâche à mettre à jour. Tapez @ pour sélectionner une variable.
NameNonNouveau nom ou titre pour la tâche. La valeur par défaut est null.
NotesNonNouvelle description ou notes pour la tâche. La valeur par défaut est null.
CompletedNonMarquer la tâche comme terminée (true) ou incomplète (false). La valeur par défaut est null.
Custom FieldsNonChamps personnalisés à mettre à jour sous forme de dictionnaire. Format : {\"field_gid\": \"value\"} ou {\"field_name\": \"value\"}. La valeur par défaut est null.