Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ParameterMandatoryDefaultDescription
Data source nameYesProQuestThe name of the Circulation Manager's data source used to store information about ProQuest books.
BooksCatalog Service's URL Yes

The URL of BooksCatalog service used to download the ProQuest OPDS 2.0 feed and described on ProQuest API page.

Info

Please note that the BooksCatalog service is accessible only from whitelisted IP addresses.

Please refer to ProQuest API for more information.


PartnerAuthToken Service's URLYes
The URL of PartnerAuthToken service used to create a ProQuest JWT bearer token required to authenticate in other ProQuest services. and described on ProQuest API page
DownloadLink Service's URLYes
The URL of DownloadLink service used to download ProQuest books and described on ProQuest API page.
ProQuest JWT token's expiration timeoutNo3600Determines how long in seconds can a ProQuest JWT token be valid.
List of SAML attributes containing an affiliation IDNoeduPersonPrincipalName,
eduPersonScopedAffiliation
ProQuest integration assumes that the SAML provider is used for authentication. ProQuest JWT bearer tokens required by the most ProQuest API services are created based on the affiliation ID - SAML attribute uniquely identifying the patron.This setting determines what attributes the ProQuest integration will use to look for affiliation IDs. The ProQuest integration will investigate the specified attributes sequentially and will take the first non-empty value.
Test SAML affiliation IDNo1

This configuration setting is really useful for testing ProQuest API without setting up a SAML authentication provider.
If this configuration setting is set, then the ProQuest integration will be using its value in the case when it cannot find a SAML affiliation ID.

Warning

Please contact ProQuest before using it.


Default audienceNo
If ProQuest does not specify the target audience for their books, assume the books have this target audience.
Feed page's sizeNo5,000

This value determines how many publications will be on a single page fetched from the BooksCatalog service.

Warning

Please note that this value also affects how many publications will be committed in a single database transaction by Circulation Manager. Making this value too big may lead to different database issues.


HTTP proxy's URLNo
URL of the proxy handling HTTP traffic. Proxies can be used for testing when trying to access ProQuest API from machines having non-whitelisted IP addresses. Please find more information below.
HTTPS proxy's URLNo
URL of the proxy handling HTTPS traffic. Proxies can be used for testing when trying to access ProQuest API from machines having non-whitelisted IP addresses. Please find more information below.

...

However, the ProQuest import process is a very computationally expensive operation due to the inefficient ProQuest feed's internal structure and proquest_import_monitor is set up to run only twice a week: 

  • Monday 2 AM EST (11 PM PST).
  • Thursday 2 AM EST (11 PM PST). This run uses an additional --process-removals flag which forces proquest_import_monitor to remove from Circulation Manager's catalog items that are no longer present in the ProQuest feed (it's not enabled by default).
Warning

The schedule above is subject to change.

...