Variables dynamiques (DynVars)

Cette page est encore en cours de rédaction

Vous y trouverez néanmoins les informations essentielles concernant les Dynvars. En cas de problème, contactez votre chef de projet

Introduction

Une variable dynamique est une variable dont la valeur n'est pas figée, mais calculée à partir d'une formule.

À la différence des variables de saisie, dont leur valeur est fixée par exemple lors du remplissage d'un champ de formulaire, la valeur d'une variable dynamique est calculée lorsque l'on en fait mention.

Exemple :

• Soit une variable "PRIX_HT", associée à un champ numérique dans un formulaire.

• Soit une variable dynamique nommée "PRIX_TTC" avec pour formule PRIX_HT * 1.20 .

• Alors, si l'utilisateur a complété le champ avec le nombre "50" (donc "PRIX_HT" vaut 50.0), et la variable "PRIX_TTC" vaudra 60.0. Dés lors que l'utilisateur modifiera le champ associé à "PRIX_HT", alors la valeur de "PRIX_TTC" s'en trouvera impactée : sa valeur n'est pas figée, mais dynamique, comme son nom l'indique.

Notez que :

• Les variables dynamiques n'ont pas de type prédéfini (chaîne, nombre, date...) mais, afin de ne pas complexifié l'usage de ces variables, il est recommandé d'uniformiser les types des différentes valeurs que peut renvoyer une variable dynamique ;

• Le nom d'une variable dynamique (son identifiant) répond à la même [norme de nommage que celle des variables du Datastore (voir ici)](DataStore#Id_de_la_variable) ;

• La formule d'une variable dynamique est dans un format [SmartExpresions], avec quelques particularités spécifiques aux Variables Dynamiques, telle que les [Instructions de boucle] ;

• Les valeurs des variables dynamiques peuvent être un nombre, une valeur booléenne (true / false), une chaîne de caractère, une date, une liste … puisque c'est la réponse d'une [SmartExpresions] ;

Mise en place

Création d'une feuille Dynvars

Le fichier de paramétrage doit contenir une feuille nommée Dynvars "mainstore"

Dynvars mainstore

Cette feuille doit contenir trois colonnes :

ID

ID : c'est le nom de la Dynvar

- Les Dynvars doivent respecter les mêmes règles syntaxiques que les Variables, à savoir :

- Le nom de la variable doit être en majuscules

- Les espaces ne sont pas autorisés. Pour marquer un espace, on préférera donc les tirets du bas qui eux sont autorisés : _

Les accents & et caractères spéciaux ne sont pas non plus autorisés.

Formule

Formule : c'est la formule utilisée pour donner une valeur à cette Dynvar

ID de la source

ID de la source : pour l'instant, une seule valeur est possible (et obligatoire) ici : dynvar

Cas d'usages

Introduction : Les Dynvars reposent sur une syntaxe spécifique nommée SmartExpressions : vous trouverez des informations plus détaillée sur la page dédiée.

Cette page présente uniquement les SmartExpressions basiques les plus utilisées dans les Dynvars.

Pour plus d'informations et de précisions sur la syntaxe, rendez-vous sur la page dédiée.

Opérations mathématiques

Les Dynvars peuvent servir à effectuer des opérations mathématiques, en utilisant les opérateurs basiques, comme par exemple :

Dans cet exemple, une variable PRIX_HT est multipliée par 1.20 pour obtenir un prix TTC

Il est possible d'effectuer des opérations mathématiques entre plusieurs variables, et aussi entre plusieurs Dynvars.

Liste des opérateurs mathématiques pouvant être utilisés : *+-/

Factorisation du raisonnement

On peut aussi prévoir qu'une Dynvar prenne pour valeur TRUE ou FALSE en fonction de la valeur d'autres variables

Par exemple :

Si une des deux variables vaut "france", alors la variable FISCALITE_FR vaudra "vrai".

Cette formule signifie : la Dynvar nommée FISCALITE_FR vaudra TRUE si NATIONALITE_ACHETEUR ou NATIONALITE_VENDEUR est égal à "france"

Il sera donc possible d'utiliser la Dynvar FISCALITE_FR dans des Visible Ifs, ou même dans les formules d'autres Dynvars.

Utilisation des Dynvars pour stocker des chaînes de caractères

Coming Soon