<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (C) 2000-2010  Ministere de la culture et de la communication (France), AJLSM
See LICENCE file
-->
<!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.1b1//EN" "../../../dtd/website.dtd" [
<!ENTITY parametres SYSTEM "parametres.xml" NDATA XML>
<!ENTITY pipeline SYSTEM "pipeline.xml" NDATA XML>
]>
<webpage id="indexation_champs-sdx"> 
  <head> 
	 <title>Champs SDX</title> 
	 <titleabbrev>Champs SDX</titleabbrev> 
	 <author> 
		<firstname>Martin</firstname> 
		<surname>Sévigny</surname> 
		<affiliation> 
		  <orgname>AJLSM</orgname> 
		</affiliation> 
	 </author> 
	 <revhistory> 
		<revision> 
		  <revnumber>1.0</revnumber> 
		  <date>2003-05-14</date> 
		</revision> 
	 </revhistory> 
  </head> 
  <para>Peu importe la liste des champs déclarés pour une base de documents, et peu importe les champs effectivement remplis lors de l'indexation d'un document, SDX va toujours ajouter des champs aux bases de documents et des valeurs à ces champs lors de l'indexation de tous les documents. Ces champs sont les champs internes à SDX ; un certain nombre sont actuellement définis, d'autres pourraient s'ajouter. Le nom de ces champs commence toujours par <literal>sdx</literal> et cette règles sera conservée dans le futur, il est donc préférable que les champs spécifiques à une application ne débutent pas par ces trois lettres.</para><para>La liste des champs internes à SDX est :</para><variablelist><varlistentry><term>sdxall</term><listitem><para>Ce champ est ajouté systématiquement à tous les documents et il a toujours la même valeur : le chiffre <literal>1</literal>. Il est utilsé pour retourner tous les documents d'une base et il est nécessaire (en interne) pour effectuer des recherches par intervalle de dates.</para><para>On peut donc trouver tous les documents d'une base en effectuant la recherche simple <literal>sdxall:1</literal>.</para></listitem></varlistentry><varlistentry><term>sdxappid</term> <listitem><para>Ce champ contient l'identifiant de l'application à qui appartient la base de documents où le document a été indexé.</para></listitem></varlistentry><varlistentry><term>sdxdbid</term><listitem><para>Ce champ  contient l'identifiant de la base de documents dans laquelle le document a été indexé.</para></listitem></varlistentry><varlistentry><term>sdxdoctype</term><listitem><para>Ce champ contient le type de document dont il s'agit, selon la mécanique interne à SDX. Ce type de document est obtenu par la méthode <literal>getDocType()</literal> de l'objet qui implémente l'interface <literal>fr.gouv.culture.sdx.document.Document</literal> et qui est indexé. Pour l'instant, SDX peut indexer des documents XML et des documents HTML et les classes respectives retournent <literal>xml</literal> et <literal>html</literal>. Pour les utilisateurs et les groupes (qui sont aussi des documents indexés par SDX) les valeurs utilisées sont respectivement <literal>user</literal> et <literal>group</literal>.</para><para>Si un développeur veut avoir sa propre classe de documents, il n'a qu'à retourner de cette méthode une valeur appropriée et elle sera utilisée pour ce champ interne à SDX.</para></listitem></varlistentry><varlistentry><term>sdxmoddate</term><listitem><para>La date de modification, c'est-à-dire la date à laquelle le document a été indexé pour la dernière fois. Cette date est en format ISO 8601 (par exemple 2003-05-02T08:14:00CEST) et est strictement la même qui a été passée en <olink targetdocent="parametres">paramètre</olink> au pipeline d'indexation.</para><para>Ce champ est utile pour obtenir des documents indexés depuis ou avant une certaine date, par exemple pour connaître les mises à jour depuis un certain moment.</para></listitem></varlistentry><varlistentry><term>sdxcontentlength</term><listitem><para>Le nombre d'octets de ce document, lorsqu'il est possible de le déterminer. Par exemple, lorsque le document a été fourni sous la forme d'un objet DOM, sa taille n'est pas connue parce qu'elle n'est pas pertinente. Ce champ n'est donc pas systématiquement renseigné.</para></listitem></varlistentry></variablelist><para>A noter que ces champs internes à SDX sont toujours retournés dans les résultats de recherche, un peu comme s'ils avaient un attribut <sgmltag class="attribute">brief="true"</sgmltag> dans leur déclaration.</para> 
</webpage> 
