Différences

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

--- scrutaridata:xml [2010/02/10 14:38]
vincent
+++ scrutaridata:xml [2016/07/06 17:53]
vincent [Exemple]
@@ Ligne 48: / Ligne 48: @@
 L’élément //<base-metadata>// comprend différentes informations sur la base que décrit le fichier :
-    *   un élément !!<authority-uuid>!! dont la valeur doit être un identifiant universel propre au producteur de la base (voir la politique de [[scrutaridata:details:uuid|l'identifiant unique]] pour plus de détails) ;
+    *   un élément !!<authority>!! dont la valeur doit être un nom identifiant le producteur de la base, cela peut être un nom de domaine ou un identifiant universel (voir [[scrutaridata:uri|URI]] pour plus de détails) ;
     *   un élément !!<base-name>!! dont la valeur est le nom technique (chaine de caractères en minuscules, sans accent,ni espace) de la base et qui permet de la distinguer des autres produites par le même producteur ;
     *   un élément !!<intitule-short>!! qui donne un intitulé court de la base ;
@@ Ligne 59: / Ligne 59: @@
 Un élément //<langs-ui>// contient une série d’éléments !!<lang>!! contenant les codes ISO des langues disponibles pour les URL. Celles-ci en effet peuvent contenir la chaîne **$LANGUI** qui sera remplacées dynamiquement par la langue d’interface demandée.
-Les éléments //<lib>// et la question de la langue d'interface sont détaillés dans la [[scrutaridata:details:multilinguisme|question du multilinguisme]].
+Les éléments //<lib>// et la question de la langue d'interface sont détaillés dans la [[scrutaridata:multilinguisme|question du multilinguisme]].
 ==== Exemple ====
@@ Ligne 65: / Ligne 65: @@
 <code xml>
 <base-metadata>
-   <authority-uuid>e17a05b0-c45e-11d8-9669-0800200c9a66</authority-uuid>
+   <authority>e17a05b0-c45e-11d8-9669-0800200c9a66</authority>
    <base-name>gouvafrique</base-name>
    <intitule-short>
@@ Ligne 104: / Ligne 104: @@
 L’élément //<corpus-metadata>// comprend :
-  * un élément !!<corpus-type>!! facultatif qui indique le type des fiches (est-ce des fiches d’expérience, d’analyse, de concepts), cet élément n'est ni normalisé ni exploité pour le moment, on peut l'ignorer pour l'instant,
   * un élément !!<intitule-corpus>!! qui indique les intitulé du corpus dans différentes langues,
   * un élément !!<intitule-fiche>!! qui indique les intitulé à utiliser dans différentes langues pour désigner une fiche du corpus,
@@ Ligne 121: / Ligne 120: @@
 <code xml>
 <corpus-metadata>
-   <type>EXP</type>
+   <corpus-type>EXP</corpus-type>
    <intitule-corpus>
       <lib xml:lang=’fr’>Fiches de suivi</lib>
@@ Ligne 131: / Ligne 130: @@
    </intitule-fiche>
    <href-parent>...</href-parent>
+   <corpus-icon>...</corpus-icon>
    <complement-metadata>
       <lib xml:lang="fr">Participants</lib>
@@ Ligne 156: / Ligne 156: @@
   *un élément !!<href>!! obligatoire indiquant la localisation de la fiche complète sur la Toile
   *autant d’éléments !!<complement>!! que d'éléments //<complement-metadata>// présents dans //<corpus-metadata>// (s’il y a moins d’éléments //<complement>// que prévu, cela signifie que les champs complémentaires non indiqués sont vides)
-  *un élément !!<type>!! facultatif indiquant que la fiche est d’un type différent que le type indiqué pour le corpus (note: les types ne sont ni utilisés ni normalisés pour le moment)
+  *un élément !!<geoloc>!! facultatif permettant d'associer des coordonnées géographiques à la fiche (afin de la géolocaliser), cet élément comprend lui-même un élément !!<lat>!! (la latitude sous forme décimale) et un élément !!<lon>!! (la longitude sous forme décimale)
   *un élément !!<fiche-icon>!! facultatif qui permet d'indiquer un icone propre à la fiche (en remplacement de l'icone de la base)
+  *un nombre illimité d'éléments !!<attr>!! qui définissent des valeurs d'attributs ; les attributs sont un moyen d'étendre le format ScrutariData pour des usages particuliers ; la différence entre attributs et champs complémentaires la manière dont est utilisé un attribut dépend de la configuration du serveur Scrutari
+==== Les attributs ====
+Les attributs sont un moyen d'étendre le format ScrutariData pour des usages particuliers. En effet, un attribut est caractérisé par sa clé qui est elle-même composé de deux éléments : un espace de noms et une clé locale. Ce qui se traduit au niveau XML par la présence de deux attributs pour l'élément //<attr>// : //@ns// (l'espace de noms) et //@sct//. L'utilisation d'un espace de noms permet de limiter les conflits entre clés d'attribut. L'espace de noms !!sct!! est réservé aux attributs gérés par défaut par le seveur Scrutari.
+Un élément //<attr>// contient un ou plusieurs éléments !!<val>!! qui contiennet les valeurs de l'attribut.
+Les différences entre champs complémentaires et attributs sont les suivantes :
+  * Les attributs possèdent une clé, ce qui permet de retrouver facilement leurs valeurs
+  * Les champs complémentaires sont définis au niveau du corpus, ils seront utilisés quelque soit le serveur Scrutari alors que l'utilisation de tel ou tel attribut dépend de la configuration du serveur
+  * Un attribut peut avoir plusieurs valeurs
 ==== Exemple ====
-Dans cet exemple, le premier champ complémentaire correspond à l'auteur de la fiche.
+Dans cet exemple, les auteurs sont gérés par un attribut et le premier champ complémentaire correspond à l'organisme auteur de la fiche.
 <code xml>
@@ Ligne 169: / Ligne 183: @@
    <lang>fr</lang>
    <href>http://www.mapeadores.net/dev-omic/developpement-5.html</href>
-   <complement>Vincent Calame</complement>
+   <geoloc>
+      <lat>48.34</lat>
+      <lon>-80.86</lon>
+   </geoloc>
+   <complement>Exemole</complement>
+   <attr ns="sct" key="authors">
+     <val>Vincent Calame</val>
+     <val>Karine Goasmat</val>
+   </attr>
 </fiche>
 </code>
 ===== <thesaurus> =====