🔃Boucle
L'action Boucle permet de sélectionner une liste d'enregistrements et d'effectuer une séquence d'Actions pour chacun d'entre eux.
Il est possible de boucler sur :
⏺️ L'action boucle sur des enregistrements
Lorsque vous sélectionnez l'action boucle sur des enregistrements, vous devez choisir sur quelle table vous voulez effectuer votre boucle. Puis, vous pouvez conditionner votre boucle et paramétrer l'ordre dans lequel sera effectué votre boucle.
Dans le tutoriel suivant, vous trouverez trois cas d'usage de l'action boucle :
Duplication d'enregistrement d'un workflow à matrice
Duplication d'enregistrement dans un même table
Duplication d'enregistrement d'une table A à une table B
☎️ L'action boucle sur le résultat d'un call API
Lorsque vous sélectionnez l'action boucle sur le résultat d'une action call API, vous devez choisir sur quelle liste vous souhaitez itérer. Vous pouvez ensuite utiliser les objets de la liste sélectionnée dans la séquence d'action de votre boucle.
Cette action peut servir à pré-remplir une matrice qui affiche les résultats d'un Call API. Prenons l'exemple d'un logiciel qui affiche une matrice de communes recherchées par code postal.
🚧 Construire une boucle sur le résultat d'un call API (exemple)
1️⃣ Créez un workflow Recherche des communes par code postal et dans la première page ajoutez un champ texte Code postal pour permettre aux utilisateurs de renseigner un code postal.
2️⃣ Ajoutez une action Call API et utilisez la documentation de l'API que vous souhaitez appeler. Ici, on utilise l'API Géo fourni par le gouvernement et plus particulièrement la recherche par commune. Le Call APi est paramétré de la manière suivante :
En testant la requête sur un code postal quelconque, vous obtenez un schéma que vous pouvez directement utiliser dans votre Call API en cliquant sur Utiliser ce schéma.
3️⃣ Ajoutez une action boucle et bouclez sur le résultat de votre action Call API communes.
4️⃣ Créez un nouvelle page en dehors de votre boucle pour afficher vos résultats. Ajoutez-y une matrice et paramétrez ses colonnes.
5️⃣ Finalement, dans votre boucle, vous pouvez créer un enregistrement dans votre matrice pour permettre à l'utilisateur de visualiser les résultats de sa recherche par code postal.
En saisissant le code postal 14123, l'utilisateur obtient la matrice suivante :
🗂️ L'action boucle sur les fichiers d'un champ fichiers multiples
L'action boucle sur les fichiers d'un champ fichiers multiples sert à traiter indépendamment les fichiers d'un même champ fichiers multiples, l'usage classique étant de les séparer pour les mettre dans un champ fichier simple d'une autre table.
Cette action est disponible dans les workflows, les suivis et les automations. Pour l'instant, dans les automations, elle n'est vraiment utile que pour les triggers "quand un enregistrement est créé", "quand un enregistrement est modifié" et "quand un mail est reçu", c'est à dire lorsque les actions sont reliées à une table. En effet, ce type de boucle a besoin d'être lié à une table : c'est dans celle-ci que se trouvera le champ fichiers multiples sur lequel vous souhaitez travailler.
Lorsque vous sélectionnez l'action boucle sur les fichiers d'un champ fichiers multiples, la table étant déjà sélectionnée, vous devez donc choisir le champ sur lequel vous souhaitez itérer. Pour chaque fichier de votre champ fichiers multiples, vous aurez alors accès au fichier lui-même et à son nom.
Si vous utilisez cette fonctionnalité pour séparer les fichiers d'un champ fichiers multiples, pensez bien à vider le champ fichiers multiples une fois la duplication faite. De cette manière, votre application ne sera pas inutilement lourde, ce qui lui assurera un fonctionnement optimal !
Voyons comment construire une boucle sur les fichiers d'un champ fichiers multiples, et prenons pour cela l'exemple d'un logiciel de gestion de personnel dans lequel on voudrait permettre à un utilisateur de déposer tous ses documents d'un coup, tout en lui permettant de les traiter et de les consulter de manière différenciée.
🚧 Construire une boucle sur les fichiers d'un champ fichiers multiples (exemple)
1️⃣ Créez une table Documents utilisateurs sur laquelle vous souhaitez stocker tous vos fichiers (simples). Créez un champ fichier simple "fle_fichier_utilisateur". Ici, on créera aussi un champ "txt_nom_documentsUtilisateurs" pour stocker le nom des fichiers.
2️⃣ Créez une table Import de documents et y ajouter un champ fichiers multiples "fleM_fichiers_ImportDeDocuments" : cette table sera une table de transition, elle vous servira à recueillir les documents que vous séparerez après coup.
3️⃣ Sur le workflow Import de documents, ajouter le champ "fleM_fichiers_ImportDeDocuments" de sorte à ce que vos utilisateurs puissent déposer tous leurs fichiers.
4️⃣ Dans ce même workflow, ajoutez une boucle et dans "boucler sur", choisissez "les fichiers d'un champ fichiers multiples", puis sélectionnez votre champ "fleM_fichiers_ImportDeDocuments".
5️⃣ Dans cette boucle, ajoutez une action "Créer un enregistrement" sur la table Documents utilisateurs et paramétrer comme suit :
fle_fichier_utilisateur -> par un champ -> {boucle -> fichier}
txt_nom_documentsUtilisateurs -> par "{Boucle → Nom du fichier}"
6️⃣ Ressortez de la boucle et ajoutez, tout en bas, une action "Supprimer un enregistrement", et configurez-la pour supprimer "L'enregistrement en cours".
7️⃣ Vous pouvez à présent lancer un import via l'interface end-user puis vous rendre sur votre table Documents utilisateurs, où vous retrouverez bien tous vos enregistrements.
8️⃣ Sur une page "Mes documents", vous n'avez plus qu'à placer un tableau avec pour source votre table Documents utilisateurs, et comme colonnes le nom du document et le fichier associé. Conditionnez le tableau de sorte à n'afficher que les documents créés par l'utilisateur connecté, et le tour est joué !
Libre à vous à présent d'y ajouter des actions personnalisées, les colonnes ou les conditions de votre choix !
Mis à jour
Ce contenu vous a-t-il été utile ?