Emailed Letters
- Chris Lee
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 |
|---|---|
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 |
|---|---|
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 |
|---|---|
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 |