输入格式

按以下方式指定 Text API 的输入：

在命令行界面中，输入通常在传递给 pdm_text_cmd 命令的文本文件中指定。
在电子邮件界面中，输入在电子邮件的文本中指定。可指定正则表达式来查找目标对象标识符。

无论使用哪一种界面，您都用相同的方法设置 Text API 输入的格式。

输入的基本格式如下：

%关键字=值

或

%PROPERTY={{属性标签}}值

Text API 命令的典型行为具有以下例外（其中最后出现的两个或更多个冲突命令优先）：

当消息中包含匹配邮箱规则筛选字符串的多个有效故障单 ID 印证码，或包含多个 Text API 故障单 ID 命令时，将使用遇到的第一个。此外，无论显示的第一个项是什么，使用邮箱规则筛选字符串标识的故障单 ID 印证码会覆盖任何 Text API 故障单 ID 命令。
当消息中包含多个日志注释 Text API 命令时，将发布所有注释，尽管这些注释出现在故障单活动日志中的顺序各异。

无论匹配筛选的所有故障单 ID 印证码是否有效，以及消息内的 Text API 故障单 ID 命令是否适用或应用，都会在发布消息前进行注释。通过邮箱规则筛选确定的故障单 ID 印证码显示为 - ((...)) -。Text API 故障单 ID 命令中的起始百分号 (%) 将转换为两个左括号“((”，而命令后将附加两个右括号“))”。如果某个 Text API 故障单 ID 命令出现在带有日志注释 (%LOG=...) 的另一个 Text API 命令之后，则已注释的 Text API 故障单 ID 命令将成为独立的日志注释。

注意：日志注释是唯一可以在一条消息中出现多次并且应用所有各出现实例的 Text API 命令。对于任何其他命令，Text API 仅使用最近一次出现的命令，因为这些命令的多个实例间相互发生冲突。多个日志注释命令将独立日志注释消息发布到故障单中，不一定按任何特定顺序发布。

此外，如果 Text API 故障单 ID 命令出现在消息的开头或两个其他 Text API 命令之间，它将转换为日志注释。如果前一个命令是日志注释 (%LOG=...) 或更新说明 (%DESCRIPTION=...)，则会将其附加到该命令，而不是成为独立的日志注释。

不包括纯文本版本的仅以 HTML 格式发送的传入消息会丢失其消息正文。如果消息将任何邮箱规则筛选与空消息正文进行匹配，则可以创建具有空说明或以两边带引号的消息主题作为故障单说明整体的一个故障单。