Affichage des documents

La recherche documentaire au sein d'une collection de documents XML est la fonction première de SDX. Si l'affichage de ces documents est une fonction secondaire, elle demeure relativement incontournable.

SDX offre une action permettant l'inclusion d'un document XML dans une page (cf. sdx:page sur la notion de page SDX) : sdx:includeDocument. Le document est offert tel quel ; c'est-à-dire comme un ensemble d'éléments (au sens XML du terme). Ce système simple présente un intérêt majeur puisqu'il permet de travailler le document dynamiquement. Plusieurs styles d'affichage peuvent donc être définis. Par exemple, on peut masquer une partie du document suivant l'identité de l'utilisateur courant ou simplement modifier l'organisation des informations. Bref, c'est toute la puissance du couple XML/XSLT qui est offerte ici.

En relation avec la lecture d'un document XML issus d'une requête, SDX offre des fonctions de navigation au sein des résultats (cf. sdx:navigation). Le développeur d'application peut ainsi permettre au lecteur de naviguer littéralement d'un document à un autre suivant un système de document précédent-suivant.

L'action sdx:includeDocument permet d'inclure un document dans une page SDX. Le document est offert tel quel ; c'est-à-dire comme un ensemble d'éléments (au sens XML du terme). Ce système simple présente un intérêt majeur puisqu'il permet de travailler le document dynamiquement. Plusieurs styles d'affichage peuvent donc être définis. Par exemple, on peut masquer une partie du document suivant l'identité de l'utilisateur courant ou simplement modifier l'organisation des informations. Bref, c'est toute la puissance du couple XML/XSLT qui est offerte ici.

La seule condition nécessaire à l'utilisation de cette action est de connaître l'identifiant du document (id). Dans certains cas, il peut être nécessaire de préciser l'application (app) et la base de documents (base) gérant le document.

<sdx:page>
  <document>
    <sdx:includeDocument idParam="id" baseParam="base"/>
  </document>
</sdx:page>

<sdx:page>
  <document>
    <article id="F1614199900014">
     <articleinfo>...</articleinfo>
     <section>
      <para>...</para>
      <mediaobject>...</mediaobject>
     </section>
    </article>
  </document>
</sdx:page>

<sdx:page>
 <document>

  <sdx:includeDocument
    idParam="id"
    qidParam="qid"
    noParam="n"
    hilite="true"
  />

  </document>
</sdx:page>

<sdx:page>
  <document>
    <sdx:hilites>
      <sdx:term value="france"/>
    </sdx:hilites>
    <article id="F1614199900014">
      ... <sdx:hilite no="1" term="france">France<sdx:hilite> ...
    </article>
    <sdx:navigation qid="q0" page="1" no="3" queryId="q0" docNo="3">
      <sdx:previous
        id="F1388199800042"
        base="docs"
        app="fr.culture.sdx.adfi"
        no="2"
        page="1"
        docId="F1388199800042"/>
      <sdx:next
        id="F1354199500011"
        base="docs"
        app="fr.culture.sdx.adfi"
        no="4"
        page="1"
        docId="F1354199500011"/>
    </sdx:navigation>
  </document>
</sdx:page>

Comme il a été dit dans l'introduction de cette page, sdx:show n'est pas une action SDX à proprement parlé. Elle offre des paramètres SDX utilisables par des actions (généralement des actions de recherche). Le résultat demeure le même qu'en utilisant sdx:includeDocument : le document est inclus dans le XML virtuel prêt à être transformé et affiché dans le navigateur (voir la section Pages XSP pour approfondir la notion de génération/transformation/sérialisation).