ILLiad Internet Archive Server Addon
This is a Server Addon and is installed using the ILLiad Customization Manager. See Installing and Configuring Server Addons for more information.
If you have successfully configured this addon but have suddenly started experiencing errors, please check the following URL to determine if the Internet Archive API is temporarily down: https://archive.org/services/atlas/
Name | Internet Archive Server Addon |
|---|---|
Version | 1.0.4 |
Author | Atlas Systems, Inc. |
Description | Queries the Internet Archive API to determine if an ILLiad request can be filled by the Internet Archive. |
Download
Download zip file:
Configuration
When configuring and using this addon, please note that the Internet Archive can only supply nonreturnable materials.
Name | Type | Default | Description |
|---|---|---|---|
InternetArchiveApiBaseUrl | String | The base URL for the Internet Archive API. | |
InternetArchiveWebPlatformConfigId | String |
| The ID of the row in the ILLiad WebPlatformConfig table containing the API key to be used by the Internet Archive. |
MonitoredQueue | String | Awaiting Internet Archive Sending | The queue used to monitor for requests to send to the Internet Archive. |
ReviewQueue | String | Awaiting Internet Archive Review | The queue to which requests are routed for manual review when the Internet Archive API returns a No response. |
ErrorQueue | String | Internet Archive Error | The queue to which requests are routed when there is an error in processing the request. |
Workflow
Once configured, the addon will perform the following workflow illustrated and outlined below:
The addon will monitor a queue defined in the MonitoredQueue addon settings (default: Awaiting Internet Archive Sending).
When a request enters the MonitoredQueue, the server addon will query the Internet Archive API using the values of the ILLiad request fields specified in DataMapping.lua (including but not limited to ISBN/ISSN, Title, Author, Volume, Issue, and Publication Date).
Based on the query, a response of No or Maybe will be returned:
For an API response of No, requests will be moved to the queue defined by ReviewQueue (default: Awaiting Internet Archive Review) for staff review to send to another lender.
For an API response of Maybe, requests will be routed to Request Sent.
After the request has been moved to the Request Sent, Internet Archive will process the request manually to determine if it can be filled and perform one of the following options outside of the addon's built-in workflows:
If the request can be filled, Internet Archive will supply the item via Odyssey.
See the Automating Electronic Delivery with Odyssey Trusted Sender section below for information on automating the delivery of the item to the patron.
If the request cannot be filled, Internet Archive will use the ILLiad API to mark the request as unfilled and route the request to Awaiting Unfilled Processing.
Automating Electronic Delivery with Odyssey Trusted Sender
The Internet Archive can be added as an Odyssey Trusted Sender to automate the delivery of the electronic document to the patron on the web for requests that are successfully fulfilled through the addon. If Trusted Sender is configured, the requested document will be delivered to the patron through the ILLiad web pages once supplied by the Internet Archive and the ILLiad request status will be automatically updated to Delivered to Web without manual intervention by ILL staff.
To enable this functionality, a basic lender address record should be created for the Internet Archive with the following information (at minimum):
Field Name | Value |
|---|---|
Symbol | INARC |
Library Name | Internet Archive |
Odyssey Address | archive.org:7968/ILL |
Trusted Sender? | Checked |
Shipping Address | The Internet |
