什么是信件标签

可以使用标签轻松编辑信件，而无需编辑实际的XSL模板。例如，如果希望信件声明“Item Description”而不是“Description”，则可以在标签中更改： 

信件中的标签

标签影响XSL中的@@代码，并且标签中的任何更改都会立即反映在预览中。然而，当自定义letterName标签时，为在预览中看到更新的信件名称，您需要使用相关业务流程再次生成信件。然后，在信件配置页面（配置 > 信件配置 > 信件示例 > 从系统信件添加）中，选择XML（它包含/notification_data/general_data/letter_name 中的自定义信件名称）。

如何配置信件标签

可以按如下所述配置特定信件的标签。 

1. 选择信件行操作列表上的编辑。
    
   
2. 选择位于页面顶部的标签按钮。
    
   
3. 从行操作菜单选择自定义。可以更新以下内容：
   • 启用 — 使用此切换按钮可激活/停用信件中使用的标签。
   • 描述 — 更新信件上显示的标签描述。
     请注意，在“描述”字段中不支持使用HTML标签。
   • 翻译 — 如果Alma中启用了另一种语言并在过滤器下拉列表中选择该语言，则可以编辑翻译。
      
     
      
   • 恢复 — 如果修改了行，启用和描述字段恢复到默认设置。
   • 恢复翻译 — 如果在Alma中启用其他语言且修改其翻译标签，则字段恢复到默认设置。
4. 点击自定义全部编辑所有行。
5. 选择全部恢复将所有行恢复为默认值。
6. 点击恢复默认翻译恢复所有翻译。
7. 完成后选择保存。对标签列表执行的任何更改都会保存，无论在主XSL预览页面上选择的保存/取消操作如何。
8. 可以在信件预览面板中查看更改。
    
   
9. 要禁用标签，见如何禁用Alma电子邮件信件中的行？

在主题标签中包含请求ID

一些信件可以在主题标签的描述栏中包含字符串%reqId%（发送给用户的电子邮件的主题）。生产信件时会被请求者ID取代。信件包含的选项有：

• Borrower Overdue Email Letter
• Externally Obtained Email Letter
• Ful Cancel Email Letter
• Ful Outgoing Email Letter
• Ful Renew Email Letter
• Lending Recall Email Letter
• 读者查询信件

如何自定义信件模板

Ex Libris客户支持可以对自定义XSL样式表相关问题进行协助。但是，他们排除故障的能力根据实际情况受限。如果样式表自定义部分过多，可能需要长时间的分析来找到错误。客户支持无法对全部自定义的样式表提供此类验证。解决此类情况的最佳方式是一次去除一个条件/测试/部分以确定哪里出现问题。

条件声明

有关如何使用条件声明的描述，见How to use the if condition to configure a letter to not be sent under certain circumstances.pptx。

XSL自定义的一般示例

读者查询信件自定义示例

外借活动信件自定义示例

此示例显示如何对外借活动信件电子邮件进行以下自定义：有关如何使用XSL自定义信件输出的一般示例，请见XSL自定义的一般示例。

1. 在读者识别页面（见管理读者服务），在扫描读者ID或检索读者字段输入读者姓名并点击执行。显示读者服务页面。
2. 在扫描单册条形码字段中，输入单册条形码，然后点击确定。单册在外借选项卡中列出。
3. 点击发送活动在电子邮件中发送XML输出。
4. 将电子邮件中的XML输出复制并粘贴到XML文件（例如BorrowingActivityLetter.xml）。

1. 在信件配置页面上，对于外借活动信件，编辑XSL文件（在XML面板中）。

2. 使用您之前创建的XML文件来确定包含图书馆名称的字段的完整路径名。

   
   XML输出中的库名称字段
   根据上图中的嵌套元素，图书馆名的完整路径如下：
   /notification_data/overdue_loans_by_library/library_loans_for_display/item_loans/overdue_and_lost_loan_notification_display/item_loan/library_name
3. 在XSL文件中搜索@@loans@@占位符，并添加xsl：if子句，如粗体文本所示，如下所示：
   ...
   <xsl:if test="notification_data/item_loans/item_loan">
   <xsl:if test="notification_data/item_loans/item_loan/library_name='Main Library'">
   <center>
   <span style="font-family:Arial; font-weight:bold">
   <FONT COLOR="#FF0000">
   <br></br><b> 请通过登录图书馆检查到期日期。</b>
   </FONT>
   </span>
   </center>
   </xsl:if>
   <tr>
   <td>
   <b> @@loans@@ </b>
   </td>
   </tr>
   ...
   Alma用关联的信件代码表中定义的标签/翻译来替换占位符。

4. 当您仍在编辑XSL文件时，将类型列添加到外借列表中。在XSL文件中的@@loans@@占位符下面，添加如下图所示的粗体文本。
   ...
   <b>@@loans@@</b>
   </td>
   </tr>
   <tr>
   <td>
   <table cellpadding="5" class="listing">
   <xsl:attribute name="style">
   <xsl:call-template name="mainTableStyleCss" /> <!-- style.xsl -->
   </xsl:attribute>
   <tr>
   <th>@@title@@</th>
   <th>Type</th>
   <th>@@due_date@@</th>
   <th>@@fine@@</th>
   <th>@@description@@</th>
   </tr>
   <xsl:for-each select="notification_data/item_loans/item_loan">
   <tr>
   <td><xsl:value-of select="title"/></td>
   <td><xsl:value-of select="material_type"/></td>
   <td><xsl:value-of select="due_date"/></td>
   <td><xsl:value-of select="fine"/></td>
   <td><xsl:value-of select="description"/></td>
   </tr>
   </xsl:for-each>
   ...
   通过检查XML文件来确定资料类型的XML字段。
   由于material_type代码在代码表中不可配置，所以不能对新的列标题使用占位符。

5. 选择保存。
6. 通过上传之前创建的XML文件来测试对XSL文件的更改（见更新和预览示例信件以进行测试）。

Customizing the Lending Recall Email Letter 

当单册被催还且必须归还或催还取消时，借出催还电子邮件信件将发送给借阅合作者。

已经自定义此信件并希望支持取消催还的机构（见管理借阅请求）必须按如下方式更新该信件。

从此：

至此：

在系统提醒和信件中使用用户首选名字

可以更新一些与名字信息关联的系统提醒和信件以使用用户的首选名字。对于与名称信息相关的系统通知和信件例如Mail Reason Letter XSL，可以使用preferred_first_name, preferred_middle_name, and preferred_last_name指定首选名字。见下例：

访问“组件配置”页面

组件配置页面（配置菜单 > 通用 > 信件 > 组件配置）使您可以自定义模板和其他信件共享的组件。与信件一样，组件由标签（静态文本字符串）和模板（用于格式化和动态数据的XSL样式表）组成。

配置组件标签

自定义组件模板

组件列表

信件模板概述

使用示例信件进行测试 

1. 访问配置 > 通用 > 信件 > 信件配置。

2. 在相关信件的行操作菜单中选择编辑。
3. 选择信件示例按钮。
    
   
    
4. 始终会提供默认信件，但可以添加更多示例，如下所述。

1. 在“信件示例”页面中，选择从系统信件添加按钮。请注意，如果此信件过去从未作为Alma流程的一部分发送，则从系统信件添加按钮将不会显示。
    
   
2. 此时将出现“已发送信件”页面，其中显示过去7天内的最多10封最新XML。
3. 选择要添加的信件。
   
4. 选定的信件出现在“信件示例”页面中。 
   
5. 选择保存。此信件现在将显示在XML面板中。 
6. 可以通过在下拉列表中选择相关信件在XML面板中的信件之间切换。
   
    

1. 在“信件配置”页面中，对于相关信件，在行操作菜单中选择编辑。
2. 在XML面板中，选择下载按钮。
3. 在XML编辑器中编辑文件以进行任何相关更改。
    
   
   将信件下载为XML文件
   XML编辑器上方引入一个下拉列表，显示所有可用的示例信件XML文件。用户可以从此下拉列表中选择一个选项来在各个文件之间切换。选择后，XML编辑器内容将替换为所选文件中的信息，并且信件预览会自动刷新。

1. 在“信件示例”页面中选择上传信件示例（XML）按钮。
    
   
    
2. 浏览并选择XML文件，然后选择上传。
3. 除非在默认预览列中选择，否则添加的信件不会标记为默认预览。 

设置From地址

From地址可以从addressFrom标签或“组织单位”页面进行配置，如下所述。

使用集成配置文件设置EnvelopeFrom地址

1. 在集成配置文件列表页面（配置菜单 > 通用 > 外部系统 > 集成配置文件），点击添加集成文件。Alma允许您仅定义一个邮件处理集成配置文件。如果已经有邮件处理集成配置文件，选择编辑编辑配置文件。
   
2. 为配置文件输入唯一的代码和名称。
3. 在集成类型字段中，选择邮件处理。
4. 选择下一步。显示向导第二页。活动选项默认选中。
   
   
5. 如果您要继续使用Alma邮件服务器：
   1. 选择从Ex Libris直接发送（默认选择）。
   2. 为SMTP EnvelopeFrom地址输入有效的电子邮件地址。
6. 要使用您机构的邮件中继服务器：
   1. 选择使用机构邮件中继发送。出现几个附加字段。
   2. 输入机构域名。执行此操作后，域名将在SMTP EnvelopeFrom地址字段后面显示为@<domain name>。该域名最多可以包含63个小写字母数字字符，破折号，以及后跟一个句点和两到六个字符的小写字母顶级域名。
   3. 输入机构SMTP邮件中继主机名。主机名可以包含小写字母数字字符以及 - ！# $ % & ' * + / = ?^ _ ` { | }或~和句点。
   4. 默认选定客户SMTP EnvelopeFrom地址。在该选项下的非标签字段中输入地址的用户名。这会将EnvelopeFrom设置为<username>@<domain name>。用户名可以包含与SMTP邮件中继主机名相同的字符。
   5. 如果邮件中继需要使用用户名和密码从Ex Libris接收电子邮件，请输入用户名和密码。这些可以是任何ASCII字符。
   6. 如果转寄需要加密，选择使用加密。
      加密端口设置为587。
7. 要使用MS Graph API发送邮件，请选择使用MS Graph API发送并填写出现的附加字段：
   • 租户ID - 为机构定义的Azure ID
   • 客户ID - 提供给Alma用于发送电子邮件的Azure ID 
   • 客户密钥 - Azure生成的用于验证用户的密码
   • 用户ID - 定义用于发送电子邮件的Azure用户
     
     有关详细信息，请见使用Microsoft Identity Platform注册应用程序和使用Microsoft Graph API从Alma发送电子邮件。
8. 选择保存。

关于邮件中继和支持域密钥识别邮件(DKIM)的Alma建议 

当SMTP服务器收到电子邮件时，其会执行多项安全检查以确定这是合法还是可疑的电子邮件。如果电子邮件标记为可疑，SMTP服务器可能会延迟电子邮件的传送，将电子邮件标记为“垃圾邮件”或完全不传送电子邮件。本文介绍如何确保来自Ex Libris云的电子邮件不会被标记为可疑。

可以通过以下两种方式之一从Ex Libris产品发送电子邮件：

1. 使用@exlibrisgroup.com的“发件人地址”域

2. 使用品牌的“发件人地址”，例如@institution.edu

目前上述两种方法均支持DKIM。从我们的云发送且“发件人地址”域为@exlibrisgroup.com的电子邮件不应标记为可疑，因为已使用DKIM对其进行签名，并且Ex Libris具有DMARC政策。请注意，SMTP信封的“发件人地址”和“header.from地址”必须使用相同的域。SMTP信封的“发件人地址”在邮件处理集成配置文件中配置，而header.from地址在发出的每封单独信件上配置。有关配置传出邮件的更多信息，请见此处。

如果您想要使用自定义域进行DKIM合规设置，建议的方法是以“使用机构电子邮件中继发送”选项配置Alma邮件集成配置文件，并在机构电子邮件中继上实施DKIM。 

从Ex Libris发送且带有该机构域品牌的电子邮件可以通过以下两种方式安全地实施：

1. 配置Ex Libris应用程序，将电子邮件直接传递到机构的SMTP服务器，以便根据机构的政策(DKIM + DMARC)进行身份验证。

   要配置Alma平台以将电子邮件传递到外部SMTP服务器，请见文档中的“配置邮件处理集成配置文件”（此处）。根据机构的防火墙政策，IT人员可能需要开放从Ex Libris云到SMTP服务器的相关端口访问。可以在此处找到Alma、Primo VE和Primo Classic的传出IP范围。

2. 配置要从Ex Libris云发送的电子邮件，并使用“发件人政策框架”(SPF)和DKIM进行身份验证。

   SPF是一种允许Ex Libris云代表机构发送电子邮件的方法。当SMTP服务器收到电子邮件时，其会执行安全检查，将发送电子邮件的IP与“发件人地址”域的DNS记录中列出的IP进行比较。要配置SPF，机构的DNS管理员需要将Ex Libris邮件中继IP添加到TXT记录中机构的域。Ex Libris邮件中继IP根据客户所在地区而有所不同，因此应选择相关的“SPF包含条目”。可以在此处找到不同地区的不同“SPF包含条目”。

   DKIM（域密钥标识邮件）是一种电子邮件身份验证方法，专门用于识别电子邮件中的欺诈性发件人地址，解决电子邮件欺骗问题。为您的机构激活DKIM功能后，邮件处理集成配置文件将支持传出电子邮件中的DKIM数字签名。配置说明可以在此处找到。

有关更多信息，请见传出电子邮件配置。

1. 选中DKIM设置复选框。这会创建密钥并将公共密钥上传至Ex Libris DNS。系统会显示包含CNAME详细信息的弹出窗口。

2. 从对话框复制CNAME并将其传递给您的IT人员，以便他们将其添加到您的DNS。

3. 在IT人员将CNAME添加到DNS后，选择测试DKIM DNS设置选项来进行测试。如果测试通过，将出现成功消息。如果测试因任何原因失败，则会出现一条包含失败详情的消息。 

4. 测试成功后，选择DKIM激活复选框。从此时起，发出的电子邮件将包含DKIM签名。