Variables globales
Les variables globales permettent de définir des valeurs réutilisables — fixes ou calculées dynamiquement — pour l’ensemble de SEI. Vous pouvez les utiliser partout dans la plateforme : filtres, en‑têtes de colonnes, pages de sélection, calculs, traductions, etc.
Les variables globales peuvent également être utilisées dans le Générateur de scripts SQL du Concepteur de modèle de données, notamment pour des calculs ou comme en‑têtes dans les traductions.
Quand utiliser les variables globales
- Standardiser des valeurs dynamiques : Stockez des valeurs récurrentes comme le nom de l’entreprise, la période fiscale courante ou la devise par défaut afin de les réutiliser dans plusieurs rapports ou tableaux de bord.
- Définir la logique personnalisée en un seul endroit : Gérez des calculs complexes ou susceptibles d’évoluer dans un seul endroit, afin que chaque mise à jour s’applique automatiquement partout où la variable est utilisée.
- Automatiser le contenu adapté au contexte : Utilisez des scripts pour générer des textes, libellés ou valeurs qui s’adaptent automatiquement en fonction de la logique métier ou de l’environnement.
Créer une variable globale
- Dans le panneau de navigation, cliquez sur l’icône engrenage. La page Administration s'ouvre.
- Sélectionnez Variables Globales dans le panneau latéral.
- Cliquez sur Ajouter un nouvel enregistrement.
- Complétez les champs requis.
- (Optionnel) Si vous choisissez JavaScript comme type, cliquez sur Évaluer l'expression pour prévisualiser le résultat du script.
- Cliquez sur Créer.
Propriétés des variables globales
| Champ | Description |
|---|---|
| Clé | Saisissez un identifiant unique. Les clés doivent commencer par @@ et sont généralement en majuscules (@@DATE, @@USER). |
| Description | Saisissez une description permettant d’identifier l’usage de la variable. |
| Type de la variable globale | Choisissez parmi :
|
| Type de données | Sélectionnez le type de données attendu pour la variable. |
| Source de données | (Si le type est JavaScript) Sélectionnez la source de données utilisée par le script. |
| Script | (Si le type est JavaScript) Saisissez le code JavaScript ou cliquez sur Constructeur de JavaScript pour créer ou insérer un script. |
| Résultat | (Si le type est JavaScript) Cliquez sur Évaluer l'expression.
|
Constructeur de JavaScript
Le Constructeur de JavaScript vous aide à écrire, valider et tester les scripts utilisés dans les variables globales dynamiques. Servez‑vous de cet outil pour créer votre logique à l’aide de fonctions, opérateurs, constantes et variables globales, afin de calculer des valeurs basées sur votre source de données ou une logique avancée.
| Champ | Description |
|---|---|
| Éditeur de script | Écrivez ou collez votre code JavaScript dans la zone d’édition en haut de la fenêtre. |
| Aide au code | Utilisez les boutons d’opérateurs et de fonctions au‑dessus de l’éditeur pour insérer rapidement des opérateurs, parenthèses ou mots‑clés. |
| Mots-clés de scripts | Recherchez et insérez des fonctions JavaScript intégrées, instructions, opérateurs et constantes via le menu de gauche. |
| SEI | Accédez aux variables globales, fonctions spéciales et variables spécifiques à SEI. |
| Recherche | Saisissez un mot‑clé pour retrouver rapidement une fonction, une variable ou un opérateur. |
| Valider | Vérifiez la syntaxe de votre script avant de le confirmer. |
Utiliser le générateur JavaScript
- Cliquez sur Constructeur de JavaScript dans la fenêtre de la variable globale.
- Écrivez ou collez votre code JavaScript dans l’éditeur.
- Utilisez les panneaux de gauche pour rechercher et insérer des fonctions, instructions, opérateurs ou variables disponibles.
- Utilisez les boutons d’aide au code pour insérer les opérateurs courants et structurer le script.
- Cliquez sur Valider pour vérifier la syntaxe. Si elle est correcte, un message en vert s’affiche sous l’éditeur.
- Cliquez sur Confirmer pour insérer le script dans la variable globale.
Utilisez necResult = pour définir la valeur retournée par votre script.