Skip to content

Fonctions dans les modèles de documents

Les fonctions peuvent être utilisées lors du formatage automatique des documents à l'aide de modèles. Les fonctions simplifient l'affichage des données dans vos documents. Par exemple, vous pouvez utiliser des formules pour afficher automatiquement des nombres en lettres ou calculer le coût d'une commande.

Formules

Pour ajouter une formule à un document, utilisez la syntaxe suivante : %%%FORMULA%%%.

UNE FORMULE est une expression pour calculer la valeur d'un champ, tout comme dans un champ calculé.

Exemple :

%%%TEXT({{DataTag.Service.Quantity}}*{{DataTag.Service.Cost}};".2f")%%%


Dans l'exemple ci‑dessus, les données du tag de données "Service" sont ajoutées à la formule en utilisant les variables correspondantes. Les deux valeurs sont multipliées et le résultat est la valeur du coût total d'un service ou produit spécifique. La fonction TEXT() formate la valeur en une chaîne de texte lisible par un humain.

Important

Par exemple :

  • Les formules doivent être écrites dans une seule chaîne et ne peuvent pas être coupées en appuyant sur Entrée. Si vous devez insérer un saut de ligne, utilisez la séquence "\n".
  • Sans saut de ligne
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{Datatag.Service calculation.Quantity}} + " " + {{Datatag.Service calculation."Unit"}} + " (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Avec un saut de ligne
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{atatag.Service calculation.Quantity}} + " " + {{{Datatag.Service calculation."Unit"}} + "\n (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Les variables dans la formule ne peuvent pas être mises en forme, par exemple en gras ou en italique.
  • Si vous souhaitez que le résultat de la formule apparaisse en gras, appliquez la mise en forme à l'ensemble de la formule, y compris les symboles pour cent.

Fonctions

Toutes les fonctions disponibles dans les formules des modèles de document :


La fonction SUM

SUM() est une fonction qui additionne toutes les valeurs obtenues lors du calcul d'une formule. Elle s'applique à chaque élément d'une variable multipliée.

Par exemple, supposons que vous avez un tag de données "Service" et que vous souhaitez calculer le coût total de tous les services dans un document. Vous utiliseriez la fonction suivante : 

SUM({{DataTag.Service.Cost}})


Pour obtenir le coût total des services fournis, vous devez multiplier le coût du service par le nombre de fois où il a été commandé. Voici la formule à utiliser dans votre document : 

SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}))


Notez que la fonction SUM() peut contenir n'importe quelle formule composée de fonctions.

La fonction PLURALFORM

Utilisée pour ajouter un suffixe à un mot ou pour modifier le mot lui‑même s'il s'agit d'un nom irrégulier, en fonction du nombre donné précédemment dans le modèle de document.


Format : 

PLURALFORM (number; "text1"; "text2";)


Selon la valeur calculée du nombre, la fonction sélectionne l'un des deux paramètres. Les paramètres doivent être spécifiés dans l'ordre strict demandé par l'algorithme.

Par exemple, vous devez fléchir le mot "dollar". Suivez l'algorithme :

D'abord, écrivez le mot requis avec le nombre 1 :

  • 1 dollar

Cela signifie que le premier paramètre de la fonction doit être le mot "dollar" au lieu de "text1".


Ensuite, écrivez le mot avec le nombre 2 :

  • 2 dollars

Cela signifie que le deuxième paramètre de la fonction doit être le mot "dollars" au lieu de "text2".

Enfin, vous pouvez spécifier la fonction PLURALFORM() suivante dans le document :

PLURALFORM(SUM({{Datatag.Service.Cost}}*{{Datatag.Service.Quantity}}); "dollar"; "dollars")

La fonction NUMBERASWORDS

C'est une fonction qui renvoie un nombre en toutes lettres. Seule la partie entière du nombre est écrite en toutes lettres.

Format : 

NUMBERASWORDS(number; Output; "language")

Où :

  • number — est un nombre ou une formule
  • Output — définit la manière dont le nombre sera affiché (de 0 à 6)
  • language — chaîne qui spécifie la langue de sortie. Si laissée vide (""), la langue de l'utilisateur générant le document est utilisée.

Langues et leurs méthodes dOutput :

  • English ("en")
    • 0-3 — par défaut (nombre cardinal)
    • 4-6 — par défaut avec majuscule
  • German ("de")
    • 0 — par défaut (neutre en genre)
    • 1 — écrit au féminin
    • 2 — écrit au masculin
    • 3 — écrit au neutre
    • 4 — avec majuscule au féminin
    • 5 — avec majuscule au masculin
    • 6 — avec majuscule au neutre
  • French ("fr")
    • 0 — par défaut (nombre cardinal)
    • 1 — écrit au féminin
    • 2 — écrit au masculin
    • 4 — avec majuscule au féminin
    • 5 — avec majuscule au masculin


Par exemple, pour afficher un nombre en toutes lettres dans un document, utilisez la fonction suivante : 

NUMBERASWORDS(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2; "en")

La fonction FRACTIONALPART

Cette fonction affiche la partie fractionnaire d'un nombre. Vous pouvez préciser le nombre de chiffres après la virgule que vous souhaitez afficher.


Format : 

FRACTIONALPART(number; NumberOfDigitsAfterDecimal)


Par exemple, pour afficher le nombre de cents du coût d'un service dans un document, utilisez la fonction suivante : 

FRACTIONALPART(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2)


Cette fonction affiche les deux chiffres après la virgule :

  • 176.03 — la fonction renvoie 3.
  • 15.15 — la fonction renvoie 15.
  • 16.156 — la fonction arrondit les deux premiers décimales à 16.


Aller à

Récupérée de « http://planfix.com/fr/help/index.php?title=Fonctions_dans_les_modèles_de_documents&oldid=2424 »