数据记录员

概述

数据记录器模块管理记录器定义，定期读取已配置的数据路径并将数值存储在趋势数据库中。利用它创建日志，定义记录值，控制日志是否启用，启动或停止运行时进程，并检查存储的数据和日志。

每个记录器包含通用配置、一个或多个数据集、可选的趋势条件以及运行时操作，用于启动、停止、重启、预览数据和读取日志。

伐木工名单

主数据记录器界面会以表格形式显示所有已配置的记录器。

列或控制	描述
过滤器	通过ID、名称、启用状态、数据集名称、文件大小或状态筛选列表。
身份证	内部记录器编号。
姓名	伐木工的名字。眼睛图标会打开该记录器的数据预览对话框。
数据集	记录器记录的数据集名称的逗号分隔列表。
文件大小	当前数据库大小。点击该数值下载该记录器数据库。
状态	当前运行状态并带有彩色点，例如运行、停止、启动、停止、重启、崩溃、守护者崩溃、服务崩溃、未管理、闲置或未知。
启用开关	启用或禁用日志配置。该状态作为配置被持久化，且与当前运行时的启动/停止状态分开。
开始	启动日志运行时。日志在运行时该功能被禁用。
停	停止日志运行。除非日志器运行，否则该功能是被禁用的。
重启	请求日志重启运行时。
编辑	打开日志详情界面。双击行还会打开详细信息界面。
删除	确认后删除所选日志。

工具栏包含导出、导入和新。

• 导出 下载日志器配置档案，通常为trends.tar.gz.
• 导入只接受.tar.gz文件，导入成功后刷新列表。
• 新 创建新的日志器定义

伐木工小组

详细屏幕用于创建或编辑一个日志。运行时操作仅适用于已有保存的日志。如果表单中有未保存的更改，运行时操作将被禁用，直到更改被保存或取消。

一般设定

场	描述
姓名	需要记录器名称。名字必须是唯一的。
毫秒（毫秒）的间隔	记录器和数据预览刷新使用的轮询区间。最低接受值为1000毫秒。
满分	记录员保留的最大记录数。该值必须至少为1.
自定义数据库文件	禁用时，日志器使用默认客户数据库路径，例如 .../db/trends/{id}.db。启用后，路径必须以/media/sd/开头，必须使用有效的Linux路径段，必须以.db结尾，且不得已被其他记录器使用。
启用	控制配置中日志是否启用。它不会取代启动和停止运行时操作。

保存 仅在表单有效且包含未保存的更改时可用。取消返回列表但未保存。

运行时操作

详细信息界面和列表都提供运行时控制：

• Start 启动一个已有的日志机，当日志机已经运行时该功能被禁用。
• Stop 会停止现有的日志记录器，当日志器未运行时会被禁用。
• 重启 重启已有的日志记录器。
• 数据预览 打开日志采集器存储的数据表。
• ** 日志 打开运行时日志对话框。

运行时操作会在新的未保存日志机上被禁用，且当编辑表单有未保存的更改时，因为运行时必须对已保存的配置进行操作。

数据集

数据集定义了一个记录器记录的值。每个记录器必须至少包含一个有效数据集。

场	描述
姓名	记录值所需的数据库列名。必须是有效的SQLite列名。
数据路径	必填的价值来源。使用连接选择器选择PLCVisu数据路径。保存的路径包括连接 ID 和路径，例如 1：：Application.PLC.value。
格式	可选的数字显示/存储格式，仅使用0占位符。有效的例子有000、000.00或0.000000。其他角色被拒绝。

使用添加来创建另一个数据集。使用编辑图标更改数据集。当存在多个数据集时，一个数据集可以被删除。

趋势条件

趋势条件定义何时应进行新数据趋势。如果没有条件配置，日志记录器会根据日志运行时间和间隔进行记录。如果条件被配置，条件必须解析为真，才能对新值进行趋势分析。

当出现某一条件时，按钮会显示一个小的彩色分辨率点：

• 绿色 表示当前全球分辨率为真。
• 红色表示当前全局分辨率为假。
• 灰色 表示当前全局分辨率未知或等待数值。

状态编辑器

条件对话框构建条件树。树可以包含组和条件。

• 群组将子规则与AND、OR或XOR结合。
• 条件 将选定的数据路径与操作符进行比较，并在需要时比较一个值。
• 添加条件会在当前组中添加另一条规则。
• 添加组创建嵌套组。
• 清除 移除所有配置条件。
• 应用 将条件树保存到日志格式。当树不完整或逻辑上不可能时，它会被禁用。

支持的条件算符有：等于、不等、大于、大于或等、小于、小于或等、空、非空、为真和为假。空、非空、真和假算子不需要取值。

编辑器会验证不可能的组合，例如要求同一路径既空又非空的规则、无法重叠的数值范围，或相互矛盾的异或替代方案。

实时状态解析

在条件对话框打开时，每个条件都订阅了通过配置连接选定的数据路径，并显示一个实时状态：

• 真或假显示规则当前结果。
• 未知表示该数值尚未可用或无法评估。
• 离线表示所选连接已离线。
• 等待表示编辑者正在等待某个值或订阅。
• 错误表示订阅或读取失败。

对话框还显示了全局分辨率，这是整个条件树的结果。

数据预览

数据预览 打开一个只读的记录器数据表。它显示每个数据集的时间戳列和一列。

• 预览在从列表中启动时加载已保存的日志和数据集，然后打开。
• 该表支持按时间戳或数据集列排序。
• 该表支持每页10、20、50或100行的分页。
• 列可以通过拖动分隔符或聚焦分隔符并使用左右方向键来调整大小。
• 时间戳在可能的情况下以人类可读的数值显示。
• 对话框打开时，数据仅在日志器运行且条件允许新数据趋势时，使用日志区间刷新。
• 当对话关闭时，投票停止。

预览还解释了当前是否预期会对新数据进行趋势分析：

• 如果日志未运行，显示新数据未被趋势分析，并在可用时包含当前状态。
• 如果条件无效，则警告条件无法解决。
• 如果条件为真，则表明在日志运行期间可以对新数据进行趋势分析。
• 如果条件为假，表示新数据未被趋势化。
• 如果条件未知，表示预览正在等待条件值。

当日志停止、条件无效，或当前条件解析为错误或未知时，预览仍可显示已存储的行，但不会持续轮询新行。

日志

*日志对话框显示一个日志记录器的运行时日志条目。

• 日志以时间和日志列显示。
• 对话框在最后一页打开，因此最新条目优先可见。
• 对话框在打开状态下每两秒刷新一次。
• 当对话框关闭时，刷新计时器停止。
• 使用分页器更改页面大小或浏览较早的条目。

数据库文件

• 列表 文件大小值下载一个日志器的数据库文件。
• 全局下载端点还可以返回所有趋势数据库作为归档。
• 如果配置了自定义数据库文件，确保存储设备在运行时可用且可写入。
• 更改数据库路径会改变记录器写入新数据的位置。现有的数据移动不由当前的UI工作流程处理。

推荐工作流程

1. 创建一个新的数据记录器条目。
2. 输入名称、区间、最大点数、启用状态和数据库路径（如有需要）。
3. 添加数据集并使用连接选择器选择它们的数据路径。
4. 如果录制应依赖于现场数值，则添加趋势条件。
5. 拯救伐木工。
6. 启动记录器并确认状态变为运行。
7. 开放数据预览以验证值是否被存储。
8. 需要检查运行时行为时打开日志。

故障排除

• Start 被禁用：日志器已经在运行，日志尚未保存，运行时动作正在进行，或表单有未保存的更改。
• 停止功能被禁用：记录器当前未运行。
• 保存被禁用：表单无效或内容未变。
• 未显示预览行：尚未记录数据、条件未满足、日志停止，或选定的时间/顺序/页面没有行。
• 条件保持未知：所选连接可能离线，数据路径尚未输出值，或当前值无法被选定操作符评估。
• 导入失败：验证所选文件是否为.tar.gz档案。
• 数据库下载不可用：检查记录器状态以及数据库文件是否存在且可访问。