m (documentation variable loans_per_page)
m (Dans Cosmogramme)
 
Line 36: Line 36:
 
** ''1'': les documents disponibles ne pourront pas être réservés
 
** ''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 [[Gérer_les_demandes_d'inscription#Notes_sur_les_biblioth.C3.A8ques_d.C3.A9partementales | demandes d'inscription]]
 
* '''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 [[Gérer_les_demandes_d'inscription#Notes_sur_les_biblioth.C3.A8ques_d.C3.A9partementales | demandes d'inscription]]
* '''loans_per_page''' : Si différent de zéro, Bokeh ne chargera d’abord que les N premiers prêts et si l’adhérent a plus de prêts alors un bouton « Charger tous les prêts » sera affiché dans la page de consultation des prêts de l’abonné. Un clic sur ce bouton recharge alors la page et récupère l’ensemble des prêts de l’abonné auprès du SIGB.
+
* '''loans_per_page''' : Si différent de zéro, Bokeh ne récupéreras les prêts de l'abonnés que lors de la consultation de la page "Voir mes prêts".
 +
La liste est récupérée en plusieurs fois afin de ne pas surcharger le serveur Koha lorsque la liste des prêts dépasse le millier de prêts (dans le cas des BDP par exemple). Cette fonctionnalité n'est disponible qu'à partir de la version 18.11.09 de Koha
 
* '''Codification_disponibilites''' : codification des libellés des disponibilités de Koha. Ex:
 
* '''Codification_disponibilites''' : codification des libellés des disponibilités de Koha. Ex:
  

Latest revision as of 11:02, 10 September 2019

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
  • loans_per_page : Si différent de zéro, Bokeh ne récupéreras les prêts de l'abonnés que lors de la consultation de la page "Voir mes prêts".

La liste est récupérée en plusieurs fois afin de ne pas surcharger le serveur Koha lorsque la liste des prêts dépasse le millier de prêts (dans le cas des BDP par exemple). Cette fonctionnalité n'est disponible qu'à partir de la version 18.11.09 de Koha

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

Bokeh permet d'afficher dans la vue Notice le nombre de réservations en cours sur un document. Les données sont remontées à Bokeh par Koha au moyen du WebService ILS-DI lors de l'appel à GetRecords.

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 :

Configuration de l'import[edit | edit source]

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[edit | edit source]

Suppression d'exemplaires[edit | edit source]

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.

   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

Configuration de la communication via web service[edit | edit source]

Dans Cosmogramme[edit | edit source]

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

Suggests cosmo config.png

Options du web-service Koha:

 1:Consultation sur place uniquement
 2:Document en cours de commande

Dans Bokeh[edit | edit source]

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

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.

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)

Bokeh permet d'afficher dans la vue Notice le nombre de réservations en cours sur un document. Les données sont remontées à Bokeh par Koha au moyen du WebService ILS-DI lors de l'appel à GetRecords.

Authentification via le web service[edit | edit source]

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[edit | edit source]

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[edit | edit source]

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 :

Dans SIGB :

Points d'attention:

Export des listes de Koha vers Bokeh[edit | edit source]

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