说明
-->此案例<-- 如何将 mappAudit 与 mappView 一起使用。 mappAudit 允许您跟踪 PLC 上的各种事件，例如变量或用户更改。 有关事件的详细信息，请参阅自动化帮助文件 (7070eb76-adca-4842-bfee-9b225d8633a5)。 在此示例中，我们使用文本系统为审计事件创建有意义的文本。
如果下面显示的图片之一太小，请右键单击并在新窗口中打开
需求
•Automation Studio 4.5
•mappView 5.71
•mappServices 5.71
基础案例
将 mappAudit 配置添加到项目中
1.打开配置视图并选择 mappServices
2.将 MpAuditTrail 从工具箱拖放到 mappServices 文件夹中 
配置 mappAudit
1.打开新的mappAudit 配置
2.将文本源改为“TextSystem”，文本源格式输入“MpAudit/Event/Root”。 （有关文本系统的详细信息，请参见文本源）
3.选择一个或多个 PLC 变量进行测试 
增加语言支持
如果项目已经有语言配置，请跳过此步骤
1.切换到逻辑视图，选择项目顶部
2.从工具箱中添加“ProjectLanguages” 
增加 mapp server
1.选择库文件夹
2.在工具箱中选择B&R库
3.添加库“MpServer” 
添加 mpAudit功能块调用
这是驱动审计服务器的核心功能块。 它必须在循环任务中调用。
1.创建新任务或打开现有任务
2.点击添加库
3.选择函数调用 MpAuditTrail
只有两个参数“MpLink”和“Enable”是强制性的。 将功能块调用更改为
MpAuditTrail_0(MpLink := ADR(gAuditTrail), Enable := 1);
添加功能块声明
添加示例文本文件
1.展开库 MpAudit。 选择所有以 tmx 结尾的文件并复制文件
2.打开 mappView 可视化并将所有 tmx 文件粘贴到 Resources->Texts 下
添加数据点信息
由于在大多数情况下，变量名称本身对操作员没有什么意义，因此可以为该文本文件中的每个变量定义替代文本。 这是我们在第 3 步 此处 定义的变量名称。
1.打开文本文件 TxtDatapoints.tmx
o使用 "::TestVar1" 作为文本 ID 并为变量添加有意义的文本
o对于本地变量使用 "::Program:TestVar3"
o对于OPC变量使用 "::AsGlobalPV:TestVar3"
添加audit容器widget
打开现有的 mappView 可视化并添加 AuditList 小部件widget 
添加 audit list 数据
选择 AuditList 小部件并添加 AuditListItem 
绑定 audit list widget 至 mappView
1.选择 AuditList 小部件并打开属性
2.单击 mpLink 绑定
3.打开选项卡“mapp”
4.选择 mpAudit 配置
增加文本配置系统
如果您已经有文本系统配置，请跳过此步骤。 切换到配置视图。
1.切换到配置视图。 选择 TextSystem
2.将文本系统配置添加到项目中 
配置文本系统
1.打开新的文本系统配置
2.选择 System, Fallback language 并添加至少一种 Target language
3.选择文本文件 mappView.Resources.Texts.TxtEvent.tmx 和 TxtDatapoints.tmx 
下载项目并打开可视化并检查是否跟踪值更改 
使用OPC变量事件
要包含 OPC 变量事件，必须更改基本示例。
使能 OPC server
1.打开 PLC 配置
2.展开 OPC UA 系统
3.启用 OPC server，Auditing Server Facet并选择安全管理员Security Admin 
使能 OPC audit
1.打开 mappAudit 配置
2.启用高级设置
3.在最后一个事件（灰色）中选择“OPC/UA Value-changes”
OPC tag 配置
1.打开OpcUA标签配置
2.选择需要审计的OPC变量
3.启用 OPC 访问的变量
4.在属性中启用审计变量 
定义变量文本
1.打开文本文件 TxtDatapoints.tmx
2.为 TextID 输入 "::Program:TestVar3" 并为变量添加有意义的文本 
将 TestVar3 的输入字段添加到 mappView 可视化。 下载项目并打开可视化。
自定义事件
要包含自定义事件，必须更改基本示例。
增加函数调用
1.打开示例任务
2.添加以下代码并定义一个 REAL 类型的新变量“TestVar3old”
// 当 TestVar3 为 0 时创建自定义事件
IF(TestVar3 = 0 AND TestVar3old <> 0) THEN
MpAuditCustomEvent(MpLink := gAuditTrail, Type := "ValueChange", Message := "Test Variable 3 was set to 0", Comment := "");
END_IF
TestVar3old := TestVar3;
添加文本信息
1.打开文本文件 mappView.Resources.Texts.TxtCustom.tmx
2.为文本 ID 和语言输入“ValueChange” [%msg] 
添加文本文件
1.切换到配置视图，打开文本配置
2.将 TxtCustom 文件添加到列表中 
下载项目并打开可视化。 当您将 TestVar3 设置为 3 并返回 0 时，将触发一个新的自定义事件。
使用导出功能
要导出审计事件，必须更改基本样本。
添加文件设备
这是存储审核信息的文本文件的位置。
1.打开物理视图并打开 PLC 配置
2.添加一个新的文件设备并指向一个文件夹 
更改 mappAudit 功能块调用
1.打开逻辑视图并打开任务
2.将设备信息和触发器添加到功能块调用中。 定义一个 BOOL 类型的新变量“cmdExport”
// Main function call for mappAudit
MpAuditTrail_0(MpLink := ADR(gAuditTrail), Enable := 1, DeviceName := ADR('HD'), Export := cmdExport);
cmdExport := FALSE;
在可视化中添加按钮
1.打开mappView可视化
2.添加新按钮，将按钮名称改为“btnExport”
3.切换到事件属性
4.点击进入“点击”事件
事件绑定的默认窗口将打开。 确保事件绑定文件是正确的并且在可视化配置中列出。 为事件添加以下代码。
<EventBinding id="contentStart.btnExport.Click">
<Source contentRefId="contentStart" widgetRefId="btnExport" xsi:type="widgets.brease.Button.Event" event="Click" />
<EventHandler>
<Action>
<Target xsi:type="opcUa.NodeAction" refId="::Program:cmdExport" >
<Method xsi:type="opcUa.NodeAction.SetValueBool" value="true" />
</Target>
</Action>
</EventHandler>
</EventBinding>
改变OPC配置
1.切换到配置视图，打开OPC配置
2.选择变量cmdExport
3.启用带有绿色复选标记的变量 
修改mappAudit配置
1.打开mappAudit配置
2.修改加密为false使文件可读
下载项目并打开可视化。 使用按钮导出当前审计数据。
附录
文本源Text Source
mappAudit 中使用的文本由一组文本文件 (tmx) 提供。 在基本示例中，这些文本文件位于 mappView 可视化中。 在许多情况下，文本是由多个文本文件组合而成的。 在 mappAudit 配置 (2) 中定义的 mappAudit 中使用的文本的入口点。 在此示例中，入口点位于文件 TxtEvent.tmx (1) 中。 主消息在 Root 中定义。 根引用文本取决于事件类型 (3)。 有关事件的详细信息，请参阅自动化帮助文件 (7070eb76-adca-4842-bfee-9b225d8633a5)。 由于 PLC 中使用的变量名称对操作员来说意义不大，因此可以为每个被审计的变量定义更有意义的名称。 此定义存储在文件 TxtDatapoints.tmx 中。
FAQs
问题：为什么我会收到类似“值从旧值 5 更改为新值 5”之类的条目 答：当您使用该函数生成值更改条目时，即使旧值和新值相同，也会记录此问题。 当您将变量连接到输入小部件时，打开数字触摸板并按 Enter 键而不更改值，也会生成审计事件