Différences entre versions de « SIGB Koha »

De WIKI-BOKEH
Aller à : navigation, rechercher
(ajout info annexes)
m
 
(34 versions intermédiaires par 8 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 8 : Ligne 8 :
 
==== Suppression d'exemplaires ====
 
==== Suppression d'exemplaires ====
  
Si vous réutilisez les codes--barres d'exemplaires, il est indispensable de configurer cet import.
+
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.
 
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"
 
* Créer un profil de données "liste de code-barres"
    Type de données : notices
+
Type de données : notices
 
     Format du fichier : CVS avec séparateur tabulation
 
     Format du fichier : CVS avec séparateur tabulation
 
     Encodage : UTF8
 
     Encodage : UTF8
 
     Configuration des champs pour le fichier des notices : uniquement le code-barres
 
     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
 
* Affecter ce profil à l'intégration programmé des fichiers de suppression d'exemplaires
 +
 +
 +
==== Périodiques ====
 +
 +
Voir la page dédiée [[Import des périodiques Koha dans Bokeh]]
  
 
== Configuration de la communication via web service ==
 
== Configuration de la communication via web service ==
Ligne 23 : Ligne 28 :
  
 
Dans les intégrations programmées, sélectionnez:
 
Dans les intégrations programmées, sélectionnez:
* SIGB: '''Koha'''  
+
* SIGB: '''Koha < 21.11'''  
* Mode de communication avec le SIGB: '''web-service Koha'''
+
* Mode de communication avec le SIGB: '''Koha &lt; 21.11<br>'''
  
 
[[Fichier: Suggests cosmo config.png|500px]]
 
[[Fichier: Suggests cosmo config.png|500px]]
  
Options du web-service Koha:
+
Options du web-service KohaLegacy:
* 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]]
 +
* '''loans_per_page''' : Si différent de zéro, Bokeh ne récupérera les prêts de l'abonné que lors de la consultation de la page "Voir mes prêts".
 +
 
 +
La liste est récupérée en plusieurs fois chaque appel permettant de récupérer le nombre de prêts définis dans la variable.
 +
Le but est 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
 +
Les valeurs présentes doivent correspondre aux valeurs existantes dans Koha pour le champ exemplaire "notforloan".<br>
 +
 
 +
"0" correspond au statut empruntable et réservable, une valeur négative à un statut non-empruntable mais réservable, et une valeur positive à un statut ni empruntable, ni réservable.
 +
*'''withdrawn_mapping''' : codification des libellés de disponibilités en prenant en compte le champ exemplaire "withdrawn" de Koha plutôt que le champ "notforloan".
 +
*'''disable_items_availability_threshold''' : le seuil du nombre d'exemplaires pour une seule notice déclenchant l'arrêt de l'usage du webservice pour l'enrichissement des données d'exemplaires (disponibilité, date_retour, nombre de prêts en cours). La valeur par défaut est 200.
 +
 
 +
<span style="background-color: rgb(241, 196, 15);">Attention!</span>
  
  1:Consultation sur place uniquement
+
<span style="background-color: rgb(255, 255, 255);">à partir de la version 21.11 de Koha il est possible d'utiliser le connecteur '''Koha''' au lieu de '''Koha &lt; 21.11''', </span><span style="background-color: rgb(255, 255, 255);">restful est alors remplacé par l'utilisation de l'API communautaire.</span>
  2:Document en cours de commande
 
  
 +
<span style="background-color: rgb(255, 255, 255);">Il faut alors créer un utilisateur dans Koha avec des droits de bibliothécaire. Cet utilisateur sera utilisé par le portail pour réaliser des opérations nécessitant des droits d'administration.</span>
 +
 +
<span style="background-color: rgb(255, 255, 255);">la variable '''restful''' dans l'intégration programmée est remplacée par les variables suivantes :</span><span style="background-color: rgb(255, 255, 255);"></span>
 +
*<span style="background-color: rgb(255, 255, 255);">'''api_user''' : login de l'utilisateur<br></span>
 +
*<span style="background-color: rgb(255, 255, 255);">'''api_pass''' : mot de passe de l'utilisateur</span>
 +
*'''<span style="background-color: rgb(255, 255, 255);">preregistration_category</span>'''<span style="background-color: rgb(255, 255, 255);"> : code de catégorie d'utilisateurs pour les pré-inscriptions.</span><span style="background-color: rgb(255, 255, 255);"></span>
 
=== Dans Bokeh ===
 
=== Dans Bokeh ===
  
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)
 +
 +
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.
 +
 +
== Ajouter une bibliothèque ==
 +
Se connecter dans l'interface d'administration de Bokeh en administrateur et dans le menu de gauche, cliquer sur le menu "Bibliothèques".
 +
 +
Cliquer sur le bouton "Ajouter une bibliothèque".
 +
 +
Indiquer le nom de la bibliothèque (champ obligatoire) et dans l'onglet "Configuration", paramétrer le status de la bibliothèque en "Envois des données".
 +
 +
Ensuite, se rendre dans Cosmogramme et dans le menu de gauche, dans le sous-menu "Configuration", cliquer sur "Annexe".
 +
 +
Dans la page qui s'ouvre, en haut de la liste des annexes, cliquer sur "Ajouter une annexe".
 +
 +
Selectionner la nouvelle bibliothèque créée et compléter les informations en renseignant le code d'annexe telle que défini dans Koha et un libellé.
 +
 +
Les exemplaires liés à cette bibliothèque seront dorénavant reconnus lors de l'import et la nouvelle bibliothèque est disponible comme un site de retrait.
 
== Authentification via le web service ==
 
== 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.
 
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 :  
 
La requete webservice permettant l'authentification est :  
  
> http://monserveurkoha.biblibre.com/cgi-bin/koha/ilsdi.pl?service=AuthenticatePatron&username=test&password=test
+
&gt; 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:
 
Si l'abonné existe le serveur réponds avec l'id Koha correspondant:
Ligne 60 : Ligne 135 :
 
               <id>96138</id>                                                                                                                                                                                                                   
 
               <id>96138</id>                                                                                                                                                                                                                   
 
             </AuthenticatePatron>   
 
             </AuthenticatePatron>   
</pre>
+
</pre>  
 +
 
 +
== Changer ses informations personnelles 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.
 +
 
 +
Les autres informations peuvent également être changées, en fonction de la valeur des variables d'administrations suivantes :
 +
 +
* CHAMPS_FICHE_UTILISATEUR pour limiter les champs modifiables par les lecteurs
 +
* INTERDIRE_MODIF_FICHE_ABONNE pour interdire la modification de la fiche abonné par les usagers.
 +
 
 +
Voir l'article détaillé, dans la section paramètres : [[Fiche_utilisateur]]
 +
 
 +
== 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 ==
Ligne 70 : Ligne 173 :
 
* Importer les listes dans bokeh : [[Intégration_de_fichiers_paniers]]
 
* Importer les listes dans bokeh : [[Intégration_de_fichiers_paniers]]
  
[[Catégorie:Intégrations_programmées]]
+
 
 +
 
 +
 
 +
 
 +
== Spécificités pour Koha ==
 +
 
 +
=== Lien direct vers une notice avec le biblionumber ===
 +
 
 +
Dans Bokeh il est possible d'appeler directement une notice par une url basée sur le biblionumber Koha. L'url est de la forme :
 +
url_de_bokeh/recherche/viewnotice/id_sigb/[id de la notice]/id_site/*
 +
 
 +
Exemple : https://urlbokeh.fr/recherche/viewnotice/id_sigb/249229/id_site/*
 +
 
 +
Ceci donne accès à la notice quels que soient les sites des exemplaires.
 +
 
 +
 
 +
=== Création des groupes Koha dans Bokeh en fonction dy type d'abonné ===
 +
 
 +
A l'authentification, le groupe Koha de l'abonné est récupéré dans Bokeh sous la forme d'un groupe manuel d'utilisateurs. Ces groupes sont créés et mis à jour automatiquement dans la catégorie de groupes d'utilisateurs nommée '''Koha'''.
 +
 
 +
Attention : Koha n'exportant à ce jour pas les libellés des groupes, le groupe d'utilisateurs côté Bokeh est nommé par le code ( '''L''', '''ADM''', '''PRO''', ....). Ces groupes ne doivent pas être renommés ni déplacés sous peine de la création de doublons de groupes.
 +
 
 +
L'activation de ce mode a lieu dans cosmogramme &gt; Intégrations programmées &gt; create_category_usergroup
 +
 
 +
[[Catégorie:Intégrations programmées]]
 
[[Catégorie:Koha]]
 
[[Catégorie:Koha]]

Version actuelle datée du 9 novembre 2023 à 11:37

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


Périodiques[ ]

Voir la page dédiée Import des périodiques Koha dans Bokeh

Configuration de la communication via web service[ ]

Dans Cosmogramme[ ]

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

  • SIGB: Koha < 21.11
  • Mode de communication avec le SIGB: Koha < 21.11

Suggests cosmo config.png

Options du web-service KohaLegacy:

  • 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érera les prêts de l'abonné que lors de la consultation de la page "Voir mes prêts".

La liste est récupérée en plusieurs fois chaque appel permettant de récupérer le nombre de prêts définis dans la variable. Le but est 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

Les valeurs présentes doivent correspondre aux valeurs existantes dans Koha pour le champ exemplaire "notforloan".

"0" correspond au statut empruntable et réservable, une valeur négative à un statut non-empruntable mais réservable, et une valeur positive à un statut ni empruntable, ni réservable.

  • withdrawn_mapping : codification des libellés de disponibilités en prenant en compte le champ exemplaire "withdrawn" de Koha plutôt que le champ "notforloan".
  • disable_items_availability_threshold : le seuil du nombre d'exemplaires pour une seule notice déclenchant l'arrêt de l'usage du webservice pour l'enrichissement des données d'exemplaires (disponibilité, date_retour, nombre de prêts en cours). La valeur par défaut est 200.

Attention!

à partir de la version 21.11 de Koha il est possible d'utiliser le connecteur Koha au lieu de Koha < 21.11, restful est alors remplacé par l'utilisation de l'API communautaire.

Il faut alors créer un utilisateur dans Koha avec des droits de bibliothécaire. Cet utilisateur sera utilisé par le portail pour réaliser des opérations nécessitant des droits d'administration.

la variable restful dans l'intégration programmée est remplacée par les variables suivantes :

  • api_user : login de l'utilisateur
  • api_pass : mot de passe de l'utilisateur
  • preregistration_category : code de catégorie d'utilisateurs pour les pré-inscriptions.

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.

Ajouter une bibliothèque[ ]

Se connecter dans l'interface d'administration de Bokeh en administrateur et dans le menu de gauche, cliquer sur le menu "Bibliothèques".

Cliquer sur le bouton "Ajouter une bibliothèque".

Indiquer le nom de la bibliothèque (champ obligatoire) et dans l'onglet "Configuration", paramétrer le status de la bibliothèque en "Envois des données".

Ensuite, se rendre dans Cosmogramme et dans le menu de gauche, dans le sous-menu "Configuration", cliquer sur "Annexe".

Dans la page qui s'ouvre, en haut de la liste des annexes, cliquer sur "Ajouter une annexe".

Selectionner la nouvelle bibliothèque créée et compléter les informations en renseignant le code d'annexe telle que défini dans Koha et un libellé.

Les exemplaires liés à cette bibliothèque seront dorénavant reconnus lors de l'import et la nouvelle bibliothèque est disponible comme un site de retrait.

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 ses informations personnelles 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.

Les autres informations peuvent également être changées, en fonction de la valeur des variables d'administrations suivantes :

  • CHAMPS_FICHE_UTILISATEUR pour limiter les champs modifiables par les lecteurs
  • INTERDIRE_MODIF_FICHE_ABONNE pour interdire la modification de la fiche abonné par les usagers.

Voir l'article détaillé, dans la section paramètres : Fiche_utilisateur

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 :



Spécificités pour Koha[ ]

Lien direct vers une notice avec le biblionumber[ ]

Dans Bokeh il est possible d'appeler directement une notice par une url basée sur le biblionumber Koha. L'url est de la forme : url_de_bokeh/recherche/viewnotice/id_sigb/[id de la notice]/id_site/*

Exemple : https://urlbokeh.fr/recherche/viewnotice/id_sigb/249229/id_site/*

Ceci donne accès à la notice quels que soient les sites des exemplaires.


Création des groupes Koha dans Bokeh en fonction dy type d'abonné[ ]

A l'authentification, le groupe Koha de l'abonné est récupéré dans Bokeh sous la forme d'un groupe manuel d'utilisateurs. Ces groupes sont créés et mis à jour automatiquement dans la catégorie de groupes d'utilisateurs nommée Koha.

Attention : Koha n'exportant à ce jour pas les libellés des groupes, le groupe d'utilisateurs côté Bokeh est nommé par le code ( L, ADM, PRO, ....). Ces groupes ne doivent pas être renommés ni déplacés sous peine de la création de doublons de groupes.

L'activation de ce mode a lieu dans cosmogramme > Intégrations programmées > create_category_usergroup