Les scripts vous permettent d’ajouter de la logique et des automatismes aux gabarits grâce à un langage de programmation propre au logiciel. Même si vous pouvez concevoir de nombreux récapitulatifs sans scripts, utilisez-les lorsque vous devez :

• effectuer des calculs ;
• modifier des variables ;
• afficher des messages ;
• contrôler l’impression ;
• définir des comportements personnalisés.

Types de scripts disponibles dans un gabarit

Un gabarit de récapitulatif peut inclure les scripts suivants :

• Script d’initialisation
  • Définissez-en un seul par gabarit.
  • Exécutez-le juste avant le début de l’impression du récapitulatif.
    
    
• Script 'Après chargement'
  • Définissez-le pour chaque section de registres.
  • Exécutez-le après le chargement des données de chaque registre et avant l’impression via les zones de la section.
    
    
• Script 'Avant impression'
  • Définissez-le pour chaque zone du gabarit.
  • Exécutez-le immédiatement avant l’impression de chaque requête de la zone.
  • Préparez notamment les variables utilisées par les objets de la zone.
    
    
• Script 'Après impression'
  • Définissez-le pour chaque zone du gabarit.
  • Exécutez-le immédiatement après l’impression du contenu de la zone.
  • Mettez notamment à jour les variables utilisées par les objets du masque de page.

Éditeur de scripts

L’éditeur de scripts vous permet de définir et modifier le contenu des scripts du gabarit. En haut de la fenêtre, identifiez :

• le type de script en cours d’édition ;
• la section ou la zone concernée.

En plus des fonctions d’édition habituelles, utilisez les options suivantes :

• 'Évaluation du script'
  • Définissez si le script doit être exécuté lors de la génération de la liste :
    • 'Toujours évaluer'
    • 'Évaluer si visible'
    • 'Ne pas évaluer' (conservez le script sans l’exécuter)
      
      
• 'Analyser'
  • Vérifiez la syntaxe et détectez d’éventuelles erreurs.
    
    
• 'Mettre en forme'
  • Appliquez une mise en forme pour améliorer la lisibilité du code.
    
    
• 'Coller une constante'
  • Insérez une constante à la position du curseur.
    
    
• 'Coller un champ'
  • Insérez un champ de registre disponible à la position du curseur.
    
    
• 'Coller une variable'
  • Insérez une variable disponible à la position du curseur.
    
    
• 'Coller une fonction'
  • Insérez une fonction du langage de script à la position du curseur.
    
    
• 'Localiser l’origine'
  • Identifiez la source d’un élément utilisé dans le script.
    
    
• 'Variables du gabarit'
  • Accédez aux variables définies dans le gabarit.

La barre d’outils supérieure vous permet également d’effectuer les actions courantes : enregistrer, annuler, rétablir, couper, copier, coller, rechercher, remplacer, etc.

Variables utilisées dans les scripts

Utilisez différents types de variables pour stocker et manipuler des informations pendant l’exécution des scripts :

• variables du gabarit ;
• variables stockables ;
• variables internes (calculs intermédiaires au sein d’un script) ;
• variables dynamiques (basées sur des variables internes, afin de conserver et partager des valeurs entre plusieurs exécutions et plusieurs scripts) ;
• variables utilisateur (valeurs stockées dans la base de données, utilisables dans des expressions associées à des colonnes utilisateur calculées).

Script externe

En plus des scripts définis dans le gabarit, utilisez un script externe.

• Classez les scripts externes par type.
• Partagez-les entre plusieurs gabarits.

Gérez-les depuis l’option 'Script externe' du menu 'Données' :

• si le gabarit n’a aucun script externe, sélectionnez un script externe existant ou créez-en un nouveau ;
• gérez les scripts externes (création, modification, suppression) ;
• localisez leurs fichiers ;
• consultez les gabarits qui les utilisent.