HLM, or Holdings Management, is the EBSCO system that powers Full Text Finder, Publications Finder (eJournal A-Z), and the exact match eJournal placard in EBSCO. Files from HLM are used to populate Rapid and to provide collection statistics. Maintaining HLM means enabling subscribed, full-text eJournal content at the title, or package level as well as managing linking to that content.

Also See

• EDS Admin Management
• EBSCOhost Database Maintenance

The overview page for HLM in the EBSCOAdmin shows how many unique titles and packages we have enabled, as well as linking out to be able to create custom resources and packages, and to manage some of our universal settings. From this page you can get to the following

• Titles and Packages
  • This placard will open up the search screen and default to selected.
    • The number of packages is split between managed (EBSCO Global) and UMA Custom
    • The number of titles is for unique titles, and includes managed (EBSCO Global) and UMA custom titles. A download of the full KB will not match this number as it includes duplicates.
• Managing Links
  • This portal is similar to ranking in EDS. Here you can rerank, manage link assignments, change text/icons/etc, and manage our local links for Menu integrations, etc.
    • EBSCO should automatically apply the appropriate links when we activate a resource - they should always be checked though.
• Upload/Download Holdings
  • This can be used to import external data into existing Packages
    • Documentation exists on EBSCO Connect and below for these functions
    • HLM Notes (not custom labels) are not included.
• Searching Options
  • When searching by title, rely primarily on an identifier rather than title as HLM does not return results consistently for all titles.
  • Searching by UMAAH under vendors will return custom packages created locally.
• Manage Notes
  • These are for the internal or public notes attached to records, not for Custom Labels. This is available by going into the title search screen.
    • HLM is hierarchical, any note attached to a vendor will inherit down to Package and then Title.
  • There is no functional limit to how many notes you can create or attach to a record, but they do only appear in FTF and PubFinder, not in the Exact Match Screen
    • Notes should be avoided as they behave strangely. Use appropriate Custom Labels for internal and public notes, use these notes when you need to apply something across multiple KB items or if you need more advanced formatting.
• eHoldings & the Holdings IQ
  • Data from HLM and eHoldings communicate back and forth nearly 1:1 via the HoldingsIQ product. There is no delay (unless something is wrong) but some things only exist on one side of the divide (notes for instance are not shared between HLM and eHoldings and tags and access status types do not appear in HLM.)

HLM functions as the back end for the Link Resolver Full Text Finder, and the eJournal A-Z Publications Finder. These two interfaces rely on different linking mechanisms.

• The Full Text Finder CustomLink exists in EBSCO profiles to allow for the generation of a Link Resolver Menu in EDS or EBSCOHost.
  • [UMAAH SERVICE] FTF - Full Text Finder - use this ONLY in EDS Profiles
  • [UMAAH SERVICE] FTF - EHOST Full Text Finder - use this ONLY in EHOST Profiles
    • [UMAAH SERVICE] FTF - PQD&T Full Text Finder - do not use in any profile, this is setup to allow linking to PQ D&T content via HLM and is assigned as an HLM link only.
• HLM Links are associated with different packages and titles in packages. They are automatically associated with selected content but can be edited. They are generated based on the combination of the BaseURL, a Query String, and a Mandatory Field
  • There is a known issue with HLM links relying solely on the DOI rather than ISSN or a combination of multiple identifiers. For a link to correctly appear on an FTF menu there MUST be a DOI in the source metadata. When found, these should be reported to EBSCO. Bob suggested that sometimes an ISSN version of a link can be created and Sara has had luck with getting additional metadata elements included.
  • This is a VERY different structure than SFX.
• PubFinder Links appear in the titles themselves. The URL stored here is what is actually linkable from PFUI and can sometimes be used on the FTF menu if the PubFinder link is applied to those packages/titles.
  • They are NOT editable, any changes need to be sent to EBSCO.

We have not made any decisions on what sort of statistics we will track once we leave SFX.

Branding for Full Text Finder and PubFinder are handled differently since PFUI is one of EBSCO's newer products.

• FTF Branding Tab
  • Basic changes are handled here, and we use enhanced branding but most of the design is handled via the bottom branding.
  • “[UMAAH] FTF Active” has all of our custom branding.
    • The same LibAnswers tab Kat created for EDS is used in FTF
    • MHC lent their code for the footer link to the eResource Use Policy
    • The same Favicon Switcher app for EDS is used
    • Bob added code to allow Unpaywall to work correctly.
    • Courtney added code created for Amherst to increase the font size and underline the menu links
    • Courtney also created code to allow for a link in the FTF header to PFUI
    • Courtney created code to allow for better mobile use of the FTF menu
    • There is also code at the base from Courtney to rearrange elements of the metadata header and to change the way that the branding works to hide the EBSCO FTF image, put our branding in the top right, and allow for better resizing of the metadata.
• PFUI Branding
  • The branding tab only controls the Title of PubFinder and the top right text and URL for images
  • “[UMAAH] PubFinder Active” has most configuration options and it needs to be set to Plain Text for the JSON to work
    • We have LOC subject headings configured
    • Colors are configured here as well
    • Alphabrowse is TBD
    • We have hidden the Browse by Database (package) but not the filter option
    • Our UMass branding image is stored here
    • The PfResourceTypeControl contains our customized radio buttons for searching
      • Final execution was to define All Publications as everything except eBooks, and streaming content.
      • We also created radio buttons for Journals, Newspapers, and Reports & Proceedings

EDS and HLM are two sides of the same knowledgebase but they are NOT the same thing. EDS can be viewed primarily as a metadata source with a unique linking aspect (CustomLinks and SmartLinks/Plus) of which HLM/FTF plugs in to be a link resolver. The EKB (HLM) is NOT intended to facilitate discovery. Important things to know:

• Selecting a package/title in HLM does NOT mean it is discoverable in EDS. Metadata is handled separately and it is possible that titles in the EKB are not actually indexed, and therefore not linkable via FTF
  • Since we have the Exact Match Placard, this is how we expect patrons to link out to a title when searching in EDS
• FTF Menus cannot be generated when there is no match to holdings in HLM (meaning, the generation of a link! not the selection of a title). An ILL button will appear instead. This is the same behavior as SFX.
  • A link existing in HLM does NOT mean it is linkable in FTF based on EDS metadata. Metadata from EDS must include the specific mandatory elements (like a DOI) for a link to appear on the FTF menu. If the required elements are not present a link will not generate, meaning there will be false negatives for content that will lead to ILL requests.

Try to keep custom content to a minimum to avoid the hastels of duplication. Search UMAAH in the vendor search to find all custom content.

• ProQuest Legislative and Executive Publications: a UMAAH custom package for the different access points/names of the PQ Congressional Collection, there is a mix of managed custom and full custom titles.
• ScholarWorks@UMass Amherst: eJournal content from Scholarworks, there is a mix of managed custom and full custom titles.
• UMass Amherst eResources: Outlier resources of various types, there is a mix of managed custom and full custom titles.
• UMass Amherst Open Books: eBooks published by UM Libraries - workflow is that Ann creates records and shares system ID with Jack, who adds to HLM.
• UMass Amherst Print Journals: TBD
• DEPRECATED: Journal Citation Reports: Based on a file provided by Clarivate to power the JCR customlink. Titles update annually.
  • Linking stopped working so the package was disabled.

ILL uses the link resolver in a very specific way which is different from all other patrons.

All packages which CANNOT be lend or have at least 1 restriction on lending should be associated with the relevant note in HLM in the Admin. These assignments should be reviewed at renewals. Details are shown below for when new packages are added to the KB. K. Zedepski will use these to curate distinct files for upload in to RAPID. Instructions below:

Login to the EBSCO Admin: https://eadmin.ebscohost.com/eadmin/login.aspx

1. Navigate to Holdings Management > Download Your Holdings
2. Change Type or Format if required
   1. The default is a CSV in EBSCO's file syntax. SFX was using .txt files in their Syntax but we may want to switch to KBART.
3. Create two downloaded files based on package content type
   1. Aggregated Full Text, E-Journal, Online Reference, Unknown
   2. eBooks
      1. A&I is not Full Text and Print is duped on the ILS transfer
4. Enter a File Name and click “Create File for Download”
   1. The screen will refresh, wait for the status “In progress” to change to Completed
   2. Download the Files when completed.

Open one of the Files in Excel

1. In Holdings Management, navigate to Notes (top right, below pink ribbon)
2. Find the notes: ILL: No Lending and ILL: Restricted Lending (they will always be at the bottom of the list)
3. Open the No Lending note and navigate to the packages tab.
4. Use this list and filter down to these packages in the Excel File. (Column D: PackageName, use the Sort & Filter for the entire sheet)
   1. Using the search in Excel is not reliable. Uncheck the “Select All” and choose specific package names.
5. When the list of packages is created in excel, cut an paste the content to a new spreadsheet for RAPID.
   1. Repeat for Restricted Lending
   2. This process needs to be done for both files coming from HLM.
6. When content has been removed, resort the file and you will have all lendable content.

TBD

TBD

To generate reports for Assessment and the Statistics of the Collection please use the following instructions.

Login to the EBSCO Admin: https://eadmin.ebscohost.com/eadmin/login.aspx

1. Navigate to Holdings Management > Download Your Holdings
2. Change Type or Format if required
   1. The default is a CSV in EBSCO's file syntax.
3. Under Resource Types choose the desired types to generate a download file.
   1. You have to click the radio button to the right of the table before selecting resource types.
4. Enter a File Name and click “Create File for Download”
   1. The screen will refresh, wait for the status “In progress” to change to Completed
   2. Click on the “Title List Summary” when it appears. The column “Unique Titles” will give a number that has deduplicated identical titles held in multiple places.
      1. ie. if Journal of Fish Biology is in two selected packages from Wiley it will be listed twice. This is true for a single title which is available through multiple aggregators or in a subscribed package and in an open access package with a different date range. The unique titles may be considerably less than total titles.

When a brand new resource appears in your queue it can be enabled in HLM.

• Confirm whatever title or package actually matches the subscribed content. Selecting the title will activate it in HLM
  • Moving forward, we will activate all material types in HLM except for Abstract and Index packages.
  • PubFinder will be configured specifically to show only some types of title material types (primarily excluding non serial content like eBooks) but if there is a link and a linking mechanism, the content could appear in an FTF menu and will always appear in downloads.

If you are selecting a new package:

• Always check the proxy settings, custom coverage, and whether or not the package is set to Allow EBSCO to Add New Titles.
  • OA content, including content from publishers we pay for, should not be proxied to allow for better guest access.
• Leave any notes as Custom Labels
• If there is a new link, it needs to be ranked in the Links Management pane and configured.
  • See details below.
• Update ILL Spreadsheet & Notes for RAPID holdings
  • See details below
• Agreement Lines need to be created for new content in FOLIO.

To curate files for RAPID of what can and cannot be lent via ILL, Please add the package with associated information for licensing to the eResource Working Document Spreadsheet. (Jack's document) Then in HLM do the following:

• If the full content of a package CAN be lent with no restrictions:
  • Do not do anything.
• If the full content of a package CANNOT be lent:
  • Add the package to the note: ILL: No Lending
  • K. will use this to curate separate out what cannot be lent to send to RAPID.
• If content of a package can be lent WITH RESTRICTIONS
  • Add the package to the note: ILL: Restricted Lending
    • For the time being, this content will also be considered NO LEND. Jack & K. will work to strip out this content to be loaded as a third “Restricted” file to RAPID.

Labels for the FTF Menu are also linked. Keep links on the 10s to allow for wiggle room.

• The ranking of HLM Links is loosely based on SFX sort_services.config ranking.
  • 0 = EBSCO Linking Services (?)
  • 10 = Paid Journal subscriptions
  • 20 = Publisher hosts (Ingenta, Highwire, etc.)
  • 30 = Newspapers
  • 40 = Databases
  • 45 = Media, image, and streaming
  • 50 = Less reliable aggregators and digitized historical publications
  • 60 = eBooks
  • 70 = Open access
  • 80 = Print
  • 90 = Alternate Linking (CrossRef / PubFinder)
  • 100 = Service Links (Set to Always Show)
    • Begins with Section Label “Unable to Find Full Text?”
• Once you've assigned or changed a ranking, scroll to the top of the page and click Refresh.

If you are deselecting entire packages, download the content first to see if there are any CustomLabels that should be preserved. Record relevant notes in FOLIO. Deselecting a title will delete ALL customizations including custom date coverage.

Checking renewals in HLM is actually easier than SFX. There's a quick three step process for processing a renewal when it shows up in your queue.

Packages have basic settings which should be reviewed:

• Be sure that the package has not been hidden
• The Proxy Server should reflect whether the package is OA or not
  • (If it is mixed, it should NOT be set at the package level.)
• Custom Date coverage should usually be unset (the exception being Springer eBooks)
• Allow EBSCO to Add New Titles
  • Generally, unless the Package Type is Complete this should be set to No.

Titles do not need to be closely checked unless the package is for individual eJournal or package content

• For packages, title lists should be checked against the content
  • Sometimes, a new package is created and that package should be evaluated for new selection
  • Otherwise, check for cessations or title changes in EBSCONet and update Custom Labels
• For individual eJournal titles, check access through HLM and ensure that the proxy settings are correct
  • Confirm the coverage is correct and record any relevant notes.

eBook Packages and individual eBook titles are handled differently.

• For packages, ideally there should be a complete package and it can be treated like an eJournal package or aggregator.
• For individual eBook titles, they really should be a one and done selection process, you won't need to review unless it's something with a recurring subscription.

The Link assigned to the package/title should be reviewed to make sure that no settings have been changed. Match the links to the criteria outlined above in the Enabling a New Resource setting.

• Review everything relating to ILL (can/cannot lend) on the spreadsheet and the ILL notes in HLM.
• Make sure OA versions of CrossRef and PFUI Linking replace the non OA versions for free resources or else they will cause proxy errors.

Moving forward we will test links during the renewal process.

• Create a new test profile in the “Test” Group where FTF is the only link ranked and all metadata is selected.
• Generate an FTF menu off of EDS Metadata
• Confirm that the link you are expecting (based on assignment) is appearing and that linking to the platform is successful.
• Consider testing from multiple metadata sources and comparing the menus to see if mandatory fields are causing some links to fail.

There are some regular maintenance things that need to be done to make sure that HLM is up to date.

EBSCO is still working on advertising content updates before they happen, so management in HLM is more reactionary than in SFX. Each week a copy of the Full KB should be downloaded and stored on the DRMS Drive and a “Titles Removed from my Holdings” report should be run for the previous week.

• Currently the KB Download should be done on Mondays
  • Choose package types: Aggregated Full Text, E-Journal, Online Reference, Unknown
  • Full KB Download 2022
• The Titles Removed report should be on run on Tuesday and cover the previous Monday to Sunday. Compare titles against an appropriate download of the Full KB.
  • Ignore eBook Packages/Titles
  • De Gruyter should have 41 titles (As of 20221129)
  • EBSCO Open Access Journals should have 9 titles (As of 20221129)
  • IngentaConnect should have 15 titles (As of 20221129)
  • Publisher's Site should have 48 titles (As of 20221129)
  • Taylor & Francis should have 467 titles (As of 20221129)

• If titles are removed that we care about, check the package first to see if there is still content there that can be selected, or else, create a KB Inquiry.

Once a year, all HLM Links should be checked to make sure that they conform to the criteria outlined above. Link language and hover text should be reviewed to ensure it matches, settings should be verified, and the proxy settings should be checked to make sure it is correctly toggled.

Once a year the custom package for ScholarWorks should be updated based on the Journals page. Package Name: ScholarWorks@UMass Amherst

Publications Finder & CrossRef are added as links but have NOT been tested yet. Jack can work with EBSCO to try and get an actual link created so that we can link to ScholarWorks articles directly. Erin Jerome should be a part of this project. Scholarworks includes DOIs so an HLM link should be possible.

IRM does not currently have the capacity to review and clean up our serials data for import into HLM. A file was generated before the Aleph migration which can be used as a temporary data source until better export/reporting features exist in FOLIO.

• An HLM link (Check Discovery for Print Versions) which performs an PISSN/EISSN search in EDS was added in Spring 2022 so that patrons can move between the interfaces and can see results for our print collection if there is no online full text.

These are some of the short term policies and procedures being created for HLM, Full Text Finder, and PubFinder

Knowledgebase Maintenance takes place in two phases. Content should be renewed on a yearly basis during the renewals process (see above) and general maintenance should be performed regularly throughout the year.

For regular maintenance consider the following:

• Content formerly managed by the autoloads should be downloaded as KBART files from the publisher platform, transformed, and uploaded to HLM to overwrite existing data twice a year. Specific instructions can be found above.
• Links should be reviewed regularly to ensure that link language, customizations, icons, etc. have not been changed in the EBSCO Admin
• Whenever Support interacts with HLM, their suggestions or changes should be reviewed to ensure that local decisions have not been reversed.
• Once a week, a Full download of the KB should be taken from the Admin (minus Print and eBooks) to make sure we have backups of content.
• Once a week, titles removed from holdings should be reviewed.

Open Access content in HLM should always be reviewed prior to it's selection. If the OA content is from a specific vendor it may be duplicated in our subscribed content so linking mechanisms should be changed to show one link per vendor. Requests from Liaison should be considered, but until a more formal OA policy is written we are restrictive in what we enable due to lack of time to manage it all.

We are NOT selecting the large EBSCO provided OA packages as we have no way of comprehensively reviewing them for accuracy. If specific titles are requested they should be selected and documented via CustomLabels.

If linking becomes unreliable for a subset of a package content should be deselected. IRM is not able to coordinate with OA publishers for access issues so if an entire package becomes unreliable it will be delestected.

OA content is specifically not proxied on PubFinder so that all patrons can access it. We have tried to have content specific links unproxied (like CrossRef and PubFinder OA) and include the OA button icon (like DOAJ) to advertise OA access via FTF but this method is not comprehensive and some OA content will be duped with proxied or unlabeled links.

See Perpetual Access Procedures & Codes

• This is an older version of this policy created specifically for SFX.

UMass policy for tracking and maintaining perpetual access in HLM is as follows (as of 03/10/21):

• Cancellations of individual subscriptions: If a good range of PA is accessible (ie. more than 2-3 years) and we retain subscriptions from the same publisher, PA access can be enabled. (Ex. Taylor & Francis)
• Transferred titles from package ejournals: Do not set up PA access EXCEPT for Springer, Wiley, and Elsevier. The Elsevier and Springer KBART loads include these titles so they will be uploaded to HLM.
• Individual subscription transfers: Mostly we are retaining PA access but if publisher is known to retain PA, exceptions can be made. Many publishers are not reliably retaining PA access long-term so a judgement call may need to be made.
  • Publishers who have retained PA relatively reliably are: Taylor & Francis, De Gruyter, Wiley, Elsevier, Springer.
  • Publishers who have may NOT retain PA reliably are: Sage, Ovid, Cambridge, Oxford.

• Library Website Search Box (contact LTS with issues)
• Library Find & Borrow Menu (contact LTS with issues)
• Springshare Databases A-Z List (contact Research Services with issues)
• Discovery Top Ribbon (contact DRMS with issues)
• FTF Top Ribbon (contact DRMS with issues)

• Base URL: https://resolver.ebscohost.com/openurl
• Small: https://www.library.umass.edu/assets/Branding/ftfsmall85x20.png
• Large: https://www.library.umass.edu/assets/Branding/ftflarge170x40.png

• EBSCOHost/EDS Branding:
• Favicon Icon: https://www.library.umass.edu/favicon.ico OR https://www.library.umass.edu/wp-content/themes/umasslibrary/images/favicon.ico
• Ask Us Box: https://www.library.umass.edu/wp-content/uploads/2022/07/AskUs-Box.png

• Full Branding, white background: https://www.library.umass.edu/assets/Branding/UMass-Libraries-horiz-RGB.png

• OpenAthens Main Branding:

Linking from a specific source to Full Text Finder

FTF uses OpenURL version 0.1

— Primary contact: Jack Mulvaney