MpAuditTrail configuration

<< 点击显示目录 >>

主页  mappServices帮助手册 > mapp Audit:事件管理 > 配置 >

MpAuditTrail configuration

mapp Services V5.16

该配置可以在运行时通过功能块 MpAuditTrailConfig进行调整 。

该配置中的密码可以被加密。有关其他信息，请参阅 一般条件下的 "配置中的密码加密 "部分 。

•显示高级参数

Name


Audit



Events




Event 1-N



Record memory



Recording size



Buffer size



Text source




Output format




Display Text





Format




Error message





Specifier invalid




Name




Format-Text Group-Index




Format-Text Index




Display Text





Format-Text Group-Index





Format




Error message





Text not found





Specifierinvalid




Root-Namespace




Format Text Source




Display Text





Format Text Source




Error message





Text not found





Specifier invalid



Archive




Mode




Time




Maximum size



Export




Raw data




File type




Encrypt




Passphrase




PDF





Default Font





Owner Password





User Password





Allow Print





Allow Copy





Allow Edit





Header-Text





TitlePage




















Text





Fonts






Language:{/Language}







Language







Font


Variable Monitor



0-N




PV-Name


Data Queries



Query: {/Name}




Name




Update count




SELECT





{/Column}






Column






Process variable




WHERE





Connect





#1-N






Column






Operator






Compare To







Value







PV


id_Audit_TextSource_VC4_OutputFormatSource

在数据类型 MpAuditTextSourceType中被指定为 "OutputFormat" 。

id_Audit_TextSource_VC4_OutputFormat

在数据类型 MpAuditTextSourceType中被指定为 "OutputFormatSource" 。

id_Audit_Export_PassPhrase

指定用于对文件进行编码的密钥。使用256位AES编码。用户 不能 独立地解密文件。"PassPhrase "只需要为应用程序开发人员提供影响安全程度的可能性。 必须 改变 "PassPhrase" ，以 确保合理地进行加密!

id_Audit_Export_PDF_Header

头部信息可以在这里指定。文本来源与其他事件文本相同，所以它在配置中被定义。它可能看起来像这样。

配置为源: "Enter text directly"

文本系统为源: "{$Namespace/TextID}"

以VC4为来源: "group/index"

id_Audit_Export_PDF

需要库MpReport来导出事件列表为PDF文件。由于该库不包含任何组件，只需将其添加到项目中即可。

存储设置Storage settings

哪些事件应该被记录，可以在 "事件 "下定义。该选项可以在高级参数中启用（"显示高级参数"）。

内存存储设置可以在配置的第一部分中定义。可以定义应该为事件保留多少存储空间，以及在SRAM中应该为事件提供多少内存。

 

采集的数据首先被暂时保存在RAM中的数据对象中。然后在UserROM中进行备份，这样在断电的情况下可以得到保护。

 

存储位置

参数 "Record memory" 定义了记录数据的保存方式。可以选择以下模式。

UserROM: 记录的数据被存储在UserROM中。

SRAM: 当使用电池支持的存储器时，必须在控制器配置中预留足够的存储器。采集的数据被暂时保存到数据对象中，然后备份到SRAM中。只有在使用的硬件配备有SRAM存储器时才能使用。

memoryconfiguration

Buffered UserROM: 如果使用存储器类型 "缓冲的UserROM"，那么在传输到UserROM之前，数据首先被暂时保存在SRAM的数据对象中。

Temporary: 数据被保存在DRAM中。需要注意的是，在断电或重启的情况下，这些数据是不受保护的

文本来源Text source

文本源可以在 "Text source "部分定义。 可以定义各种事件的描述文本应该来自哪里。有关其他信息，请参阅 定义事件文本。

如果使用VC4作为文本源， 目标系统上必须有VISAPI库 。

"Display text "定义了应该使用哪些显示文本。这指的是显示在 MpAuditTrailUI或（如果使用mapp View HMI应用程序） Widget AuditList上的 文本 。 当使用选项 "Same "时，将使用 "Output format "中定义的相同文本。

选项 "Separate "可以用来指定一个单独的显示文本。这与 定义事件文本中的解释完全相同 。 用于导出和查询的文本是在 "Output format "中被指定为文本源的文本!

有关其他信息，请参阅 显示事件文本。

归档Archiving

在 "Archive "一节中可以定义什么时候应该从当前事件中创建归档。如果启用该选项，必须定义归档的频率，以及允许归档的大小。

导出设置Export settings

出口设置可以在 "Export "部分定义。 该文件名 ("Filename pattern") 和档案名称 ("Archive name pattern") 可以通过启用高级参数来定义。

"Raw data" 将原始数据添加到出口文件中. 在 "File type "中定义了应该使用哪种文件类型进行导出。 输出的文件可以用 "Encrypt "进行加密. "Passphrase "是用于加密文件的钥匙的规格。 使用256位AES编码. 用户 不能 独立地解密文件。 "PassPhrase "只需要为应用程序开发人员提供影响安全程度的可能性。必须 改变 "PassPhrase" ，以 确保合理地进行加密。

如果 "Encrypt"= TRUE，那么加密后的数据将被保存为一个ZIP文件。

可以对文件类型PDF进行额外设置:

Default font: 标准字体。如果没有为当前语言定义其他字体，则使用。

Page format: 必须启用高级参数，才能修改这个参数（"Show advanced parameters"）。定义了页面格式。

Page direction: 必须启用高级参数，才能修改这个参数（"Show advanced parameters"）。定义了页面的方向。

Page margins: 要修改这个参数，必须启用高级参数（"Show advanced parameters"）。定义文本与页面边缘的距离。

Owner password: 该密码定义了PDF文件是否允许被打开、打印或编辑。不允许与 "UserPassword "相同。

User password: 该密码定义了PDF文件是否允许被打开、打印或编辑。不允许与 "OwnerPassword "相同。

Allow print: 定义PDF文件是否可以被打印

Allow copy: 定义了PDF文件是否可以被复制

Allow edit: 定义PDF文件是否可以被编辑

Header icon: 必须启用高级参数，才能修改这个参数（"Show advanced parameters"）. 图标可以被整合到页眉中，在这里指定路径。唯一支持的格式是.jpg。图标总是以其原始尺寸显示。格式: DeviceName/FolderName/FolderName/FileName.jpg

Title page: 定义是否应显示起始页。

Language: 定义哪种语言应使用哪种字体（"Font"）。

为了确保文件能够被复制（"Allow copy"）、打印（"Allow print"）或编辑（"Allow edit"），必须指定用户密码（"Owner password"、"User password"）。如果一个或两个密码都是空的，配置的设置就不会被考虑在内。

页眉文本用于 指定页眉信息。文本来源与其他事件文本相同，所以文本在配置中定义。这可以是这样的

Configuration as source: "直接输入文字"

Text system as source: "Namespace/TextID"

VC4 as source: "group/index".

标题文本也可以使用各种缩写来创建。可以使用以下代码:

time: 输出的时间。可以指定所需的时间格式，如  "Inserting the time in the entry "下的解释  。

lb: "lb" 可以用来插入一个换行符。

usr: 输出时目前登录的用户

page: 页码

nrpages: 文件的总页数

缩写可以使用，例如，如下:

新格式

MpAudit export file ({&time}) / Page {&page}: MpAudit export file (1526541882) Page 5

在配置中，"Header text "被指定如下:

header_text

在这种情况下，它被链接到文本系统中的一个文本。

textsystem

旧格式

MpAudit export file ([%time]) / Page [%page]: MpAudit export file (1526541882) Page 5

变量监视器Variable monitor

可以用观察窗口来代替功能块 MpAuditRegPar。这里指定的过程变量通过功能块 MpAuditTrail被自动监控 。一旦一个变量发生变化，就会记录一个事件。

以下变量不能使用。

 

注册限制:

•不能注册不是以索引0开始的数组。

•不能注册多维数组。

•不能注册拥有超过65535个元素的数组。

•衍生的数据类型

•TIME_OF_DAY

•BYTE

•WORD, DWORD, LWORD

•WSTRING

•LINT

查询Query

查询可以在 "Data queries "下创建。 这些查询可以用来过滤或搜索事件列表中的特定事件。必须在 "Name "下为查询指定一个独特的名称。如果查询应通过 MpAuditQuery启动 ，这里定义的名称必须在输入参数 "Name "中指定。

一旦有了新的信息，在 "Update count "上指定的变量的值会自动增加1。这意味着，一旦有与指定的过滤标准（WHERE）相对应的新数据，"Update count"上的变量的计数器值就会改变。这可以作为启动 MpAuditQuery的 "Excute "命令的触发器 。

要包含在查询中的信息是通过 "Select "和 "Where "定义的。

SELECT

"Select" 确定哪些信息应该被请求，以及应该被复制到哪里. 一个过程变量必须指定在 "Process variable". 如果查询是通过 MpAuditQuery 启动的 ，信息将显示在这个进程变量上。也可以指定一个数组变量。数组变量必须按以下方式指定: "::MyVar[]".

"Column" 决定了哪些信息应该被查询。关于各个类型的其他信息，请参见 事件类型。

WHERE

在 "Where "下，应指定查询信息的事件类型（"Column"）。

关于各个类型的其他信息，请参见 事件类型。使用 "Operator "和 "Compare to"，可以为查询提供额外的过滤器，例如，具有某种事件类型的事件或来自特定时间点的事件。这意味着可以查询某些值，例如。"Compare to "可以是一个固定值（"Value"）或过程变量（"PV"）。

如果使用 "LIKE "进行比较（"Operator"），可以搜索到类似的条目。必须使用通配符 "*"。如果使用 "*Test*"作为值（"Value"），例如，可以搜索到条目 "Test01"、"MyTest "和 "MyTest01"。

例子

所有发生过的报警名称都应在事件列表中搜索到。所有报警事件都有事件ID 33。有关其他信息，见 这里。这意味着可以通过事件ID 33进行过滤（"WHERE"）。由于应该显示报警名称，所以选择 "Alarm name"（"SELECT"）。信息显示在变量 Text中 ，它的数据类型是STRING[200][99]。这意味着该变量是一个有100个元素的数组变量。因为它是一个数组变量，所以必须用 ::Text[]来指定该变量 。

这将显示变量 Text中发生的所有报警事件的报警名称 。

data_queries

如果为一个列类型指定了PV，则必须为过程变量使用正确的数据类型。关于要求的事件类型的例子，见 这里。

专栏类型

PV的数据类型

(text): 渲染的事件文本

STRING, WSTRING

可以使用事件类型 "text "来查询记录的事件的导出文本。

通过功能块 MpAuditQuery，可以根据语言和单位来显示查询的事件文本 。只有 "text "或 "dtext "才可以根据语言和单位进行显示。

(dtext): 渲染的显示事件文本

STRING, WSTRING

可以使用事件类型 "dtext "来查询记录的事件的导出文本 。

通过功能块 MpAuditQuery，可以根据语言和单位显示所查询的事件文本 。只有 "text "或 "dtext "才可以根据语言和单位显示。

(idx): 条目索引 (idx): 条目索引

STRING, WSTRING, UDINT

(desc): 事件描述

STRING, WSTRING

(ev): 事件标识符

STRING, WSTRING, UDINT

(op): 操作者名称

STRING, WSTRING

(evtime): 事件时间

以下数据类型可用于获取确认的时间戳，精度为秒： DATE, DATE_AND_TIME, UDINT.

为了获得毫秒级精度的时间戳，必须使用以下结构：

query_milliseconds

epoch: 返回日期和时间（精确度为秒）

msOffset: 返回毫秒数

utcOffset: UTC时间中的分钟。在mapp Audit 中不使用，总是0。

(map): 相关mapp组件

STRING, WSTRING

(dpid): 数据点标识符

STRING, WSTRING

(new): 新值/新状态

STRING, WSTRING, UDINT, UINT, DINT, INT, REAL

值得注意的是，"new "显示的是被查询过程变量的原始数据。单位显示是不可能的，单位切换也不可能。

(old): 旧值/旧状态

STRING, WSTRING, UDINT, UINT, DINT, INT, REAL

值得注意的是，"old "显示的是被查询过程变量的原始数据。单位显示是不可能的，单位切换也不可能。

(unit): VC4 单位 ID

STRING, WSTRING, UDINT, DINT

(utext): VC4 单位 text

STRING, WSTRING

(sel): VC4 文本组选择

STRING, WSTRING, UDINT, DINT

(typ): 自定义事件的类型

STRING, WSTRING

(typ): 签名活动的类型

STRING, WSTRING, UDINT, DINT

(id): 签名/批次 ID

STRING, WSTRING

(prev): 前一批 ID

STRING, WSTRING

(clid): OPC 客户端 ID

STRING, WSTRING

(tev): OPC 源事件时间

以下数据类型可用于获取确认的时间戳，精度为秒: DATE, DATE_AND_TIME, UDINT.

为了获得毫秒级精度的时间戳，必须使用以下结构：

query_milliseconds

epoch: 返回日期和时间（精确度为秒）

msOffset: 返回毫秒数

utcOffset: UTC时间中的分钟。在mapp Audit 中不使用，总是0。

(nodename): OPC UA - 显示名称

STRING, WSTRING

(nodedesc): OPC UA - 描述

STRING, WSTRING

(typt): 签名事件文本

STRING, WSTRING

(msg): 自定义事件/报警信息

STRING, WSTRING

(cmt): 对自定义/签名事件的评论

STRING, WSTRING

(act): 用户(MpUser(X)) / 配方动作

STRING, WSTRING, UDINT

(usr): 受影响的用户 (MpUser(X))

STRING, WSTRING

(file): 文件名

STRING, WSTRING

(dev): 设备名称

STRING, WSTRING

(name): 警报名称

STRING, WSTRING

(code): 报警代码

STRING, WSTRING, UDINT

(sev): 严重程度

STRING, WSTRING, UDINT, UINT, DINT, INT

(stold): 旧的报警状态

STRING, WSTRING

(stnew): 新的报警状态

STRING, WSTRING

(time): 报警时间

以下数据类型可用于获取确认的时间戳，精度为秒: DATE, DATE_AND_TIME, UDINT.

为了获得毫秒级精度的时间戳，必须使用以下结构：

query_milliseconds

epoch: 返回日期和时间（精确度为秒）

msOffset: 返回毫秒数

utcOffset: UTC时间中的分钟。在mapp Audit 中不使用，总是0。

(change): 作为一个字符串的PackML事件类型

STRING, WSTRING

(resp): 调用者的名称（PackML）。

STRING, WSTRING

(mode): PackML模式

STRING, WSTRING

(prog): 程序名称

STRING, WSTRING

(type): 程序改变的类型 (MpCodeBox)

STRING, WSTRING

(ityp): 程序改变的类型 (MpCodeBox)

STRING, WSTRING, UDINT