(ajout info annexes)
(Dans Bokeh)
 
(6 révisions intermédiaires par 3 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 43 : Ligne 43 :
  
 
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 61 : Ligne 93 :
 
             </AuthenticatePatron>   
 
             </AuthenticatePatron>   
 
</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.
  
  

Version actuelle en date du 22 octobre 2018 à 10:59

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


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 :