Versions Compared

Key

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


Note
titleStatus: Draft

This document is currently being revised to reflect recent changes in the integration with NoveList.

 

 

A guide to configuring the SimplyE Circulation Manager to provide NoveList Select Title Recommendations to the SimplyE mobile clients.

...

SimplyE piggybacks off your current NoveList Select for Catalog subscription similar title recommendations. The Circulation Manager queries the NoveList API for information about items in your collection using API account credentials NoveList will supply to you (see below). If you do not have currently have a NoveList Select subscription, the information below will help you get started.

Starting a NoveList Subscription

Library staff must This integration with NoveList Select is only available to librarys which have a currently active NoveList Select for Catalog subscription. If your library currently does not have an active NoveList Select subscription, contact EBSCO at NoveListSelectSupport@ebsco.comto start  for information on starting a subscription.

Required Metadata

However, before NoveList Select can provide meaningful recommendations, the library must let NoveList know what books are in its collection. NoveList staff will need an export of metadata from your collection which contains:

  • ISBN (in 13-digit form, if possible)
  • Item ID (may also be referred to as barcode id or inventory id)
  • Item CallNo (call number)
  • BibRecord ID (may be referred to as control number or control identifier)
  • Title

Primary Export Method

To get your information about your collection to NoveList, using a tab-delimited text file with the following specifications is recommended:

  1. You will want your export to be in the order above and to include a header, using the values "isbn," "itemid," "bibrecordcallno," "bibrecordid," and "title" (do not include quotation marks). If you cannot export in the above order, the header will allow NoveList to process the file.
  2. The file should be tab delimited (other characters could be in the title field and interfere with processing), with one record on each line.
  3. Make sure you get a record for every ISBN in the Bib Record and all of the Item IDs that map to those ISBNs. For example, a book record with 2 distinct ISBNs for which there are 5 items (5 Item IDs), should result in 10 export records.ISBNs should be in 13-digit format. If this is not possible, NoveList can handle the conversion and remove the duplicates.
  4. It is expected that certain fields, such as ISBN or Item ID, will be repeated in the exported file.
  5. You can omit any Item ID that does not have an ISBN associated with it.
  6. You may have records where Call Number is an empty field. You can leave this field empty or mark as "null."
  7. Only include one ISBN/Item ID per line.
  8. In your export, please include the data from both MARC fields 020$a and 020$z.
  9. The BibRecord ID field allows patrons to place holds.
  10. Once you have an export file, send the NoveList Support Team an email at NoveListSelectSupport@ebsco.com and NoveList will send you instructions on how to get the file to them for processing. Please include the library or organization name in the export file name.

Sample Export:

Image Removed

If you have questions about the export, please contact the NoveList Support Team. If you need assistance generating your export file, please contact your ILS provider. 

...

Anchor
obtain-credentials
obtain-credentials
Obtaining NoveList Select API Credentials

 

To request credentials for this integration, remember that your library must have an active NoveList Select for Catalog subscription with EBSCO. To request API credentials for the SimplyE integration, contact NoveList Support at NoveListSelectSupport@ebsco.com, using the following subject line and email body. Substitute your library’s name and NoveList Select for Catalog subscription customer ID  for the <CustID> placeholder text. (Your customer ID will have the form snnnnnnn.main.novsel).

 

To: NoveListSelectSupport@ebsco.com 

 

CC: mwyand@ebsco.com

 

Subject: Request for NoveList Select for SimplyE Credentials

 

We are requesting NoveList Select for SimplyE credentials for <Library Name>. Our EBSCO CustID is: <CustID>. We currently have an active subscription to NoveList Select for Catalog.

 


Once you have submitted the email request to NoveList Support, you will receive a response with your account's API credentials. When you have the credentials, you can configure the NoveList integration as shown in the next section.

...

Alternatively, NoveList can work with a full MARC export manually sent via FTP, if you are unable to generate the above export from your catalog. With the MARC export you will need to include MARC fields that hold the following data:

  • Item ID (may also be referred to as barcode id or inventory id)
  • Item CallNo (call number)
  • BibRecord ID (may be referred to as control number or control identifier)
  • Please include the library or organization name in the MARC export file name.

Specific instructions for your ILS can be found on NoveList's website at https://help.ebsco.com/interfaces/NoveList_Products/NoveList_Products_-_Administration_Guide/ILS_Export_for_NoveList_Products_and_Features

Anchor
configure
configure
Configuring SimplyE Circulation Manager with NoveList Select.

Once you have SimplyE Circulation Manager installed and you have received API credentials from NoveList, you can use the SimplyE Admin Interface to configure NoveList Select recommendations for your library.

...