Fichier attributes.xml : définir les attributs utilisés

Le format ScrutariData permet d'associer des attributs à une fiche avec la liberté d'indiquer la clé de l'attribut. Encore faut-il configurer le serveur Scrutari pour qu'il sache quoi faire avec ces attributs. C'est le rôle du fichier attributes.xml.

Dans ce fichier, les attributs sont regroupés par groupe. Actuellement, les groupes sont les suivants :

• Les attributs du premier groupe : ce sont les attributs considérés comme « supérieurs » aux champs complémentaires : ils seront placés avant eux
• Les attributs du second groupe : ce sont les attributs secondaires placés après les champs complémentaires.

Le serveur Scrutari possède des attributs définis par défaut, leur espace de noms est sct. Les attributs par défaut sont :

• sct:authors : auteurs d'un document, cet attribut est toujours rajouté (meêm s'il n'est pas indiqué dans le fichier attributes.xml) dans le premier groupe (sauf si indiqué dans le second groupe dans le fichier attributes.xml)

L'élément racine est l'élément <attributes>, il contient un ou plusieurs éléments <group>. Un élément <group> possède l'attribut @name qui est le nom du groupe et contient un ou plusieurs élements <attr-def> qui sont les définitions des attributs.

Un élément <attr-def> possède deux attributs : @ns l'espace de noms de l'attribut et @key la clé locale de l'attribut (la clé complète de l'attribut est consitué de l'espace de noms et de la clé locale). Il peut contenir un ou plusieurs élements <lib> qui sont les libellés de l'attribut dans différentes langues.

Dans cet exemple, le libellé de l'attribut par défaut sct:authors est renommé pour correspondre aux réalisateurs.

<attributes>
    <group name="primary">
	<attr-def ns="sct" key="authors">
	    <lib xml:lang="fr">Réalisateurs</lib>
	</attr-def>
    </group>
    <group name="secondary">
	<attr-def ns="cine" key="producteurs">
		<lib xml:lang="fr">Producteurs</lib>
	    </attr-def>
	</group>
</attributes>

<!ELEMENT attributes (group*)>
 
<!ELEMENT group (attr-def*)>
   <!ATTLIST group name NMTOKEN #REQUIRED>
 
<!ELEMENT attr-def (lib*)>
   <!ATTLIST attr-def ns NMTOKEN #REQUIRED>
   <!ATTLIST attr-def key NMTOKEN #REQUIRED>
 
<!ELEMENT lib (#PCDATA)>
   <!ATTLIST lib xml:lang NMTOKEN #REQUIRED>