Variables Globales
Les Variables Globales vous permettent de définir des valeurs réutilisables—qu'elles soient codées en dur ou calculées dynamiquement—pour une utilisation à travers Nectari. Ces variables peuvent être référencées à travers la plateforme (par exemple, dans des filtres, des en-têtes de colonnes, des pages de sélection, des calculs ou des traductions).
Vous pouvez utiliser des variables globales dans le Générateur de Scripts SQL dans le Concepteur de Modèle de Données pour des calculs, ou comme en-têtes de colonnes dans des traductions.
Quand utiliser des variables globales
- Standardiser des valeurs dynamiques : Stockez des valeurs, comme le nom de l'entreprise, la période fiscale actuelle ou la devise par défaut, qui doivent être réutilisées dans plusieurs rapports ou tableaux de bord.
- Centraliser la logique personnalisée : Gérez des calculs complexes ou fréquemment mis à jour à un seul endroit, afin que les mises à jour soient reflétées partout où la variable est utilisée.
- Automatiser le contenu sensible au contexte : Utilisez des scripts pour générer du texte, des étiquettes ou des données spécifiques au contexte qui se mettent à jour automatiquement lorsque la logique commerciale ou l'environnement changent.
Créer une variable globale
- Dans le panneau de navigation, cliquez sur l'icône de rouage en bas. La page Administration s'ouvre.
- Sélectionnez Variables Globales dans le menu.
- Cliquez sur Ajouter un Nouvel Enregistrement.
- Remplissez les champs requis.
- (Optionnel) Si vous choisissez Javascript comme type, cliquez sur Évaluer l'Expression pour prévisualiser le résultat de votre script.
- Cliquez sur Créer.
Propriétés des variables globales
| Champ | Description |
|---|---|
| Clé | Entrez un identifiant unique. Les clés doivent commencer par @@ et sont généralement en majuscules (@@DATE, @@USER). |
| Description | Entrez une description pour aider à identifier l'objectif de la variable. |
| Type de la variable globale | Choisissez entre :
|
| Type de Donnée | Sélectionnez le type de donnée attendu pour la variable. |
| Source de Données | (Si le type est JavaScript) Sélectionnez la source de données utilisée dans le script. |
| Script | (Si le type est JavaScript) Entrez le code JavaScript manuellement, ou cliquez sur Générateur JavaScript pour construire ou insérer un script. |
| Résultat | (Si le type est JavaScript) Cliquez sur Évaluer l'Expression.
|
Générateur JavaScript
Le Générateur JavaScript vous aide à écrire, valider et tester des scripts pour des variables globales dynamiques. Utilisez cet outil pour construire une logique à l'aide de fonctions, d'opérateurs, de constantes et de 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 directement dans la zone de l'éditeur en haut. |
| Aides de Code | Utilisez les boutons d'opérateur et de fonction au-dessus de l'éditeur pour insérer rapidement des opérateurs, des parenthèses ou des mots-clés. |
| Mots-clés de Scripts | Trouvez et insérez des fonctions, instructions, opérateurs et constantes JavaScript intégrés à l'aide du menu à gauche. |
| Nectari | Accédez et insérez des variables globales spécifiques à Nectari, des fonctions spéciales et des variables spéciales. |
| Recherche | Tapez des mots-clés pour localiser rapidement les fonctions, variables ou opérateurs disponibles à utiliser dans votre script. |
| Valider | Cliquez pour vérifier votre script à la recherche d'erreurs de syntaxe avant de confirmer. |
Utiliser le générateur JavaScript
- Cliquez sur Générateur JavaScript dans la fenêtre de variable globale.
- Écrivez ou collez votre code JavaScript dans l'éditeur.
- Utilisez les panneaux à gauche pour rechercher et insérer des fonctions, instructions, opérateurs ou variables disponibles.
- Utilisez les boutons d'aide de code pour insérer des opérateurs communs et structurer votre script.
- Cliquez sur Valider pour vérifier les erreurs de syntaxe. Si la syntaxe est valide, un message vert apparaît sous l'éditeur.
- Cliquez sur Confirmer pour insérer votre script dans la variable globale.
Utilisez necResult = comme valeur de retour pour votre script.