Import d'un étalon

De WIKI-BOKEH
Aller à : navigation, rechercher

Suite à l'installation de Bokeh, les intégrations programmées ainsi que les codifications essentielles (bibliothèques, annexes, genres, emplacements, sections) doivent être configurées.

Cosmogramme propose dans son menu Configurations > Démarrer un nouvel OPAC un écran permettant d'automatiser cette tâche pour les SIGB Nanook et Pergame.

De plus, dans le cas d'un Bokeh adossé à un seul Nanook l'exécution des intégrations programmées commencera par une synchronisation de l'étalon reçu du SIGB. Cette synchronisation permet la prise en compte automatique des créations/suppressions des codifications précédemment citées.

Démarrer un nouvel OPAC[ ]

New opac.png

Nom du dossier ftp[ ]

Cosmogramme propose ici la liste des sous-repertoires présents dans le répertoire de transfert configuré dans la variable ftp_path.
Pour que la mécanique fonctionne correctement, le SIGB doit y avoir déposé un répertoire etalon contenant les fichiers au format attendu.

SIGB[ ]

Les choix possibles sont pour l'instant Nanook et Pergame.

url du web-service[ ]

Adresse de communication temps réel vers le SIGB.

Créer les annexes comme les bibliothèques[ ]

Lorsque cette option est choisie, Bokeh créera une codification annexe pour chaque bibliothèque trouvée dans l'étalon.

Synchronisation de l'étalon[ ]

Lorsque Bokeh détecte qu'il est adossé à un seul Nanook et que le répertoire de transfert contient un étalon valide, il procédera à la synchronisation de cet étalon au début de chaque traitement d'intégration.

Chaque codification présente dans l'étalon peut donc se trouver ajoutée, modifiée ou supprimée.


Detection Nanook Unique[ ]

La détection que Bokeh est face à un seul Nanook est basée sur deux paramètres de configurations :

  • toutes les intégrations programmées ont pour SIGB Nanook sélectionné.
  • Toutes les urls serveur des connexions webservice sont identiques.

Paramètres à vérifier pour un Nanook Unique et la mise à jour de l'étalon automatique

Ajout[ ]

Lorsqu'une nouvelle codification apparait, elle est ajoutée dans Bokeh et les notices exportées l'utilisant sont donc liées automatiquement sans autre intervention.

Modification[ ]

La modification du libellé des codifications entraîne des conséquences différentes selon le type de codification.

Bibliothèque[ ]

Si vous avez souhaité générer les annexes pour chaque bibliothèque, Bokeh retrouvera l'annexe existante par son code et mettra à jour le libellé.
Les notices déjà présentes dans Bokeh restent liées au code, l'affichage dans Bokeh s'en trouve mis à jour sans autre intervention.

Genre, Emplacement et Section[ ]

Pour Bokeh, la clef de ces codifications étant leur libellé, il procédera à un ajout d'une codification pour le nouveau libellé puis à la suppression de la codification portant l'ancien libellé.
Les exemplaires des notices déjà présentes dans Bokeh se trouvent déliées de l'ancienne codification et leur notice marquée pour recalcul de leurs facettes issues des exemplaires.
Les notices concernées perdent donc la facette de la codification modifiée qui ne s'affiche plus en résultat de recherche.
Concernant particulièrement le genre, cette facette pouvant être tirée d'autres champs que ceux de l'exemplaire, Bokeh ne pourra la supprimer en se basant uniquement sur les informations d'exemplaire et donc une facette genre sans libellé peut apparaitre en résultat de recherche.

Si le SIGB envoie en export les notices concernées par des modifications de libellé de leurs codifications, l'impact est nul car les notices concernées sont retraitées dans la foulée. Cependant, ce n'est pas encore le cas de Nanook, il est donc nécessaire de procéder à un export total lors des modifications de libellé des genres, sections et emplacements

Suppression[ ]

Lorsqu'une codification disparait de l'étalon, elle est supprimée de Bokeh.
Les exemplaires des notices déjà présentes dans Bokeh se trouvent déliées de la codification et leur notice marquée pour recalcul de leurs facettes issues des exemplaires.
Cependant, lorsque la codification a été supprimée du SIGB, les exemplaires concernés ont du être modifiés, ce qui aboutira à leur export vers l'OPAC.
Les notices modifiées sont donc importées dans la foulées et mises à jour sans autre intervention.

Réinitialiser l'OPAC[ ]

Lorsque les données du SIGB ont massivement changés, par exemple suite à migration de données, fusion dans un réseau, etc... vous pouvez souhaiter repartir d'un export total du SIGB après suppression des données précédemment importées dans Bokeh.

Dans cosmogramme, menu Configuration > Réinitialiser l'OPAC, un écran présente les informations qui peuvent être remises à zéro.

Cosmo integration reset.png

Cette mécanique supprime des codifications qui peuvent être utilisées dans des configurations de Boîtes ou des définitions de domaines qui peuvent donc cesser de fonctionner correctement.

Suite à une réinitialisation et un import total, il est donc probable que vous deviez reprendre les paramétrages se basant sur des codifications supprimées.

Format de l'étalon[ ]

L'étalon doit être constitué de 4 fichiers texte au format iso 8859, une codification par ligne, séparateur de champ "|", le tout sous un répertoire nommé "etalon".

annexes.txt[ ]

La première ligne est un en-tête.

BIB_SPS_UTT|ID_SITE|LIBELLE

Elle est suivie d'une ligne par bibliothèque, contenant l'identifiant puis le libellé.

1|Médiathèque A
2|Bibliotèque B

emplacements.txt[ ]

La première ligne est une en-tête.

BIB_C_EMPLACEMENT|CODE|LIBELLE

Elle est suivie d'une ligne par emplacement, contenant l'identifiant puis le libellé.

1|Etage
2|Rez-de-Chaussée

genres.txt[ ]

La première ligne est une en-tête.

BIB_GENRES|SUPPORT|CODE|LIBELLE|DOC

Elle est suivie d'une ligne par genre, contenant le support, l'identifiant, le libellé puis le type de document.
Bokeh n'utilise que l'identifiant et le libellé.

0|1|Roman|f
0|2|Policier|f

sections.txt[ ]

La première ligne est une en-tête.

BIB_C_SECTION|CODE|LIBELLE

Elle est suivie d'une ligne par section, contenant l'identifiant puis le libellé.

11|Réserve
149|Salle
181|Couloir

tarifs.txt[ ]

La première ligne est une en-tête.

ID|LIBELLE|ACTIF

Elle est suivie d'une ligne par type d'abonnement, contenant l'identifiant puis le libellé puis le statut de l'abonnement (actif ou archivé).

1|Gratuit|1
2|Payant commune|1
3|Payant extérieur commune|1
4|Gratuit hors commune|0

Les abonnements archivés sont récupérés et peuvent être affichés sur des fiches abonnés.