实施策略 › 策略实施 › 通知 › 如何配置邮箱以处理入站电子邮件 › 邮箱 › 邮箱规则字段 › 印证码使用注意事项

印证码使用注意事项

电子邮件印证码是指由邮件进程生成的内容，例如，包括在转发电子邮件中的电子邮件地址。Text API 使用包含故障单 ID（如引用编号）的印证码提供回复支持。当找到故障单 ID 时，系统将设置现有的 Text API 关键字（如 %INCIDENT_ID），并将其添加到 Text API 的输入。Mail Eater 通过在消息中查找印证码来确定回复与特定的故障单相关联。

通过邮箱规则，您可以指定 Text API 使用的印证码和值。例如，可以将突发事件的规则定义为 Incident:{{object_id}}%。当规则找到 Incident:1234 时，Text API 将使用 %INCIDENT_ID=1234（1234 是突发事件的 ref_num）。因为印证码在电子邮件中必须唯一且很容易找到，所以您可以使印证码更与众不同，如 %Incident:{{object_id}}%。{{object_id}} 之后必须有百分比符号 (%)、空格或无法在印证码值中显示的其他某个字符。大写和小写字母、数字、斜杠、逗号以及加号符号可以是值的一部分。安全的印证码在加密之后具有 Base64 编码形式。如果不使用安全印证码，则印证码后面的字符不得包含在为该类型故障单配置的故障单 ID 后缀（如果有）中。

当使用邮箱规则的筛选字符串来识别故障单 ID 印证码时，关键字 {{object_id}} 表示故障单 ID 印证码在筛选字符串中的预期位置。此关键字区分大小写，即使邮箱规则不区分大小写也是如此。

示例：电子邮件印证码的使用

以下示例显示用于变更请求故障单的邮箱规则中的印证码格式。

用法：%REQUEST=@{call_req_id.ref_num}%

示例：%REQUEST=1234%

构建邮箱规则的筛选字符串时，请考虑以下事项：

• 在故障单 ID 印证码与其前后的相邻关键字之间必须存在明显的边界。我们强烈建议您在此边界文本中包括空白符文本。
• 请不要以可重复或可选模式（可能匹配故障单 ID 印证码的开头）结束筛选字符串中 {{object_id}} 关键字前面的相邻部分，也不要以长度不定的模式结束该部分。例如，筛选字符串不能包含 request(er|ed|ing)?{{object_id}}，因为这种构造会导致歧义，即尾随的 er、ed 或 ing 是前导文本的结尾，还是不受保护故障单 ID 的前缀组成部分。
• 筛选字符串中 {object_id}} 关键字后面的相邻部分不能以可重复或可选模式（可能匹配故障单 ID 印证码的结尾）开始，也不能以长度不定的模式开始，而且必须至少包含一个空白元素。例如：
  • 筛选字符串不能包含 {{object_id}}[A-Z]?，因为 [A-Z]? 可能匹配故障单 ID 印证码的最后一个字符。
  • 筛选字符串不能以 {{object_id}}Item 结束，因为 Item 可能会出现在故障单 ID 印证码中：作为纯文本或受保护印证码中故障单 ID 的后缀，或者作为安全印证码中的字符。
  • {{object_id}} Item 是可接受的，因为空格不可能是故障单 ID 印证码的一部分，且不是受保护的或纯文本故障单 ID 印证码的组成部分。但是，{{object_id}}[ \t\r\n]+Item (左括号, 空格, 反斜杠, t, 反斜杠, r, 反斜杠, n, 右括号, 加号, +Item) 更好，因为 [ \t\r\n]+ 会补偿在 {{object_id}} 之后插入换行符的邮件程序。
• 在为不同邮箱规则构建筛选字符串时，请避免使用完全包括其他邮箱规则筛选字符串的筛选字符串，或避免使用其 {{object_id}} 关键字之前或之后的部分完全包括其他邮箱规则筛选字符串中对应部分的筛选字符串。适用于一个筛选的消息匹配项可能匹配另一个筛选，而故障单 ID 印证码的某一部分与区分这两个筛选字符串的其他文本相匹配，这要取决于这些筛选的检查顺序。