Formules de balises

Les formules de balises vous permettent d'effectuer des calculs, de formater des dates, de construire du texte et d'agréger des valeurs à l'intérieur d'une balise. Elles utilisent la même syntaxe {{ }} qu'une balise normale, mais commencent par = pour indiquer qu'il s'agit d'une formule.

Par exemple, si votre source contient un champ Line Item Price et que vous souhaitez afficher le prix avec 10 % de taxe ajoutée, multipliez le champ par 1.1 :

{{= Line Item Price * 1.1}}

Tag formula evaluated inside a Portant document template

Arithmétique

Vous pouvez utiliser les opérateurs arithmétiques suivants dans les formules de balises :

Symbole	Opération
`+`	Addition
`*`	Multiplication
`-`	Soustraction
`/`	Division

Vous pouvez combiner plusieurs opérateurs et utiliser des parenthèses ( ) pour construire des expressions plus complexes.

Formules intégrées

Comme Google Sheets et Excel, Portant dispose d'un ensemble de formules intégrées que vous pouvez appeler à l'intérieur d'une balise. Par exemple, ROUND limite une valeur numérique à un nombre défini de décimales :

{{Line Item Price}} -> 24.1234
{{=ROUND(Line Item Price, 2)}} -> 24.12
{{=ROUND(Line Item Price)}} -> 24

Les formules intégrées suivantes sont disponibles :

Formule	Description
`ROUND(Tag, [Places])`	Arrondit la valeur numérique de `Tag` à `Places` décimales. Omettez le second argument pour arrondir à un nombre entier.
`DEFAULT(Tag, Default Value)`	Utilise une valeur de remplacement lorsque la balise est vide.
`ADD(Tag 1, Tag 2, [...])`	Additionne deux balises numériques ou plus. Équivalent à l'utilisation de `+`.
`MULTIPLY(Tag 1, Tag 2, [...])`	Multiplie deux balises numériques ou plus entre elles. Équivalent à l'utilisation de `*`.
`TRUNCATE(Tag, Length)`	Raccourcit la valeur textuelle de `Tag` à la longueur `Length` spécifiée.
`LOWER(Tag)`	Convertit la valeur de `Tag` en texte minuscule.
`UPPER(Tag)`	Convertit la valeur de `Tag` en texte MAJUSCULE.

[ ] signifie que le paramètre est facultatif.

Vous pouvez passer des valeurs littérales à la place de balises (et des balises à la place de valeurs) n'importe où dans une formule.

Numérique

Formules agrégées

Certaines formules intégrées sont conçues pour fonctionner avec les workflows de regroupement de données et agrègent toutes les valeurs regroupées pour une balise. La plus courante est SUM, qui additionne toutes les valeurs d'une balise donnée. C'est le moyen le plus simple de calculer un total à l'intérieur d'un modèle.

Within a Data Grouping Table:
+-----------------------------+
|1. {{Line Item Price}} -> 10 |
+-----------------------------+
|2. {{Line Item Price}} -> 20 |
+-----------------------------+
|3. {{Line Item Price}} -> 30 |
+-----------------------------+

{{=SUM(Line Item Price)}} -> 60

Les formules agrégées numériques sont les suivantes :

Formule	Description
`SUM(Tag)`	Additionne toutes les valeurs de `Tag`.
`PRODUCT(Tag)`	Multiplie toutes les valeurs de `Tag` entre elles.
`AVG(Tag)`	Calcule la moyenne de toutes les valeurs de `Tag`.
`MAX(Tag)`	Renvoie la valeur la plus grande de `Tag`.
`MIN(Tag)`	Renvoie la valeur la plus petite de `Tag`.

Vous pouvez utiliser des formules agrégées n'importe où dans le document, y compris à l'intérieur d'expressions plus complexes. Par exemple, pour calculer le pourcentage qu'un poste représente par rapport au total :

{{= (Price / SUM(Price)) * 100 | 2}}%

Pour les postes du tableau ci-dessus, cela produit :

+-------------------+------------------------------------------------+
|1. {{Price}} -> 10 | {{= (Price / SUM(Price)) * 100 | 2}}% -> 0.16% |
+-------------------+------------------------------------------------+
|2. {{Price}} -> 20 | {{= (Price / SUM(Price)) * 100 | 2}}% -> 0.33% |
+-------------------+------------------------------------------------+
|3. {{Price}} -> 30 | {{= (Price / SUM(Price)) * 100 | 2}}% -> 0.50% |
+-------------------+------------------------------------------------+

Modificateur de décimales

Ajoutez | suivi d'un nombre à la fin d'une expression pour arrondir le résultat à ce nombre de décimales, de la même manière que ROUND. Par exemple, pour arrondir une expression quelconque à 3 décimales :

{{1.1234 + 1.0 | 3}} -> 2.123

Formatage des dates et heures

Formatez n'importe quelle date ou horodatage à l'aide de la formule FORMATDATE. Cela vous donne un contrôle total sur la façon dont les dates apparaissent dans vos documents générés.

Utilisation de base

Utilisez la formule à l'intérieur d'une balise :

{{=FORMATDATE(Timestamp, "DD/MM/YYYY")}}

Le premier paramètre est votre champ de date. Le second paramètre est le format de sortie.

Jetons de formatage

Jeton	Exemples de sortie
D	1, 19
DD	01, 19
M	1, 12
MM	01, 12
MMM	Jan, Dec
MMMM	January, December
YY	25
YYYY	2025

Exemples de formats

Format	Exemple de sortie
`"DD/MM/YYYY"`	07/02/2025
`"MMM D, YYYY"`	Feb 7, 2025
`"MMMM DD"`	February 07
`"YY-MM-DD"`	25-02-07

Arithmétique sur les dates et heures

Vous pouvez ajouter ou soustraire du temps à un champ de date à l'aide de ces fonctions auxiliaires :

{{= Date + DAYS(30)}} retourne une valeur 30 jours après la valeur de Date.

Les unités prises en charge (où N est la quantité à ajouter ou à soustraire) sont :

MINUTES(N)
HOURS(N)
DAYS(N)
WEEKS(N)

Glossaire des formules

Somme

Retourne la somme d'une série de valeurs de champs, y compris toutes les valeurs de champs au sein d'une balise de regroupement de données.

Syntaxe

{{=SUM(tag1, tag2, ...)}}

tag1 : La première balise à additionner.
tag2, ... (facultatif) : Balises supplémentaires à ajouter à tag1.

Les balises à l'intérieur des parenthèses n'ont pas besoin d'être entourées de {{ et }}.

Moyenne

AVG retourne la moyenne numérique d'un groupe de balises, y compris toutes les valeurs de champs au sein d'une balise de groupe de données.

Syntaxe

{{=AVG(tag1, tag2, ...)}}

tag1 : La première balise ou balise de groupe de données à inclure dans la moyenne.
tag2, ... (facultatif) : Balises supplémentaires à inclure.

Maximum

Retourne la valeur la plus élevée d'un groupe de balises, y compris toutes les valeurs de champs au sein d'une balise de groupe de données.

Syntaxe

{{=MAX(tag1, tag2, ...)}}

tag1 : La première balise ou balise de groupe de données à considérer.
tag2, ... (facultatif) : Balises supplémentaires à considérer.

Minimum

Retourne la valeur la plus faible d'un groupe de balises, y compris toutes les valeurs de champs au sein d'une balise de groupe de données.

Syntaxe

{{=MIN(tag1, tag2, ...)}}

tag1 : La première balise ou balise de groupe de données à considérer.
tag2, ... (facultatif) : Balises supplémentaires à considérer.

Arrondi

Arrondit la valeur numérique d'un champ à un certain nombre de décimales.

Syntaxe

{{=ROUND(tag, [places])}}

tag : La valeur à arrondir.
places (facultatif, 0 par défaut) : Le nombre de décimales à utiliser pour l'arrondi.

Exemple d'utilisation

{{=ROUND(1.234, 2)}} -> 1.23

{{=ROUND(1.234)}} -> 1

Multiplication

Retourne le produit de deux champs ou valeurs numériques. Équivalent à l'opérateur *.

Syntaxe

{{=MULTIPLY(tag1, tag2)}}

tag1 : Un champ avec une valeur numérique ou un nombre littéral (par exemple 6).
tag2 : Un champ avec une valeur numérique ou un nombre littéral (par exemple 7).

Addition

Retourne la somme de deux champs ou valeurs numériques. Équivalent à l'opérateur +.

Syntaxe

{{=ADD(tag1, tag2)}}

tag1 : Un champ avec une valeur numérique ou un nombre littéral (par exemple 19).
tag2 : Un champ avec une valeur numérique ou un nombre littéral (par exemple 23).

Texte

Concaténation

Assemble des chaînes de caractères.

Exemple d'utilisation

{{=CONCATENATE('Hello', ' ', 'World')}} -> "Hello World"

{{=CONCATENATE(Line Item Name)}} -> "Item AItem BItem C" (sans espaces)

CONCATENATE(A2:B7)

Syntaxe

CONCATENATE(tag_name_1, [tag_name_2, ...])

string1 : N'importe quel champ ou champ de regroupement de données provenant de la source, ou une chaîne littérale entre guillemets.
string2 ... : N'importe quel nombre d'autres champs, champs de regroupement de données ou chaînes littérales.

Jointure de texte

Combine du texte provenant de plusieurs champs, ou d'un champ de regroupement de données contenant plusieurs valeurs, en insérant un délimiteur entre chaque élément.

Exemple d'utilisation

{{=TEXTJOIN(" | ", "Hello", "World")}} -> "Hello | World"

{{=TEXTJOIN(", ", Line Item Name)}} -> "Item A, Item B, Item C"

Syntaxe

{{=TEXTJOIN(delimiter, tag_name_1, [tag_name_2, ...])}}

delimiter : Une chaîne de caractères (qui peut être vide) ou un autre champ. Si elle est vide, les valeurs sont simplement concaténées.
tag_name_1 : N'importe quel champ ou champ de regroupement de données provenant de la source, ou une chaîne littérale entre guillemets.
tag_name_2, ... : N'importe quel nombre d'autres champs, champs de regroupement de données ou chaînes littérales.

Vous pouvez également utiliser {{=TEXTJOINNONEMPTY(...)}} pour ignorer les valeurs vides dans le résultat.

Troncature

Raccourcit la valeur d'un champ ou d'une chaîne littérale à une longueur donnée.

Syntaxe

{{=TRUNCATE(tag, length)}}

tag : Le texte à tronquer.
length : Le nombre de caractères à conserver.

Si length est supérieur au nombre de caractères de la valeur, la valeur est retournée sans modification.

Exemple

{{Message}} -> "Hello World"

{{=TRUNCATE(Message, 5)}} -> "Hello"

Filtrer et sommer (SUMIF)

Additionne les valeurs qui correspondent à une condition.

Syntaxe

{{=SUMIF(Condition Tag = "Something", Numeric Data Grouped Field)}}

Pour en savoir plus sur les conditions dans les balises, consultez les instructions conditionnelles des balises.