Introduction
An Integration in Primo VE can help staff and students find reading lists that are related to the resource being viewed in Primo. It can also provide a button that will display a button to send that particular resource to Talis Aspire as a bookmark.
The bookmark this button can appear below the other 'send to' actions.
The links to reading lists that this item appears on are shown under the main details.
Multiple MMS_IDs
Sometimes you might have multiple MMS_IDs displaying on a record. This integration will only trigger when it sees a 'local' MMS_ID which has your institution code in it. It will also trigger multiple times if it sees two or more different, but all local, MMS_IDs.
The Installation Process
Primo VE supports UI customisations. This involves downloading or creating a customisation, modifying it, and repackaging it for upload back into Primo VE. This is documented by Ex Libris on their knowledge base. If you have any questions about this process please contact Ex Libris Support, or ask a question in the Developer Community to find other libraries that might have done this.
If you want to make more detailed customisations, Ex Libris have more information about how to set up a development environment here: https://github.com/ExLibrisGroup/primo-explore-devenv
Get the Code
The code is available in a gist:
https://gist.github.com/timhodson/cfc22d17548a8539bf9bb0808e55868d
The code was based on earlier work by a customer, and we are grateful for the initial support in working out how best to Integrate Talis Aspire into Primo.
You will need to copy and paste the code into your custom.js file. Be careful to make sure the code is pasted within the existing function that defines the primo angular app.
Customising the code
There are two important things that you will need to update before the integration will work.
- You will need to add your specific tenancy base url. Go to your reading lists home page and look at the URL, then copy the part of it that follows the same pattern as in the example code.
- You will need to add the last four digits of the MMS_ID that is used in your Alma instance. This will be a number which is unique to your tenancy. This ensures that we only try to lookup resources that have an LCN in Talis Aspire. It saves unnecessary network requests behind the scenes.
At the top of the code is a section where you can update the various text labels used in the display for the end user. This allows you to use phrases and language that your users will recognise.
You can also toggle the bookmark this button on and off.
Placement of the button and list links
If you want to modify where the bookmark this button or the related lists are displayed, you will need to know about various placeholders that exist in the Primo VE interface. There is a helpful javacsript bookmark that you can use to turn on a hover view of the placeholders.
You would then replace the relevant placeholder id in the lines that look like this in the javascript code.
// prmActionContainerAfter is the placeholder label
app.component('prmActionContainerAfter',{