Intégration Businessmap n8nAutomatiser Businessmap avec n8n.

Crée une carte et la pose à un endroit précis du tableau, puis la renvoie dans la forme demandée.

• Board Name or ID, Workflow Name or ID, Lane Name or ID et Column Name or ID : les quatre coordonnées requises de la destination, chacune choisie dans une liste ou donnée par son identifiant.
• Title, Description, Priority (Critical, High, Average, Low), Deadline et Owner Name or ID : facultatifs, à remplir depuis l’item entrant, par exemple {{ $json.deadline }}.

Modifie une carte existante en laissant intact tout ce que tu ne remplis pas.

• Card ID : l’identifiant numérique de la carte à modifier, requis, souvent repris du trigger sous la forme {{ $json.card_id }}.
• Board Name or ID : requis ici aussi, pour que le nœud sache de quel tableau viennent les tags, stickers et types de carte.
• Workflow, Column and Lane Fields : collection facultative, utile quand la modification déplace aussi la carte.

Envoie une carte à une autre position sans toucher à son contenu, ce qui est l’opération derrière la plupart des changements d’étape.

• Card ID : la carte qui bouge.
• Board Name or ID, Workflow Name or ID, Lane Name or ID, Column Name or ID : la destination complète, les quatre sont requis, parce qu’une colonne seule reste ambiguë sur un tableau à plusieurs lignes.

Lit une carte à partir de son identifiant numérique et la transmet au nœud suivant.

• Card ID : l’identifiant de la carte à récupérer, requis.
• Output : simplified pour une carte compacte, raw pour tout ce que l’API renvoie, selected pour choisir.
• Select Output Fields : les champs renvoyés en mode selected, par exemple title, deadline et owner_user_id.

Retrouve une carte à partir de la référence lisible que l’équipe lui donne, et non de la clé numérique.

• Custom Card ID : le custom card ID de la carte cherchée, une chaîne de caractères, requis.
• Board Name or ID : facultatif, utile pour restreindre la recherche quand le même format de référence existe sur plusieurs tableaux.

Récupère toutes les cartes d’un tableau en une exécution, point de départ de la plupart des exports et des audits.

• Board Name or ID : le tableau à lire, requis.
• Select Output Fields : c’est ici qu’on allège la charge, parce qu’un tableau de plusieurs centaines de cartes renvoyé en raw rend la suite du workflow pénible à lire et à déboguer.

Crée une relation entre deux cartes, c’est ainsi que le tableau montre qu’un travail dépend d’un autre.

• Card ID : la carte de départ, qui doit appartenir au tableau sélectionné quand l’action en réclame un.
• Will Be Linked As : le type de relation, parents, children, relatives, successors ou predecessors.
• To Card ID : la carte à l’autre bout.

Supprime une relation existante entre deux cartes. Les deux cartes, elles, restent en place avec leur contenu intact.

• Unlink Card ID : la carte dont tu coupes la relation.
• Linked As : la relation à retirer, avec les mêmes cinq valeurs qu’à la création.
• From Card ID : la carte située à l’autre extrémité de cette relation.

Écrit les champs propres au tableau sur une carte, ceux que l’équipe a ajoutés en plus des champs standards.

• Card ID et Board Name or ID : requis tous les deux, puisque les champs personnalisés se définissent tableau par tableau.
• Custom Fields to Set : un resource mapper qui charge les champs du tableau et te laisse associer chacun à une valeur de l’item entrant.

Marque une carte comme bloquée avec un motif documenté, pour que le tableau montre où ça coince.

• Board Name or ID et Card ID : le tableau concerné et la carte bloquée.
• Block Reason Name or ID : à prendre parmi les motifs configurés sur ce tableau.
• Comment : requis, et c’est là que le workflow s’explique, par exemple en nommant le document manquant.

Retire le marqueur bloqué d’une carte une fois l’obstacle levé, et la carte reprend son chemin normal.

• Card ID : la carte bloquée, requis. Si l’action choisie réclame un tableau, vérifie que la carte en fait partie.
• Output : choisis simplified quand le nœud suivant a juste besoin de la confirmation que la carte n’est plus bloquée.

Sort une carte terminée du tableau actif tout en la gardant consultable, contrairement à une suppression.

• Card ID : la carte à archiver, requis.
• Select Output Fields : inclus archived_at quand le nœud suivant doit noter à quel moment la carte a quitté le tableau.

Ramène une carte archivée sur le tableau, à la position qu’elle occupait au moment de l’archivage.

• Card ID : la carte archivée à faire revenir, requis.
• Output : raw est le choix prudent ici, parce que l’état après désarchivage est justement ce que tu veux inspecter dans le journal d’exécution.

Abandonne une carte qui ne sera jamais livrée, la fin honnête d’un travail annulé.

• Card ID : la carte à abandonner, requis.
• Select Output Fields : discarded_at et discard_comment sont les deux champs à renvoyer quand un rapport devra expliquer l’annulation plus tard.

Annule un abandon et remet la carte parmi les vivantes.

• Card ID : la carte abandonnée à restaurer, requis. Si l’action retenue demande un tableau, contrôle que la carte lui appartient.
• Output : selected garde une réponse courte quand seul l’identifiant compte pour la suite.

Poste un commentaire sur une carte, la façon la plus simple pour un workflow de laisser une trace que les gens lisent vraiment.

• Card ID : la carte qui reçoit le commentaire, requis.
• Comment : le texte lui-même, requis, saisi en texte ou en HTML, donc un récapitulatif mis en forme plus tôt dans le workflow reste lisible.

Ajoute une étape de checklist dans une carte, avec son propre responsable et sa propre échéance.

• Card ID et Board Name or ID : la carte parente et son tableau, requis tous les deux.
• Description : le texte de la sous-tâche, requis, en texte ou en HTML.
• Deadline, Owner Name or ID et Subtask Status : facultatifs, le statut permettant de créer une étape déjà marquée comme faite.

Enregistre du temps passé sur une carte, ce qui rend un tableau exploitable pour la facturation ou la charge.

• Card ID : la carte à laquelle le temps se rattache.
• Time Unit et Duration : l’unité et la quantité, requises toutes les deux, pour qu’un même chiffre ne soit jamais lu en minutes ici et en heures ailleurs.
• Date : le jour où le travail a eu lieu, requis, et Comment reste facultatif.

Attache un fichier à une carte à partir des données binaires portées par le nœud précédent.

• Card ID : la carte qui reçoit le fichier, requis.
• File Name : le nom que portera la pièce jointe sur la carte, requis, et un nom dynamique du type {{ $json.reference }}.pdf vaut mieux qu’un nom figé.
• Content : les données binaires du fichier, requises.

Récupère dans le workflow, en données binaires, un fichier déjà attaché à une carte.

• Card ID : la carte qui porte le fichier, requis.
• File Name or ID : le fichier à télécharger, choisi dans la liste ou donné par un identifiant de pièce jointe issu de Get Attachments, ce qui est la manière habituelle d’enchaîner les deux opérations.

Liste les fichiers attachés à une carte, sans autre réglage à se poser.

• Card ID : la carte dont tu veux les pièces jointes, requis, et c’est l’unique paramètre de cette opération.

Ouvre un espace de travail, le conteneur qui accueillera ensuite des tableaux.

• Workspace Name : le nom de l’espace de travail, requis, et la seule chose dont l’opération ne peut pas se passer.
• Type : facultatif, fixe le type de l’espace quand la valeur par défaut ne convient pas.

Renomme un espace de travail ou change son état d’archivage, selon le champ facultatif que tu remplis.

• Workspace ID : l’identifiant numérique de l’espace à modifier, requis, de la forme 12345.
• Workspace Name : facultatif, de quoi garder le nommage aligné sur le référentiel qui fait autorité.
• Archive : facultatif, archive ou désarchive l’espace en une exécution.

Va chercher un espace de travail et transmet sa charge utile à la branche suivante.

Rien n’est réécrit côté outil, donc l’opération se pose sans risque dans une branche qui cherche seulement du contexte.

• Workspace ID : l’identifiant de l’espace à lire, requis, et l’unique paramètre ici.

Liste les espaces de travail sur deux critères requis, plutôt que de tout ramener à l’aveugle.

Les deux filtres étant requis, le résultat reste prévisible même sur un compte qui a grossi pendant plusieurs années.

• Type : requis, cherche les espaces du type sélectionné.
• Get All, Archived or Non-Archived : requis, sélectionne les espaces selon leur état d’archivage.

Ajoute un tableau dans l’espace de travail que tu désignes, prêt à recevoir des cartes.

Le tableau arrive vide, l’exécution qui suit assigne donc en général ses tags et ses stickers dans la foulée.

• Workspace : requis, choisit l’espace auquel le tableau appartient.
• Name : requis, le nom du tableau, par exemple My board.
• Description : facultatif, pratique pour porter le contexte du projet servi par le tableau.

Réécrit le nommage d’un tableau, sa description, ou son état d’archivage.

• Board ID : l’identifiant numérique du tableau à modifier, requis, de la forme 9876.
• Name et Description : facultatifs, laissés tels quels si tu ne les remplis pas.
• Archive : facultatif, archive ou désarchive le tableau.

Renvoie un seul tableau depuis son identifiant, sans rien modifier dessus.

C’est la lecture qui répond à une seule question : le tableau derrière un identifiant est-il bien celui qu’attend le workflow.

• Board ID : l’identifiant du tableau à lire, requis, et l’unique champ à remplir.

Parcourt les tableaux du compte, avec deux filtres facultatifs pour resserrer la récolte.

Sans aucun filtre, elle renvoie simplement ce que le credential peut voir, ce qui suffit pour une première exploration.

• Workspace : facultatif, filtre les tableaux par espace de travail.
• Show Archive : facultatif, décide si les tableaux archivés reviennent dans la liste.

Expose la façon dont un tableau est bâti, ce qu’on lit avant d’y déplacer quoi que ce soit.

La réponse décrit l’agencement et non le contenu, elle reste donc utile sur un tableau dont les cartes bougent toute la journée.

• Board ID : l’identifiant du tableau dont tu récupères la structure, requis.

Déclare un tag dans le compte, avec une couleur facultative pour le rendre lisible d’un coup d’œil.

Le tag existe au niveau du compte une fois créé, et doit encore être assigné à un tableau avant qu’une carte le porte.

• Label : requis, le libellé du tag, par exemple Label.
• Color : facultatif, fixe la couleur du tag sous la forme #EEEEEE.

Change le libellé d’un tag existant, et sa couleur si tu remplis aussi ce champ.

• Tag ID : requis, l’identifiant numérique du tag, de la forme 12345.
• Label : requis ici, contrairement à la création où rien n’oblige à le répéter.
• Color : facultatif, et le moyen le plus rapide d’aligner un tag sur un code couleur décidé ailleurs.

Efface un tag du compte, décision qu’aucune autre opération ne rattrape.

Mieux vaut la protéger par une condition, parce que les cartes qui portaient le tag ne le retrouveront pas ensuite.

• Tag ID : l’identifiant du tag à supprimer, requis, et l’unique paramètre de l’opération.

Retrouve un tag par son identifiant ou par son libellé, pratique quand seul le texte circule entre les outils.

• Tag ID/Label : requis, l’identifiant ou le libellé du tag à lire, par exemple 12345 or Label Name.
• Search By : facultatif, choisit sur lequel des deux porte la recherche.

Rend tous les tags connus du compte, sans aucun réglage à poser.

Cette opération ne prend aucun paramètre, ce qui en fait la façon la moins chère de constituer une table de correspondance en début d’exécution, et la compagne naturelle de l’assignation qui viendra ensuite. À lancer une fois par exécution plutôt qu’une fois par carte.

Rend un tag existant disponible sur un tableau, étape obligatoire avant qu’une carte l’y porte.

Assigner coûte un appel par paire, ce qu’une boucle sur les tableaux d’un espace absorbe sans logique supplémentaire.

• Tag Name or ID : requis, choisi dans la liste ou donné par son identifiant.
• Board Name or ID : requis, le tableau qui reçoit le tag.

Enregistre un sticker avec son libellé, et une couleur quand tu veux le faire ressortir.

Comme un tag, un sticker se crée une fois pour le compte et se réutilise sur autant de tableaux que tu lui assignes.

• Label : requis, le libellé du sticker, par exemple Label.
• Color : facultatif, posé sous la forme #EEEEEE.

Modifie le libellé d’un sticker déjà en place, et sa couleur au passage.

• Sticker ID : requis, l’identifiant numérique, de la forme 12345.
• Label : requis sur cette opération, pour qu’un sticker ne se retrouve jamais sans texte.
• Color : facultatif, laissé intact si tu ne le remplis pas.

Supprime définitivement un sticker du compte.

Aucun retour en arrière ici, donc une exécution qui supprime en masse mérite une branche à blanc qui se contente de journaliser.

• Sticker ID : l’identifiant du sticker à supprimer, requis, et rien d’autre à fournir.

Résout un sticker depuis son identifiant ou son libellé, selon ce que porte l’item entrant.

• Sticker ID/Label : requis, l’identifiant ou le libellé du sticker à lire, par exemple 12345 or Label Name.
• Search By : facultatif, indique au nœud sur lequel des deux chercher.

Énumère les stickers du compte en un seul appel.

Aucun paramètre à remplir ici non plus, ce qui en fait une première étape naturelle dans une synchronisation et un moyen simple de savoir ce qui existe déjà avant de créer quoi que ce soit. La réponse couvre le compte et non un tableau, l’assignation reste donc une décision à part.

Accroche un sticker à un tableau pour que ses cartes puissent le porter.

L’assignation se fait tableau par tableau, si bien qu’un même sticker équipe une équipe et reste invisible chez une autre.

• Sticker Name or ID : requis, choisi dans la liste ou donné par son identifiant.
• Board Name or ID : requis, le tableau de destination.

Rédige un document depuis le workflow, contenu passé en texte ou en HTML.

• Title : requis, le titre du document.
• Content : facultatif, saisi en texte ou en HTML.
• Additional Fields : collection facultative avec For Welcome, Is Archived, Is Important, Is Indexed for AI, Parent Doc ID et Show in Main Doc List.

Charge un document unique par son identifiant et le passe à la suite.

Seul l’identifiant circule, cette lecture s’associe donc naturellement à un trigger qui en porte déjà un.

• Document ID : requis, l’identifiant numérique, de la forme 123.

Rassemble tous les documents qui vivent sur un tableau.

La liste revient tableau par tableau, ce qui en fait le point d’entrée de tout audit qui parcourt le compte entier.

• Board Name or ID : requis, le tableau dont on liste les documents.

Retouche un document sur place, en gardant tel quel chaque champ laissé vide.

• Document ID : requis, le document à modifier.
• Title et Content : facultatifs, conservés si tu les laisses vides.
• Update Fields : collection facultative avec For Welcome, Is Archived, Is Important, Is Indexed for AI et Parent Doc ID.

Pose un document existant sur une carte, sur un tableau, ou sur les deux dans le même appel.

• Document ID : requis, le document à poser.
• Card ID : facultatif, la carte qui reçoit le document, laissé à 0 pour passer outre.
• Board Name or ID : facultatif, le tableau qui le reçoit, laissé vide pour passer outre.

Téléverse un fichier depuis le workflow et l’attache à un document.

• Document ID : requis, le document qui reçoit le fichier.
• File Name : facultatif, le nom que prend le fichier.
• Binary Property : facultatif, le nom du champ binaire de l’item, ou une expression qui renvoie ce nom ou l’objet binaire complet quand l’item ne porte plus le fichier.