SIGB Koha

De WIKI-BOKEH
Aller à : navigation, rechercher

Configuration de l'import[ ]

Préalable : créer la bibliothèque dans Bokeh et avoir sélectionné "Envoie des données" dans la liste déroulante des statuts, onglet "configuration" de la bibliothèque pour la voir apparaître dans la liste des annexes configurables dans cosmogramme. Envoie des données.png Annexe-cosmo.png

Notices[ ]

Suppression d'exemplaires[ ]

Si vous réutilisez les codes--barres d'exemplaires, il est indispensable de configurer cet import. Il est permet à Bokeh de ne pas conserver un code-barres dans une ancienne notice.

  • Créer un profil de données "liste de code-barres"
   Type de données : notices
   Format du fichier : CVS avec séparateur tabulation
   Encodage : UTF8
   Configuration des champs pour le fichier des notices : uniquement le code-barres
  • Affecter ce profil à l'intégration programmé des fichiers de suppression d'exemplaires

Configuration de la communication via web service[ ]

Dans Cosmogramme[ ]

Dans les intégrations programmées, sélectionnez:

  • SIGB: Koha
  • Mode de communication avec le SIGB: web-service Koha

Suggests cosmo config.png

Options du web-service Koha:

  • url_serveur : URL du web service fournie par Biblibre
  • restful : active l'utilisation du webservice Restful, notamment pour les Suggestion_d'achat ou l'Historique de prêts
  • pre-registration : active la préinscription en ligne Préinscription
  • Interdire_reservation_doc_dispo :
    • 0: les documents disponibles sont réservables
    • 1: les documents disponibles ne pourront pas être réservés
  • use_card_number : si renseigné, Bokeh utilisera ce numéro de carte pour faire les réservations à la place de la carte abonné. Cela concerne les bibliothèques départementales en permettant à un lecteur de réserver des documents au nom de sa bibliothèque. Cela a un impact aussi sur les demandes d'inscription
  • Codification_disponibilites : codification des libellés des disponibilités de Koha. Ex:
 1:Consultation sur place uniquement
 2:Document en cours de commande

Dans Bokeh[ ]

La variable KOHA_MULTI_SITE permet de modifier le comportement des réservations via le webservice.

  • Lorsque cette variable est activée, Bokeh procède à l'appel du service ILS-DI HoldItem qui aboutira à une réservation au niveau exemplaire.

ATTENTION, à partir de Koha 17.11, il faut que la réservation à l'exemplaire soit autorisée dans Koha pour les types de documents considérés (tableau des règles de circulation), sinon la réservation ne peut pas se faire.

Exemple :

 * KOHA_MULTI_SITE actif
 * Dans Koha : réservation autorisée sur l'exemplaire pour les périodiques, pas pour les livres
 * Réservation d'un exemplaire de périodique dans Bokeh : réservation de l'exemplaire dans Koha
 * Réservation d'un exemplaire de livre dans Bokeh : réservation impossible

IMPORTANT : si KOHA_MULTI_SITE est actif, peu importe la valeur de la variable KOHA_TRY_HOLD_ITEM


La variable KOHA_TRY_HOLD_ITEM permet de modifier le comportement des réservations via le webservice.

  • Lorsque cette variable est activée, Bokeh tente de faire une réservation à l'exemplaire puis à la notice en cas d'échec.

Exemple :

 * KOHA_MULTI_SITE désactivé
 * KOHA_TRY_HOLD_ITEM actif
 * Dans Koha : réservation autorisée sur l'exemplaire pour les périodiques, pas pour les livres
 * Réservation d'un exemplaire de périodique dans Bokeh : réservation de l'exemplaire dans Koha
 * Réservation d'un exemplaire de livre dans Bokeh : réservation sur le prochain disponible (donc la notice) dans Koha

Lorsque qu'aucune des variables n'est activée, Bokeh procède à l'appel du service ILS-DI HoldTitle qui aboutira à une réservation au niveau titre

Exemple :

 * KOHA_MULTI_SITE désactivé
 * KOHA_TRY_HOLD_ITEM désactivé
 * Dans Koha : réservation autorisée sur l'exemplaire pour les périodiques, pas pour les livres
 * Réservation d'un exemplaire de périodique dans Bokeh : réservation sur le prochain disponible (donc la notice) dans Koha
 * Réservation d'un exemplaire de livre dans Bokeh : réservation sur le prochain disponible (donc la notice) dans Koha


Lorsque les 2 variables sont activées c'est le comportement décrit dans KOHA_MULTI_SITE qui est appliqué (quelle que soit la valeur de KOHA_TRY_HOLD_ITEM)

Authentification via le web service[ ]

Un abonné qui vient d'etre créé via le SIGB Koha peut etre authentifié à la volée par son login / mot de passe.

La requete webservice permettant l'authentification est :

> http://monserveurkoha.biblibre.com/cgi-bin/koha/ilsdi.pl?service=AuthenticatePatron&username=test&password=test

Si l'abonné existe le serveur réponds avec l'id Koha correspondant:

             <?xml version="1.0" encoding="UTF-8" ?>                                                                                                                                                                                            
              <AuthenticatePatron>                                                                                                                                                                                                             
              <id>96138</id>                                                                                                                                                                                                                   
             </AuthenticatePatron>  

Changer le mot de passe dans Koha et Bokeh via le web service[ ]

Un abonné peut changer son mot de passe dans les deux logiciels via le formulaire de modification de son compte.

Pour que le mot de passe soit modifier dans Koha, il faut que l'option "restful" soit activée dans l'intégration programmée.

Bonnes Pratiques pour l'Authentification[ ]

Avant décembre 2018, Bokeh pouvait authentifier un lecteur sur la base d'un mot de passe généré n'étant pas celui sur SIGB. Pour des raisons de respect et de sécurité, Bokeh peut authentifier maintenant sur la base du SIGB seulement. Un symptôme peut être un ou plusieurs lecteurs qui ne peuvent plus s'identifier sur Bokeh. Il est également impossible de s'identifier sur l'opac de Koha directement.

Dans Bokeh :

  • Chaque lecteur devrait pouvoir être autonome pour retrouver son mot de passe si oublié :
    • activer la fonctionnalité de "mot de passe oublié" dans la boîte d'authentification
    • Spécifiques Koha: activation restful dans cosmogramme, besoin de la version 17.11 (à vérifier)
  • LOGIN_THROW_SIGB permet de ne plus stocker les mots de passe dans Bokeh, elle devrait être activée

Dans SIGB :

  • Il est possible que les lecteurs retrouvent leurs accès au catalogue en re-générant les mots de passe dans votre SIGB. Cette solution n'est pas idéale ni pérenne car on ne devrait pas forcer le mot de passe d'un utilisateur (et potentiellement écraser le mot de passe qu'ils auraient pû changer).

Points d'attention:

  • Les nouveaux lecteurs n'auront pas de mot de passe regénérés automatiquement, ce sera le mot de passe initialisé à la création qui sera pris en compte.

Export des listes de Koha vers Bokeh[ ]

Pour exporter les listes bibliographiques créées dans Koha vers des paniers Bokeh, se reporter aux documentations suivantes :