My Library Card

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

If you are working with Primo VE and not Primo, see Additional Library Card Configurations for Primo VE for more details.

Return to menu

The My Library Card page in Primo displays the end users’ Library Card information (such as loans, requests, fines, and so forth) from Alma using the OPAC via Primo mechanism, which allows Primo to request information from Alma via the ILS Gateway and then display the information on the My Library Card page in Primo. For more information about how OPAC via Primo functions, see How OPAC via Primo Works.

As long as the Primo institution configuration includes the api_base base URL, Primo will invoke OPAC via Primo for the My Library Card functionality. For more information on configuring the institution, see Configuring the Primo Institution.

In addition, you can customize the information that displays on the My Library Card page (such as which fields appear in the detailed display of a loan or request). For more information, see Configuring OPAC via Primo.

When working with a Network Zone, a patron can view all of their accounts from My Library Card by selecting the institution in the My Library Card menu.

Updating Patron Information

If permitted by Alma, the My Preferences section in My Library Card > Personal Settings allows patrons to update their personal information.

To allow users to update their patron information from Primo, set the primo_patron_info_updatable parameter to Y in the Customer Parameters table (Configuration Menu > General > General Configuration > Other Settings) in Alma.

Personal Details Tab in My Library Card.

Personal Details and Settings Tab - My Library Card

Updating Self-Check Machine PINs

The Update Login Credentials section in My Library Card > Personal Settings allows Alma users to retrieve, display, and modify their PIN and password.

The following restrictions apply:

Password updates are limited to collaborative network users (patrons who are not associated with the institution but can receive fulfillment services from it).
PIN updates are only allowed for Alma environments that use PINs (Authentication required is set to Yes in the self-check machine integration profile - see Self-Check Machines) and have the use_pincode_for_selfcheck_machine parameter set to true in the Customer Parameters table (Configuration Menu > User Management > General > Other Settings) in Alma.

Select Update Login Credentials to open the dialog box:

Update Login Credentials button under Personal Settings.

Update Login Credentials Section - Personal Settings

If not permitted by Alma, some or all of the login credential fields may not display in My Library Card > Personal Settings.

Paying Fines and Fees

Alma allows users to pay fines and fees online using My Library Card. For Alma configuration information, see Configuring the WPM Education E-Payment System.

To pay fines and fees via Primo:

On the My Library Card > Fine & Fees tab in Primo, select the Pay Fine link above the list of fines.

Fines & Fees Link in My Library Card

To configure the link that display above and below the list of fines, see Configuring the Pay Fine Link.
On the WPM Education E-Payment System's Payments page, select the items to pay and select Continue.

Sample WPM Education E-Payment System's Payments Page
On the WPM Education E-Payment System's Payment Method page, enter your credit card and billing address information and then select Continue.

Sample WPM Education E-Payment System's Payment Method Page
On the WPM Education E-Payment System's Transaction Confirmation page, select Confirm your transaction.

Sample WPM Education E-Payment System's Transaction Confirmation Page

Payment receipt emails are sent to the user shortly after processing completes in the WPM Education E-Payment System and Alma.

Sample WPM Education E-Payment System's Payment Receipt Email

Configuring the Pay Fine Link

To allow users to pay fines online using My Library Card, you must configure the link to the WPM Education E-Payment System. For Alma configuration information, see Configuring the WPM Education E-Payment System.

To add the Pay Fine link:

On the Primo Home > Advanced Configuration page, select All Mapping Tables.
The All Mapping Tables page opens.
Select Edit in the row containing the My Account Links mapping table.
The My Account Links mapping table page opens.
In the Create a New Mapping Row section, enter the following fields and then select Create:
- View ID – Select the view.
- Link Code – Select fines.payfinelink.
- Order – Specify 1 to place the link next to the fines/fees balance in the title.
- Link URL – Specify the following link to Alma:
  
  https://<Alma domain>.alma.exlibrisgroup.com/view/FinesFeesPayment/<Alma institution code>/do?system=WPM&pds_handle={{pds_handle}}
  
  See Your Alma Domain Names. For example:
  
  https://university.alma.exlibrisgroup.com/view/FinesFeesPayment/01_UNI_INST/do?system=WPM&pds_handle={{pds_handle}}
Save and deploy your changes to the mapping table.

If you want to change the name of the link, modify the label for the fines.payfinelink link code in the My Account Links Labels code table.

Disabling Paging for Request List APIs

Alma allows customers to utilize the paging feature provided by Primo in the My Library Card > Loans List. By default, Primo fetches loans in bulks. If the user has more loans than the configured bulk size, Primo displays the Show More Loans link at the bottom of the My Library Card > Loans List page, which allows the user to fetch an additional bulk.

If the user invokes the Renew or Renew All option before all loans have been fetched from Alma, Primo will replace the Show More Loans link with the Refresh List link, which allows the user to display the updated loans list from Alma.

If this functionality is disabled, all of the loans display on the My Library Card > Loans List page.

To disable paging in Primo:

On the Primo Home > Advanced Configuration page, select All Mapping Tables.
The All Mapping Tables page opens.
Select Edit in the row containing the ILS Adaptors Templates table.
In the Service Name column, search for get_loans.
For each of the rows that contain an Alma Adaptor ID (such as ALMA_01), remove the text in shown in bold in the Call Template column:
{{api_base}}/view/rest-dlf/patron/{{patron_id}}/circulationActions/loans?lang={{lang}}&view=brief&type={{type}}&institution={{ils_user_institution}}&noLoans={{noItems}}&startPos={{startPos}}
Save and deploy your changes to the mapping table.
For additional configurations associated with paging, refer to the description of the Bulk Definition mapping table in Front End Subsystem.

Configuring the Sort Direction for List of Loans

The primo_loan_list_sorting customer parameter allows you to configure the direction in which loans are sorted in Primo My Library Card > Loans. By default, the loans are listed in descending order by due date. You may sort them in ascending order by due date if you prefer.

To configure other settings, you must have one of the following roles:

General System Administrator
Fulfillment Administrator

To change the sort direction of the loans in My Library Card:

Set primo_loan_list_sorting to ascending or descending (see Configuring Other Settings). By default, the loans in the list are sorted in descending order by due date.