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-03Le 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(, )##