C'est le nom public qui sera publié lors de l'identification sur serveur par la requête Identify
. Ce nom est un libellé libre.
Mémoires et thèses
Adresse email à contacter en cas de problème d'accès au serveur.
C'est un identifiant unique qui sert au client à repérer de manière certaine l'entrepot OAI représenté par la source. Cet identifiant est aussi utilisé comme préfixe pour construire les identifiants des méta-données.
Cet identifiant ne doit contenir aucun caractère spécial, espace, lettres accentuées. Uniquement des lettres simples et des chiffres. Cet identifiant ne doit pas être utilisé dans une autre source OAI.
C'est l'URL qu'il faudra fournir aux clients pour qu'ils puissent se connecter au serveur OAI. Lors de la création, elle n'est pas modifiable, nous verrons son importance plus tard.
Les sets de PMB inclus dans la source seront exportés dans l'entrepot OAI comme les sets OAI accessibles par la requête ListSets
. Si il n'y a pas de sets définis, l'entrepot OAI proposé par le serveur sera vide.
Vous pouvez sélectionner plusieurs sets avec un Control-Clic
. Chaque set sera visible dans l'entrepot. Il n'y a pas de regroupement de sets possible.
C'est le nombre d'enregistrements (l'équivalent des notices dans PMB) qui seront exportés par page lorsqu'un client moissonne l'entrepôt. Le nombre proposé par défaut est 100. Cette valeur est obligatoire.
Cette valeur est importante car elle peut faire varier fortement la qualité de service du serveur. Une valeur trop faible force les clients à appeler trop souvent le serveur et ralentit d'autant la récupération des enregistrements car le temps de connexion au serveur n'est plus négligeable. De plus un nombre trop petit charge le serveur web qui doit répondre à beaucoup de requêtes HTTP.
A l'inverse, un nombre trop élevé fait que le volume de données renvoyé au client est important, ce qui implique des réponses très longues à charger et parfois le client se déconnecte avant la fin (trop de données ou réponse trop longue).
La valeur par défaut est un bon compromis.
Sélectionnez les formats que vous souhaitez proposer pour les méta-données. PMB liste tous les formats d'export dont il dispose. Ce n'est pas la peine de sélectionner UNIMARC PMB XML
ni Dublin Core (dc)
qui sont proposés par défaut (le Dublin Core est obligatoire pour les serveurs OAI).
Lorsque le client du serveur OAI demande un ensemble d'enregistrements, l'envoi se fait par page en fonction du paramètre Nombre de résultats par requête
. A la fin de chaque page, le serveur renvoie un code qui permet d'appeler la page suivante. Ce code est appelé resumption token
dans le protocole OAI. Les token ont une durée de vie limitée afin de ne pas stoquer indéfiniment sur le serveur des données périmées.
Ce champ donne la durée de validité d'un token, c'est à dire le temps dont dispose le client pour rappeler la page suivante.
Le protocole OAI offre la possibilité de proposer au client une compression des réponses aux requêtes. La compression des XML est très efficace (car il y a de nombreux éléments redondants). La case à cocher permet d'activer cette option.
Afin de ne pas re-générer à chaque demande les enregistrements, PMB peut mettre ceux-ci en cache. Cette option allège fortement la charge du serveur en évitant une conversion à chaque notice transformée en méta-données.
Il est vivement conseillé d'activer cette option.
Donne la durée en secondes, avant que les enregistrements ne soient recalculées dans le cache (si l'option Mettre en cache les enregistrements complets
est activée). Cette durée est par défaut à 24h (86400 secondes). Elle doit dépendre essentiellement de la fréquence de mise à jour de vos notices dans le catalogue.
Si vous mettez une durée trop courte (inférieure à quelques minutes), vous allez charger encore plus le serveur, car en plus du recalcul des enregistrements, il faut gérer la mise à jour du cache, ce qui prend aussi des ressources du serveur. Plus le temps de mise en cache est important, plus la charge liée à la mise à jour du cache est négligeable face au temps gagné pour le re-export des notices en méta-données, plus l'optimisation est efficace.
Par défaut, le serveur OAI de PMB ne prévient pas de la suppression des enregistrements. Cette option permet d'implémenter le mode transient
du protocole OAI pour la supression des enregistrements. Indiquer dans la liste en dessous le statut de notice qui sera utilisé pour signaler au client qu'un enregistrement est supprimé.
Une fois toutes les informations renseignées, enregistrez le formulaire en cliquant sur Enregistrer
. La source OAI est créée.
Pour tester que le serveur OAI fonctionne, cliquez sur la ligne correspondante à la source que vous venez de créer (dépliez éventuellement les sources du connecteur pour la voir), copiez l'adresse dans le champ URL de base de l'entrepot
et collez-la dans votre navigateur en y ajoutant à la fin &verb=Identify
.
Par exemple :
http://localhost/pmb/ws/connector_out.php?source_id=1&verb=Identify
Si le serveur fonctionne, vous devez obtenir une page similaire à la copie d'écran ci-dessous. Ne cliquez pas sur les liens Identify
, ListRecords
, ListSets
, ListMetadataFormats
et ListIdentifier
, cela ne fonctionnera pas, il faut encore configurer une ré-écriture d'URL (voir la section suivante).