Différences

Ci-dessous, les différences entre deux révisions de la page.

--- serveurscrutari:config:fields [2017/11/04 14:31]
vincent Exemples
+++ serveurscrutari:config:fields [2024/09/13 22:48] (Version actuelle)
vincent [Structure du format XML]
@@ Ligne 17: / Ligne 17: @@
 ===== Structure du format XML =====
-L'élément racine est l'élément !!<fields>!!. Il peut contenir un nombre illimité d'éléments !!<variant>!!, celui-ci doit posséde un attribut obligatoire, !!@name!!, qui est le nom de la variante. Le nom de la variante doit être un nom « technique », c'est à dire composé uniquement de minuscules non accentuées, de chiffres et du trait de soulignement //_//.
+L'élément racine est l'élément !!<fields>!!. Il peut contenir un nombre illimité d'éléments !!<variant>!!, celui-ci doit posséde un attribut obligatoire, !!@name!!, qui est le nom de la variante. Le nom de la variante doit être un nom « technique », c'est à dire composé uniquement de minuscules non accentuées, de chiffres et du souligné //_//.
 Un élément !!variant!! possède les élements suivants :
-  * !!<fiche>!! : optionnel et unique, il possède un attribut @fields destiné à recevoir un contenu identique au paramètre //fichefields// tel que décrit dans [[serveurscrutari:json:fiche_fields|Champs des fiches]]
+  * !!<fiche>!! : optionnel et unique, il possède un attribut !!@fields!! destiné à recevoir un contenu identique au paramètre //fichefields// tel que décrit dans [[serveurscrutari:json:fiche_fields|Champs des fiches]]
-  * !!<motcle>!! : optionnel et unique, il possède un attribut @fields destiné à recevoir un contenu identique au paramètre //motclefields// tel que décrit dans [[serveurscrutari:json:motcle_fields|Champs des mots-clés]]
+  * !!<motcle>!! : optionnel et unique, il possède un attribut !!@fields!! destiné à recevoir un contenu identique au paramètre //motclefields// tel que décrit dans [[serveurscrutari:json:motcle_fields|Champs des mots-clés]]
-  * !!<alias!! : en nombre illimité, permet de renommer un champ, voire de construire un champ concaténant des champs existants, il possède trois attributs :
+  * !!<alias>!! : en nombre illimité, permet de renommer un champ, voire de construire un champ concaténant des champs existants, il possède trois attributs :
-    * !!@name!! : obligatoire, nom du nouveau champ, le nom est libre mais on évitera de le commencer par //_// (//_// préfixe les champs calculés dans ScrutariJs)
+    * !!@name!! : obligatoire, nom du nouveau champ, le nom est libre mais on évitera de le commencer par un souligné « //_// » (//_// préfixe les champs calculés dans ScrutariJs)
     * !!@fields!! : obligatoire, liste des champs composant le nouveau champ, il est similaire à l'attribut //@fields// de l'élément //<fiche>//
-    * !!@separator!! : optionnel, il indique le séparateur à utiliser si le nouveau champ est composé de plusieurs valeurs
+    * !!@separator!! : optionnel, il indique le séparateur à utiliser si le nouveau champ est composé de plusieurs valeurs ; peut avoir la valeur spéciale ARRAY et, dans ce cas, la valeur du champ ne sera pas une chaine de caractère mais un tableau de chaines de caractères
@@ Ligne 68: / Ligne 68: @@
 	</variant>
 </fields>
+</code>
+===== DTD =====
+<code xml>
+<!ELEMENT fields (variant?)>
+<!ELEMENT variant (fiche?|motcle?|alias*)>
+   <!ATTLIST variant name NMTOKEN #REQUIRED>
+<!ELEMENT fiche EMPTY>
+   <!ATTLIST fiche fields NMTOKEN #REQUIRED>
+<!ELEMENT motcle EMPTY>
+   <!ATTLIST motcle fields NMTOKEN #REQUIRED>
+<!ELEMENT alias EMPTY>
+   <!ATTLIST alias
+        name NMTOKEN #REQUIRED
+        fields NMTOKEN #REQUIRED
+        separator NMTOKEN #IMPLIED
+   >
 </code>