Les extensions de balise

Les extensions de balises

Les caractères compris dans la chaine de format Date est interprêtée comme une chaine de format et d'heure personnalisée. Ajoutez un spécificateur standard pour définir l'affichage de l'information souhaitée.

Résumer avec l'IA

Pré-requis
✓ Avoir installé, paramétré Gonexa Doc et savoir créer un modèle de document
✓ Ajouter une balise à l'aide de l'assistant

Formater la date & les nombres

Spécifiez le format d'une date ou d'un nombre pour faciliter sa lecture grâce aux nombreuses extensions de balises.

📅 Personnaliser le format Date

CHOIX DES EXTENSIONS

Depuis votre balise basée sur une Date, ajoutez le spécificateur de format en fonction du résultat attendu.

SPÉCIFICATEUR DE FORMAT

DESCRIPTION

Exemple

{!Etiquette|NomAPI(d)}

Modèle de date courte

01/09/2023

{!Etiquette|NomAPI(D)}

Modèle de date longue

Lundi 10 septembre 2023

{!Etiquette|NomAPI(f)}

Modèle de date longue + heure courte

Lundi 10 septembre 2023 13:30

{!Etiquette|NomAPI(F)}

Modèle de date longue + heure longue

Lundi 10 septembre 2023 13:30:50

{!Etiquette|NomAPI(g)}

Modèle de date courte + heure courte

10/09/2023 13:30:50

{!Etiquette|NomAPI(G)}

Modèle de date courte + heure courte

10/09/2023 13:30

{!Etiquette|NomAPI(M)}

Modèle de mois + jour

10 septembre

{!Etiquette|NomAPI(R)}

Modèle RFC1123

Lundi, 10 Septembre 2023 13:30:3

{!Etiquette|NomAPI(T)}

Modèle d'heure longue

13:30:50

{!Etiquette|NomAPI(t)}

Modèle d'heure court

13:30

{!Etiquette|NomAPI(Y)}

Modèle de date + mois

septembre 2023

{!Etiquette|NomAPI(dd MM yyyy)}

Vous pouvez créer des balises complexes avec les spécificateurs de formats suivants sous la forme {!obj|champ(dd MM yyyy)} par exemple. Vous pouvez également choisir d'utiliser les tirets ou les "/" entre chaque format de date.

01 09 2023

{!Etiquette|NomAPI(d)}

Jour du mois, de 1 à 31

{!Etiquette|NomAPI(dddd)}

Nom complet du jour de la semaine

lundi

{!Etiquette|NomAPI(yyyy)}

Année à 4 chiffres

2023

Pour exemple
Pour afficher le jour et le mois de la date d'expiration d'un devis seulement, on ajoutera l'extension (M) {!Quote|DeliveryDate} affichera "Livraison prévue le 10/08/2027"
{!Quote|DeliveryDate(M)} affichera "Livraison prévue le 10 août"

🔢 Personnaliser le format Nombre

GENERER UN FORMAT NOMBRE

SPÉCIFICATEUR DE FORMAT

TYPE DE CHAMP

Exemple

{!Etiquette|NomAPI(C4)}

DEVISE

123,45 €

{!Etiquette|NomAPI(D)}
Facultatif : spécificateur de précision
{!Etiquette|NomAPI(D6)}

DÉCIMAL

1234
-001234

{!Etiquette|NomAPI(F)}
Facultatif : spécificateur de précision
{!Etiquette|NomAPI(F4)}

VIRGULE FIXE

1234,56
1234,5600

{!Etiquette|NomAPI(P)}
Facultatif : spécificateur de précision
{!Etiquette|NomAPI(P4)}

POURCENTAGE

100,00 %
-39,7 %

{!Etiquette|NomAPI(N)}
Facultatif : nombre souhaité de décimales
{!Etiquette|NomAPI(N3)}

NOMBRE

1,234567
1,234

Pour aller plus loin, consultez l'article suivant : https://learn.microsoft.com/fr-fr/dotnet/standard/base-types/standard-date-and-time-format-strings

Faire des calculs

Faire un sous-total de produit ou tout simplement un compte du nombre de produit

Attention
L'utilisation des extensions nécessite d'être sur une version du package ultérieur à la version 1.7. Veuillez mettre à jour le package via l'AppExchange, le cas échéant

Utiliser les extensions de balises dans un tableau

Faire des sommes avec la balise "SUM"

Additionnez les montants d’un même objet enfant, d’un groupement voire même d’une information cachée et cumulez les multi devises. Evitez ainsi les champs de type formule dans Salesforce et affichez facilement des sous totaux.

Après avoir paramétré un objet enfant dans Salesforce ouvrez l'assistant et cherchez la balise de type Nombre sur la quelle vous souhaitez faire une Somme
Cliquez sur les "..." au bout de la balise, puis sur "Faire une somme"
Copiez la balise proposée qui comporte l'extension de balise (SUM)
Collez-là dans le tableau lié à l'objet enfant

Pour exemple
Ajouter le Sous total des Produits et le sous total des Services avec une balise dans chaque tableau {!Product|TotalPrice(SUM)}, {!Service|TotalPrice(SUM)}

Attention
Une balise SUM est impérativement une balise sur un objet enfant
La gestion des mutli devises est prise en compte.

Compter le nombre d'enregistrements dans le tableau

Faîtes le cumul des enregistrements de l'objet enfant pour afficher le nombre de ligne d'un tableau ou qui répondent à un critère renseigné dans Salesforce.

Après avoir paramétré un objet enfant dans Salesforce, ouvrez l'assistant.
Accédez aux balises de l'objet enfant souhaité.
Scrollez la liste des balises disponibles jusqu'en bas et accédez à la balise "Nombre d'enregistrements"
Cliquez dessus pour la copier et collez-là à l’endroit de votre page souhaité.

Attention
Il est possible d’afficher une balise COUNT dans un tableau ou en dehors d'un tableau
Une balise COUNT est impérativement une balise sur un objet enfant

Pour exemple
Sera utile pour compter le nombre de participants à une formation avec la balise "{!count(Participants)} élèves ont participés à cette formation"

Gérer les champs "Rich Text"

La mise en page Salesforce est appliquée par défaut au contenu d'un champ rich text placé dans un document Word à la génération. Ajoutez une ou plusieurs extensions de balise pour modifier ces paramètres.

Par défaut, c'est la mise en page choisie dans le champs Salesforce qui est appliqué à la génération : Taille, couleur, indentation... Pour écraser cette mise en page et appliquer le format définit dans Word, utilisez une extension de balise pour permettre de choisir exactement le bon format.

Les formats modifiables
‍
"f" pour "font" = police
"s" pour "size" = taille
"c" pour color = couleur
"t" pour "type form" = forme de caractère,
"i" pour "indentation" = indentation

Depuis l'assistant, accédez à la balise de type Rich Text à modifier
Cliquez sur les 3 petits points à droite
Cliquez sur "Formater le richtext"
Sélectionnez la mise en forme à prendre du Word
Votre balise est copiée et pourra être collée dans votre modèle à l'endroit souhaité

Attention
Dans le cas où la gestion des indentations n'est pas bien prise en charge, utilisez l'extension i pour uniformiser l'affichage avec une balise comme {!Account|Description(HTML,i)}

Pour exemple
{!Account|Description(HTML,f,s)} dans le cas où vous souhaitez appliquer la police et la taille de la balise Word définie dans le modèle. Le résultat sera uniforme à la mise en page Word.

Gérer les images

Assurez vous d'afficher l'image exactement comme vous le souhaitez

Il est possible d’afficher des images dynamiques à la génération d’un document. Les images peuvent être directement stockées dans des champs de type zone de texte enrichi ou URL.
‍
Nous recommandons néanmoins de stocker l’image en tant que fichier Salesforce, puis de stocker l’ID de la version de contenu (Content Version) sur l’enregistrement

Dans votre modèle de document, ouvrez l’assistant pour accéder à l’objet souhaité
Recherchez le champ zone de texte enrichi ou URL qui contient l’image, ou encore le champ texte contenant l’ID de la version de contenu
Cliquez sur les 3 petits points "..." puis sur "Configurer l’image"
Sélectionnez "Taille d'origine" ou "Taille personnalisée" pour définir manuellement la taille de l'image
Pour exemple
On utilisera {!Account|Champtexte__c(img)} dans le cas où vous conservez la taille d’origine
{!Account|Champtexte__c(img,w=30,h=15)} dans le cas où vous définissez une taille personnalisée, avec une largeur de 30 et une hauteur de 15
{!Account|Champtexte__c(img,w=100)} dans le cas où la largeur est de 100 pixel et que la hauteur se resize automatiquement pour ne pas déformer l'image
Copiez et collez la balise dans votre document

Astuce
Ne définissez qu'un paramètre parmi largeur / hauteur et laissez l'autre en Auto. À la génération, le paramétre non définit s'ajustera automatiquement pour ne pas être déformé.

Affichage partiel d'un champ texte

Choisissez le nombre de caractère d'un champ

La fonctionnalité “Affichage partiel” vous sera grandement utile pour tronquer un champ de type texte

Comment ça fonctionne ?
‍
La syntaxe {!label|champ(X,Y)} permet d'extraire une sous-chaîne d'un champ texte.

‍Paramètres :
‍X = position de départ (en partant de 0)
‍Y = nombre de caractères à afficher

La fonctionnalité "Afficher partiellement le texte" dans l'Assistant Gonexa génère automatiquement cette syntaxe sans avoir à l'écrire manuellement..

Depuis l'assistant, accédez à la balise que vous souhaitez tronquer
Via les "..." cliquez sur "Afficher partiellement le texte"
Définissez le nombre de caractères à afficher et dans "Afficher à partir" cochez "du début" ou "de la fin"
Copiez-collez ensuite la balise dans votre document à l'endroit souhaité

Pour exemple
Un champ de code produit qui contient 5A133.
{!obj|champ(0,2)} = pour renvoyer 5A et la balise {!obj|champ(2,3)} pour renvoyer 123

Attention
Cette fonctionnalité est limitée aux champs de texte ne contenant que des lettres ou des chiffres, et dont le nombre total de caractères est connu

Insertion d'URL dans un texte

Transformez un texte en lien cliquable dans Word

Attention
L'utilisation de ces extensions nécessite d'être sur une version du package ultérieure à la version 2.3.
Veuillez mettre à jour le package via l'AppExchange ou votre compte App, le cas échéant.

Dans Word, il est possible d’associer un lien hypertexte à un texte spécifique en utilisant une extension de balise.

Comment ça fonctionne ?
‍
La syntaxe {!label|champ(link,Texte_affiché,Message_erreur)} transforme une URL stockée dans un champ en lien hypertexte cliquable dans le document Word.

‍3 paramètres :
‍link : mot-clé fixe, toujours identique
‍Texte_affiché : ce que voit l'utilisateur (ex: "Cliquez ici")
‍Message_erreur : texte affiché si l'URL est invalide ou vide

Construisez votre balise via l'assistant et enrichissez son extension selon la méthode ci-dessus
Insérez-là dans votre document Word à l'endroit souhaité
Enregistrez, chargez et testez comme d'habitude

Pour exemple
Pour insérer un lien cliquable lié à un champ texte contenant une URL et affichant le texte "Cliquez ici" avec un message d’erreur "Une erreur est survenue", la balise complète sera :
‍
{!Account|Champtexte__c(link,Cliquez ici,Une erreur est survenue)}

Attention
Assurez-vous que l’URL du champ est valide pour éviter l’affichage du message d’erreur

Mise en majuscule et minuscule

Choisissez de mettre en majuscule ou en minuscule la valeur d'un champ

Attention
L'utilisation de ces extensions nécessite d'être sur une version du package ultérieure à la version 2.4.
Veuillez mettre à jour le package via l'AppExchange ou votre compte App, le cas échéant.

Il est possible de transformer des valeurs de champ en majuscule ou en minuscule à la génération d'un document. Cette fonctionnalité apporte plus de flexibilité et facilite la mise en forme homogène des données affichées.

Ces extensions vous permettent de gérer la mise en forme directement dans le document généré, et vous évite ainsi de créer des champs supplémentaires dans Salesforce.

Comment ça fonctionne ?
‍
Deux extensions pour forcer la casse à la génération du document :
(UPPerCase) → tout en majuscules (lowerCase) → tout en minuscule‍

Construisez votre balise via l'assistant et enrichissez son extension selon la méthode ci-dessus
Insérez-là dans votre document Word à l'endroit souhaité
Enregistrez, chargez et testez comme d'habitude

Pour exemple
‍UPPERCASE → tout en majuscules {!Account|Name(UPPerCase)} Anna's Company devient ANNA'S COMPANY ‍ ‍lowercase → tout en minuscules {!Account|Description(lowerCase)} Logiciel CRM Entreprise devient logiciel crm entreprise