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. Trois 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)
  • check : 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>
serveurscrutari/config/validation.txt · Dernière modification: 2017/11/02 11:39 par vincent
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0