Concaténer les valeurs de plusieurs occurrences

1. À quoi sert le tag :concat() ?

Le tag :concat() permet de regrouper les valeurs d’une même tâche renseignée sur plusieurs occurrences, en choisissant le séparateur à utiliser entre chaque valeur.

Il s’utilise pour les tâches comprises dans :

  • Une section répétable ;
  • Une sélection automatique ;
  • Une sélection manuelle ;
  • Une création.

Vous pouvez ainsi récupérer l’ensemble des valeurs sans renseigner individuellement les indices [1], [2], [3], etc.

Syntaxe à utiliser :

##TAG:concat(séparateur)##

Remplacez TAG par le tag de votre tâche et séparateur par le texte à insérer entre les valeurs.

Par exemple, pour séparer les valeurs par une virgule suivie d’un espace :

##TAG:concat(, )##

2. En pratique, comment utiliser le tag concat ?

Mise en contexte : un technicien réalise une ronde de contrôle des pompes d’un bâtiment. Pour chaque pompe contrôlée, il complète une nouvelle occurrence d’une section répétable et renseigne le nom de l’équipement.

À la fin de la ronde, vous souhaitez récupérer la liste des pompes contrôlées.

Étape 1 : Paramétrer la section répétable

Dans votre formulaire, ajoutez une brique Section répétable nommée « Contrôle des pompes ».

Définissez un maximum de 5 occurrences pour cet exemple.

Étape 2 : Ajouter la tâche contenant le nom de la pompe

Dans cette section, ajoutez une brique Texte nommée « Nom de la pompe ».

Récupérez son tag. Pour cet exemple, nous utiliserons nom_pompe.

Étape 3 : Utiliser le tag concat

Pour regrouper les noms des pompes contrôlées, utilisez :

##nom_pompe:concat(, )##

Étape 4 : Réaliser la ronde

Le technicien contrôle 3 pompes et renseigne les noms suivants dans 3 occurrences :

Occurrence
Nom de la pompe
1
Pompe de relevage PR-01
2
Pompe de circulation PC-02
3
Pompe de surpression PS-03

Le tag renvoie alors :

Pompe de relevage PR-01, Pompe de circulation PC-02, Pompe de surpression PS-03

Le paramétrage s’adapte au nombre d’occurrences réalisées : vous n’avez pas besoin de prévoir un tag pour chacune des 5 occurrences possibles.

3. Comment personnaliser le séparateur ?

Tout le contenu placé entre les parenthèses sert de séparateur, y compris les espaces.

Avec les mêmes pompes, voici quelques exemples :

Paramétrage
Résultat
##nom_pompe:concat(, )##
Pompe de relevage PR-01, Pompe de circulation PC-02, Pompe de surpression PS-03
##nom_pompe:concat( ; )##
Pompe de relevage PR-01 ; Pompe de circulation PC-02 ; Pompe de surpression PS-03
##nom_pompe:concat( / )##
Pompe de relevage PR-01 / Pompe de circulation PC-02 / Pompe de surpression PS-03
💡

À noter

Le tag concat remplace l’énumération manuelle des occurrences :

##nom_pompe[1]##, ##nom_pompe[2]##, ##nom_pompe[3]##, ##nom_pompe[4]##, ##nom_pompe[5]##

Vous utilisez désormais un seul tag :

##nom_pompe:concat(, )##