mapp Services V5.16
定义文本源
为每个配置的 事件创建一个条目 。该条目由mapp Audit 管理，并位于内存中。为了存储尽可能多的条目，当一个新事件发生时，不会使用不必要的内存。例如，只保存事件的原始数据（事件类型、新值、旧值、索引、注释等），而不是其整个文本。只有当数据被导出或准备用于HMI应用时，才会从原始数据中生成一个可读条目。事件文本可以来自不同的来源。文本的来源在 MpAuditTrail配置中的 "文本来源 "中定义 。该来源可以定义为文本系统（"TextSystem"）、基于 VC4 的 HMI 应用程序（"VC4"）或配置（"None"）。
None
如果选择 "None"，事件文本将直接在配置中的 "输出格式 "下指定。该文本用于发生的每个事件。
VC4
如何在基于VC4的HMI应用程序中定义事件，将在 VC4作为文本源一节中说明 。
文本系统
如何使用文本系统配置事件，在 作为文本源的文本系统一节中进行了说明 。
定义事件文本
每个事件都有一个定义的事件ID。MpAudit通过这个ID来识别该事件。食谱系统中的事件 mapp Recipe 有48个ID，报警系统中的事件 mapp AlarmX 的ID为33，以此类推。每个事件的ID都列在 事件类型 的描述中 。这个ID可以用来定义事件文本。
除了ID之外，一个事件还提供了可以在事件文本中使用的标记符。报警系统中的事件 mapp AlarmX 提供标记 "name "或 "msg"，例如。代币 "name "代表报警的名称；"msg "代表报警信息。这意味着事件文本可以根据事件的情况提供额外的信息。
事件文本中的标记是以特定格式指定的。可以使用新格式或旧格式。当使用新格式时，标记被指定在带有&符号的大括号中。在旧格式中，使用方括号和%符号。
例子
本例中使用了一个 报警事件的 标记。
•新格式
•Alarm: {&name}, Previous state: {&stold}, New state: {&stnew}
•旧格式
•Alarm: [%name], previous state: [%stold], new state: [%stnew]
例如，如果事件文本被评估，事件文本 "Alarm: TempHigh, previous state: Active, new state: Inactive" 可以显示。
有关该格式的其他信息，请参见 使用新格式一节 。需要注意的是，只能使用一种格式。新格式（"{&msg}"）不能与旧格式（"[%msg]"）一起使用。
对于某些事件，可以包括单位信息。有关其他信息，请参阅 显示变量的单位。
为一个条目添加时间
与此原理类似，也可以在条目中添加时间。
新格式（文本系统作为文本来源）：
{&evtime[TIME=format]}
旧格式：
[%[TIME=format]]
"format" 指定时间的显示方式。
Token |
说明 |
%u |
使用UTC时间（否则将使用当地时间）。 |
%H |
24小时格式的小时。如有必要，可使用前导零。00 - 23 |
%I |
12小时格式的小时。如有必要，可使用前导零。01 - 12 |
%k |
24小时格式的小时。0 - 23 |
%M |
一小时内的分钟数。如有必要，可使用前导零。00 - 59 |
%S |
一分钟内的秒数。如有必要，可使用前导零。00 - 59 |
%L |
一秒钟内的毫秒。如有必要，可使用前导零。000 - 999 |
%z |
当地转变为UTC时间 |
%s |
自1970年1月1日起的秒数 |
%C |
四位数的年份除以100。用两位数显示。如有必要，可使用前导零。00 - 99 |
%Y |
年份为四位数的数字。如有必要，开头为零 |
%y |
年的最后两位数字。如有必要，在前面加零。00 - 99 |
%m |
月份。如有必要，在前面加零。01 - 31 |
%d |
本月的一天。如有必要，可使用前导零。01 - 31 |
%e |
每月的一天。1 - 31 |
%R |
时间为24小时格式。"%H:%M" |
%T |
24小时格式的时间。"%H:%M:%S" |
%D |
日期以下列格式显示。"%M/%D/%Y" |
%F |
ISO 8601格式的日期。"%Y-%´m-%d" |
%c |
以下格式的日期和时间。"%F %T.%L" |
在"="字符之后如何显示时间，可以自由选择。上面列出的几个Token也可以一起使用。举几个例子。
新格式
当被写为, "{&evtime[TIME=%u%R]} Operator ({&op}) generated an event." 可以看起来像这样: 2014-12-05 15:35:20.234 Operator Andy generated an event.
当被写为, "Event at {&evtime[TIME=%Y-%m-%d %H:%M]} local time" 可以看起来像这样: Event at 1990-25-03 12:35 local time.
旧格式
当被写为, "[%[TIME=%u%R]] Operator [%op] generated an event." 可以看起来像这样: 2014-12-05 15:35:20.234 Operator Andy generated an event.当被写为, "Event at [%[TIME=%Y-%m-%d %H:%M]] local time" 可以看起来像这样: Event at 1990-25-03 12:35 local time'
使用结构 MpAuditTrailUIOutputType在HMI应用程序中可见的事件文本 限制为100个字符。
如果选择VC4或文本系统作为文本源，并导出事件列表，那么在文本系统或HMI应用程序中定义的文本可以读出，最大长度为200字符。单独添加的事件（[user]、[message]、[ev]等）的长度也可以是200。时间戳（[time]）限制在80个字符以内。
在VC4中的例子。
|
由此产生的字符串在导出文件中可以有任何长度。
如果单个文本输入超过200个字符（见上图），那么{Err:Overflow}将显示在导出的文件中。
本节的主题：