Nous allons voir dans cette section comment utiliser de manière générale les connecteurs.
Avant toute chose, les sets peuvent être classés dans des catégories définies au préalable dans le menu Administration
> Connecteurs
> Catégories de sets
.
Les sets peuvent être alimentés par :
des paniers de notices
des paniers d'exemplaires
des recherches multi-critères
Dans le menu Administration
> Connecteurs
> Sets pour les connecteurs sortants
, cliquez sur Ajouter un set
. Saisissez le nom du nouveau set et choisissez son type (c'est à dire a partir de quoi il sera rempli).
Cliquez sur le bouton Enregistrer
. Une fois le set créé, cliquez sur la ligne du nouveau set pour choisir le panier ou la recherche multi-critère en fonction du type que vous avez sélectionné. Le formulaire comporte des nouveaux champs selon le type choisi.
Sélectionnez les paniers qui seront utilisés pour remplir le set.
Cliquez sur Modifier cette recherche
pour créer une nouvelle recherche multi-critère qui remplira le set. Composez votre recherche, éxécutez la en cliquant sur Rechercher
. Si le résultat vous convient, cliquez sur Associer à un set pour connecteur externe
pour l'associer au set et enfin sur Enregistrer
.
Au lieu de composer une nouvelle recherche, vous pouvez utiliser une équation utilisée dans la DSI. Il suffit dans ce cas de cocher le bouton radio correspondant à l'équation.
Afin d'éviter un recalcul trop fréquent du contenu des sets et de charger la machine hébergeant PMB, il est fortement conseillé d'activer le cache des sets. Ainsi, le contenu du set sera mis à jour à une périodicité donnée et non à chaque utilisation par les sources du set.
Pour activer le cache, donnez simplement la périodicité à la fin du formulaire dans la case Durée de vie du cache
. La liste déroulante à côté de la case permet de choisir l'unité.
Enregistrez les modifications en cliquant sur Enregistrer
.
Initialisez le set
Sur la ligne du nouveau set, cliquez sur Mettre à jour manuellement
. Le set est rempli avec les notices issues de(s) panier(s) ou de la recherche multi-critère associée au set. Dans la colonne information vous devez voir apparaitre le nombre de notices.
Une fois le set initialisé, il sera automatiquement mis à jour en fonction de la durée de vie du cache que vous aurez donné. Si vous n'avez pas mis de durée de vie (0), il sera actualisé à chaque utilisation.
Les connecteurs possèdent des paramètres généraux qui conditionnent le fonctionnement du protocole. Ces paramètres ne concernent que le protocole lui même et non les sources. Ils seront donc utilisés pour toutes les sources du même connecteur. On peut accéder aux paramètres généraux d'un connecteur en cliquant directement dans la colonne Service de la ligne correspondante au connecteur.
Les connecteurs OAI et JSON-RPC n'ont pas de paramètres généraux, dans ce cas un formulaire vide est proposé. Il n'y a rien a faire de particulier.
Pour ajouter une source, cliquez simplement sur le bouton Ajouter une source
. Un formulaire dépendant du connecteur vous est proposé.
Deux champs sont communs à toutes les sources :
Nom de la source : c'est le nom qui apparaitra dans toutes les listes des sources.
Commentaire : une explication brève de ce que propose la source.
Renseignez les autres informations nécessaires à la source en fonction du connecteur et cliquez sur Enregistrer
(vous pouvez essayer avec le connecteur OAI, vous le supprimerez ensuite !).
Il arrive que vous deviez revenir dans le formulaire pour compléter des informations qui ne peuvent êtres proposées qu'après la création de la source. La démarche pour ré-éditer la source est expliquée ci-dessous.
Pour éditer une source, dépliez la liste des sources en cliquant sur l'icône +
puis cliquez sur la source que vous voulez éditer.