Intégration Asana n8nAutomatiser Asana avec n8n.

L'opération crée un projet dans un workspace Asana et renvoie son identifiant, prêt à recevoir des tâches plus loin dans le même passage.

• Name : le nom du projet, souvent construit avec une expression comme {{ $json.company }} pour que chaque nouveau compte ait son tableau.
• Workspace Name or ID : le workspace de destination, choisi dans la liste ou passé en identifiant via une expression.
• Additional Fields : quatre champs facultatifs, dont Privacy Setting (private, private_to_team, public_to_workspace), Due On au format YYYY-MM-DD, Notes et Color.

Supprime un projet côté Asana. Un seul identifiant est demandé, ce qui explique sa place habituelle : en bout de branche de ménage, jamais au milieu d'un flux.

• Project ID : le projet à supprimer. Rien d'autre n'est demandé, donc le garde-fou se met avant, dans un nœud IF qui confirme que la cible est bien le tableau jetable.

Lit un projet et renvoie ses champs. C'est ainsi qu'un workflow vérifie un nom, des notes ou une échéance avant de décider de la suite.

• Project ID : le projet à relire, souvent récupéré depuis le trigger avec {{ $json.resource }} ou depuis une opération de liste.

Renvoie les projets d'un workspace. Cette opération sert surtout quand le workflow connaît le workspace mais pas encore l'identifiant du tableau visé.

• Workspace Name or ID : requis, le workspace dont on liste les projets.
• Return All : activé, n8n enchaîne les pages de l'API et ramène tous les projets ; désactivé, il s'arrête au nombre fixé par Limit.
• Additional Fields : Archived ne garde que les projets dont l'état d'archivage correspond, Teams Name or ID restreint à une équipe.

Modifie un projet existant sans toucher à ses tâches. Détail qui surprend : le workspace est requis en plus de l'identifiant, ce qui n'est pas le cas des opérations de lecture.

• Workspace Name or ID et Project ID : les deux sont requis pour viser le projet.
• Update Fields : sept champs y vivent, dont Name, Notes, Owner, Due On, Color, Privacy Setting et Team Name or ID. Collection laissée vide, l'appel ne change rien.

Accroche une sous-tâche sous une tâche existante. La checklist vit dans la tâche parente au lieu d'encombrer la vue du projet.

• Parent Task ID et Name : la tâche sur laquelle on travaille, et le nom de la sous-tâche à créer.
• Additional Fields : sept options, dont Assignee Name or ID, Due On, Notes, Completed et Assignee Status (inbox, today, upcoming, later), qui ne fonctionne que si un assigné est renseigné.

Renvoie les sous-tâches rattachées à une tâche parente. L'usage naturel, c'est de compter ce qui reste ouvert avant d'autoriser la clôture de la parente.

• Parent Task ID : la tâche dont on veut les sous-tâches.
• Return All et Limit : toutes les sous-tâches, ou un nombre plafonné.
• Options : Field Names or IDs choisit les champs renvoyés, ce qui allège la réponse, et Pretty demande une sortie lisible.

C'est l'opération la plus sollicitée du nœud. Elle crée une tâche dans un workspace et renvoie l'identifiant que réutilisent ensuite les commentaires, les tags et les projets.

• Workspace Name or ID et Name : où va la tâche, et comment elle s'appelle.
• Additional Fields : huit options, dont Assignee Name or ID, Due On, Notes, Project Names or IDs et Completed. Ranger la tâche dès la création évite un second appel.

Efface une tâche pour de bon. Aucun retour en arrière côté n8n, donc cette opération se place derrière un filtre qui a déjà confirmé la cible.

• Task ID : l'identifiant de la tâche à supprimer, en général hérité d'une recherche ou d'une liste plutôt que saisi à la main.

Récupère une tâche et ses champs. Beaucoup de workflows l'appellent juste après le trigger, pour transformer un identifiant brut en données utilisables dans un message.

• Task ID : l'identifiant de la tâche à relire, typiquement {{ $json.resource }} quand la valeur vient du trigger.

Aucun paramètre n'est requis ici, et c'est précisément le piège : sans rien de réglé, l'appel ratisse beaucoup plus large que prévu.

• Return All et Limit : tous les résultats, ou un nombre plafonné.
• Filters : huit filtres, dont Project Name or ID, Section Name or ID, Completed Since et Modified Since. Deux sont liés : Assignee Name or ID exige Workspace Name or ID, et réciproquement.

Envoie une tâche dans une section d'un projet. C'est la façon de faire changer une carte de colonne sans réécrire aucun de ses autres champs.

• Task ID, Project Name or ID et Section Name or ID : les trois sont requis. La liste des sections dépend du projet choisi, donc on renseigne le projet en premier.

Cherche des tâches dans un workspace à partir d'un texte. À ne pas confondre avec l'opération de liste : ici Asana compare les mots du nom ou des notes.

• Workspace Name or ID : requis, le workspace dans lequel la recherche s'exécute.
• Filters : Text est la chaîne cherchée dans le nom ou les notes, Completed garde ou écarte les tâches déjà terminées.

Modifie une tâche en place. Seul l'identifiant est requis, et tout ce que tu veux réellement changer se range dans la collection facultative.

• Task ID : la tâche dont on met les données à jour.
• Additional Fields : huit champs, dont Completed, Name pour le nouveau nom de la tâche, Due On, Assignee Name or ID, Notes et Project Names or IDs.

Publie un commentaire sur une tâche. C'est la manière la moins coûteuse de laisser une trace là où le travail se fait, plutôt que dans un journal que personne n'ouvre.

• Task ID et Text : la tâche à commenter, et le texte brut du commentaire.
• Is Text HTML : indique au nœud si le corps est du HTML ou du texte simple.
• Additional Fields : Pinned épingle le commentaire en haut du fil.

Supprime un commentaire d'un fil. Attention à l'identifiant attendu : celui du commentaire, pas celui de la tâche, donc on garde la valeur renvoyée au moment de l'ajout.

• Comment ID : l'identifiant du commentaire à retirer. Le stocker dans le même passage, ou dans une petite table, c'est ce qui rend le nettoyage possible plus tard.

Range une tâche existante dans un projet, sans rien créer de neuf. Une tâche Asana peut appartenir à plusieurs projets en même temps, et c'est ce qui rend l'opération utile.

• Task ID et Project Name or ID : la tâche à ranger, et sa destination.
• Additional Fields : Insert After et Insert Before prennent une tâche du projet comme repère de position, Section dépose la tâche en bas d'une section.

Sort une tâche d'un projet, la tâche elle-même restant vivante dans le workspace. Rien n'est supprimé, seul le lien entre les deux disparaît.

• Task ID et Project Name or ID : la tâche, et le projet qu'elle doit quitter.

Pose un tag sur une tâche. Dans Asana, les tags servent à filtrer au travers des projets, ce qu'un champ projet seul ne permet pas.

• Task ID : la tâche qui reçoit le tag.
• Tags Name or ID : le tag à poser, choisi dans la liste ou donné en identifiant via une expression.

Opération miroir : elle enlève un tag d'une tâche. Mêmes deux identifiants, effet inverse sur les vues filtrées.

• Task ID et Tags Name or ID : la tâche, et le tag à retirer.

Renvoie un utilisateur Asana. L'identifiant accepté est inhabituellement souple, ce qui économise une recherche dans la plupart des workflows.

• User ID : une adresse email, l'identifiant global unique de la personne, ou le mot-clé me pour désigner le compte qui porte le credential utilisé.

Liste les membres d'un workspace avec leurs noms et leurs identifiants. C'est cette liste qui permet de répartir du travail sans écrire le moindre identifiant en dur.

• Workspace Name or ID : requis, le workspace dont on récupère les utilisateurs.