Content Alignment between Providers and Ex Libris Knowledgebase
Manifest - Ensuring Content Alignment Between Providers and Ex Libris
The Manifest is a file, maintained by the provider, edited by the provider and passed to Ex Libris every time that there is a need to notify Ex Libris about the need to create new collections in Ex Libris Knowledgebases.
The Manifest file serves as a crucial component for maintaining data integrity and consistency between Ex Libris Knowledgebases and external providers. This file, maintained and updated by the provider (#1 in the image below), is regularly passed to Ex Libris when there is a need to notify that a new collection should be made available in Ex Libris Knowledgebases (#2 in the image below). When a Manifest file is passed and found by Ex Libris automated process, it is prompting Ex Libris to compare the latest version of the Manifest file against the existing data in Ex Libris database (#3 in the image below). Through this comparison process, any discrepancies between the latest Manifest file uploaded by the provider and Ex Libris database, are identified and automatically flagged for further investigation (#4 in the image below).
This proactive approach ensures that Ex Libris Knowledgebase are always aligned with the provider's latest collection offerings, preventing potential gaps or inconsistencies in data availability. The Manifest file's unique format streamlines data exchange and simplifies the process of identifying discrepancies, safeguarding the integrity of Ex Libris's Knowledgebase.
- The list of collections within the Manifest file is only used in order to identify new collections, it will not serve as the actual ingest of new collections into Ex Libris Knowledgebase.
- The Manifest file should only contain informaiton about new collection/s which has an available title list so Ex Libris can ingest. The Manifest should not hold information about collections which are planned to be released in the future.
How to Deliver a Manifest in 5 steps
Multiple providers already furnish Ex Libris with a Manifest file to ensure that mutual customers can find the collections they need within Ex Libris Knowledgebases.
To successfully ingest the Manifest file, Ex Libris has established a set of minimum requirements:
- Download the Manifest file template: Manifest Template_March_2024.xlsx
- Populate the Manifest file: Each row in the Manifest file represents a collection. Fill in the columns for each collection as described in the Manifest Template Structure table below.
There are 3 options to populate a list of collections in the Manifest:
- Option 1: Complete list of all the Provider collections. List is updated with new collection/s as needed
- Option 2: Empty list with no historical data. List is updated with new collection/s as needed in an accumulative manner.
- Option 3: Empty list with no historical data. List is updated with new collection/s as needed. A new Manifest file will be created every time there are new collections (not in an accumulative manner).
- Mandatory fields: The following mandatory fields must be populated for every collection:
- CollectionName (Column A) - The name of the collection as offered to mutual customers by provider
- CollectionID (Column B)- The ID of the collection as recognized at the provider system
- FileName (Column E)- The name of the KBART file which holds the title list
- FileLocation (column F) - The name of the KBART file which holds the title list
Populating the remaining columns in the Manifest file with additional information can significantly enhance the ability to successfully ingest the new collection.
- First time only: Contact Ex Libris Provider Relations team at: Provider.Relations@exlibrisgroup.com to coordinate the Manifest file ingestion, please populate the information in the table below and share it once you contact Ex Libris provider relations team
Manifest file location Manifest file name (regular expression) Which list of collections will the file hold What is the expected timeline for a test file What is the expected timeline for a live file (where will the Manifest file will be placed every time the provider would like to notify Ex Libris about a new collection)
Manifest file can be loaded to one of the following locations
•Ex Libris servers
•Provider servers
•Provider website
What will be the name of the Manifest file that the provider will use, example:
providername_Manifest_YYYYMMDD.xlsx
Option 1: Complete list of all the Provider collections. List is updated with new collection/s as needed
Option 2: Empty list with no historical data. List is updated with new collection/s as needed in an accumulative manner.
Option 3: Empty list with no historical data. List is updated with new collection/s as needed. A new Manifest file will be created every time there are new collections (not in an accumulative manner).
When are you expected to notify Ex Libris that a test Manifest file was loaded? This step is mandatory to intiate successful Manifest process. When should Ex Libris expect to get a Manifest file with indication for new collections?
Once you pass to Ex Libris the Manifest file location, the Manifest file location should not change due to the fact that Ex Libris is setting the automation to harvest the file from the specific location
- Ongoing: Update the Manifest file whenever a collection is added to your catalog and load the Manifest to the server.
Ex Libris will query the server on a daily basis in order to see if a new Manifest file was loaded.
Manifest Template Structure
The table below provides a detailed explanation of each column in the Manifest template file (Manifest Template_March_2024.xlsx):
| Cell # in the Manifest file | A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z | AA | AB |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Column name | CollectionName | CollectionID | CollectionURL | CollectionType | FileName | FileLocation | DateAdded | DateFileUpdated | RecordCount | UpdateFrequency | LinkingSupported | CollectionDescription | PreviousCollectionName | FreelyAccessible | Notes | ExlibrisCollectionType | ServiceType | ContentType | DataFormat | CharacterSet | DateAddedToPlatform | CollectionStatus | Perpetual | FullOverwrite | FileUrlOrSftpSite | DirectoryPath | exlibrisCollectionName | exlibrisCollectionID |
| Column explanation | The name of the collection as identified by the provider in their system | The ID of the collection as recognized by the provider internal system - this ID must be unique and should not repeat in other | AKA "Level URL" - the URL used to access the content of collection as seen by the end user |
Possible values which are under the NISO standard:
|
The name of the KBART file which holds the title list |
This path is relevant for the followinf 3 use cases:
|
On what date was this collection first included in the Manifest file? This should be formatted in the following format: YYYY-MM-DD |
Date of the most recent update to the collection's title list file |
Number of titles within the collection |
Possible values:
In case the above values do not match the update frequency, please add a custom value |
AKA "Linking Level"
|
Up to 255 characters |
This column should be populated in cases where the collection name has changed. THe column should include the name which the collection had preior to the newly given name |
|
Free text. General note, this will not be reflected to users. |
Possible values which are supported by Ex Libris:
|
Possible values which are supported by Ex Libris:
|
Possible values which are supported by Ex Libris:
|
Possible values which are supported by Ex Libris:
This is relevant only for the collection level - MARC feeds are not part of the expected information. |
UTF8 (This is the value ExLibris works with) |
When was the collection added to the provider platform? This should be formatted in the following format: YYYY-MM-DD |
|
Does the collection contain perpetual items?
|
AKA as "negative load"
When updating a collection in the KB and we see that there are less titles in the KBART file, from the past load. If marked as yes, the missing titles will be deleted. If selected as No, the titles which do not appear in the new feed will be preserved |
File location where the KBART title list of the collection can be found This path is relevant for the following 3 use cases:
|
In which directory is the file located?
|
Leave Blank For Ex Libris internal purposes |
Leave Blank For Ex Libris internal purposes |