DataStore
Sommaire
DataStore
Contexte
Le Datastore est l’endroit où toutes les variables utilisées ailleurs dans le Fichier de Paramétrage doivent être déclarées.
C’est en quelque sorte un “dépôt” de variables.
Le Datastore doit donc être le miroir des autres feuilles du Fichier de Paramétrage.
Il faut obligatoirement définir pour chaque variable : un ID et un type.
On peut définir, facultativement, un contrôle d’intégrité et un commentaire.
Id de la variable
La colonne “Id de la variable” permet de déclarer auprès du système le nom de la variable qu’on définit.
Aspects syntaxiques
Les variables doivent être nommées en respectant certaines règles :
- Le nom de la variable doit être en majuscules
- Les espaces ne sont pas autorisés, on préférera les tirets du bas qui eux sont autorisés : _
- Les accents & et caractères spéciaux ne sont pas non plus autorisés.
Exemples :
Cette colonne doit impérativement être remplie.
Type
Principe
Il s'agit ici d'indiquer quel type d'information sera stockée dans la variable en question.
String: une chaîne de caractèresNumeric: un nombreDate: une dateFile: un fichierList: à utiliser lorsque la variable a vocation à articuler des Repeaters ou des Boucles (se reporter aux sections correspondantes). Ou bien lorsque la variable a vocation à stocker un Multiple-choices.
Cohérence entre le Fields-Form et le DataStore
Il faut être attentif à bien faire coïncider le type dans le Fields-Form et le type dans le DataStore.
Pour cela, on peut se reporter au tableau de compatibilité ci-après :
Cette colonne doit impérativement être remplie.
Contrôle d’intégrité
Introduction
Présentation générale
Pour exercer un contrôle plus précis sur la phase d’input, c'est-à-dire sur le questionnaire, le système peut effectuer des “contrôles d’intégrité” sur les variables : c’est-à-dire vérifier la conformité de ce que rentre l’utilisateur final par rapport à des règles définies dans le DataStore.
Les contrôles à effectuer sont paramétrables et dépendent du type de variable :
Remplir cette colonne est facultatif.
Description des contrôles
Contrôles pour les variables de type String
maxlength:: permet de définir un nombre de caractères maximum lors de la saisie.
minlength:: permet de définir un nombre de caractères minimum lors de la saisie.
choices:: permet de contrôler que le Fields-Form enregistre bien un des choix mentionné.
source:: permet de contrôler que le Fields-Form aille bien chercher une valeur dans la Choice-List qui est choisie.
Contrôles pour les variables de type Numeric et Date
min:: permet de définir un nombre minimum (ou une date minimum) lors de la saisie.
max:: permet de définir un nombre maximum (ou une date maximum) lors de la saisie.
Contrôles pour les variables de type File
extension:: permet de définir les type de fichier autorisés.
Exemples dans un Fichier de Paramétrage
Explications de l'exemple
La variable ACHETEUR_CIVILITE ne pourra recevoir que deux valeurs : M. ou Mme.
La variable ACHETEUR_NOM sera limitée à 64 caractères
La variable ACHETEUR_PRENOM devra contenir au minimum 2 caractères
La variable ACHETEUR_PAYS devra contenir les choix issus d'une Choice-List nommée "pays" (voir la section correspondante du Wiki)
La variable ACHETEUR_MONTANT_ACHATS_HT devra valoir au moins 0
La variable ACHETEUR_DATE_ACHATS devra au minimum valoir la date du 1er janvier 2015 et au maximum la date du jour.
La variable ACHETEUR_CARTE_ID n'acceptera que des fichiers ayant l'extension : png, pdf, jpg, ou bien jpeg
La variable PRODUIT_REF devra contenir au minimum 6 caractères et au maximum 6 caractères
La variable PRODUIT_PRIX_HT devra valoir au minimum 0 et au maximum 10
Commentaires
Celui qui paramètre peut écrire ici toute instruction/remarque utile pour comprendre la manière dont il a construit le datastore et l’organisation des variables.
Remplir cette colonne est facultatif.
