Différences

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

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
scrutaridata:xml [2010/02/10 14:38]
vincent
scrutaridata:xml [2017/11/02 11:04] (Version actuelle)
vincent
Ligne 48: Ligne 48:
 L’élément //<​base-metadata>//​ comprend différentes informations sur la base que décrit le fichier : 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 !!<​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 ;     *   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 !!<​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 é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. 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 59: Ligne 60:
 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. 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 ==== ==== Exemple ====
Ligne 65: Ligne 66:
 <code xml> <code xml>
 <​base-metadata>​ <​base-metadata>​
-   <​authority-uuid>​e17a05b0-c45e-11d8-9669-0800200c9a66</​authority-uuid>+   <​authority>​e17a05b0-c45e-11d8-9669-0800200c9a66</​authority>​
    <​base-name>​gouvafrique</​base-name>​    <​base-name>​gouvafrique</​base-name>​
    <​intitule-short>​    <​intitule-short>​
Ligne 104: Ligne 105:
 L’élément //<​corpus-metadata>//​ comprend : 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-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,   * un élément !!<​intitule-fiche>​!! qui indique les intitulé à utiliser dans différentes langues pour désigner une fiche du corpus,
Ligne 110: Ligne 110:
   * un élément facultatif !!<​corpus-icon>​!!,​ qui permet d'​indiquer une icône différente pour le corpus,   * 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).   * 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. 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 121: Ligne 122:
 <code xml> <code xml>
 <​corpus-metadata>​ <​corpus-metadata>​
-   <​type>​EXP</​type>​+   <corpus-type>​EXP</​corpus-type>
    <​intitule-corpus>​    <​intitule-corpus>​
       <lib xml:​lang=’fr’>​Fiches de suivi</​lib>​       <lib xml:​lang=’fr’>​Fiches de suivi</​lib>​
Ligne 131: Ligne 132:
    </​intitule-fiche>​    </​intitule-fiche>​
    <​href-parent>​...</​href-parent>​    <​href-parent>​...</​href-parent>​
 +   <​corpus-icon>​...</​corpus-icon>​
    <​complement-metadata>​    <​complement-metadata>​
       <lib xml:​lang="​fr">​Participants</​lib>​       <lib xml:​lang="​fr">​Participants</​lib>​
Ligne 156: Ligne 158:
   *un élément !!<​href>​!! obligatoire indiquant la localisation de la fiche complète sur la Toile   *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)   *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 é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 ​
 +
  
 ==== Exemple ==== ==== 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> <code xml>
Ligne 169: Ligne 173:
    <​lang>​fr</​lang>​    <​lang>​fr</​lang>​
    <​href>​http://​www.mapeadores.net/​dev-omic/​developpement-5.html</​href>​    <​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>​ </​fiche>​
 </​code>​ </​code>​
- 
  
 ===== <​thesaurus>​ ===== ===== <​thesaurus>​ =====
Ligne 190: Ligne 201:
  
 ===== <​thesaurus-metadata>​ ===== ===== <​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 ==== ==== Exemple ====
Ligne 204: Ligne 217:
  
 ===== <​motcle>​ ===== ===== <​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 ==== ==== Exemple ====
Ligne 233: Ligne 248:
 </​code>​ </​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
  
  
  
scrutaridata/xml.1265809086.txt.gz · Dernière modification: 2010/02/10 14:38 par vincent
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0