Third Party Enrichment

During implementation, we will set you up with Accelerated Reader credentials.

Aspen pulls in data weekly from Renaissance Learning based off of the ISBN.

In Catalog/Grouped Works > Grouped Work Display, you can select Show Accelerated Reader Information to show in your Search Results and Full Record Display.

In Catalog/Grouped Works > Grouped Work Facets, you can turn on the following facets:

• AR Interest Level
• AR Reading Level
• AR Point Value

During implemenetation, we will set up the Coce Server Settings.

COCE Server is a remote image URL cache. With this option, cover images are not fetched directly from Amazon, Google, and Open Library. Their URLs are requested via a web service to Coce which manages a cache of URLs.

• • Coce currently will check Amazon Web Services, Google Books or Open Library.
  • We grab book/magazine/etc. covers with UPC (024) or ISBN (020). We do not currently use ISSN (022) but vendors like Syndetics do.

Learn more about Cover Images here.

Add DPLA Credentials

If you choose to use the DP.LA (Digital Public Library of America) API, we will set you up with API credentials during implementation. Reach out to your support team if you choose to turn them on at a later date.

The API Key will be added to Aspen Administration > Third Party Enrichment > DP.LA Settings

Add DPLA to Search Results

Once added, in Aspen Administration > Primary Configuration > Library Systems > scroll toward the bottom to DPLA and click Include DPLA content in search results. This will make DPLA results will show up at the bottom of search results.

Add DPLA to Combined Results

You can also choose to have DPLA results show up in Combined Results. You can set this up in Aspen Administration > Primary Configuration > Library Systems > Combined Results > Click Enable Combined Results

In Combined Results Sections, choose the Display Name, the Number of Results to show, and pick the Source from the dropdown.

Once set up, you will have a in Combined Results section in your search dropdown.

Google Analytics

To set up Google Analytics, go to Aspen Administration > Third Party Enrichment > Google API Settings

• Select your Google Analytics Version - Version 3 or Version 4
• Add your Google Analytics Tracking ID- typically a UA number
• Add your Google Analytics Linking ID - if applicable
• Add your Google Analytics Linked Properties (one per line) - if applicable
• Google Analytics Domain Name - if applicable

Google Books

The Google Books API key can be used to load covers only from Google, but if a library has ByWater's COCE information, it isn't really needed. If you do want to load a Google Books Key, you can go to Aspen Administration > Third Party Enrichment > Google API Settings > Google Books Key.

Google Maps

The Google Maps Key is used for geolocation within Aspen and to show a link to the map in the Hours and Locations popup. The Google Maps API for each library is what makes the coordinates from their provided Location address (In Aspen Administration > Primary Configuration > Locations) for LiDA, too.

During implementation, we add our ByWater Google Maps Key to Aspen Administration > Third Party Enrichment > Google API Settings > Google Maps Key.

Setting up New York Times Best Sellers Lists

To add New York Times lists to your Aspen catalog, follow these steps. Once you've set up your NYT account and added the necessary credentials, the NYT Best Sellers lists will pull in automatically and Aspen will check for updates on a weekly basis.

1. Create an account: https://developer.nytimes.com/accounts/create

This will send you a confirmation email with a verification link that is active for 10 minutes. We have seen occasional bugginess with this. If the link takes you to an error page, try clicking it again until it says your email address has already been verified.

2. Once account has been created, sign in: https://developer.nytimes.com/accounts/login

3. Once signed in, click your email/username in the top right corner, then click Apps.

4. Click New App.

5. Enter the App Name (ie "{LibraryName} NYT Lists") and give a description (ie "Aspen Discovery").

6. Next to the line that says Books API, click Enable. Then, click Save.

7. You will now see a section called API Keys. Click the Copy icon next to the Key to copy the key.

8. In another tab or window, log into Aspen and open up Aspen Administration > Third Party Enrichment > New York Times Settings.  Click Add New. Paste in the key you just copied into both fields, then Save.

New York Times lists: General Info

• New York Times lists will only appear via the API if they have been updated within the last year. 
• Aspen will fetch list updates weekly. To check on New York Times indexing, you can go to Aspen Administration > User Lists > NYT Update Log. 
• You can manage the lists that show in Aspen in Aspen Administration > Third Party Enrichment > New York Times Lists. You can see last updated date for the list and delete any lists you do not want.
• Titles will only show on the lists if you own a copy of the title. If the NYT List has 25 titles on it but your library only owns 15 of the items, only 15 items will show up on the list in Aspen.
• To display titles in these lists, Aspen is matching ISBN numbers from the list(s) to your bibliographic data.
• When the lists are loaded, they will show up in Lists and the "Created By" will show as The New York Times.

Learn More About Lists Here

During implementation, we will set up the OMBD Settings in Aspen Administration > Third Party Enrichment > OMDB Settings.

OMDb (Open Movie Database) - The OMDb is a web service to obtain movie information where all content and images on the site are contributed and maintained by OMDb users. These are pulled in by release year (lives in publication date field, 260/264) and title, but if we don't get anything with the release date, we try to pull it off title.

Learn more about Cover Images here.

Once the SSL is set up for the domain, you can register the reCAPTCHA: https://www.google.com/recaptcha/admin/create 

The Aspen Team will do this for you during implementation.

Once the domain is registered, you will receive a Public and Private Key.

Copy these into Aspen Administration > Third Party Enrichment > reCAPTCHA Settings.

Wikipedia information is brougt in by via web-scraping, where we basically are pulling in live information from Wikipedia, however we do cache the information so immediate changes to Wikipedia will not be reflected right away in Aspen because we cache the information for one day. 

Turn On/Off Wikipedia Integration

To turn on the Wikipedia Integration in Aspen, go to Aspen Administration > Primary Configuration > Library Systems > Catalog Enrichment > check Show Wikipedia Content.

When a user clicks on a hyperlinked Author name, the Wikipedia description will pop up.

Customize the Wikipedia Integration

In Aspen Administration > Third Party Enrichment > Wikipedia Integration > Click Add New

Put in the Author Name you want to update. You can either click on Hide Information to completely hide the author's information from Wikipedia or put in a Wikipedia URL where the Author Name should be directed to.

Video Tutorial

If you have a ContentCafe subscription, go to Aspen Administration > Third Party Enrichment > ContentCafe Settings > Add New 

You will need:

• Content Cafe ID
• Profile Password
• Check Has Summary, Has Table of Contents, Has Excerpt, and Has Author Notes

Note: If ContentCafe/Baker & Taylor is down or experiencing slowness, there is an Integration Enabled option you can uncheck to temporarily disable. 

Once ContentCafe is set up, in Catalog/Grouped Works > Grouped Work Display:

In the Catalog Enrichment section, click Prefer Syndetics/Content Cafe Description

In the Full Record Options section, you can tailor your Content Cafe related options:

• Table of Contents (MARC/Syndetics/ContentCafe)
• Excerpt (Syndetics/ContentCafe)
• Author Notes (Syndetics/ContentCafe)
• Syndicated Reviews (Syndetics/ContentCafe)

Cover images and other enrichment will begin to load immediately after inputting your credentials.

Aspen checks for new cover images every two weeks, beginning from when a record is first loaded.

Learn more about Cover Images here.

Setting Up NoveList Select

With a paid NoveList Select subscription (if you subscribe to NoveList Plus, check that this is available with your subscription), add your NoveList Select credentials in Aspen Administration > Third Party Enrichment > NoveList Settings > Add New.

You will need:

• Profile ID (Ex: s1234567.main.novselcsc)
• Profile Password

Select which Libraries the settings apply to.

Note: You should be able to find this info in your EBSCO Admin Portal. Contact EBSCO if you need assistance locating this information.

Once NoveList is set up, in Catalog/Grouped Works > Grouped Work Display:

In the Full Record Options section, you can tailor your NoveList related options:

• Similar Series from NoveList
• Similar Titles from NoveList
• Similar Authors from NoveList

Similar Authors from NoveList

Similar Authors from NoveList will show a related list of authors. 

A user can click on the author's name hyperlink to be redirected to an Author search in Aspen.

Note: Occasionally, these author searches may come back with no results.

Similar Series from NoveList

Similar Series from NoveList will show a list of related series. A user can click on a hyperlink to be redirected to a Keyword search of that series in Aspen.

Note: Occasionally, these series searches may come back with no results.

Similar Titles from NoveList

Similar Titles from NoveList will show similar titles in the item record. Titles without covers and/or without a hyperlinked title, are not available in your collection. This is based on each library's collection. If you click on the other covers and/or hyperlinks, this will take the user out to that item's record in your catalog.

Note: Unlike the Series and Author searches, Similar Titles will only display hyperlinks when the items are available in your catalog.

Series Display Information from NoveList

If you have NoveList, Aspen will use the series and volume information from NoveList by default.

Updating Grouped Work Display Information

If you see an error or want to change the series and volume information that is displaying in the grouped work display, you can by clicking into the record and going to Staff View > Set Display Info

A box will pop up for you to enter in the information you want to display. Click on Set Display Info to save your work. There may be some browse cacheing that occurs, so changes might take a force reload of the page. 

Note: This only effects the display in Aspen and does not push any changes to bib records and/or the ILS. 

Novelist API Information

To see what information Aspen gets from the NoveList API, go to Aspen Administration > Third Party Enrichment > Novelist API Information and enter the ISBN you want to test in the ISBN field.

If you use the paid card registration service, Quipu, Aspen has an integration with this.

To add your credentials, go to Aspen Administration > Third Party Enrichment > Quipu eCARD Settings

Add your:

• Server (this will be a Quipu URL, example: ecard-us.quipugroup.net)
• Client ID

To turn on, go to Aspen Administration > Primary Configuration > Library Systems > ILS/Account Integration > Self Registration > Enable Self Registration - Select Quipu eCard

In the Self Registration URL, put the Quipu eCard public facing URL

ex: {YOURURL}/MyAccount/eCARD

Note: You may need to have Quipu and the Aspen Team work together to help configure this integration.

In Aspen Administration > Third Party Enrichment > Rosen LevelUp Settings you can customize your Rosen LevelUp options. 

• Add PTypes that can register for Rosen LevelUP
• LevelUP API Host
• LevelUP API Username
• LevelUP API Password
• LevelUP Multi-District Name
• LevelUP District Name
• LevelUP School Name
• School Location Code Prefix

You can provide your patrons with a simple way to register for accounts with your school library's Rosen LevelUP subscription

Instruct patrons to:

• • Go to {$SITE_URL}/MyAccount/Rosen/RegisterRosenLevelUP and log in as the student
  • Fill out the form with student and parent information
  • A single parent username can be used to register multiple students

StackMap

While there are no settings in Aspen or API connections available for Stack Map at this time, we do allow Stack Map integration via JavaScript Snippets. 

If you would like to integrate StackMap into your discovery layer, please reach out to your support company for assistance. ByWater support can reach out to StackMap to obtain the necessary code and make sure everything is configured correctly on their end. 

Below is an example of what StackMap integration looks like on Flagstaff Public Library (note the blue "Map It" button beneath the call number):

Adding StackMap Code to Aspen

If you have received a code snippet from StackMap configured for your instance of Aspen, you can add it via JavaScript Snippets.

1. Aspen Admin > Local Catalog Enrichment > JavaScript Snippets > click Add New.
2. Name your snippet, then paste in the code snippet. It may look something like this:

Note: While most JavaScript snippets require you to surround the code in opening and closing tags, do not include these for the StackMap snippet or it will not work.

3. Check off applicable Libraries and Locations, then Save.

If successful, the StackMap integration should appear in records immediately. 

Syndetics is a paid content enrichment service that provides cover images, reviews, excerpts, author notes, and table of contents for records.

If you have a Syndetics subscription, navigate to Aspen Administration > Third Party Enrichment > Syndetics Settings > Add New.

1. Enter your Syndetics Key. (This is typically composed of letters and is some variant of your library name. Syndetics calls this the 'client id')
2. If you have Syndetics Unbound, click Syndetics Unbound and add your Unbound Account Number
3. Check/uncheck whichever options you need:

• Has Summary, Has Audio Visual Summary, Has Audio Visual Profile, Has Table of Contents, Has Excerpt, Has Fiction Profile, Has Author Notes, Has Video Clip

4. Save the settings. Once saved, you should begin to see content enrichment almost immediately. 

Next, head over to Aspen Administration > Catalog / Grouped Works > Grouped Work Display > Edit your library's settings.

1. In the Catalog Enrichment section, click Prefer Syndetics/Content Cafe Description
2. In the Full Record Options section, you can tailor your Syndetics related options:

• Table of Contents (MARC/Syndetics/ContentCafe)
• Excerpt (Syndetics/ContentCafe)
• Author Notes (Syndetics/ContentCafe)
• Syndicated Reviews (Syndetics/ContentCafe)

Learn more about Cover Images here.

Getting your Syndetics Key

To set up Syndetics/Syndetics Unbound you will need your Syndetics Key (also called the 'Client ID'). Contact Syndetics support to obtain this if you don't have it on hand.

Setting up Syndetics Unbound

In order to set up Syndetics Unbound for your Aspen catalog, you will need to create an instance for Aspen in your Syndetics Unbound account.

To create a new instance in your Syndetics account, navigate to Home > OPAC Settings > Instances, then click Add Instance to set up the new instance.

Next, in OPAC Basics, select "Open Source" as the vendor, and "Aspen" for the product. Then enter the URLs for your library website, and your Aspen catalog URL. 

Next, you will need to configure the Links and URLs. The supported URL types are ISBN, Keyword, and Title.

ISBN URL:

https://[YourAspenURL]/Union/Search?view=list&lookfor=UNBOUNDREPLACE&searchIndex=Keyword&searchSource=local

Keyword URL: 

https://[YourAspenURL]/Union/Search?view=list&lookfor=UNBOUNDREPLACE&searchIndex=Keyword&searchSource=local

Title URL:

https://[YourAspenURL]/Union/Search?view=list&showCovers=on&lookfor=UNBOUNDREPLACE&searchIndex=Title&searchSource=local

Finally, if you are using Syndetics Unbound with an existing catalog other than Aspen, you will need to make sure the Aspen instance you created is the primary instance when you're ready to go live. In the below screenshot, the existing Enterprise instance is still the primary, so you would need to enable Aspen as the primary instance in order to see Unbound integration in Aspen.

Getting your Unbound Account Number

To find your Unbound Account Number, log into your Syndetics account and navigate to Cover Settings to find the account number. You can also navigate to this URL and log in to see your account number: https://admin.syndetics.com/enrichments/getcode

Adding Credentials to Aspen

Once you have your credentials, go to Aspen Administration > Third Party Enrichment > Syndetics Settings > Add New

Enter the Syndetics Key/Client ID, Check the box if you have Unbound and add your Unbound Account Number (if applicable), and select any other options you need.

Adding Unbound Tags

The Unbound Tags appear in the detailed record display.

For the Unbound tags to work correctly in Aspen, you'll have to upload a list of titles into Syndetics. You can reach out to your Syndetics rep or Aspen Discovery support team to learn more.

If you are also using the Koha ILS supported by ByWater Solutions, please submit a Koha support ticket and request a Syndetics cron job to regularly transfer bib information via FTP. You will need to supply us with the following credentials:

• Server
• Username
• Password

This information can be found in your Syndetics account under Holdings > Upload Holdings via FTP.

How Syndetics Unbound Displays in Aspen