Différences

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

--- scrutaridata:xml [2012/09/14 17:38] – vincent
+++ scrutaridata:xml [2025/03/19 22:29] (Version actuelle) – [Structure globale] vincent
@@ Ligne 16: / Ligne 16: @@
   * un ou plusieurs éléments !!<corpus>!! (qui contiennent les informations sur les fiches),
   * zéro ou plusieurs éléments !!<thesaurus>!! (qui contiennent les informations sur les mots-clés),
-  * zéro ou plusieurs éléments !!<indexation-group>!! (qui contiennent les informations sur les liens entre fiches et mots-clés).
+  * zéro ou plusieurs éléments !!<indexation-group>!! (qui contiennent les informations sur l'indexation des fiches par les mots-clés).
@@ 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 [[scrutaridata:uuid_uri|UUID et URI]] 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 54: / Ligne 54: @@
     *   un élément !!<langs-ui>!! facultatif qui liste les différentes langues disponibles pour les URL des fiches et des mots-clés.
     *   un élément !!<base-icon>!! facultatif qui donne l’URL de l’icone de 16 pixels sur 16 à utiliser pour différencier les fiches de la base de celles des autres bases
+    *   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 (voir ci-dessous)
 Les éléments //<intitule-short>// et //<intitule-long>// ne comprennent pas directement du texte mais des éléments !!<lib>!! dotés de l’attribut !!@xml:lang!! qui précisent l’intitulé dans une langue donnée. Le nombre d’éléments //<lib>// est illimité (pas plus d’un par langue, évidemment) et le premier élément //<lib>// est considéré comme la langue par défaut.
@@ Ligne 65: / Ligne 66: @@
 <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 109: / Ligne 110: @@
   * un élément facultatif !!<corpus-icon>!!, qui permet d'indiquer une icône différente pour le corpus,
   * zéro ou plusieurs éléments !!<complement-metadata>!! qui indiquent la présence de champs complémentaires dans les méta-données (en plus du titre et du sous-titre).
+  * 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 (voir ci-dessous)
 Comme pour les intitulés de la base, les intitulés sont précisés à l'aide d'éléments !!<lib>!! avec l'attribut !!@lang:xml!! pour indiquer la langue. Les éléments <complement-metadata> comprennent également des éléments //<lib>// indiquant l’intitulé du champ complémentaire.
@@ Ligne 159: / Ligne 161: @@
   *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 187: / Ligne 177: @@
       <lon>-80.86</lon>
    </geoloc>
-   <complement>Vincent Calame</complement>
+   <complement>Exemole</complement>
+   <attr ns="sct" key="authors">
+     <val>Vincent Calame</val>
+     <val>Karine Goasmat</val>
+   </attr>
 </fiche>
 </code>
@@ Ligne 207: / Ligne 201: @@
 ===== <thesaurus-metadata> =====
-L’élément //<thesaurus-metadata>// comprend un seul élément !!<intitule-thesaurus>!! qui indique l’intitulé du thésaurus. Comme les autres intitulé, cet élément est composé d’élément !!<lib>!!.
+L’élément //<thesaurus-metadata>// comprend :
+  * un seul élément !!<intitule-thesaurus>!! qui indique l’intitulé du thésaurus. Comme les autres intitulé, cet élément est composé d’élément !!<lib>!!.
+  * 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 (voir ci-dessous)
 ==== Exemple ====
@@ Ligne 221: / Ligne 217: @@
 ===== <motcle> =====
-L’élément //<motcle>// possède un attribut obligatoire !!@motcle-id!! qui est l’identifiant du mot-clé au sein du thésaurus (des mots-clés dans des thésaurus différents peuvent avoir la même valeur de //@motcle-id//). Il comprend des éléments !!<lib>!! similaires à ceux des intitulés de thesaurus, de corpus ou de base puisqu’un mot-clé peut-être multilingue.
+L’élément //<motcle>// possède un attribut obligatoire !!@motcle-id!! qui est l’identifiant du mot-clé au sein du thésaurus (des mots-clés dans des thésaurus différents peuvent avoir la même valeur de //@motcle-id//). Il comprend :
+  * des éléments !!<lib>!! similaires à ceux des intitulés de thesaurus, de corpus ou de base puisqu’un mot-clé peut-être multilingue.
+  * 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 (voir ci-dessous)
 ==== Exemple ====
@@ Ligne 250: / Ligne 248: @@
 </code>
+===== 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 serveur Scrutari.
+Un élément //<attr>// contient un ou plusieurs éléments !!<val>!! qui contiennet les valeurs de l'attribut.
+Les attributs sont utilisables pour chaque élément : base, corpus, thésaurus, fiches et mots-clés.
+En ce qui concerne les fiches, 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