De nouveaux API pour Bokeh

C’est bientôt l’hiver il faut se (re)couvrir.

Bokeh se dote d’un nouveau connecteur pour Koha.

En pratique, rien ne change, sinon le mode de communication entre ces deux logiciels à qui l’on promet un bel avenir.

D’abord, un peu d’histoire

Lors des début de la collaboration entre BibLibre et AFI, les webservices de Koha étaient assez pauvres.

Un effort communautaire avait été fait pour enrichir Koha d’une compatibilité avec le standard ILS-DI.

La liste des recommandations laisse une grande marge de manœuvre aux éditeurs pour l’implémentation.

Voir ici la liste des recommandations : https://old.diglib.org/architectures/ilsdi/DLF_ILS_Discovery_1.0.pdf

Les recommandations ILS-DI répond à des cas d’usage de base : connexion utilisateur, réservation, disponibilité en temps réel, récupération d’information bibliographiques.

Cependant, le nombre de bibliothèques utilisant Koha avec Bokeh grandissant, les besoins se sont fait sentir de développer les interactions possible des lecteurs au travers du portail : historique des prêts, suggestions d’achat, préinscription en ligne, etc…

Face à ce constat, BibLibre a développé une API répondant aux besoins exprimés, et AFI, en étroite collaboration avec BibLibre intègre ce nouveau moyen de communication à Bokeh.

Malgré les efforts de l’entreprise pour promouvoir ce développement au sein de la communauté Koha, celui-ci n’a jamais été intégré, probablement par manque d’usage et d’intérêt des autres prestataires.

Quelques années plus tard, des web-services sécurisé, documentés et maintenu à l’échelle communautaires étaient proposés dans Koha.

La situation actuelle

A ce jour cohabitent donc pour nos clients plusieurs WebServices:

• ILS-DI : le standard, l’historique (https://demo.biblibre.com/cgi-bin/koha/ilsdi.pl)
• Koha-rest version BibLibre : le « spécifique BibLibre », maintenu par BibLibre (sans l’aide d’autres prestataires), peu documenté, non-authentifié. (https://git.biblibre.com/biblibre/koha-restful)
• Koha-Rest : maintenu par la communauté, authentifié, documenté. (https://api.koha-community.org/)

Bokeh à ce jour utilise la version BibLibresque de ces web-services. Cependant, chaque nouvelle version de Koha apportant son lot de changement, il devient progressivement difficile voir impossible de maintenir cette version en condition opérationnelle.

C’est pourquoi nous avons œuvré à ce que Bokeh soient compatible avec les web-services supportés par l’ensemble des prestataires.

Aujourd’hui, cette version n’est pas disponible en production.

La médiathèque de Caluire-et-Cuire a gentiment fait preuve de courage pour tester le bon fonctionnement en conditions réelles d’utilisation.

Afin que ce développement soit intégré au plus vite dans Bokeh, nous avons besoin de vous pour tester et valider!

Que vont apporter ces nouveaux web-services?

Ils sont aujourd’hui utilisé en plus de ILS-DI et en lieu et place des web-services initialement développés par BibLibre et non-intégrés à la version standard de Koha.

Les utiliser permet de garantir que Bokeh restera compatible avec Koha. Par ailleurs, ces web-services ayant vocation à permettre d’utiliser toutes les fonctionnalités disponibles de Koha tel que connecté en administrateur, cela permet d’imaginer beaucoups plus de cas d’usages sans nécessiter de nouveaux développements dans Koha.

Ces nouveaux web-services sont également plus sécurisés avec l’utilisation d’un utilisateur et mot de passe pour réaliser toutes opérations.

Ils prennent également en compte les permissions de telle sorte qu’un utilisateur lambda ne saurait accéder à des fonctionnalités d’administrateur.

C’est donc un gage de simplicité, de sécurité et d’évolutivité de nos outils pour l’avenir.

Comment nous aider?

Simplement en étant volontaire pour tester et en nous le faisant savoir via un ticket.

le développement concernant Bokeh, il est préférable de saisir la demande soit :

• directement dans Bokeh dans le menu « Assistance » de l’interface d’administration (voir : https://wiki.bokeh-library-portal.org/index.php?title=Intégration_des_demandes_d’assistance)
• via l’outil de suivi des demandes de AFI (https://forge.afi-sa.net/).

Merci d’avance pour votre aide!