Interlibrary loans

Get there: More > Administration > System preferences > Interlibrary loans

Features

CirculateILL

Asks: ___ the circulation of ILL requested items.

Default: Disable

Values:

  • Disable

  • Enable

Description:

  • This system preference controls whether you have the option to checkout ILL items directly from an ILL request. More details can be found in the Circulating ILL materials section.

ILLHiddenRequestStatuses

Asks: ILL statuses that are considered finished and should not be displayed in the ILL module: ___ (separated with |). If left empty, all ILL requests will be displayed.

Description:

  • This preference allows libraries to hide requests from the View ILL requests list based on the status of the request. Available ILL statuses are configured in the ILL_STATUS_ALIAS authorized value category and in the backends.

ILLModule

Asks: ___ the interlibrary loans module (master switch).

Default: Disable

Values:

  • Disable

  • Enable

Description:

  • This preference is used to enable Koha’s ILL module which is used to manage ILL requests.

ILLModuleCopyrightClearance

Attention

This system preference is deprecated as of version 24.05 of Koha. It is now an HTML customization location.

Asks: Adding text will enable the copyright clearance stage in request creation. The text you enter will be the text displayed.

Description:

  • This system preference is used to turn on the copyright clearance step when creating an ILL request from the OPAC. Patrons will need to accept the copyright clearance before they can proceed.

  • The text entered here is the text they will need to agree to.

ILLModuleUnmediated

Asks: ___ unmediated interlibrary loan requests. If enabled and the ILL backend supports it, the newly created requests are immediately requested by backend.

Default: Disable

Values:

  • Disable

  • Enable

Description:

Avertissement

Not all ILL backends can support this feature.

ILLPartnerCode

Version

This system preference was added to Koha in version 23.11. In previous versions, the partner code was defined in the koha-conf.xml file.

Asks: Use patrons from category ___ as partners to place ILL requests with.

Values: list of existing patron categories

Description:

  • When using interlibrary loans, you can send requests to partners, which should be “patrons” in your system. This system preference is used to determine which patron category these partners are assigned.

Notifications

ILLDefaultStaffEmail

Asks: Fallback email address for staff ILL notices to be sent to in the absence of a library address: ___ .

Description:

  • By default, replies to ILL request emails will go to the library’s ILL staff email address. If the library’s ILL staff email field is empty, the address entered here will be used.

ILLSendStaffNotices

Asks: Send these ILL notices to staff when appropriate: ___

Description:

  • You can configure which ILL notices should be sent to staff. More details can be found in the ILL email notifications section.

  • Enter the letter codes for the notifications to be sent, separated by pipes (|). For example:

    ILL_REQUEST_CANCEL|ILL_REQUEST_MODIFIED
    
  • If this system preference is left empty, no staff ILL notices will be sent.

OPAC

ILLOpacbackends

Asks: Enabled ILL backends for OPAC initiated requests: ___ .

Description:

  • This preference controls which ILL backend request forms are available for OPAC requests.

  • Enter the backend codes, separated by pipes (|). For example:

    FreeForm|BLDSS
    
  • Refer to the backend configuration guidance for the correct terminology to enter here.

  • If this system preference is left empty, all installed backends will be< enabled for OPAC requests.

Workflow

ILLCheckAvailability

Asks: ___ external sources for availability during the request process.

Default: Don’t check

Values:

  • Don’t check

  • Check

Description:

  • This preference controls whether specific external resources will be searched prior to a request being placed. The resources available are installed using plugins. These can be located on the Koha plugins wiki page at https://wiki.koha-community.org/wiki/Koha_plugins. Currently there are plugins for EDS (EBSCO Discovery Service), Z39.50 and Unpaywall. When a patron submits an ILL request, the item metadata in the form is used to search the external resource. The patron can then click on the title links in the displayed results. If they find the item they were requesting the request can be abandoned. If not, the patron can continue with the request in the normal way.

ILLModuleDisclaimerByType

Version

This system preference was added to Koha in version 23.11.

Asks: If the ILL backend supports it, adding YAML will enable the request type disclaimer stage in request creation, prompting the user with a request type specific disclaimer as defined (staff interface and OPAC).

Description:

  • This system preference is used to provide different disclaimers for different request types.

  • For each request type, there are 3 configuration options:

    • text: the HTML that will be visible for the specified request type.

    • av_category_code: the authorized value category that will be used for the options being presented at the disclaimer stage.

    • bypass: allows for a specific request type to skip the disclaimer stage.

    Example:

    all:
     text: |
      <h2>HTML title</h2>
      <p>This is an HTML paragraph</p>
      <p>This is another HTML paragraph</p>
     av_category_code: YES_NO
    article:
     text: copyright text for all article type requests
     av_category_code: YES_NO
     bypass: 1
    

    The example will show the first text (« HTML title, etc. ») with a yes/no choice for all requests except for article requests, which will skip the disclaimer step.

Note

This is not available to all backends.

Avertissement

This system preference requires YAML syntax to work properly.

This means

  • Make sure there is NO space between the configuration name and the colon

  • Make sure there IS a space between the colon and the value

  • Make sure each configuration is on its own line