Ceci est une ancienne révision du document !
Table des matières
Fichier validation.xml : définir quelques règles de validation des données
Le fichier validation.xml permet de définir des règles de validation qui vont s'appliquer au contenu des fiches. Cinq règles sont disponibles :
- mandatory : vérifie qu'un champ est présent et ne conserve pas la fiche s'il est absent (ne s'applique qu'à la géolocalisation pour le moment)
- length : vérifie la longueur d'une chaine de caractères et la coupe si nécessaire (ne s'applique qu'au sous-titre pour le moment)
- unique : ne conserver que la première valeur d'un attribut
Structure du format XML
L'élément racine est l'élément <validation>, il contient les éléments suivants en nombre illimité :
- <mandatory> : vide avec l'unique attribut @field qui contient le nom du champ obligatoire (geoloc pour la géolocalisation)
- <check> : vide avec trois attributs : @field le nom du champ, @min la taille minimale de conservation, @max la taille maximale (quand une chaine est plus grande que @min, elle est coupée avant @max à un signe de fin de phrase s'il existe.
- <unique> ! vide avec deux attributs : @ns l'espace de nom de l'attribut et @key la clé locale
Exemple
Ce fichier indique les trois règles prises en compte pour le moment :
<validation> <mandatory field="geoloc"/> <check field="soustitre" min="150" max="250"/> <unique ns="geo" key="city"/> <unique ns="sct" key="website"/> <unique ns="sct" key="thumbnail"/> </validation>
DTD
<!ELEMENT validation (mandatory*|check*)> <!ELEMENT mandatory (EMPTY)> <!ATTLIST mandatory field NMTOKEN #REQUIRED> <!ELEMENT check (EMPTY)> <!ATTLIST check field NMTOKEN #REQUIRED> <!ATTLIST check min NMTOKEN #REQUIRED> <!ATTLIST check max NMTOKEN #REQUIRED> <!ELEMENT unique (EMPTY)> <!ATTLIST unique ns NMTOKEN #REQUIRED> <!ATTLIST unique key NMTOKEN #REQUIRED>