! still in state of translation from a German original
Abstract
Currently FOLIO offers two disjoint interfaces for discovery systems:
- edge_rtac: for item related availability (functional subset of DAIA)
- edge_patron: for ordering (functional subset of PAIA)
The basic axioms are:
- Availability is a binary property that can be derived exclusively from the properties of the media.
- The user functions do not require any information other than availability. If nevertheless, the search interface should handle this.
When discussing real-world challenges, it quickly became clear that these axioms are not sufficient. All use cases are missing, where availability does not only depend on the properties of the medium, but can also be limited by the properties of the user.
This gap is documented here. Based on an example different solutions are discussed.
Matching FOLIO tickets
- UXPROD-2422 (Discovery Integrations - Expose Circulation Rules Regarding Requests)
- UXPROD-2758 (Discovery Integrations - Expose Circulation Rules Regarding Renewal Options)
- UXPROD-1630 (Pre-Check Request Policy When Requests are Created and/or Moved)
Generic example
Environment
- A small library has two types of readers and all media are stored in closed stacks.
- Some of the media may be ordered by all readers, some only by group 'A' and others only by group 'B'.
- The library has a discovery system that does not require an initial registration.
Challenge
The search interface should offer meaningful action elements (buttons) in two modes of operation.
- Without prior registration (patron is unknown) There are four possibilities of display:
- The copy is basically not available. (Infotext for the reason: e.g. ordered, lost, ...)
- The copy is available and may be ordered by all patrons. (Button: "Please register and order")
- The copy is available but on loan. (Button: "Please register, reservation possibly possible")
- The copy is available but may only be ordered by one patron group. (Button: "Please register, ordering may be possible")
- With prior registration (patron is known) there are again several options:
- The copy is basically not available. (Infotext for the reason e.g. on buy, lost, ...)
- The copy is available and
- the patron's group has the authority to place a hold. (Button: "order")
- the patron's group has no authority to place a hold. (Infotext: ...)
- The copy is available but on loan and
- the patron's group has the authority to place a hold. (Button: "reserve")
- the patron's group has no authority to place a hold. (Infotext: ...)
Problem
For the first case of the example, an extended¹ edge_rtac should sufficient.
¹) Currently there is no information about the limitations/restrictions of the general availability available.
In the second case, however, it is necessary to include knowledge about the patron. The full set of circulation rules has to be evaluated.
Currently neither edge_rtac nor edge_patron are able to fulfill the requirement.
Solution approaches
When designing edge_rtac and edge_patron, an attempt was made to avoid any overlaps between the interfaces. As demonstrated in the example
above, this cannot be totally sustained.
In this paragraph we discuss where/how the missing connection between the patrons's characteristics and those of the item might be mapped.
Introduction of an additional interface (For example edge_patron-rtac)
It is obvious to outsource functions that cannot be directly assigned to a separate interface. On the other hand every new interface brings new
complexity. Such an additional interface would obviously have a lot of overlaps with edge_rtac and edge_patron. To avoid duplicate code, the
existing interfaces would have to be reworked as well.
Extension of the availability information (edge_rtac)
To consider properties of a reader edge_rtac would have to know the login data. On the other hand, edge_rtac must also work without login. This
would result in two different working modes for edge_rtac: "Without login vague information" vs. "With login exact information". The second mode
would correspond to the third interface discarded above, but would be clearer to assign.
For a search interface, such an approach had only the disadvantage that existing availability information (hit list) would have to be reloaded after a login.
Extension of the user interaction (edge_patron)
In contrast to edge_rtac, edge_patron always knows the ID of the copy and the reader. Accordingly, a two-step workflow would be conceivable: 1.
fetch the exact availability information; 2. order according to the obtained information.
The first step would again correspond to the third interface (or the 2nd mode for edge_rtac), would be logically most inappropriate assigned to
edge_paron.
Partitioned expansion of both interfaces
The non-overlapping design of edge_rtac and edge_patron can be preserved if both interfaces are slightly extended in their context.
* edge_rtac extends the basic availability by information about restrictions of the availability, partly as a list for
different user groups.
For this extension edge_rtac still needs not to know the ID of the reader. It is sufficient if the interface becomes more talkative and outputs as much loan
relevant information as possible.
* edge_parton offers the possibility of a mock order, to query the individual patrons state,
individual restrictions (lock, ...) and individual options (pickup location, ...).
The concept of a mock order can be adopted from the basically comparable interface PAIA. The procedure is as follows:
- If the reader wishes to place an order/reservation, this is requested without additional information (collection location, ...). This triggers a
test order in the library system. This test order does not lead to any change in the loan status. But, as with a 'normal' order, all borrowing
rules are evaluated to determine any and restrictions/options. (restricted list of possible pickup locations, list of possible delivery options,
info on individual restrictions, ...). - With the result of the query, the search interface generates a dialog box in which:
- the reader is informed why the order/registration is not possible for you. (E.g.: Blocked due to too many open charges).
- the reader has the possibility to select order parameters. (pick-up location, delivery option, cost transfer, ...)
- The search interface sends the order/reservation with selected parameters to the interface. In the library system, this triggers a regular
order attempt. - The search interface informs about the success of the order.
The current behavior of edge_patron is already similar. To place a hold currently at least the parameter 'pickup location id' is expected. Without edge_patron reacts with an error message. At this point an mock order could be triggered, to do a full evaluation.
(Currently such a mock order is not yet supported, bur requested -> Tickets).
Summary
Even though they are possible in principle, the first three possibilities seem inconsistent.
- An additional interface would confuse more than help.
- The extension only of 'edge_rtac', would disturb the flow in the search interface
- Extending only 'edge_patron' would blur the clear separation to edge_rtac.
In contrast, the partitioned extension of both interfaces fulfills the requirements without logical breaks.
Appendix
More application examples
Of course, there are many other framework conditions besides the example above that need to be covered with the approach discussed above. In the
following, further basic examples are outlined and it is examined whether the solution described above is sufficient.
Remote locations 1
Environment
- A library has two library locations.
- Local stock should not be able to be ordered.
- Stock from site 'A' should be able to be ordered to site 'B'.
- Stock from site 'B' should be able to be ordered to site 'A'.
- The library has a search interface that does not require registration for research.
Discussion
This example has two aspects:
- edge_rtac
The discovery system needs the information that local ordering is limited by place. - edge_patron
The mock order returns only issue pickup locations from other locations like that of the specimen. (a use case of UXPROD-2689)
Remote locations 2
Framework
- In a departure from the previous example, there is a privileged group that is also allowed to order locally.
- Additionally, there is a third group that is allowed to order locally for a handling fee.
Discussion
edge_rtac
The orderability constraint should be specified as a property of the group.possible response{"limitations": [ {"place" [ {"ordinary": "non local"}, {"privileged": "also local"}, {"payer": "local for money"} ]} ]}
Note: The example above isn't a realistic goal. But 'rtac' might provide all non classified attributes and notes of holding, location and item. this might be sufficient for the discovery system to visualize all cases.edge_patron
The usable pickup locations are filtered by reader and copy.
If the patron is member of the 'payer' group, the amount of the fee could be provided also from the mock order.
Reading room
Environment
- A library has a collection order for an area. Media that have been procured for this purpose may not leave the building, but can be viewed.
- Some of the media are stored in a closed magazine. For reading, these can only be ordered to special reading rooms. There the media can
be used exclusively during the loan period. - Additionally, there is a trusted group that is allowed to order to other pickup locations in the house.
Discussion
- edge_rtac
The orderability constraint should be specified as a property of the group. - edge_patron
The pickup locations are filtered based on reader and copy.
Short-term loan
Environment
- For some media (blank book collection) shortened lending times apply from the usual standard
Discussion
- edge_rtac
To allow the interface to indicate shortened lending times. The restriction should be specified as a property of the group. - edge_patron
The pickup locations are filtered based on reader and copy
{"limitations": [
{"duration" [
{"normalos": "shortened loan, 3d"},
{"privileged": "shortened loan, 7d"}
]}
]}
Example