exlibris-request

SRA-Exlibris-Request

This module is part of the Bond University Centre for Research in Evidence-Based Practice Systematic Review Assistant suite of tools.

This module forms the reference request tool.

var exlibrisRequest = require('sra-exlibis-request');

new sraExlibrisRequest()
	.set({
		exlibris: {
			apiKey: 'YOUR API KEY'
		},
		user: {
			email: 'someone@somewhere', // User making request
		},
	})
	.set('request.source', 'SRA') // Set some extra request fields
	.set('request.note', 'SRA')
	.set('validator', (ref, eref) => { // Custom validator code
		if (!ref.type) return 'No reference type specified';
		if (ref.type == 'book') {
			if (!eref.title) return 'Missing book title';
			if (!eref.journal) return 'Missing journal';
			eref.pickup_location = 'MAIN',
			eref.format = 'PHYSICAL';
			eref.citation_type = 'BK';
		}
		return true;
	})
	.requestAll(refs, function(err, res) { // Request a bunch of references (maybe use reflib - https://github.com/hash-bang/Reflib-Node - to read in a library?)
		expect(err).to.be.not.ok;
		done();
	})

See the testkits for more examples.

API

ExlibrisRequest (class)

The main ExlibrisRequest class is used to setup the instance with initial settings and provide an API.

Supported Settings:

Setting	Type	Default	Description
exlibris	Object	See below	Settings passed onto the Exlibris NPM module
exlibris.region	String	"eu"	What Exlibris region server the place the request with
exlibris.apiKey	String	none	Your Exlibris API key
exlibris.resourceRequestRetry	Number	10	How many times to retry a single request if it fails
exlibris.resourceRequestRetryDelay	Function	See code	How to calculate how long to wait between requests. Default behaviour is to pick a random millisecond delay between 0 and 2000
exlibris.threads	Number	2	How many requests to place simultaneously
user	Object	See below	Information about the user to place the request against
user.email	String	none	The users email to link the request against
request	Object	{}	Additional fields to provide in the request
validator	Function	()=> true	Validator function used to verify that a reference can be submitted. Should return either a boolean or a string (error message). Note, this occurs AFTER the field translation stage, so the fields are Exlibris and NOT Reflib spec. If you are mutating the object, mutate the Exlibris object (eRef)
debug	Object	See below	Debug flags
debug.execRequest	Boolean	false	Whether to actually place requests. User details and all other validation stages are applied except the final submission
debug.titleMangle	String	title => title	How to mutate the citation title before submission. Override this function to specify a prefix / suffix
cache	Object	See below	Caching details, the cache is used only on this instance and can significantly speed up requests if working in batches
cache.enabled	Boolean	true	Whether to use caching
cache.cacheGet	Function	See code	Uses simple memory caching
cache.cacheSet	Function	See code	Uses simple memory caching

Notes:

• The debug.execRequest flag is disabled by default. Set this to true to make the library submit requests, although you should test without this enabled first
• All functions are chainable

ExlibrisRequest.set(config, [value])

Used to quickly set one or more config values. See the main constructor for a list of settings.

ExlibrisRequest
	.set('key1', 'value1')
	.set('key2', 'value2')
	.set('key3.subKey1', 'value3')

ExlibrisRequest.set({
	key1: 'value1',
	key2: 'value2',
	key3: {
		subKey1: 'value3',
	},
})

ExlibrisRequest.request(ref, [options], [cb])

Make a citation request to Exlibris.

The reference should be in the reflib format.

Options can be specified to override the defaults. Callback is optional.

ExlibrisRequest.requestAll(refs, [options], [cb])

Similar to request() but places requests in batch.

See the request function for details.

Events

The ExlibrisRequest instance can also fire events.

Event	Parameters	Description
requestSucceed	(ref, attempt)	Fired when a request succeeded
requestRetry	(ref, attempt, tryagainInTimeout)	Fired when a request fails but will be retried
requestFailed	(ref, attempts)	Fired when a request failed after retrying
requestError	(ref, err)	Fired when a request is completely rejected by the server