Concat

Syntaxe

Paramètres

Description

Cette fonction permet de concaténer le résultat d'une formule appliquée à tous les enregistrements d'une table, produisant une seule chaîne de caractères.

Remarques

• La fonction Concat est très utile pour transformer une série de valeurs issues d'une table en une seule chaîne de texte. Elle applique une formule à chaque ligne, récupère la valeur correspondante, et les assemble dans une chaîne unique. C'est l'équivalent d'un "join" textuel dans d'autres langages, souvent utilisé pour l'affichage ou l'exportation.
• Le paramètre Formula est essentiel : il permet de sélectionner dynamiquement le champ à concaténer ou de calculer une expression à partir des données de chaque ligne. Par exemple, on peut extraire un champ spécifique ou combiner plusieurs champs dans chaque itération. Cela donne une grande souplesse dans la construction du résultat final.
• Le paramètre separator permet d'insérer une chaîne (comme une virgule, un saut de ligne ou un tiret) entre chaque élément concaténé. Cela rend le résultat bien lisible et structuré, particulièrement dans les interfaces ou les exports. Sans ce séparateur, les éléments seraient collés les uns aux autres sans distinction.
• Contrairement à la fonction Concatenate, qui assemble des chaînes de texte simples, Concat traite des ensembles de données complexes comme des tables. Elle est donc mieux adaptée aux scénarios avec des sources de données structurées, comme les galeries ou les collections. C'est un outil puissant pour synthétiser de grandes quantités d'informations.
• Concat est souvent utilisée dans des champs d'étiquette (Label) ou des notifications, pour générer dynamiquement du contenu lisible à partir d'une liste. Par exemple, on peut afficher la liste des noms sélectionnés dans une galerie ou les titres d'articles dans un résumé. Cela améliore la lisibilité sans boucle explicite.
• Il est important de noter que la fonction Concat ne modifie pas la table d'origine : elle lit chaque enregistrement et retourne uniquement une chaîne de caractères. Cela la rend sûre pour l'affichage ou le traitement de données sans risque de modifier la source. Elle est purement déclarative et sans effet de bord.
• Concat est compatible avec des tables filtrées ou transformées à l'aide de fonctions comme Filter, Sort, ou AddColumns. On peut ainsi préparer les données en amont, puis les concaténer avec précision selon des critères spécifiques. Cela permet une gestion efficace et dynamique des textes complexes.
• La fonction Concat peut aussi servir à créer des fichiers texte, des messages, ou des structures JSON simples dans un format personnalisé. En associant chaque ligne à une mise en forme spécifique, on peut construire des documents ou chaînes structurées. Elle est donc aussi utile pour la génération de contenu automatisé.