View Central Repository on Github

View XSLT Letters Description Spreadsheet

View our FAQ page for Common Questions you may have about editing letters

XSL Letter Editing Quick Guide

From the Functional Call on Letters Located Here.

 How does the editing process work for letters? How do you get a copy of a specific letter to see how it looks? 

Customizing Text Elements / Label
Administration > General Configuration > Configuration Menu > General Configuration > Letter Emails
Actions → Edit on the letter that you want to change
Open Footer..xsl
You can customize the email addresses (or URL) to which the Contact Us and My Accountlinks are directed by modifying the parameter values of the email_my_account and email_contact_us parameter keys in the General Customer Parameters mapping table (Administration > General Configuration > Configuration Menu > Other Settings).

Customizing Look & Feel of Letters
Administration > General Configuration > Configuration Menu > General Configuration > Customize Letters
Note that other XSL template are calleds (e.g. Sender/Receiver and MailReason) that can be used to drill down to the specific point of customization
Note @@variable@@ which indicates that data is pulled from the text elements & labels area

To get a copy of a specific letter to see how it looks:
Two options:
Easy – do an activity in Alma that causes the email to be sent to your email address

Not as easy:
Navigate to Administration > General Configuration > Configuration Menu > General Configuration > XML To Letter Admin
Select a letter administrator from the dropdown and then select the letter for which you want to receive the XML
Do an activity in Alma that would generate the letter (Example: Cancel a RS request)
You can also utilize the XML of letters found on the Developers Network

Note from task force: This list is not complete, you will have to generate many of the letters on your own. To learn how to test the xml output of a specific letter, use this page. 

Save the XML, navigate to Administration > General Configuration > Configuration Menu > General Configuration > Notification Template and upload the XML that was sent, choose whether to receive in email or view in browser

Background

Problem: there is no centralized repository for all CSUs to learn how to edit the XSL in their letters

Policy Statement

This statement applies to all notification letters sent to patrons that are listed in the general configuration area in Alma. 

Best practice recommendations

While we understand that everyone has differing ideas of what their letters should look like, we recommend that everyone use this repository for help in editing their letters as it will provide a more cohesive look and feel for all CSU Libraries. This will make it easier for the group to troubleshoot any potential issues and provide resources for those who are not comfortable editing the letters on their own. 

• We suggest these areas to begin learning xsl: 

  http://www.w3schools.com/xml/xsl_intro.asp

  http://www.tizag.com/xmlTutorial/xslttutorial.php

  http://libraryjuiceacademy.com/019-intro-xml.php

  http://gandhimukul.tripod.com/xslt/xslquality.html <--- program to judge the XSL quality of your letter

  
  
  
• We suggest you use whatever free software you have available for editing your letters. Most standard web development software will be good enough for working on customizing letters in Alma.   

  oXygen https://www.oxygenxml.com/xml_editor/xslt.html Note: oXygen is a really nice software product but we believe it's overkill for what most libraries will be doing.  

  Treebeard http://treebeard.sourceforge.net/ Free

  Notepad++ https://notepad-plus-plus.org/download/v7.1.html Free

• XSLT Customizations

  We are currently working on an XSL customizations spreadsheet that describes each letter and includes links to what each letter looks like.

Procedures in Alma

https://knowledge.exlibrisgroup.com/Alma/Product_Documentation/Alma_Online_Help_%28English%29/Administration/050Configuring_General_Alma_Functions/070Configuring_Alma_Letters

Action log