<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//UR1//DTD docbookAllegeEsup//FR"
"http://www.esup-portail.org/consortium/espace/docbook/xxe/dtd/docbook_allege_esup.dtd">
<article lang="FR">
  <title>Interface inJAC-OAI</title>

  <subtitle>Utilisation</subtitle>

  <section>
    <title>Utilisation en tant que dépôt compatible OAI-PMH</title>

    <para>En tant que dépôt OAI, cette application s'utilise de façon
    transparente en fournissant à un moissonneur l'URL qui répond aux
    différents verbes du protocole.</para>

    <para>Celle-ci correspond à l'URL de déploiement de l'application en
    ajoutant "/OAIHandler" :</para>

    <para>[<emphasis role="bold">url du
    serveur]/injac-oai/OAIHandler</emphasis></para>

    <para>Note : cette URI peut être modifiée dans le fichier WEB-INF/web.xml,
    dans le mapping de la servlet correspondant.</para>
  </section>

  <section>
    <title>Utilisation de l'IHM de test</title>

    <para>L'IHM est accessible à l'URL du serveur augmenté du contexte de
    l'application :</para>

    <para>[<emphasis role="bold">url du serveur]/injac-oai</emphasis></para>

    <para>Un menu dynamique apparait sur la gauche, qui liste tous les
    ensembles et tous les formats exposés par l'entrepôt OAI :<mediaobject>
        <imageobject>
          <imagedata align="left" fileref="media/menu.jpg"></imagedata>
        </imageobject>
      </mediaobject></para>

    <para>La première section emet les requêtes Identify, ListSets et
    ListMetadaFormats, qui n'ont besoin d'aucun argument.</para>

    <para>Exemple d'un ListSets :<mediaobject>
        <imageobject>
          <imagedata fileref="media/listsets.jpg"></imagedata>
        </imageobject>
      </mediaobject></para>

    <para>La deuxième section, "Enregistrements par ensembles" , emet des
    requêtes ListRecods ou ListIdentifiers, selon que l'on coche la case
    "Enregistrements" ou "Entêtes" :<mediaobject>
        <imageobject>
          <imagedata fileref="media/listidentifiers.jpg"></imagedata>
        </imageobject>
      </mediaobject></para>

    <para>On remarque le lien "Suivant" au bas de la page, qui indique que le
    dépôt a été configuré avec une taille maximale de liste assez petite(ici
    de 5, voir la documentation sur l'installation), et qu'il faut répéter la
    requête à l'aide d'un jeton de contrôle de flux(resumption token) qui
    permet d'avoir la suite de la liste jusqu'à épuisement complet des
    documents concernés. </para>

    <para>La troisième section produit un ListRecords dans l'un des formats
    disponibles.</para>

    <para>Enfin, la section "Requête OAI" permet de tester n'importe quelle
    requête, grâce à un formulaire dynamique qui s'adapte au paramètres requis
    par le verbe choisi :<mediaobject>
        <imageobject>
          <imagedata fileref="media/merge_forms.jpg"></imagedata>
        </imageobject>
      </mediaobject></para>
  </section>
</article>