占位符是您在电邮通知的主题和正文中添加的对工单、用户和 自定义 数据的引用。没有它们就无法创建自动消息。在指定占位符时，请注意它们区分大小写。有关占位符的完整列表，请参阅 Zendesk Support 占位符引用。
Support 包括在某些情况下禁止在工单触发器中使用占位符的系统工单规则。系统工单规则是无法更改、修改或覆盖的预定义规则，它规定了 Support 的标准行为。这些规则有时可能会使工单触发器中的占位符看似无法正常工作，但这并不是错误。这些规则为您提供保护，因为它们可以防止垃圾邮件发送者使用您的帐户分发垃圾邮件。请参阅了解占位符禁止规则。
相关文章：
在业务规则中使用占位符
占位符可用于某些（但不是所有）业务规则操作。当占位符受支持时，字段下方会显示查看可用占位符按钮。占位符采用匹配的双花括号格式，通常用在通知消息和引用工单属性中。如果占位符引用了没有值的字段，则占位符在自行程序、触发器或宏中为空白。
以下是在电邮通知中如何使用占位符的示例：
如需查看占位符的完整列表以及可以使用的位置，请参阅 Zendesk Support 占位符引用。如果您想对占位符数据的选择和显示方式进行更多控制，请参阅了解 Liquid Markup。
在宏中使用占位符
当您将包含占位符的宏应用到工单时，将根据工单当前的真实情况对占位符进行评估。如果评估的输出返回任何信息，则将其添加为工单评论。例如，如果在一张未保存的工单（因此还没有工单号）上运行返回工单 ID 的宏，则工单评论不会更新。保存工单时不会重新评估宏。您可以使用占位符 {{ticket.id}} 手动添加占位符到工单。这将允许您在提交工单时对其进行评估，并将占位符返回的值添加到工单评论中。
在故障工单和事务工单中使用宏时，通常需要使用反斜杠 (\) 对占位符进行转义，以便在相关事务工单中填充适当的值。例如：Hello
\{{ticket.requester.first_name}}
对自定义字段使用占位符
占位符根据工单、当前用户和自定义对象属性自动生成。这些被称为“系统占位符”。
当您添加工单、用户、组织和自定义对象的自定义字段时，它们也可用作占位符。您可以像使用任何其他系统占位符一样，将占位符用于自定义字段。每个自定义字段都有一个唯一的 ID 或密钥。当您创建自定义工单字段时，系统会自动为您生成 ID。在创建自定义用户、自定义组织或自定义对象字段时，您需输入唯一密钥，该密钥一旦设置后就无法编辑。
自定义字段不包含在可用占位符列表中，但所有自定义字段（下拉列表除外）都遵循引用其唯一 ID 或密钥的简单命名模式。
| 工单自定义字段 | {{ticket.ticket_field_<field ID number>}} |
| 用户自定义字段 | {{ticket.requester.custom_fields.<field_key>}} |
| 组织自定义字段 | {{ticket.organization.custom_fields.<field_key>}} |
| 自定义对象字段 | {{custom_object.<object_key>.custom_fields.<field_key>}} |
例如，像这样的自定义工单字段具有以下占位符：
{{ticket.ticket_field_505156}}
查找自定义工单字段的 ID
-
在管理中心，单击侧栏中的对象和规则图标 (
)，然后选择工单 > 字段。在列表中查找您的字段。ID 显示在字段 ID 列中。
查找自定义用户字段或自定义组织字段的密钥
)，然后选择配置 > 用户字段。
查找自定义对象字段的密钥
- 在管理中心，单击侧栏中的对象和规则 ()，然后选择自定义对象 > 对象。
- 单击对象的名称。
- 单击字段标签。
- 在列表中找到相应字段，然后查看字段密钥列中显示的值。
对自定义下拉字段使用占位符
自定义下拉列表中选项的占位符名称遵循不同的模式。所有四个下拉列表选项只有一个占位符，因为这是对已选择选项的引用。此 ID 用于自定义下拉列表，因为选项没有 ID。同样，这是对已选择的单个选项的引用。
| 工单自定义下拉字段 工单自定义多选字段 |
|
| 用户自定义下拉字段 | {{ticket.requester.custom_fields.<field_key>.title}} |
| 组织自定义下拉字段 | {{ticket.organization.custom_fields.<field_key>.title}} |
| 自定义对象下拉字段 | {{custom_object.<object_key>.custom_fields.<field_key>.title}} |
例如，自定义工单字段的下拉列表占位符如下所示：
{{ticket.ticket_field_option_title_515416}}
对自定义查找关系字段使用占位符
查找关系字段是一种自定义字段，用于定义对象之间的关系。所有标准 Zendesk 对象（工单、用户和组织）和自定义对象都支持它们。
除了使用占位符显示与主要对象相关的数据（例如工单请求者的姓名）外，您还可以使用占位符显示相关记录中的数据。例如，如果您有一张工单，其中的查找关系字段指向用户，您可以使用占位符来引用关于该用户的数据。同样，您可以使用占位符通过自定义对象的查找关系字段引用工单数据，反之亦然。就这些占位符而言，标准工单请求者和组织字段将被视为查找关系字段。
要引用相关记录中的数据，请使用查找关系字段的字段键。这将遵循自定义字段的模式。请参阅示例。
您还可以使用查找关系字段中的目标对象支持的占位符。例如，指向用户的查找关系字段可以使用用户数据占位符。
通过工单查找关系字段引用数据的占位符可用于工单触发器和宏。通过自定义对象查找关系字段引用数据的占位符可用于对象触发器。
使用占位符从相关记录中检索数据的示例
使用工单请求者字段
例如，工单中的请求者字段在功能上是一个指向用户的查找关系字段。如果您已定义一个用户查找关系字段，其中字段键管理者指向另一个用户，则可以使用以下占位符来显示资产请求者的管理者姓名：
ticket.requester.custom_fields.manager
由于您正在处理工单请求者字段，您还可以更进一步，使用以下占位符创建一封发送给工单请求者的管理者的协作快捷对话电邮：
ticket.requester.custom_fields.manager.email
这非常适用于批准工作流程，因为您可能需要通知管理者或得到管理者的批准。
使用自定义组织查找关系字段
组织字段是另一个标准工单字段，其在功能上是一个指向组织的查找关系字段。您可以使用组织查找关系字段将组织与名为合同的自定义对象关联。然后，您可以利用工单的组织字段从与组织关联（组织本身与工单关联）的合同记录中检索数据，并使用以下占位符来传达合同的结束日期：
{{ticket.organization.custom_fields.contract.custom_fields.end_date}}
请求者和组织工单字段都属于特例，因为它们是用作查找关系字段的标准工单字段。因此，您可以使用查找关系字段占位符进行两次“跳”，以检索与主要对象相关的记录。在上面的例子中，工单是主要对象，工单的组织是第一次“跳”，与组织相关的合同记录是第二次“跳”。
在处理自定义查找关系字段时，只能“跳”到与主要对象直接相关的记录一次。
使用自定义查找关系字段
使用自定义查找关系字段的一个例子是工单查找关系字段，其字段键为 2698798899085，指向名为订单的自定义对象。订单对象有一个自定义下拉字段，其字段键为 order_status。要引用与工单关联的订单记录的状态，请使用以下占位符：
{{ticket.ticket_field_2698798899085.custom_fields.order_status.title}}
当使用下拉字段时，您必须在占位符中包括 .title 以返回选定的值。
对自定义复选框字段使用占位符
您可结合使用占位符和 Liquid Markup 来验证工单是否已选中复选框（自定义字段），并根据复选框状态（已选中或未选中）提供自定义输出。
当您对复选框自定义工单字段使用 Liquid Markup if/else/case 语句时，请记住复选框字段的值为 0 或 1，而不是 false 或 true。例如：
{% if ticket.ticket_field_<insert field_id here> contains 1 %}
checkbox is checked
{% else %}
checkbox is unchecked (or null)
{% endif %}
0 条评论