Koha::Illrequest - Koha Illrequest Object class
An ILLRequest consists of two parts; the Illrequest Koha::Object, and a series of related Illrequestattributes.
The former encapsulates the basic necessary information that any ILL requires to be usable in Koha. The latter is a set of additional properties used by one of the backends.
The former subsumes the legacy "Status" object. The latter remains encapsulated in the "Record" object.
TODO:
- Anything invoking the ->status method; annotated with: + # Old use of ->status !
All methods should return a hashref in the following format:
This should be set to 1 if an error was encountered.
The status should be a string from the list of statuses detailed below.
The message is a free text field that can be passed on to the end user.
The value returned by the method.
An interface request has determined branch address details are incomplete.
The interface's cancel_request method was successful in cancelling the Illrequest using the API.
The interface's cancel_request method failed to cancel the Illrequest using the API.
The interface's request method returned saying that the desired item is not available for request.
my $statusalias = $request->statusalias;
Returns a request's status alias, as a Koha::AuthorisedValue instance or implicit undef. This is distinct from status_alias, which only returns the value in the status_alias column, this method returns the entire AuthorisedValue object
$Illrequest->status_alias(143);
Overloaded getter/setter for status_alias, that only returns authorised values from the correct category and records the fact that the status has changed
$Illrequest->status('CANREQ');
Overloaded getter/setter for request status, also nullifies status_alias and records the fact that the status has changed
Require "Base.pm" from the relevant ILL backend.
my $backend = $abstract->_backend($new_backend);
my $backend = $abstract->_backend;
Getter/Setter for our API object.
my $backend_capability_result = $self->_backend_capability($name, $args);
This is a helper method to invoke optional capabilities in the backend. If the capability named by $name is not supported, return 0, else invoke it, passing $args along with the invocation, and return its return value.
NOTE: this module suffers from a confusion in termninology:
in _backend_capability, the notion of capability refers to an optional feature that is implemented in core, but might not be supported by a given backend.
in capabilities & custom_capability, capability refers to entries in the status_graph (after union between backend and core).
The easiest way to fix this would be to fix the terminology in capabilities & custom_capability and their callers.
my $config = $abstract->_config($config);
my $config = $abstract->_config;
Getter/Setter for our config object.
my $core_status_graph = $illrequest->_core_status_graph;
Returns ILL module's default status graph. A status graph defines the list of available actions at any stage in the ILL workflow. This is for instance used by the perl script & template to generate the correct buttons to display to the end user at any given point.
my $status_graph = $illrequest->_core_status_graph($origin, $new_graph);
Return a new status_graph, the result of merging $origin & new_graph. This is operation is a union over the sets defied by the two graphs.
Each entry in $new_graph is added to $origin. We do not provide a syntax for 'subtraction' of entries from $origin.
Whilst it is not intended that this works, you can override entries in $origin with entries with the same key in $new_graph. This can lead to problematic behaviour when $new_graph adds an entry, which modifies a dependent entry in $origin, only for the entry in $origin to be replaced later with a new entry from $new_graph.
NOTE: this procedure does not "re-link" entries in $origin or $new_graph, i.e. each of the graphs need to be correct at the outset of the operation.
my $capabilities = $illrequest->capabilities;
Return a hashref mapping methods to operation names supported by the queried backend.
Example return value:
{ create => "Create Request", confirm => "Progress Request" }
NOTE: this module suffers from a confusion in termninology:
in _backend_capability, the notion of capability refers to an optional feature that is implemented in core, but might not be supported by a given backend.
in capabilities & custom_capability, capability refers to entries in the status_graph (after union between backend and core).
The easiest way to fix this would be to fix the terminology in capabilities & custom_capability and their callers.
Return the result of invoking $CANDIDATE on this request's backend with $PARAMS, or 0 if $CANDIDATE is an unknown method on backend.
NOTE: this module suffers from a confusion in termninology:
in _backend_capability, the notion of capability refers to an optional feature that is implemented in core, but might not be supported by a given backend.
in capabilities & custom_capability, capability refers to entries in the status_graph (after union between backend and core).
The easiest way to fix this would be to fix the terminology in capabilities & custom_capability and their callers.
Return a list of available backends.
Return a list of available actions.
Mark a request as completed (status = COMP).
Migrate a request from one backend to another.
Confirm a request. The backend handles setting of mandatory fields in the commit stage:
my $ILLResponse = $illRequest->backend_cancel;
The standard interface method allowing for request cancellation.
my $renew_response = $illRequest->backend_renew;
The standard interface method allowing for request renewal queries.
my $create_response = $abstractILL->backend_create($params);
Return an array of Record objects created by querying our backend with a Search query.
In the context of the other ILL methods, this is a special method: we only pass it $params, as it does not yet have any other data associated with it.
my $params = $abstract->expandTemplate($params);
Return a version of $PARAMS augmented with our required template path.
my $limit_rules = $abstract->getLimits( {
type => 'brw_cat' | 'branch',
value => $value
} );
Return the ILL limit rules for the supplied combination of type / value.
As the config may have no rules for this particular type / value combination, or for the default, we must define fall-back values here.
my $prefix = $abstract->getPrefix( {
branch => $branch_code
} );
Return the ILL prefix as defined by our $params: either per borrower category, per branch or the default.
my $type = $abstract->get_type();
Return a string representing the material type of this request or undef
my $ok = $illRequests->check_limits( {
borrower => $borrower,
branchcode => 'branchcode' | undef,
} );
Given $PARAMS, a hashref containing a $borrower object and a $branchcode, see whether we are still able to place ILLs.
LimitRules are derived from koha-conf.xml: + default limit counts, and counting method + branch specific limit counts & counting method + borrower category specific limit counts & counting method + err on the side of caution: a counting fail will cause fail, even if the other counts passes.
my $status = $illRequest->requires_moderation;
Return the name of the status if moderation by staff is required; or 0 otherwise.
my $stage_summary = $illRequest->generic_confirm;
Handle the generic_confirm extended method. The first stage involves creating a template email for the end user to edit in the browser. The second stage attempts to submit the email.
my $prefix = $record->id_prefix;
Return the prefix appropriate for the current Illrequest as derived from the borrower and branch associated with this request's Status, and the config file.
my $params = $illRequest->_censor($params);
Return $params, modified to reflect our censorship requirements.
$Illrequest->store;
Overloaded store method that, in addition to performing the 'store', possibly records the fact that something happened
my $partners_string = $illRequest->requested_partners;
Return the string representing the email addresses of the partners to whom a request has been sent
$json = $illrequest->TO_JSON
Overloaded TO_JSON method that takes care of inserting calculated values into the unblessed representation of the object.
TODO: This method does nothing and is not called anywhere. However, bug 74325 touches it, so keeping this for now until both this and bug 74325 are merged, at which point we can sort it out and remove it completely
Alex Sassmannshausen <alex.sassmannshausen@ptfs-europe.com> Andrew Isherwood <andrew.isherwood@ptfs-europe.com>