Coder Social home page Coder Social logo

koha-illbackend-libris's Introduction

koha-illbackend-libris

Koha ILL Backend for Libris ILL (used in Sweden).

DOCUMENTATION

The official documentation of the Libris ILL API is available here: https://iller.libris.kb.se/librisfjarrlan/api/doc

See the "docs" directory for more documentation on this ILL backend.

PROBLEM WITH SENDING MESSAGES IN KOHA 23.05.00,22.11.06,22.05.13 AND NEWER

Recent versions of Koha have changed how messages are enqued, which means it is no longer possible to use the Libris backend to send out messages when receiving ILLs. In practice, this means that if you choose to send either email or SMS when an item is received, you will get a "500 Internal Server Error", and no messages are queued.

This problem is present in the following versions of Koha, and in newer minor versions of the affected major versions (so e.g. 22.11.06, 22.11.07, 22.11.08 etc are affected):

  • 23.05.00

  • 22.11.06

  • 22.05.13

A fix has been made in the git branch called fix-enqueue, so if your Koha is affected by this problem, do not use the code from the master branch, but use the fix-enqueue branch:

$ git checkout fix-enqueue

The same fix will be applied to the master branch in due time, but it is considered to be too early yet, to avoid problems for sites that run versions of Koha that are not yet affected.

MAJOR CHANGES

  • 2019-11-21: Add support for empty form.

  • 2019-11-26: Add support for multiple sigils. PLEASE NOTE: This changes the way settings for the Libris backend are stored, from koha-conf.xml to a separate YAML file. Please see the docs/config.pod for details on the new config.

  • 2020-05-13: patron_id_field is added as an optional config variable. The default remains to use the user_id from the Libris data to look up patrons based on cardnumber, but with this variable the backend can be told to use e.g. userid or borrowernumber.

NEW CONFIG VARIABLES

  • 2019-11-29: update_library_data, close_article_request_on_receive

  • 2019-12-13: ill_callnumber

  • 2020-05-13: patron_id_field (optional, default: cardnumber)

  • 2020-09-30: ill_notforloan (optional, default: 0)

  • 2020-11-25: recordid_limit (optional, default: 100)

  • 2021-22-02: patron_id_attributes (optional)

  • 2022-04-19: patron_id_field_alt (optional)

  • 2022-05-02: item_level_holds (optional, default: off)

  • 2022-05-02: subfields_for_942 (optional)

  • 2024-02-13: item_homebranch_equals_ill_branch (optional)

  • 2024-03-27: delete_article_request_on_close (optional)

DEVELOPMENT BRANCH (waiting)

The commits from the "waiting" branch have now been merged into the "master" branch, since the changes in Koha they relied on have been merged into Koha version 22.11. This means you need at least 22.11 to run the master branch.

AUTHOR

Magnus Enger <[email protected]>

koha-illbackend-libris's People

Contributors

andreasjonsson avatar magnusenger avatar taskula avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

koha-illbackend-libris's Issues

Turn statuses into codes

Currently, statuses are saved as they are returned by the API, as raw text. E.g.: "Uteliggande", "Levererad". It will be cleaner to turn this into "codes", like UTELIGGANDE and LEVERERAD.

Additionally, I think it makes sense to prefix these statuses with IN_ and OUT_, to differentiate incoming and outgoing requests.

Clarify what reading a barcode does

Currently it submits the form, which comes as a surprise for some.

Alternatives:

  1. Make it clearer that reading the barcode should be the last thing you do. Maybe add a note that says "reading the barcode will submit the form".

  2. Make reading the barcode not submit the form.

Don't error on New ILL request > Libris

It used to be that if you selected New ILL request > Libris yo uwould get a nasty error message and also create a partial ill request in the DB, that would block any display of saved ill requests.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.