DataStore : Différence entre versions

De YoWiki
Sauter à la navigation Sauter à la recherche
Ligne 45 : Ligne 45 :
 
<p><code>minlength:</code>: permet de définir un nombre de caractères minimum lors de la saisie.</p>
 
<p><code>minlength:</code>: permet de définir un nombre de caractères minimum lors de la saisie.</p>
 
<p><code>choices:</code>: permet de contrôler que le [[Fields-Form]] enregistre bien un des choix mentionné.</p>
 
<p><code>choices:</code>: permet de contrôler que le [[Fields-Form]] enregistre bien un des choix mentionné.</p>
 +
<p><code>source:</code>: permet de contrôler que le [[Fields-Form]] aille bien chercher une valeur dans la [[Fields-Form|Choice-List]] qui est choisie. </p>
 
<h5 id="ctrl_number">Contrôles pour les variables de type <b>Numeric</b> et <b>Date</b></h5>
 
<h5 id="ctrl_number">Contrôles pour les variables de type <b>Numeric</b> et <b>Date</b></h5>
 
<p><code>min:</code>: permet de définir un nombre minimum lors de la saisie.</p>
 
<p><code>min:</code>: permet de définir un nombre minimum lors de la saisie.</p>
Ligne 52 : Ligne 53 :
 
<h3 id="ex">Exemples dans un fichier de paramétrage</h3>
 
<h3 id="ex">Exemples dans un fichier de paramétrage</h3>
 
<p>
 
<p>
[[Fichier:Intégrité grand.png|800px|thumb|néant]]
+
[[Fichier:Intégrité grand.png|700px|thumb|néant]]
 
</p>
 
</p>
 
<p><b>Explications de l'exemple</b></p>
 
<p><b>Explications de l'exemple</b></p>

Version du 24 octobre 2019 à 14:36

DataStore

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 :

Un DataStore classique

Cette colonne doit impérativement être remplie.

Type

Il s'agit ici d'indiquer quel type d'information sera stockée dans la variable en question.

  • String : une chaîne de caractères
  • Numeric : un nombre
  • Date : une date
  • File : un fichier
  • List : à 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

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 :

Tablecompatibilite.png

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 :

Les contrôles d'intégrité

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 lors de la saisie.

max:: permet de définir un nombre 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

Intégrité grand.png

Explications de l'exemple

La variable ACHETEUR_CIVILITE ne pourra recevoir que deux valeurs : M. ou Mme., le Fields-Form

La variable ACHETEUR_NOM sera limitée à 64 caractères

La variable

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.