跨信件重用组件

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

要配置组件，你必须具有以下角色之一：

通用系统管理员
信件管理员

每个信件都可以包含跨字母使用的通用组件，例如页眉、页脚等。这使您能够在一个位置定义（和更新）通用组件。例如，您可以定义所有信件的通用页面，其中包括公司徽标。将来，如果您在“组件配置”页面中更改徽标的格式（例如其对齐方式），则该更改将自动应用于使用该组件的所有信件。有关配置这些通用信件的信息，见配置Alma信件。

对组件所做的更改会影响所有信件。因此，建议在保存之前仔细检查更改。

访问“组件配置”页面

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

Components Configuration.png

组件配置

配置组件标签

您可以使用组件标签来编辑信件，而无需编辑实际的XSL模板。例如，如果您希望信件中注明“联系图书馆”而不是“联系我们”，可以在标签中进行更改。

如何更新标签：

在“组件配置”页面中，选择组件行操作列表中的编辑。
点击标签按钮。请注意，如果组件没有标签，则标签按钮将被禁用。
选择自定义以便编辑标签。
根据需要更新标签。您还可以使用以下选项：
- 语言更改 - 如果配置了另一种语言，可以编辑翻译字段。
- 恢复 - 如果修改了行，启用和描述恢复到默认设置。
- 恢复翻译 - 如果配置了其他语言且修改了翻译标签，字段恢复到默认设置。
完成后选择保存。
您可以通过选择启用列中的开关来启用或禁用标签。

自定义组件模板

您可以查看和编辑用于格式化组件和决定哪些字段和文本显示在信件中的模板（XSL样式表）。配置模板以自定义信件中显示的标签和数据以及它们的显示方式。此外，您可以使用XSL条件声明决定在信件中显示哪些内容，即使信件已发送。有关示例，见How to configure a letter to not be sent under certain circumstances.docx。

要自定义组件模板（XSL样式表）：

在“组件配置”页面上，选择相关组件行操作菜单上的编辑。
根据需要编辑XSL面板中的信息。

该页面可用的字段为与组件关联的标签，且XML字段由Alma生成。
- 使用substring和string-length函数输出代码的最后四位数字：
  <b>@@requested_for@@ :*****
  <xsl:value-of select="substring (notification_data/user_for_printing/identifiers/code_value/value,string-length(notification_data/user_for_printing/identifiers/code_value/value) - 3)"/></b>
- 如果以下代码段在SenderReceiver.xsl文件中的地址行之后，您可以确保用户的电话号码包含在使用此模板的所有信件中。
  <tr>
  <td><xsl:value-of select="notification_data/user_for_printing/phone"/></td>
  </tr>
- 通过在<html>标记之后添加以下内容，将样式表的名称显示为输出中的隐藏文本。
  <html> <xsl:attribute name="data-filename"> <xsl:value-of select="/notification_data/general_data/letter_type"/> </xsl:attribute>
  
  输出将包括以下内容：
  
  <html data-filename=”FulLoanReceiptLetter”> ...
可以使用Ctrl+Shift+f实现Prettyprint（转换并显示带有换行符和缩进的XSL源代码，以使代码更易于阅读）。
选择保存草稿，将您的自定义保存为草稿。在选择保存之前，草稿中所做的更改不会应用到组件。在草稿模式下，草稿水印显示在XSL面板中。请注意，一旦选择“保存”，更改将应用到使用此组件的所有信件。选择删除草稿以擦除草稿并显示上次保存的XSL。选择恢复将XSL恢复到其原始状态。请注意，当草稿处于有效状态时，组件的行操作菜单中会提供编辑草稿和删除草稿选项。
要预览更改，请查看使用此组件的信件。
要预览对组件草稿执行的更改：
1. ，访问使用此组件的信件。
2. 在信件中，通过添加_DRAFT至相关的<xsl:include href="" />语句来更新XSL，如下例所示：
  <xsl:include heref="footer.xsl_DRAFT"/>
3. 预览面板现在将显示草稿组件（本例中为更新的页脚），以便您查看更改。
4. 更改完成后，从include语句中删除_DRAFT后缀：
  <xsl:include heref="footer.xsl"/>
选择保存将更改应用于组件，即使用更新覆盖当前的XSL。这也将删除草稿水印。现在，更改将应用于使用此组件的所有信件。请注意，保存后，该信件仍保留在预览窗口中。要返回完整的信件列表，请选择取消。

组件列表

下表列出Alma中可用的组件。

信件组件

信件

描述

checksum_calc.xsl

内部使用

footer.xsl

定义用于所有电子邮件信件的页脚文本。在通用 > 通用配置 > 其他设置中定义以下内容：

参数值	参数键
contact_us	email_contact_us
my_account	email_my_account

header.xsl

定义所有信件电子邮件的页眉（例如机构标志，信件名称和日期）。

mailReason.xsl

定义大多数信件中使用的问候语（如尊敬的先生/女士）。以下将会对名为John Smith的用户显示Dear John Smith：

<xsl:template name="toWhomIsConcerned">
<table cellspacing="0" cellpadding="5" border="0">
<tr>
<td>
<xsl:for-each select="notification_data">
<h3>@@dear@@  <xsl:value-of select="receivers/receiver/user/first_name"/> <xsl:value-of select="receivers/receiver/user/last_name"/></h3>
</xsl:for-each>
</td>
</tr>
</table>

recordTitle.xsl

定义用于信件电子邮件中的书目详情的文本。

senderReceiver.xsl

定义所有信件电子邮件的地址信息。该组件使用<xsl:value-of select="notification_data/user_for_printing/name"/>，根据用户名称显示中的配置填充。但是，user_for_printing也包含名字和首选名字值，所以可以配置得不一样。例如，以下为活动报告XML的user_for_printing：

<first_name>Ford</first_name>
<identifiers><code_value><code>Primary Identifier</code>
<value>fprefect</value>
</code_value>
<code_value><code>BARCODE</code>
<value>11223344</value>
</code_value>
</identifiers>
<last_name>Prefect</last_name>
<middle_name></middle_name>
<name>Prefecta, Forda</name>
<phone></phone>
<postal_code></postal_code>
<preferred_first_name>Forda</preferred_first_name>
<preferred_last_name>Prefecta</preferred_last_name>
<preferred_middle_name></preferred_middle_name>

SMSRecordTitle.xsl

定义用于短信中的书目详情的文本。

style.xsl 信件

定义用于所有信件电子邮件的CSS。