Older page(s): 21.11 pilot library memo, 22.05 pilot library memo

Last time (installation 22.05) AFTER INSTALLATION we found just three issues (Slack):

  • Finna's "purge checkout history", which already Fixed (thanks Ere!)
  • Melinda updates won't pass through, but that required for another our Melinda's Koha plugin to be updated, this also done
  • Records after adding (biblios) wasn't indexed by ElasticSearch.

dates, plans, steps and progress in JIRA:

PLEASE! Use Slack channel: https://kansalliskirjasto.slack.com/archives/CRAQWTEKD/p1652088566552069 for most issues and their life cycle support talks
and get back there with notes, which you think should be noted.

Table of contents:


Something working differently as before?

  • Marc Bibliographic Framework test: working better than earlier: explanations are better

Something new added? 

Appearance changes:

  • Cataloging-menu changed: more options on this page (removed from Tools-menu to Cataloging-menu)

  • Cataloging -items: possibility to add item template and use it with different titles 

  • Holds-Existing holds: cancel button → now trashbin

  • Search results: title view  → configure : possibility to fix available columns here also (no need to go Sysadmin-Table settings /cgi-bin/koha/admin/columns_settings.pl


  • Two new fields: 'Middle name' and 'Pronouns' in customer info page (if you want to hide them use syspref BorrowerUnwantedField)

  • New button 'Claims' (suomeksi 'Palautusilmoitukset') in customer info page. Function unclear so far.  (Display or hide the column using the column settings options. cgi-bin/koha/admin/columns_settings.pl → more member)

  • Check out settings (Lainausasetukset) löytyvät uudella tavalla

Vanha Koha:

Uusi Koha:

New functions

Patrons → More → Export today's checked in barcodes : makes an txt-file of barcodes

Check in - Checkin settings

New: Checkin settings revealed using sliders

New Notices and Slips

Patrons- ACCOUNT SUMMARY - Account balance slip

Patrons- 2FA_OTP_TOKEN: two-authentication step token
Holds- HOLD_CHANGED: Canceled hold available for different patron

Holds-NEW_CURBSIDE_PICKUP: New curbside pickup

Patrons-OPAC_REG: New OPAC self-registration submitted

Circulation-OVERDUE_FINE_DESC: Overdue item fine description

Patrons-PASSWORD_CHAGE: Notification of password change

Patrons-STAFF_PASSWOR_RESET: Online password reset

System preferences: (Check these preferences if they are "valuable" for your library)

Cataloging - ApplyFrameworkDefaults : apply framework defaults when (e.g.. when cataloging a new, when changing the framework while editing the existing record)

Circulation- AutomaticConfirmTransfer:  Do/Don't automatically confirm a transfer when the modal is dismissed without clicking 'Yes'. ??

Circulation- Holds- DefaultHoldPickuplocation: When placing a hold via the staff interface default the pickup location to the  item's hold library/logged in library/items holdings library

Circulation - Holds- EnableItemGroupHolds:  Enable/Don't enable the ability to place holds on item groups.

Circulation - Holds- EnableItemGroups:  Enable/Don't enable  the item groups feature to allow collecting groups of items on a record together.

Circulation-Holds - ExpireReservesAutoFill: + ExpireReservesAutoFillEmail: Do /Don't automatically fill the next hold using the item. Send email notification of the new hold filled with a canceled item to ... (=if hold is automatically expired the hold can be transferred to next patron on queque and email send e.g. to library)

Circulation-Item bundles - BundleLostValue and BundleNotLoanValue: 

Circulation - Checkoutpolicy:  CircControlReturnsBranch: To determine wether an item is transferred or remains in the libray after checkin, use the circulation rules

Circulation - Patron restrictions: PatronRestrictionTypes. Allow determining local restriction types. If allowed determine local restriction types at Koha adminstration → Patron restriction

Other preferences

  • Circulation and fines rules: new rule to allow canceling waiting holds  (can be made by patron type, item type): probably working with Koha-Opac? test it

  • 11 new authorized values concerning ERM


  • Rotating collections: Manage rotating collections

  • Manage electronic resources module

Removed preferences

New Permissions (virkailija käyttöoikeudet)

Check out and check in items:

  • Manage curbside pickups (manage_curbside_pickups)

Edit catalog

  • Create, update and delete item editor templates owned by others (manage_item_editor_templates)

  • Create, update and delete item groups, add or remove items from an item group (manage_item_groups)

Manage patrons fines and fees

  • add manual credits to a patron account

  • add manual invoices to a patron account

How to and what to test to be sure that your Koha works properly

When testing, it is important to check the result of any action in Koha and in Finna views (also Finna.fi).

Some functions may seem like they work fine, but it is a good practice to verify the situation from the staff view and patron's point of view.

Check all functions related to nightly cronjobs

  • Autorenewals

  • Fines

  • Holds expiring

  • Hold expire charges

Other resources:

Test plan notes by 3AMK, regarding test server

Function/process to test

  • test Finnish and English (and Swedish) interfaces




Create a new bibliographic record, if you do those in your Koha 

  • frameworks are working as they should 

  • fields are shown as they used to be

  • MARC bibliographic framework test, cgi-bin/koha/admin/checkmarc.pl

  • item date picker should work when adding item)  (see Jira KOHA-278 - Getting issue details... STATUS )

  • ok (22.06.00)

  • ok (22.06.00)


Making a new holdings (previous version: 500 error)

  • holdings templates (bibliographic frameworks) and fields are working as they should (previous version: couldn't change the tab in holdings framework)

  • cgi-bin/koha/admin/biblio_framework.pl

  • ok (22.06.00)

  • ok (22.06.00)


Adding and editing an item

  • editing via Action button: Duplicate a copy

  • add multiple copies using Add & duplicate, Add multiple copies of this item

  • change item's Not for loan -status eg. from Ordered to In Process etc. Check that status changes correctly in Finna too.

  • ok (22.06.00)


Component parts, e.g. music (parent and child records)

  • linking with parents and child record 

  • child and parents can be found with title

  • ok (22.06.00)

  • ok (22.06.00)

Circulation (borrowing)

Borrow items with different item types to different patron categories (regular, staff, students, ILL, special groups etc.)

  • correct due dates

  • print due date slips

  • duedates ok (22.06.00)

Circulation (borrowing, returning)

Renewing an item

  • one by one

  • all loans

  • ok (22.06.00)

  • ok (22.06.00)

Circulation (borrowing, returning)

Borrowing items with special status (e.g withdrawn, lost, in process, ordered etc.)

  • borrowing

  • renewing

  • returning (popup windows on staff Koha, behaviour with SIP machines)

  • ok (22.06.00) (behaviour in Koha)

  • SIP not tested yet

Circulation (holds)

Placing a request and editing it

  • change pick-up place for title-level holds

  • delete title-level hold

  • make hold for title where some of items are “in order”-status

  • revert a hold and print a new slip

  • place multiple item-level and title-level holds for same patron (check that functions and blocks according to your processes)

  • canceling waiting hold (new feature in 20.11.  with Koha-Opac maybe) 

  • ok (22.06.00)

  • ok (22.06.00)

Circulation (holds)

Borrowing with SIP machines, before the request is processed

  • another patron should be able to borrow

  • does the request trap correctly when some item (from same bib) is returned

  • can item be renewed before trapping (if enough copies available on shelf)

Circulation (holds)

Holds in transfer

Circulation (holds)

Holds available for pick up

  • try to borrow item for someone else

  • cancel request (from patron page and from holds page). See that no fees are calculated either way!

  • ok not possible without confirmation (22.06)

  • ok, no fees calculated (22.06)

Circulation (holds)

Special cases that might differ in libraries due to different service processes and settings, eg, in 3AMK, check this process:

  • all items are available, place a request

  • request is trapped in different branch from pickup location

  • cancel the request while in transit

  • record the behaviour when item arrives to original pickup location (popup messages, statuses in Koha and in Finna)

Circulation (holds)

Check that new holds appear on Holds queue (Varausjono) & Holds to pull (Hyllyvaraukset) -reports

  • Transport cost matrix

Circulation (renewing)

Automatic renewing

  • ok (22.06) without holds

Customer information

Adding a patron

  • ok automatic fill (22.06)

  • ok (22.06)

  • ok (22.06)

Customer information

Making address change in Finna: request comes to Koha for approval and is changed when approved.

Check that correct fields are included in the form, and that everything works
! These have variations in different libraries (example on test-Finna)

Customer infomation

Making changes in Finna regarding (patron can do this without library approval)

  • SMS number (Koha's Primary phone) NB! Not used in 3AMK.

  • email address change in Finna: is changed successfully when patron clicks Save Patron information in Finna.

Customer information

Patron messaging preferences

  • check in Koha that there are no suprises with settings, for different patron groups

  • check that they work in Finna (if you have allowed patrons to modify them)

  • test latest messaging settings and slips: eg. Autorenewal, Hold reminder (if you are using those)

Customer information (login in Finna)

Test ability to login and operating in Finna as a patron, who

  • has more fines than Overdue fines cap (amount), like 15 euros etc.

  • has material onloan with Lost -statuses

  • is debarred

  • account is expired

  • wants to change his/her PIN code (password)

  • changing PIN in Finna -

Customer information

Accounting (Money-related) issues are extremely important

  • overdue charges accumulating correctly

  • fines and fees showing correctly

  • buttons and functions: Pay amount, Pay selected, Write off all, Write off selected

    • if unwanted buttons re-appear, check your IntranetUserCSS

  • accumulating 

  • shows 

  • adding payment manually 

  • paying 

  • accumulating 

  • fines and fees show 

Searching (patrons)

  • search patrons with special characters (ä, å, é etc.)

  • scandinavian characters: ok (22.06)

Searching (bibliographic data and items)

  • search with item barcode

  • search with ISBN and ISSN, other standard numbers if you are using them

  • search with special characters (ä, å, é etc.)

  • with item barcode: ok (22.06)

  • with ISBN, ISMN, 028,  ISSN, standardnumber : ok (22.06)

  • with é, ä, ö, å: ok (22.06)


Patron slips

  • issueslip (Patron -print slip -tulosta kuitti)

  • issueqslip (Patron-print quick slip -tulosta tänään lainatut)

Returning slips

  • transferslip (Returning item - transfer to other library)

  • holdslip (varauskuitti)

  • ok print-slip (22.06)

  • ok print quick slip (22.06)

  • ok transferslip with/without reservation (22.06)

  • ok holdslip (22.06)


Make sure necessary plugins are installed/updated and enabled, e.g. Finna plugin, Tuudo plugin, Label Maker plugin

  • test processes related to plugins, e.g. for spine labels 3-letters printing 

  • /cgi-bin/koha/plugins/plugins-home.pl

  • Label Maker,

  • Tuudo plugin


Batch item modification

  • change items full call number, or something similar

  • remove batch of biblios

  • is job queued and operated as it should, logs afterwards, any error messages

  • changed full call number for several item barcodes. Background job finished.


Testing your often used reports (daily, weekly, montly reports)

  • document changes

  • report error messages

  • be prepared to edit your reports if database structure has changed (big grin)


Prefence: IntranetUserCSS

  • see that all CSS-changes you made are still working (e.g. suppressed/hidden fields in intranet) 

  • Necessary "must" CSS code added to test server, and those work. These are library-specific, so we can't pre-test all.

Things that can’t be tested beforehand 

  • Tuudo app: making a new card, renewals

  • self-service machines: item in transit, item in transit with a hold, items with “special” status (e.g. withdrawn etc.)

  • expire reserve charge

  • overduecharges  (can be tested, but the truth reveals itself in production)

  • messages which are possilbly not delivered (bounce messages)

  • Melinda replication

Things that should be saved  from old version before update? 

Just in case? Not sure?

  • own holdings frameworks  

    • 3AMK: done (21.11./SP)

  • No labels