Utiliser des fonctions

Les variables sont utiles pour insérer des informations dans votre document lorsque vous utilisez un modèle. Cependant, les valeurs entrées dans une variable ne sont pas toujours exactement ce que nous voulons insérer dans le document. Vous voudrez peut-être d’abord faire un peu de mise en forme. C’est là que les fonctions interviennent.

Disons que vous voulez afficher le nom_client en LETTRES MAJUSCULES.

Vous pourriez remplir la valeur de la variable en LETTRES MAJUSCULES, mais :

  • C’est source d’erreurs ; il est facile pour l’utilisateur du modèle d’oublier ou de ne pas savoir.
  • Si vous avez besoin du nom_client dans son format officiel ailleurs dans le modèle, vous devriez entrer une valeur pour à la fois nom_client et nom_client_MAJUSCULE à chaque fois.

Une manière plus pratique de gérer cela est d’utiliser une fonction pour transformer nom_client avant de l’afficher.

Voyons cela en action.

1. Aller à la page du bac à sable

Nous utiliserons le bac à sable pour ce tutoriel. Si vous n’êtes pas familier avec, veuillez lire le tutoriel Utiliser le bac à sable.

Ouvrez le bac à sable :

  1. Connectez-vous sur https://documold.com
  2. Cliquez sur “Bac à sable” dans le menu à gauche
  3. Cliquez sur “Réinitialiser” en haut pour que vous commenciez avec le contenu que ce tutoriel attend

2. Localiser le <# nom_client #>

Le contenu de la boîte de gauche devrait être :

Bonjour <# nom_client #>! Ceci est un exemple.

Concentrons-nous sur le <# nom_client #> :

  • le <# marque le début de la commande.
  • le nom_client, parce qu’il commence par une lettre minuscule, est une variable.
  • le #>, marque la fin de la commande.

Note : Les espaces après <# et avant #> ne sont pas nécessaires, mais sont recommandés, car ils rendent le modèle plus facile à lire.

3. Utiliser une fonction

Nous aimerions afficher le nom_client en LETTRES MAJUSCULES. Nous utiliserons la fonction UPPER pour cela.

Pour utiliser une fonction, vous écrivez d’abord le nom de la fonction, puis ouvrez une parenthèse (, ensuite vous fournissez les valeurs à la fonction, et vous terminez avec une parenthèse fermante ).

Donc pour notre cas, la commande entière devrait être : <# UPPER(nom_client) #>.

À des fins de tutoriel, éditez / tapez-le manuellement (au lieu de copier/coller). En tapant, vous remarquerez des messages d’erreur apparaissant en bas à droite. C’est normal ; tant que vous n’avez pas fini d’écrire le tout, la commande n’est pas valide. Par exemple : <# UPPER(nom_client n’est pas valide, car il manque une parenthèse fermante ) et une fin de commande #>.

Vous devriez obtenir ceci :

Bonjour <# UPPER(nom_client) #>! Ceci est un exemple.

La boîte de droite devrait maintenant contenir ANNA LOGWATCH en lettres majuscules. N’hésitez pas à changer la valeur de la variable nom_client en bas à gauche pour le tester.

4. Donner des valeurs directement

Les fonctions n’ont pas à recevoir des variables. Vous pouvez utiliser une fonction en lui donnant des valeurs directement. Par exemple, insérez ceci :

<# UPPER("bonjour") #>

La manière dont cela fonctionne est que les guillemets (") autour de quelque chose indiquent à DocuMold que c’est un morceau de texte. Cela est nécessaire pour distinguer UPPER("bonjour") qui utilise le texte bonjour de UPPER(bonjour) qui utilise le contenu de la variable nommée bonjour.

Nous utilisons la fonction UPPER sur le texte bonjour. Vous devriez voir la boîte de droite contenir : BONJOUR.

Partout où vous utilisez une variable, vous pouvez placer une valeur directement à la place.

5. Une fonction utilisant plus d’une valeur

Certaines fonctions peuvent recevoir plus d’une valeur et d’autres n’en prennent aucune. Cela dépend de la fonction et de ce qu’elle fait.

Un exemple de fonction qui reçoit plusieurs valeurs est TEXTAFTER(texte, délimiteur). Elle reçoit un texte et un délimiteur à l’intérieur de ce texte. Elle renvoie la partie du texte qui est après ce délimiteur dans le texte.

DocuMold utilise une virgule (et un espace) pour séparer les valeurs, cela rend les différentes parties plus claires pour le lecteur (lors de l’édition du modèle) et pour DocuMold.

Essayez ; ajoutez ceci au bac à sable :

<# TEXTAFTER(texte, délimiteur) #>

Vous verrez que vous avez maintenant deux variables en bas à gauche, et rien de nouveau n’est affiché dans la boîte de droite. C’est parce que la valeur de délimiteur, qui par défaut est le texte (délimiteur) n’est pas à l’intérieur de la valeur de texte, qui est le texte (texte).

Si vous changez la valeur de la variable texte pour être “message”, et la valeur de la variable délimiteur pour être la lettre s. Alors dans la boîte de droite, vous verriez sage apparaître.

Encore une fois, la fonction peut recevoir des valeurs directement. Essayez ceci :

<# TEXTAFTER(texte, "/") #>

Écrivez partie1/partie2 comme valeur pour la variable texte en bas à gauche, puis la boîte de droite ne contiendra que partie2.

Vous pouvez utiliser n’importe quels noms de variables. texte et délimiteur sont juste des noms utilisés pour clarifier ce que ces valeurs reçues font lors de la description de la fonction.

6. Plusieurs fonctions à la fois

Vous pouvez aussi passer le résultat d’une fonction à une autre. Essayez ceci dans le bac à sable :

<# TEXTAFTER(UPPER(texte), "/") #>

Avec partie1/partie2 comme valeur pour la variable texte, vous verrez PARTIE2 dans le côté droit.

Conclusion

Les fonctions sont un outil puissant pour transformer et générer de nouvelles valeurs.

DocuMold dispose de nombreuses fonctions. La plupart d’entre elles portent le même nom et se comportent de la même manière que dans Excel.

Vous pouvez toutes les trouver dans la documentation dans la barre de menu à gauche de cette page, sous “Toutes les fonctions”.