Configuring Redirection for Primo VE Deep Links

Last updated
Save as PDF
Share
1. Share
2. Tweet
3. Share

When migrating an Alma-Primo environment to Primo VE, use the Primo Deep-Link Re-Direct Configuration page to map parameters used in Primo permalinks (classic and new UI) to the corresponding parameters used in Primo VE permalinks so that the system can redirect Primo permalinks to the correct page in Primo VE.

For permalinks to redirect correctly, users must access Primo with a dedicated DNS name (such as abc‑primo.hosted.exlibrisgroup.com or abc.primo.exlibrisgroup.com), which are then be changed to point to Primo VE.
Redirection is supported only for URLs that link to Alma and CDI record IDs. Redirections to records from externally loaded data sources are not supported.

The following table shows some examples of Primo permalinks and their redirections to Primo VE.

Type of Permalink	Primo Permalink	Primo VE Permalink
Full Display	New UI: https://my-library.hosted.exlibrisgroup.com/ primo-explore/fulldisplay?docid= ALMA_DS2137114100002341&context=L&vid=VIEW1 &search_scope=EVERYTHING&tab=default_tab &lang=en_US Classic UI: http://my-library.hosted.exlibrisgroup.com/ primo_library/libweb/action/dlDisplay.do? vid=VIEW1&search_scope=EVERYTHING&docId= ALMA_DS2137114100002341&fn=permalink	https://my-library.primo.exlibrisgroup.com/ discovery/fulldisplay?vid=MY_INST:VIEW1 &tab=Everything&docid=alma992979993502341 &context=L&search_scope=MyInst_and_CI&lang=en
Saved Search	New UI: https://my-library.hosted.exlibrisgroup.com/ primo-explore/search?query=any,contains,water &tab=default_tab&search_scope=EVERYTHING &vid=VIEW1&lang=en_US&offset=0 Classic UI: http://my-library.hosted.exlibrisgroup.com/ primo_library/libweb/action/dlSearch.do? vid=VIEW1&institution=MY_INST&search_scope= EVERYTHING&query=any%2Ccontains%2Cwater	https://my-library.primo.exlibrisgroup.com/ discovery/search?vid=MY_INST:VIEW1&tab=Everything&offset=0 &query=any,contains,water &search_scope=MyInst_and_CI&lang=en

Type of Permalink

Primo Permalink

Primo VE Permalink

Full Display

New UI:

https://my-library.hosted.exlibrisgroup.com/
primo-explore/fulldisplay?docid=
ALMA_DS2137114100002341&context=L&vid=VIEW1
&search_scope=EVERYTHING&tab=default_tab
&lang=en_US

Classic UI:

http://my-library.hosted.exlibrisgroup.com/
primo_library/libweb/action/dlDisplay.do?
vid=VIEW1&search_scope=EVERYTHING&docId=
ALMA_DS2137114100002341&fn=permalink

https://my-library.primo.exlibrisgroup.com/
discovery/fulldisplay?vid=MY_INST:VIEW1
&tab=Everything&docid=alma992979993502341
&context=L&search_scope=MyInst_and_CI&lang=en

Saved Search

New UI:

https://my-library.hosted.exlibrisgroup.com/
primo-explore/search?query=any,contains,water
&tab=default_tab&search_scope=EVERYTHING
&vid=VIEW1&lang=en_US&offset=0

Classic UI:

http://my-library.hosted.exlibrisgroup.com/
primo_library/libweb/action/dlSearch.do?
vid=VIEW1&institution=MY_INST&search_scope=
EVERYTHING&query=any%2Ccontains%2Cwater

https://my-library.primo.exlibrisgroup.com/
discovery/search?vid=MY_INST:VIEW1&tab=Everything&offset=0
&query=any,contains,water
&search_scope=MyInst_and_CI&lang=en

To configure the redirection parameters:

Open the Primo Deep-Link and Re-Direct Configuration (Configuration Menu > Discovery > Other > Primo Deep-Link Re-Direct Configuration).

Primo Deep-Link and Re-Direct Configuration Page
Select Add.

Add Configuration Options
Enter the following general parameters:
- Source Base URL – Enter the base URL of your Primo VE without the http:// or https:// prefix. This is used as the base URL for the deep link into Primo VE. Example: my-library.primo.exlibrisgroup.com
- View Code – Enter the view code of the Primo source. This enables you to create separate mapping sets for each Primo view.

In the Add New Mapping section, specify the following fields to add a new mapping row:

Redirection Mapping Fields
Field	Description
Parameter Type	Select the type of parameter that you want to map from the drop-down list: View Code – Maps the view code used in Primo to the view code used in Primo VE. Tab/Slot – Maps the tab used in Primo to the slot used in Primo VE. Scope/Search Profile – Maps the scope used in Primo to the search profile used in Primo VE. Datasource – Indicates whether the data is being mapped from Alma.
Original Primo Parameter Value	Specify the value of the parameter that you want to map from the original Primo system: View Code – The code for the view can be found on the Views List page (Primo Home > Ongoing Configuration Wizards > Views Wizard). Tab – The code for the tab can be found on the Tabs Configuration page in the Views Wizard (Primo Home > Ongoing Configuration Wizards > Views Wizard > Tabs Configuration). Scope – The code for the scope value can be found on the Scope Values List page (Primo Home > Ongoing Configuration Wizards > Pipe Configuration Wizard > Scope Values Configuration). Datasource– The code for the data source can be found on the Data Sources page (Primo Home > Ongoing Configuration Wizards > Pipe Configuration Wizard > Data Sources Configuration).
Target Parameter Value	Specify the value of the target parameter used in Primo VE: View Code – The code for the view can be found on the Views List page (Discovery > Display Configuration > Configure Views). Slot – The code for the tab can be found in the Search Profile Slots tab on the View Configuration page (Discovery > Display Configuration > Configure Views). For more information, see Configuring Search Profile Slots. Search Profile – The code for the search profile can be found on the Search Profiles page (Discovery > Search Configuration > Search Profiles). This field does not appear for the Datasource parameter type.
Is Alma data source	If you are mapping data from an Alma data source, select True. Otherwise, select False. This field only appears for the Datasource parameter type.

Select Add Row.
Repeat steps 4 and 5 to add more rows.
Select Save.