Variable

Une variable est un composant qui permet de créer des variables utilisables dans plusieurs autres composants tels que les scripts Python, les widgets, les scripts SQL.

Pour créer une variable, il y a deux possibilités :

• Indiquer une valeur fixe dans le champ "Valeur".
• Créer un champ calculé depuis l'éditeur de requête.

Pour réutiliser cette variable dans un autre composant il faut utiliser la syntaxe suivante :

{{MaVariable}}

Les variables système

Deux variables sont fournies par Onyx et disponibles dans tous les projets, sans avoir à les créer :

Elles s'écrivent comme n'importe quelle autre variable, entre doubles accolades, et sont proposées par l'autocomplétion des éditeurs de code ainsi que par le sélecteur de variables de l'éditeur de documentation. Elles apparaissent également dans le tableau des variables du projet, sans possibilité de les modifier ni de les supprimer.

Elles sont utilisables partout où une variable ou un secret l'est déjà : scripts SQL, scripts Shell et Python (script, arguments et variables d'environnement), pipelines, notifications, widgets, filtres, colonnes de formulaire, connexions et serveurs de fichiers.

Attention : la valeur retenue est celle du compte qui exécute réellement l'appel. Lors d'une exécution lancée depuis l'interface, il s'agit de l'utilisateur connecté. Lors d'une exécution planifiée, il s'agit du compte technique du worker, et non de l'auteur de la planification.

Si aucun utilisateur n'est identifié, la variable est remplacée par une chaîne vide, sans erreur.

Ces deux noms sont réservés : Onyx refuse la création ou la modification d'une variable dont le code est user.login ou user.email. Par ailleurs, les valeurs système sont toujours prioritaires sur une variable de projet ou un secret portant le même nom.