Emailed Letters

Most of the the notification letters used by Rapido are the same letters used by traditional Alma Resource Sharing. Your current CSU+ emails all still work for the same functions and don’t require updates. For functions the CSU will be using for the first time the following letters could use some updating. To edit the letters go to Configuration → General → Letters → Letters Configuration and search for the following letters:

Document Delivery Notification Letter

This letter goes out to patrons whenever a digital Resource Sharing request is delivered from another library through RapidILL. It is designed to give the patron a link to download the full request, but by default has three links. Different libraries will find different links useful depending on their local configurations, but generally wont want all three links. In our testing it looks like most CSU libraries use SAML to authenticate, but this may not be the case at every library. I recommend deleting or disabling the code for two of the three following links:

Links

You will want to delete or disable two of the following three links. If all three are removed the patron will not have a link to download the article or book chapter they requested.

local/LDAP

This link is for institutions that use local/LDAP. the following code generates the link:

<xsl:if test="notification_data/download_url_local != ''"> <tr> <td>@@for_local_users@@<a> <xsl:attribute name="href"> <xsl:value-of select="notification_data/download_url_local" /> </xsl:attribute>@@click_here@@</a> </td> </tr> </xsl:if>

If this is not the link you want to use delete the above code or disable it by inserting <!-- on a line before the code and --> on a line after the code. The resulting code would look something like this:

<!-- <xsl:if test="notification_data/download_url_local != ''"> <tr> <td>@@for_local_users@@<a> <xsl:attribute name="href"> <xsl:value-of select="notification_data/download_url_local" /> </xsl:attribute>@@click_here@@</a> </td> </tr> </xsl:if> -->

SAML

This link is for institutions that use SAML. the following code generates the link:

<xsl:if test="notification_data/download_url_saml != ''"> <tr> <td>@@for_saml_users@@<a> <xsl:attribute name="href"> <xsl:value-of select="notification_data/download_url_saml" /> </xsl:attribute>@@click_here@@</a> </td> </tr> </xsl:if>

If this is not the link you want to use delete the above code or disable it by inserting <!-- on a line before the code and --> on a line after the code.

CAS

This link is for institutions that use CAS. the following code generates the link:

If this is not the link you want to use delete the above code or disable it by inserting <!-- on a line before the code and --> on a line after the code.

Labels

The wording of the links is unnecessarily confusing to patrons. Most patrons wont car is the link is SAML or CAS, they just want to download the article or book chapter. To change the text next to the link go to the Labels tab in the Document Delivery Notification Letter and edit the text that appears next to the link you want to use. You will want to disable the following Labels to remove the text without deleting it.

  • for_cas_users

  • for_saml_users

  • for_local_users

Additional changes may also improve the letter. The following customizations were developed by @Christina Hennessey (Unlicensed).

Code

Description

Code

Description

department

Interlibrary Loan (or Resource Sharing)

click_here

Click here to download the resource.

to_see_the_resource

Click here to download the resource.

Bcc

(Email of Staff wishing to be notified when this letter is sent)

letterName

Requested Item Delivered Electronically

subject

Requested Item Delivered Electronically

addressFrom

(ILL Department Email)

Additional Changes

This letter is fairly bare bones so you may want to make additional changes to make it match your other letters. These changes would be unique to each institution. If there is a specific part you want assistance updating you can contact the Resource Sharing Manager at cwlee@calstate.edu.

Some common additions libraries have added to the letters include:

External ID:

To add the External ID post this code into the XSLT:

Email Address Link:

To add a link to the department email address add this code to the XSLT and replace “EMAIL” with your desired email address:

Ful Digitization Notification Item Letter

The Ful Digitization Notification Item Letter generates an email when a digital item is delivered to the patron from their own institution in a practice commonly referred to as Document Delivery in the Resource Sharing community. Document Delivery is when a library will scan or download materials for their own patrons. In Alma they refer to this practice as Digitization.

Unlike the Document Delivery Notification Letter this letter does not have a link to the resource, instead the file is included as an attachment.

There are no recommended changes to this letter except to review it and make adjustments to make it fit the style at your institution.

Labels

This letter could use some updating to its Labels. The following Labels were developed by @Christina Hennessey (Unlicensed).

Code

Description

Code

Description

department

University Library

request_type_digitization

Request Type: Digitization

sincerely

Sincerely,

addressFrom

donotreply@csunlibrary.edu

Change Rapido Request Terms Letter

This is a new letter that sends an update when the estimated terms of the request are changed. When patrons request an item in Rapido they see an estimate on the delivery time and checkout period. For example, items available through the CSU+ pod give an estimate for delivery within three days and a checkout period of 112 days.

Sometimes the estimate changes when a request is rejected by the Lending library in Rapido. The request could move to a library in the same pod but restart the estimate clock or move to an entirely new pod with different estimates. Maybe no one in the CSU actually has the item available to loan so it moves to the US West Pod or USA Pod with a seven day delivery estimate. This letter updates the patron on the change in delivery and checkout estimates so they can manage their expectations.

Currently there are no standard recommendations for this letter, but I do encourage you to review the wording to ensure it matches your library’s style.

Labels

The default labels in this letter are awkward and vague so @Christina Hennessey (Unlicensed) is sharing her customizations so you can use them if you wish:

Code

Description

Code

Description

costToPatron

, cost

costIsUnkown

, cost is unknown

header

Hello:

deliveryNotExist

Delivery days is not yet determined, keep for

from

From terms: Deliver in

unknownTerms

From terms: No known terms

Bcc

(Email of Staff wishing to be notified when this letter is sent)

end

Please contact the library with questions or concerns at (ILL Department Email).

signature

Sincerely,

prevTermsNoValid

The previous request terms are no longer applicable because the lender was unable to fulfill the request.

termsChange

The terms of the request have changed due to a change in the lending library.

to

To terms: Deliver in

toUnknownTerms

To terms: No known terms

pickupLocationChanged

Unfortunately, we can't supply the requested item from our network, therefore, the pickup location of the resource changed from

weWillUpdate

We will update you with more information once we have it from the lender.

start

We would like to notify you of a change to the following resource sharing request:

addressFrom

(ILL Department Email)

keepFor

business days, keep for

loanPeriodNotExist

days, loan period is not yet determined