Variables récurrentes

Variables répétées (multiplicatives) sont utilisées avec des champs pouvant contenir plusieurs valeurs (par exemple Assignés, fichiers, etc.). Elles permettent de sortir automatiquement des données de ces champs dans des modèles de document, du texte avec variables et des champs calculés — soit en générant une ligne séparée pour chaque valeur, soit en combinant toutes les valeurs en une seule ligne séparée par des virgules. Les champs qui peuvent contenir des ensembles de valeurs dans les tâches, contacts, projets et employés incluent :

Champs système

Champ	Variable
Assignés	{{Task.Assignee}}
Participants	{{Task.Participant}}
Auditeurs	{Task.Task auditors}}
Tag de données	{{Data tag.Actual working time}}
Fichiers	{{{Task.Attached files}} {{Task.Task file}} {{Task.All files of the task}}

Champs personnalisés

List
Task set
Directory values set
Users list
Values set
Files

Afficher toutes les valeurs sur une seule ligne

Si vous utilisez une variable répétée dans un modèle Word ou dans du texte avec variables, toutes les valeurs du champ seront listées sur une seule ligne, séparées par des virgules. Voici à quoi ressemble la variable dans le modèle :

Dans le document généré :

Afficher les valeurs sur des lignes séparées

Dans les modèles Excel ou dans les tableaux Word, les variables répétées dupliquent automatiquement les lignes et affichent chaque valeur contenue dans le champ.

Voici à quoi ressemble la variable dans le modèle :

Dans le document généré :

Options supplémentaires

Pour un formatage plus avancé dans le texte avec variables, vous pouvez utiliser les constructions FOREACH ou TABLE.

Par exemple, en utilisant FOREACH avec une variable répétée dans un bloc dynamique :

Après enregistrement du bloc, les données seront affichées sous forme de colonne :

Important

Dans les constructions FOREACH et TABLE, le premier argument doit être le nom du champ que vous voulez itérer :

À l’intérieur du corps de chaque construction, vous devez ajouter le nom de la variable et préciser depuis quel champ les données doivent être prises :

Variables et JSON dans les requêtes POST

Pour une requête au format JSON, une variable répétée est représentée comme un tableau :

La requête générera un JSON valide :

{
	phone: [
		"1 (234) 567-89-01",
		"2 (345) 678-91-23",
		"+5 (6789) 12-34-56"
	]
}

Si l’endpoint attend une chaîne unique au lieu d’un tableau, utilisez la variable « Phones as a string » :

{
    phone: "{{Task.Counterparty.Phones as string}}"
}

Résultat :

{
	phone: "1 (234) 567-89-01,2 (345) 678-91-23,+5 (6789) 12-34-56"
}

Go to

Fonctions standard