Paramétrage et utilisation des Webservices dans PMBConfigurer un serveur OAI dans PMB > Créer une source OAI > Informations propres au serveur OAI
page précédentepage suivante

Informations propres au serveur OAI

Informations administratives de base

Nom de l'entrepot

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 de l'administrateur

Adresse email à contacter en cas de problème d'accès au serveur.

Identifiant de l'entrepot

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.

Informations liées au protocole

URL de base de l'entrepôt

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.

Sets inclus dans la source

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.

Nombre de résultats par requête

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.

Formats de conversion supplémentaires autorisés

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).

Durée de vie des token

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.

Informations pour l'optimisation des performances du serveur

Autoriser la compression gzip des requêtes

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.

Mettre en cache les enregistrements complets

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.

Durée de vie des enregistrements dans le cache (secondes)

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.

Lier un statut de notice à l'information de supression OAI

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).

Résultat du test d'une source OAI
Résultat du test d'une source OAIzoom
page précédentepage suivante
A propos...PMB ServicesRéalisé avec Scenari