Aller au contenu

Variables

Les variables

Les variables sont des champs de données qui peuvent être utilisés dans le modèle pour personnaliser le document. Ces variables sont applicablent à un block de texte via l’onglet dynamic dans le panneau d’outils (panneau de droite).

Les variables ne sont pas liées à un contact, elles sont donc utilisables pour tous les contacts. Elle peuvent être éditées par l’utilisateur lors de la création du document.ou remplis simplement via le panneau de formulaire.

cycle-de-vie


Paramètres d’une variable

interface TFormData {
key: TChampsKeys | 'DEFAULT'
type: string;
name: string;
autoFill: boolean;
editable: boolean;
content: string | null;
index: number | null;
placeholder?: string;
options: OptionKey[];
empty: boolean;
}
KeyDescription
keyClé de la variable, elle doit être unique pour chaque variable. => customization key
typeType de la variable, il peut être string, number, mail
nameNom de la variable, il sera affiché dans le panneau d’outils.
autoFillSi la variable doit être remplie automatiquement à partir des données du contact.
editableSi la variable doit être éditable par l’utilisateur.
contentContenu de la variable, contenu affiché dans le modele et lors de la génération du fichier de production
indexIndex de la variable, il permet de définir sa position dans le bloc de texte
placeholderPlaceholder de la variable, il sera affiché lors de l’edition du bloc de texte avant d’ètre remplacé
optionsOptions de la variable, (comming later)
emptySi la variable est vide,

les options d’une variable (WIP)

type OptionKey = {
name: string;
on: boolean;
val?: any;
val1?: any;
val2?: any;
description: string;
};
KeyDescription
nameNom de l’option, il sera affiché dans le panneau d’outils.
onSi l’option est activée ou non.
valValeur de l’option, elle peut être de type string, number
val1Valeur de l’option, elle peut être de type string, number
val2Valeur de l’option, elle peut être de type string, number
descriptionDescription de l’option, elle sera affichée dans le panneau d’outils.

Options : text

KeyDescription
includeSi activé, la chaîne générée inclura le texte spécifié. Vous pouvez définir le texte dans le champ val.
startWithSi activé, la chaîne générée commencera par le texte spécifié. Vous pouvez définir le texte dans le champ val.
endWithSi activé, la chaîne générée se terminera par le texte spécifié. Vous pouvez définir le texte dans le champ val.
lengthSi activé, la longueur de la chaîne générée sera contrainte au nombre spécifié. Vous pouvez définir la longueur maximale dans le champ val.
uppercaseSi activé, la chaîne générée sera convertie en majuscules.
lowercaseSi activé, la chaîne générée sera convertie en minuscules.
first_letter_uppercaseSi activé, la première lettre de la chaîne générée sera convertie en majuscule.
replaceSi activé, vous pouvez remplacer les occurrences d’une chaîne par une autre dans la chaîne générée. Vous pouvez spécifier les chaînes à remplacer dans les champs val1 et val2.

Options : number

KeyDescription
Digit onlySi activé, la chaîne générée ne contiendra que des chiffres.
formatSi activé, vous pouvez formater la chaîne générée selon un format spécifique. Vous pouvez spécifier le format dans le champ val.
replaceSi activé, vous pouvez remplacer les occurrences d’une chaîne par une autre dans la chaîne générée. Vous pouvez spécifier les chaînes à remplacer dans les champs val1 et val2.
prefixSi activé, vous pouvez ajouter un préfixe à la chaîne générée. Vous pouvez spécifier le préfixe dans le champ val.

Options : mail

KeyDescription
atSi activé, vous pouvez forcer le champ a contenir un @ afin de garantir la présence d’un email