占位符是您在电邮通知的主题和正文中添加的对工单和用户数据的引用。没有它们就无法创建自动消息。在指定占位符时,请注意它们区分大小写。有关占位符的完整列表,请参阅 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>}} |
例如,像这样的自定义工单字段具有以下占位符:
{{ticket.ticket_field_505156}}
自定义下拉列表中选项的占位符名称遵循不同的模式。所有三个下拉列表选项只有一个占位符,因为这是对已选择选项的引用。此 ID 用于自定义下拉列表,因为选项没有 ID。同样,这是对已选择的单个选项的引用。
工单自定义下拉字段
工单自定义多选字段 |
{{ticket.ticket_field_option_title_<field ID number>}}
{{ticket.ticket_field_<field ID number>}}
注意:{{ticket.ticket_field_option_title_<field ID number>}} 占位符显示已选择选项的文本,而 {{ticket.ticket_field_<field ID number>}} 显示与已选择选项关联的工单标签。
|
用户自定义下拉字段 | {{ticket.requester.custom_fields.<field_key>.title}} |
组织自定义下拉字段 | {{ticket.organization.custom_fields.<field_key>.title}} |
例如,自定义工单字段的下拉列表占位符如下所示:
{{ticket.ticket_field_option_title_515416}}
查找自定义工单字段的 ID
-
在管理中心,单击侧栏中的对象和规则图标 (),然后选择工单 > 字段。
在列表中查找您的字段。ID 显示在字段 ID 列中。
查找自定义用户字段或自定义组织字段的密钥
对复选框自定义字段使用占位符
您可结合使用占位符和 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 %}