Cartographie

Les modules d’un scénario sont liés les uns aux autres par la cartographie des éléments. Lorsque vous mappez un élément, vous utilisez les données extraites à l’aide d’un module source dans les paramètres d’un autre module, ou modules cibles. Les valeurs des éléments cartographiés sont ensuite utilisées par le module pour effectuer l’action souhaitée.

Dans l’exemple suivant, l’adresse courriel de l’expéditeur et l’objet (le sujet du courriel), « éléments » récupérés par le module « Surveiller le courriel » et ensuite mis en correspondance dans les paramètres du module « Envoyer un courriel » :

Qu’est-ce qu’un élément?

Un module en fonctionnement produit des ensembles en sortie, et une ensemble est constituée d’éléments. En règle générale, un élément est une information récupérée par un module. L’élément est affiché dans la sortie du module sous la forme d’une étiquette et d’une valeur. Cliquez sur la bulle au-dessus du module pour afficher la sortie du module, selon l’exemple ci-dessous.

Dans l’exemple suivant, l’étiquette de l’élément est « Sujet » et la valeur de l’élément est le message qui suit.

Cartographier un élément

Procédez comme suit pour cartographier un élément d’un module à un autre :

• Ouvrez les paramètres du module cible, dans lequel vous souhaitez cartographier des éléments.
• Cliquez sur le champ où vous souhaitez cartographier un élément d’un module précédent.

Cela ouvrira un panneau de mappage offrant tous les éléments des modules précédents du scénario qui sont disponibles pour la cartographie. Les valeurs d’échantillonnage sont généralement affichées à côté de l’étiquette de l’élément.

Pour associer un élément à un champ, cliquez sur l’élément ou faites-le glisser dans le champ de saisie du module. Les utilisateurs peuvent rechercher des éléments en utilisant le champ de recherche situé en haut du panneau de cartographie. La recherche porte à la fois sur les étiquettes et les valeurs des éléments.

Lorsque vous avez terminé, cliquez sur « OK » pour fermer les paramètres du module. Vous pouvez répéter l’action (faire correspondre la sortie du module aux champs d’entrée d’un autre module) dans d’autres modules ajoutés à votre scénario. Veuillez noter que le nombre de modules liés dans le scénario n’est pas limité. Pour les fonctions de cartographie avancées, voir cet article.

Collections et tableaux

Les éléments de sortie d’un module qui contiennent plusieurs éléments sont appelés des collections (contenant des éléments d’un type différent) ou des tableaux (contenant des éléments du même type). Les collections sont développées dans le panneau de cartographie afin de permettre à l’utilisateur de cartographier facilement les éléments contenus dans la collection. Une collection elle-même n’est généralement pas cartographiée. Vous trouverez ci-dessous un exemple de collection dans la sortie d’un module :

Exemple de collection dans le panneau de cartographie du module :

Exemple de tableau (contenant des collections du même type) dans la sortie du module :

Exemple de tableau (contenant des collections de mêmes types) dans le panneau de cartographie du module :

Cartographie des tableaux

Un tableau est un type d’élément particulier. Un tableau simple contient une ou plusieurs valeurs de texte. Un tableau complexe contient une ou plusieurs collections du même type. La pièce jointe d’un courriel est un exemple de tableau complexe. Le module surveiller les courriels renvoie un tableau de pièces jointes pour chaque courriel. Chaque pièce jointe représente une collection qui peut contenir un nom, un contenu, une taille, etc.

Cartographie du premier élément d’un tableau

Si vous associez l’élément Nom du Destinataire du tableau, il apparaîtra dans le champ comme suit :

Le nombre entre crochets est un indice qui détermine quel élément du tableau sera utilisé. Il est fixé à un par défaut.

Cartographie du N-ième élément d’un tableau

Si vous souhaitez accéder à un autre élément, cliquez sur les crochets et modifiez la valeur de l’index :

Mise en correspondance d’un élément d’un tableau avec une clé donnée

Certains tableaux contiennent plusieurs collections avec des éléments de clé et de valeur. Il s’agit généralement de diverses métadonnées, d’attributs, etc. L’exemple suivant montre le résultat du module WooCommerce > Obtenir un produit qui contient les métadonnées de l’élément, qui est un tableau de collections. Chaque collection contient l’élément des IDs des métadonnées clés et la valeur de l’élément de valeur :

Il s’agit généralement de rechercher un élément en fonction de la valeur de sa clé et d’obtenir la valeur correspondante à partir de l’élément de valeur. Ceci peut être réalisé avec une formule employant une combinaison de la méthode map() et get() et get().

L’exemple suivant montre comment obtenir la valeur de l’élément Valeur de l’élément dont l’ID des métadonnées clés est égal à 20642 :

Le résultat de la formule sera « non ». C’est essentiellement ce que représente la formule :

1. Le premier paramètre de la fonction map() est l’élément entier du tableau.
2. Le paramètre 2 est le nom brut de l’élément de valeur. Pour obtenir le nom brut, placez le curseur de la souris sur l’élément dans le panneau de cartographie :
   
   Tous les paramètres sont sensibles à la casse. Même si, dans cet exemple particulier, l’étiquette de l’élément ne diffère de son nom brut que par la majuscule, il est nécessaire d’utiliser le nom brut, qui est tout en minuscules, contrairement à l’étiquette Valeur.
3. Le troisième paramètre est le nom brut de l’élément clé :
   
4. Le quatrième paramètre est la valeur de la clé donnée.

Étant donné que la fonction map() renvoie un tableau (car il pourrait y avoir d’autres éléments avec la valeur clé donnée), il est nécessaire d’appliquer la fonction get() pour obtenir le premier élément :

1. Le premier paramètre de la fonction get() est le résultat de la fonction map().
2. Le deuxième paramètre est l’indice de l’élément, dont la valeur est un (1).

Conversion d’éléments en une série d’ensembles

Les tableaux peuvent être convertis en une série de paquets à l’aide du module Itérateurs :

Les sorties des modules placés entre un itérateur et un agrégateur ne sont pas accessibles en dehors du module agrégateur.

 

Dépannage

Éléments manquants dans le panneau de cartographie

Pour chaque module, le panneau de cartographie affiche tous les éléments de sortie répertoriés par l’auteur du module. Dans certains cas, cette liste peut être incomplète pour diverses raisons et certains éléments peuvent manquer. Néanmoins, Integromat peut découvrir automatiquement les éléments de sortie manquants. Pour résoudre ce problème, exécutez le module dans l’éditeur de scénarios. La procédure exacte diffère légèrement selon le type de module :

Déclenchement instantané

1. Clic droit sur le module.
2. Sélectionner « Exécuter ce module seul » à partir du menu contextuel.
3. S’il n’y a pas de webhooks en file d’attente, le module attendra qu’un nouveau webhook soit traité.
4. Générer un webhook (par exemple, si le module est Slack > « Listen for new events », qui consiste à surveiller les nouveaux messages d’un canal, puis à envoyer un message au canal).
5. Le module doit terminer son exécution.
6. Cliquer sur la « bulle » située au-dessus du module pour explorer l’ensemble de ses résultats.
7. Le volet de cartographie contient désormais tous les éléments qui ont été détectés dans les résultats du module.

Déclencheurs d’enquêtes

1. Clic droit sur le module.
2. Sélectionner « Exécuter ce module seul » à partir du menu contextuel.
3. S’il n’y a pas de sortie, cliquez sur le bouton « Choisir où commencer » et ajustez les paramètres. S’il n’y a pas d’événement à traiter, créez-en un (par exemple, si le module est Gmail > Surveiller les courriels, envoyez un courriel au dossier que le module surveille) et revenez à l’étape 2.
4. Le module doit terminer son exécution.
5. Cliquer sur la « bulle » située au-dessus du module pour explorer l’ensemble de ses résultats.
6. Le volet de cartographie contient désormais tous les éléments qui ont été détectés dans les résultats du module.

Autres modules

• Le scénario entier (ou seulement la partie contenant le module). Si votre scénario commence par un déclencheur, reportez-vous à la section sur les déclencheurs instantanés/de sondage ci-dessus.
• Le module seul.

Si vous choisissez de n’exécuter que le module seul, alors :

1. Clic droit sur le module.
2. Sélectionner « Exécuter ce module seul » à partir du menu contextuel.
3. Indiquez des valeurs types pour les éléments d’entrée et cliquez sur le bouton « OK ».
4. Le module doit terminer son exécution.
5. Cliquer sur la « bulle » située au-dessus du module pour explorer l’ensemble de ses résultats.
6. Le volet de cartographie contient désormais tous les éléments qui ont été détectés dans les résultats du module.