mapp Services V5.16
要求
以下行为应被检查并记录在应用程序中。
•用户通过基于VC4的HMI应用进行的影响关键参数的输入/更改（如速度的改变）。
•用户登录（包括失败的尝试），注销和用户管理的所有变化（创建新用户，编辑现有用户，例如，如果一个用户由于登录失败次数过多而被锁定）。
•机器硬件的变化（机械和电气，例如，如果一个X20模块从总线上被移除）。
最新的事件应该显示在HMI应用程序中。此外，事件不允许丢失。
解决方案
•组件列表
•MpAuditTrail （自有MpLink）。记录审计事件
•MpAuditTrailUI （来自MpAuditTrail的MpLink）。在基于VC4的HMI应用程序中显示最新的审计事件
•MpAuditVC4Event (MpLink from MpAuditTrail):读取基于VC4的人机界面应用程序中的值和变化事件（例如有人按了一个键）。
•MpAuditCustomEvent （来自MpAuditTrail的MpLink）。记录客户特定的事件（例如机器硬件的变化）。
•MpUserLogin （自有MpLink）。来自MpUser库的组件，用于记录用户的进出，将审计事件与当前登录的用户相连接；此外，所有涉及用户管理的事件都可以被记录。
连接图
使用mapp组件
MpAuditTrail 实现了主要的事件记录器。所有的事件都记录在一个环形缓冲器（数据对象）中。为了防止数据丢失，应该创建档案。这个档案必须由应用程序或用户导出。导出的内容存储在一个XML文件中。
MpAuditTrailUI 可以用来显示当前语言中记录的事件（为基于VC4的HMI应用优化）。记录环形缓冲区中的所有事件都可以用这个组件来显示。
MpAuditTrailVC4Event 是与VC4事件系统的连接。它从HMI应用程序中读取所有的事件，并对其进行过滤，以便审计跟踪只记录相关的和选定的事件（对于标记有用户ID的参数变化，见 下面检测VC4事件的设置 部分 ）。VC4事件包含用户、旧值和更改后的参数的新值。
MpAuditCustomEvent 组件可用于记录任何类型的事件。这取决于应用程序是否将此功能用于必要的目的。
MpUserLogin 是必要的，用于将数值变化事件与登录的用户联系起来。所有发生的事件都与登录的用户相联系。
配置
这个用例的配置看起来像这样:
前面提到的存档功能是在配置中定义的。这里还规定单个事件的文本来自VC4文本组。
用于检测VC4事件的设置
VC4事件系统必须被启用，以便在基于VC4的HMI应用程序中接收数值变化事件:
基于VC4的HMI应用中的每个参数，其数值变化应被检测到，都会收到一个单独的用户ID:
在每个参数有一个单独的用户ID后，必须创建一个描述，在参数变化时添加。该描述被添加到一个单独的全局文本组，然后在共享资源中被指定为VC4变化的文本来源。
这允许使用用户ID在HMI应用程序中确定变化。如果一个标记有用户ID的参数被改变，就会产生一个审计事件。为该审计事件指定的文本来自全局文本组。
单个事件的文本
审计线索中的条目将根据事件的不同而出现。例如，用户早上登录时的条目和速度从100毫米/秒增加到200毫米/秒时的条目看起来就不一样。
为了获得每个事件的可读信息，有必要在配置中为这些文本配置一个适当的来源（见上文）。本用例中的文本从VC4文本组中读取，根据配置，从文本组0中的文本索引0开始。从位置0的文本开始，其他文本组和它们的内容被引用。关于语法的确切解释，见 定义事件文本一节 。
上图显示了索引为0的文本组，它包含主事件的文本（索引0）。这是所有事件文本的起点。时间（[% [TIME = uR]]）和用户名（[% op]）会首先显示。可以为每个事件指定一个单独的文本 （[%ev $ [TEXT = 0]] 指的是文本组0和一个取决于 %ev的 文本索引 ），在用户名之后。为简单起见，单个事件文本与主要事件文本一起存储在同一文本组中。
每个事件的数据存储方式不同。
•2: User-defined actions (login, logout, etc.) - 一个定义的字符串（"user action"），后面是一个详细的文本，取决于发生了什么（[%Act $ [TEXT = 5]]）。然后这个文本来自另一个文本组（文本组5，文本索引取决于 %Act）。
•16: Value change - 显示一个定义的字符串（"Changed DP"）和一个描述性文本数据点（[% dpid $ [TEXT = g2]]）。参数 "g2 "是全局文本组 "DpDescription"，这在VC4事件中提到过。旧值（[%old]）和新值（[%new]）被显示。如果在VC4中使用下拉元素改变条目，那么原始数据将被选择文本（$ [TEXT =% sel]）所取代。
•18: User-specific event - 重定向到另一个文本组，根据事件的类型，将单个文本保存在其中[% typ $ [TEXT = 4]](文本组4，文本索引取决于 %typ)