Variables
Les variables vous permettent de stocker et d’exploiter des informations supplémentaires lors de la génération d’un récapitulatif.
La plupart des informations utilisées par un gabarit proviennent directement des champs des modèles de registre. Utilisez toutefois des variables pour manipuler des données qui ne proviennent pas directement de ces champs, par exemple pour :
- stocker des résultats intermédiaires ;
- effectuer des calculs ;
- piloter certaines actions via des scripts ;
- collecter des informations saisies via des boîtes de dialogue.
Vous pouvez utiliser les variables dans différents éléments du gabarit, notamment :
- les objets alphanumériques ;
- les tirets ;
- les dialogues.
Vous pouvez aussi les utiliser sans les associer à un objet du gabarit, uniquement pour :
- effectuer des calculs internes ;
- contrôler le fonctionnement du récapitulatif.
L’éditeur de gabarits des récapitulatifs vous permet d’utiliser :
- des variables du gabarit ;
- des variables stockables.
| Note : |
|---|
| - Les champs de registre fournissent des informations issues des modèles de registre et ne peuvent pas être modifiés via des scripts. - Les variables peuvent recevoir et modifier des valeurs pendant la génération du récapitulatif. - Les variables stockables peuvent conserver leurs valeurs dans la base de données utilisée pour générer le récapitulatif. |
Variables du gabarit
Les variables du gabarit sont définies et stockées dans le gabarit. Gérez-les depuis l’option 'Variables du gabarit' du menu 'Données'.
Définissez chaque variable à l’aide des informations suivantes :
- Nom
- Identifiez la variable de manière unique.
- Utilisez uniquement : lettres non accentuées, chiffres et caractère de soulignement (
_). - Ne faites pas de distinction entre majuscules et minuscules :
total,TotalyTOTALdésignent le même nom. - Évitez tout conflit avec :
- une autre variable ;
- un champ de registre ;
- une fonction ;
- une procédure ;
- un mot réservé du langage de script.
- Type
- Définissez le type d’information stockée :
- nombre décimal ;
- nombre entier ;
- chaîne de caractères.
- Définissez le type d’information stockée :
- Valeur initiale
- Définissez la valeur par défaut, tant que vous ne la modifiez pas (par exemple via une affectation avec un tiret).
- Définissez la valeur par défaut, tant que vous ne la modifiez pas (par exemple via une affectation avec un tiret).
- Commentaire
- Ajoutez une description pour faciliter l’identification de la variable dans les fenêtres qui listent les variables disponibles.
La fenêtre vous permet aussi de :
- visualiser les utilisations de la variable sélectionnée (objets et scripts du gabarit) afin d’identifier ses dépendances avant modification ou suppression ;
- réorganiser les variables via les boutons 'Suivant' et 'Précédent' afin de les retrouver plus facilement.
Variables stockables
Les variables stockables s’utilisent dans les scripts comme les variables du gabarit, avec une différence majeure : vous pouvez enregistrer leurs valeurs dans la base de données utilisée pour générer le récapitulatif.
Ainsi :
- les variables du gabarit appartiennent à un gabarit spécifique ;
- les variables stockables conservent des informations associées à la base de données.
Organisation
- Regroupez les variables stockables en ensembles, classés par type.
- Réutilisez un même ensemble dans plusieurs gabarits.
- Associez au maximum un seul ensemble par gabarit.
Gestion
Gérez-les depuis l’option 'Variables stockables' du menu 'Données'. L’accès dépend de l’association (ou non) du gabarit à un ensemble.
Si le gabarit n’est associé à aucun ensemble :
- sélectionnez un ensemble existant ou créez-en un nouveau ;
- utilisez la fenêtre 'Ensembles de variables stockables disponibles' pour :
- sélectionner, créer ou supprimer des ensembles ;
- localiser leur fichier ;
- consulter leurs utilisations.
Si le gabarit est déjà associé à un ensemble :
- accédez directement à la fenêtre 'Ensemble de variables stockables' ;
- consultez les variables (type, valeur initiale, commentaire) ;
- gérez les variables de l’ensemble et leurs utilisations.
Conversion
Utilisez l’option 'Conversion de variables stockables en variables du gabarit' pour convertir les variables de l’ensemble en variables propres au gabarit.
| Recommandation : |
|---|
| Afin d’éviter les conflits avec les noms des champs de registre et des variables du gabarit, utilisez des préfixes distinctifs pour les variables stockables. Exemple (ensemble lié aux décomptes) : - préfixe : vsd_ ;- noms possibles : vsd_coefreduc. |
