.val 文件格式说明

.val 文件用于记录每个 DQI 指标的实际输出结果，系统将根据 .dqi 文件中的条件表达式读取 .val 文件中的值进行状态判断。

📁 路径与命名规范

• 文件名格式： <DQI_ID>.val

• 文件路径格式： <category>/<DQI_ID>.val

📂 Example：

./SCAN_DC/SCAN_DC_INSERT_0001.val

📄 文件内容格式

每一行为一条记录，字段之间用 tab 或空格分隔，格式如下：

xxxxxxxxxx
<VALUE>    <DATE_TIME>    <PATH>    <ATTACHMENT>

✏️ 字段说明

✅ Example 1: standard format

xxxxxxxxxx
5616    20250610_141306    /path/to/report:10    none

xxxxxxxxxx
# VALUE = 5616
# Used for evaluating @CRITERIA

✅ Example 2: missing optional fields

xxxxxxxxxx
12345

xxxxxxxxxx
# Treated as: 12345    ""    ""    ""

⚠️ 注意事项

1. 系统只读取 .val 文件的第一行 VALUE 字段；

2. 如果文件缺失，系统将报错并中止；

3. 如果无法将 VALUE 转换为数值类型，则该条件自动判定为不满足；

4. .val 的数值类型需与 .dqi 中的 DATA_TYPE 一致：

   • real: float，如 123.45

   • integer: int，如 100

   • bool: "true" or "false"（暂不推荐）

   • string: 任意文本（暂不支持参与运算）

📌 编写建议

• 每个 .val 文件仅需保留一条有效记录（第一行）

• 推荐使用工具自动生成 .val，避免手动书写错误

• 建议统一使用 tab 分隔字段

如需 .val 样例或生成脚本，请联系平台开发人员。