(ajout info annexes)
m
 
(12 révisions intermédiaires par 6 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 
== Configuration de l'import ==
 
== Configuration de l'import ==
Préalable : [[Gérer une fiche bibliothèque|créer la bibliothèque dans Bokeh]] et avoir sélectionner "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.
+
Préalable : [[Gérer une fiche bibliothèque|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.
 
[[Fichier: Envoie des données.png]]
 
[[Fichier: Envoie des données.png]]
[[Annexe-cosmo.png]]
+
[[Fichier: Annexe-cosmo.png]]
  
 
=== Notices ===
 
=== Notices ===
Ligne 29 : Ligne 29 :
  
 
Options du web-service Koha:
 
Options du web-service Koha:
* url_serveur: URL du web service fournie par Biblibre
+
* '''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]]
+
* '''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]]
+
* '''pre-registration''' : active la préinscription en ligne [[Préinscription]]
* Interdire_reservation_doc_dispo:  
+
* '''Interdire_reservation_doc_dispo''' :  
 
** ''0'': les documents disponibles sont réservables
 
** ''0'': les documents disponibles sont réservables
 
** ''1'': les documents disponibles ne pourront pas être réservés
 
** ''1'': les documents disponibles ne pourront pas être réservés
* Codification_disponibilites: codification des libellés des disponibilités de Koha. Ex:
+
* '''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]]
 +
* '''Codification_disponibilites''' : codification des libellés des disponibilités de Koha. Ex:
  
 
   1:Consultation sur place uniquement
 
   1:Consultation sur place uniquement
Ligne 43 : Ligne 44 :
  
 
La variable KOHA_MULTI_SITE permet de modifier le comportement des réservations via le webservice.<br/>
 
La variable KOHA_MULTI_SITE permet de modifier le comportement des réservations via le webservice.<br/>
* Lorsque cette variable est '''désactivée''', Bokeh procède à l'appel du service ILS-DI HoldTitle qui aboutira à une '''réservation au niveau titre'''<br>
 
 
* Lorsque cette variable est '''activée''', Bokeh procède à l'appel du service ILS-DI HoldItem qui aboutira à une '''réservation au niveau exemplaire'''.
 
* 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.<br/>
 +
* 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'''<br>
 +
 +
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 ==
 
== Authentification via le web service ==
Ligne 62 : Ligne 95 :
 
</pre>
 
</pre>
  
 +
== 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 ==
 
== Export des listes de Koha vers Bokeh ==

Version actuelle en date du 18 février 2019 à 17:38

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 :

Configuration de l'import[modifier | modifier le wikicode]

Préalable : créer la bibliothèque dans Bokeh et avoir sélectionner "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[modifier | modifier le wikicode]

Suppression d'exemplaires[modifier | modifier le wikicode]

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[modifier | modifier le wikicode]

Dans Cosmogramme[modifier | modifier le wikicode]

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[modifier | modifier le wikicode]

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

Authentification via le web service[modifier | modifier le wikicode]

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>  


Export des listes de Koha vers Bokeh[modifier | modifier le wikicode]

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