<< 点击显示目录 >> 主页  mappServices帮助手册 > mapp Audit:事件管理 > 库 > 功能块 > MpAuditTrailConfig  > Description

mapp Services V5.16

MpAuditTrail所使用的MpLink 也被用于这个功能块。

配置可以在运行时使用该功能块进行更改。

参数 "Configuration "可以编辑一个配置或其中的一部分。

命令 "Load "用于读出当前配置的参数。控制器上的当前活动配置被写入输入 "配置 "的PV中。这将覆盖结构中的数据。然后可以根据需要对数值进行编辑。

命令 "Save "将 "Configuration "结构中的值应用到活动配置中；如果可能的话，这些值会立即应用。

要正确调整应用程序中的配置参数，步骤如下。

1. 命令 "Load = TRUE"

将当前配置从目标系统加载到配置结构中。该过程以 "CommandDone = TRUE "完成。

2. 命令 "Load = FALSE"

重置命令 "Load"。该程序以 "CommandDone = TRUE"完成 。

3.配置配置结构。

现在可以根据需要调整配置结构的参数。

4.设置命令 "Save= TRUE"

将改变的配置结构转移到目标系统。该过程以 "CommandDone = TRUE"完成 。

5. 设置命令 "Save = FALSE"

重置命令 "保存"。程序完成后，"CommandDone = FALSE"。可以再次执行步骤1和2以检查参数是否被成功改变。

配置结构 MpAuditTrailConfigType

此配置可用于定义哪些事件应被 MpAuditTrail评估 ，以及应使用哪种格式来存储条目。

输入 "Event "是用来定义哪些事件类型会导致条目。这个数组的每个元素都定义了一个事件类型。可能的不同事件类型列在 定义事件文本部分 。事件类型必须由其 ID 指定。 MpAuditTrail 可以记录多达十种不同的事件类型。

每个新事件都会创建一个条目。一个条目在内存中约占 150 字节。一个条目的大小可以根据类型和指定的参数而变化。可以用 "RecordMemory "定义保存位置。以下是可用的选项。

•mpAUDIT_MEM_SRAM: 第一选择，只要有可能。如果有足够的SRAM，所有条目可以直接存储在这里，大小由 "RecordingSize "决定。

•mpAUDIT_MEM_BUFFERD_ROM: 如果SRAM中没有足够的内存来存储所有条目，则使用该功能。条目被存储在SRAM中，直到达到 "SramBufferSize"。只有在这时，条目才从SRAM转移到USER ROM。词条的环形缓冲区位于用户ROM中，用参数 "RecordingSize "来配置。

•mpAUDIT_MEM_ROM: 如果RAM中没有足够的内存，那么这个设置可以用来将每个条目转移到USER ROM中，其大小由 "RecordingSize "定义。如果控制器关闭了，这些条目会被保留下来，但每一个条目都要访问USER ROM（速度慢）。

•mpAUDIT_MEM_TEMP: 如果有足够的DRAM，所有条目可以直接存储在这里，大小由 "RecordingSize "决定。缺点是。当控制器关闭时，数据会丢失。

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

如果当前条目或档案被导出，系统会按照 "导出"（MpAuditExportType）配置的值进行。使用 "FileNamePattern "来定义当前条目的文件名。

•默认格式: Audit_%Y_%m_%d_%H_%M (e.g. "CurrentUserEvents_1990_03_25_01_13")

•修改后的格式（示例）: Audit_%d_%m_%Y (e.g. "CurrentUserEvents_25_03_1990")

这同样适用于导出存档

•默认格式: Audit_%Y_%m_%d_%H_%M (e.g. "ArchivedUserEvent_1990_03_25_01_13")

•修改后的格式（示例）: Archive_%d_%m_%Y (e.g. "ArchivedUserEvent_11_12_1983')

以下是调整格式的其他选项：

在导出过程中，数据可以被加密。为此必须选择 "Encrypt"。使用 "PassPhrase "进行解密。密码越长，数据就越安全。如果 "Encrypt"= TRUE，那么加密后的数据将被保存为ZIP文件。

用于解压数据的解压程序必须至少支持.zip格式5.1。7zip和PKWare已经过测试。

每个新条目在内存中都是不含文字的存储。只有引用文本源的ID被指定。在导出过程中，文本只从文本源复制到条目中。如果要导出原始数据，可以使用 "RawData "选项。原始数据被附加到文件/档案的末尾。原始数据永远不会被附加到PDF输出中（不可能进行后处理）。

参数 "FileType "定义了用于导出数据的文件格式。有几种方法可以影响导出文件的格式（对于PDF， MpAuditExportPdfType可以用来 定义字体，例如）。

每个条目都需要一个文本源。这是在创建文件/档案时文本的来源。这个来源是用 "TextSource"（MpAuditTextSourceType）定义的。条目中文本的来源基本上可以是配置或VC4文本组。"类型 "定义了应该使用哪个来源。

•配置: 如果配置被用作文本源，那么将使用 "OutputFormat "中的文本。

•VC4文本组: 如果VC4是源，必须用 "名称 "定义可视化对象。必须指定可视化对象的名称。文本组用 "OutputFormatSource "定义。必须指定文本组的索引。如果在 共享资源 中可以找到该文本组 ，那么必须在索引前加上 "g"（例如 "g3"-- 共享资源中索引为3的文本组 ）。文本组内的文本用 "OutputFormat "指定。文本索引也在这里被指定（例如：0--文本组中索引为0的文本）。

•文本系统: 这里，文本系统被引用。命名空间和TextID都必须被指定。

请参考 定义事件文本一节 ，了解 条目的外观以及哪些选项可用于在其中包含数据。如果没有找到要求的文本（指定的文本组或索引不正确），那么将显示  用 "ErrorMessage"（MpAuditErrorMessageType）  定义的文本。这同样适用于没有正确指定标记的情况（见 定义事件文本部分 ）。

•Invalid text group / index: 使用 "TextNotFound "中的文本。

•Invalid token: 使用 "SpecifierInvalid "中的文本。

归档是使用 "Archive"（MpAuditArchiveType）进行配置。"Enable "可以用来允许自动创建档案。输入 "模式Mode "定义了创建档案的日子。每天或只是周一到周五都可以选择。参数 "时间Time "决定了创建档案的时间。如果某天有大量的新条目发生，可能会导致数据丢失，那么也可以创建一个额外的档案。参数 "最大尺寸MaxSize "可用于定义何时应创建额外的档案。如果新的条目（自上次创建档案后的条目）达到 "最大尺寸MaxSize"，无论时间设置如何，都会创建一个新的档案。如果自上次存档后没有新条目，则不创建新存档。这个例子说明了这个程序。

•配置

•Enable: TRUE

•Mode: mpAUDIT_ARCHIVE_MO_TO_FR

•Time: 6:00 PM

•MaxSize: 100 kB

下表代表了一个可能的星期: