Fonctions Concat et Concatenate

S'applique à : Applications Canvas Colonnes de formule Dataverse Flux de bureau Applications pilotées par modèle CLI Power Platform

Permet de concaténer des chaînes de texte individuelles et des chaînes dans des tables.

Description

La fonction Concatenate concatène un mélange de chaînes individuelles et une table de chaînes à une colonne. Lorsque vous utilisez cette fonction avec des chaînes individuelles, cela équivaut à utiliser l’opérateur&.

La fonction Concat concatène le résultat d’une formule appliquée à tous les enregistrements d’une table, ce qui conduit à une chaîne unique. Utilisez cette fonction pour résumer les chaînes d’une table, à l’image de ce que fait la fonction Sum avec les nombres.

Les champs de l’enregistrement en cours de traitement sont disponibles dans la formule. Utilisez l’opérateur ThisRecord ou référencez simplement les champs par leur nom comme vous le feriez pour toute autre valeur. L’opérateur As peut également être utilisé pour nommer l’enregistrement en cours de traitement, ce qui peut faciliter la compréhension de votre formule et rendre les enregistrements imbriqués accessibles. Pour plus d’informations, consultez les exemples ci-dessous et la section Utilisation de l’étendue de l’enregistrement.

La fonction Split ou MatchAll permet de fractionner une chaîne en une table de sous-chaînes.

Syntaxe

Concat( Table, Formula, separator)

• Table : obligatoire. Table à utiliser.
• Formula : obligatoire. Formule à appliquer aux enregistrements de la table.
• Separator : facultatif. Une valeur de texte à insérer entre les lignes concaténées du tableau.

Concatenate( String1 [, String2, ...] )

• String(s) : obligatoire. Combinaison de chaînes individuelles ou une table de chaînes à une seule colonne.

Exemples

Les exemples de cette section utilisent ces variables globales :

• FirstName = "Jane"
• LastName = "Doe"
• Produits =

Pour créer ces variables globales dans une application, insérez un contrôle Button et définir sa propriété OnSelect sur cette formule :

Set( FirstName, "Jane" ); Set( LastName, "Doe" );
Set( Products,
    Table(
        { Name: "Violin", Type: "String" },
        { Name: "Cello", Type: "String" },
        { Name: "Trumpet", Type: "Wind" }
    )
)

Cliquez sur le bouton (tout en maintenant la touche Alt enfoncée).

Fonction Concatenate et opérateur &

Pour ces exemples, définissez la propriété Text d’un contrôle Label sur une formule de la première colonne du tableau suivant.

Formule	Description	Résultat
Concatenate( LastName, ", ", FirstName )	Concatène la valeur dans LastName, la chaîne "," (une virgule suivie d’un espace) et la valeur FirstName.	"Doe, Jane"
LastName & ", " & FirstName	Identique à l’exemple précédent, sauf l’utilisation de l’opérateur & au lieu de la fonction.	"Doe, Jane"
Concatenate( FirstName, " ", LastName )	Concatène la valeur dans FirstName, la chaîne " " (un simple espace) et la valeur LastName.	"Jane Doe"
FirstName & " " & LastName	Identique à l’exemple précédent, avec l’opérateur & au lieu de la fonction.	"Jane Doe"

Concatenate avec une table contenant une seule colonne

Pour cet exemple, ajoutez un contrôle Gallery vide vertical, définissez sa propriété Items sur la formule du tableau suivant, puis ajoutez une étiquette dans le modèle de galerie.

Formule	Description	Résultat
Concatenate( "Name: ", Products.Name, ", Type: ", Products.Type )	Pour chaque enregistrement de la table Produits, concatène la chaîne "Name:", le nom du produit, la chaîne ", Type: " et le type de produit.	Table à une seule colonne avec une colonne Value contenant les valeurs suivantes : « Nom : Violon, Type : Corde », « Nom : Violoncelle, Type : Corde », « Nom : Trompette, Type : Vent »

Fonction Concat

Pour ces exemples, définissez la propriété Text d’une étiquette sur une formule de la première colonne du tableau suivant.

Formula	Description	Result
Concat( Products, Name, ", " )	Évalue l’expression Name pour chaque enregistrement de Produits et concatène les résultats ensemble en une seule chaîne de texte séparée par ", ".	"’Violon’, ’Violoncelle’, ’Trompette’"
Concat( Products, "'" & Name & "'", ", " )	Évalue l’expression "'" & Name & "'" pour chaque enregistrement de Produits et concatène les résultats ensemble en une seule chaîne de texte séparée par ", ".	"’Violon’, ’Violoncelle’, ’Trompette’"
Concat( Filter( Products, Type = "String" ), Name, ", " )	Évalue la formule Name pour chaque enregistrement de Produits qui satisfait le filtre Type = "String" et concatène les résultats en une seule chaîne de texte séparés par ", ".	"Violon, Violoncelle"

Split et MatchAll

Si vous avez utilisé Concat avec un séparateur, vous pouvez inverser l’opération avec la fonctions Fractionner.

Pour ces exemples, ajoutez une galerie verticale vide, définissez sa propriété Items sur une formule du tableau suivant, puis ajoutez une étiquette dans le modèle de galerie.

Formula	Description	Result
Split( Concat( Products, Name, ", " ), ", " )	Fractionne la chaîne de texte avec le séparateur ", ".	Table à une seule colonne avec une colonne Value contenant les valeurs suivantes : « Violon », « Violoncelle », « Trompette »