帮助中心Appearance
5. 数据字典
5.1 采集测点表列名与 API 字段对应
文件导入路径（POST /config/point/import/{dc}）可识别的列名如下。必填为点名（PN）与点的类型（RT）。
| API 字段 | 可识别列名 | 默认值 | 说明 |
|---|---|---|---|
| ID | id | 空 | 测点 ID，有值时须不小于 1024；留空由设备端自增分配 |
| PN | pn、点名 | — | 必填。不超过 60 字节，不能含 . |
| AN | an、别名 | 空 | 不超过 256 字节 |
| RT | rt、点的类型 | — | 必填，枚举见 5.2 |
| EU | eu、量纲、量纲（EU） | 空 | 不超过 12 字节 |
| ED | ed、描述 | 空 | 不超过 512 字节 |
| AD | ad、地址信息、地址信息（AD） | 空 | 不超过 4096 字节。含义随驱动而变（PLC 为寄存器地址、MQTT 为主题、OPC-UA 为节点 ID） |
| SR | sr、采集点类型、采集点类型（SR） | 驱动相关 | 取值见 4.7.5 |
| AE | ae、控制属性、控制属性（AE） | 读 | 枚举见 5.4 |
| FK | fk、比例系数、比例系数（FK） | 1 | 不能为 0 |
| TV | tv、量程上限、量程上限（TV） | 100 | 须大于 BV |
| BV | bv、量程下限、量程下限（BV） | 0 | — |
| FB | fb、偏移量、偏移量（FB） | 0 | — |
| FQ | fq、分辨率、分辨率（FQ） | 1 | 不能为负 |
| KR | kr、特征字 | 空 | 不超过 16 字节 |
| KZ | kz、压缩类型 | 线性 | 枚举见 5.7 |
| FM | fm、显示格式 | 2 | 枚举见 5.5（文档存在冲突） |
| DB | db、死区 | 0.2 | 非负数 |
| DT | dt、死区类型 | ENG | 枚举见 5.8 |
| ReData1 | REDATA1、redata1、Redata1、rc1、RC1 | 空 | 扩展字段 |
| ReData2 | REDATA2、redata2、Redata2、rc2、RC2 | 空 | 扩展字段 |
5.2 点的类型（RT）
| 值 | 含义 |
|---|---|
0 | 模拟量 |
1 | 开关量 |
2 | 短整数 |
3 | 长整数 |
4 | 浮点数 |
5 | 长整型 |
6 | 文本 |
7 | 二进制 |
【注意】文件导入路径接受中文名（模拟量、开关量、短整数、长整数、浮点数、长整型、文本、二进制）；JSON 路径的
points[].rt为字符串，建议传数字字符串。
已实测（2026-09-12）：查询接口的filter.rt只接受中文名（传0或"0"均报invalid filter RT: 0）。注意与文件导入不同——文件导入路径同时兼容中文名；
而 JSON 新增/更新测点的points[].rt建议传数字字符串（见上表）。
5.3 采集点类型（SR）
没有固定枚举，取值由具体驱动决定，请调用：
GET /api/mlinkClient/config/driver/sr/sn/{DeviceCode}?app=<服务名>响应为 {"sr":{"KEY":"显示名"}}。常见取值形如 INT16、INT32、FLOAT32。
5.4 控制属性（AE）
| 值 | 含义 |
|---|---|
0 | 读 |
1 | 写 |
2 | 读写 |
【警告】JSON 路径只能传数字字符串
"0"、"1"、"2"。传中文会被静默转成0（读）。
【注意】合法值只有「读」「写」「读写」三种，「只读」不是 DASS 侧合法值（那是云侧的值）。
【注意】文件导入路径使用中文枚举（读 / 写 / 读写），校验失败文案为「控制属性（AE） string类型，他是一个枚举类型，只能是 读、写、读写」。
5.5 显示格式（FM）
| 值 | 含义 |
|---|---|
2 | 默认值（多处文档与代码默认值一致） |
0 | PCT（来自通道文档的说法） |
1 | ENG（来自通道文档的说法） |
【存疑】显示格式
fm的枚举在两份现有文档中自相矛盾：一处写默认值为2，另一处写0=PCT、1=ENG。建议真机导出一份 xlsx 观察实际取值（待真机确认）（本轮真机验证为只读探测，未覆盖此项）
5.6 同步属性（UM）
| 值 | 含义 |
|---|---|
0 | 同步 |
1 | 变化 |
【存疑】承载该枚举的校验常量在控制器中未见引用；且
upoint/insert请求结构体没有um字段，只能通过更新接口或文件导入设置（待真机确认）（本轮真机验证为只读探测，未覆盖此项）
5.7 压缩类型（KZ）
| 值 | 含义 |
|---|---|
0 | 死区 |
1 | 线性 |
2 | 无压缩 |
【注意】文件导入路径接受中文名（死区、线性、无压缩），默认
线性。
5.8 死区类型（DT）
| 值 | 含义 |
|---|---|
0 | PCT |
1 | ENG |
【注意】文件导入路径接受英文枚举
PCT/ENG，默认ENG。
5.9 数据状态（DS）
用于查询筛选 filter.ds：
| 值 |
|---|
Good |
Bad |
Timeouts |
First |
Unknown |
5.10 上传测点导入列清单
| 列序 | 列名 | 必填 | 说明 |
|---|---|---|---|
| 1 | ID | 是 | 不小于 1024，是已存在的采集 / 计算测点 ID 的外键引用，无自增语义 |
| 2 | 点名 | 否 | 点名 |
| 3 | 同步属性 | 是 | 枚举见 5.6 |
| 4 | 量程上限 | 否 | 默认 100 |
| 5 | 量程下限 | 否 | 默认 0 |
| 6 | 地址信息（AD） | 否 | 不超过 4096 字节 |
| 7 | 上传点类型（SR） | 否 | ⚠️ 列名与采集测点的「采集点类型（SR）」不同名 |
| 8 | 比例系数（FK） | 否 | 默认 1，不能为 0 |
| 9 | 偏移量（FB） | 否 | 默认 0 |
| 10 | redata1 | 否 | 扩展字段 |
| 11 | redata2 | 否 | 扩展字段 |
5.11 长度约束汇总
| 字段 | 约束 | 失败文案 |
|---|---|---|
| 点名（PN） | 不超过 60 字节，不能含 .，仅支持中文、数字、字母及 -、#、_、:、@ | 「验证点名长度不能超过60」/「点名 string类型， 支持中文、支持数字、字母和特殊字符-、#、_、:、@ ，长度不大于60字节」 |
| 别名（AN） | 不超过 256 字节 | 「验证别名长度不能超过256」 |
| 量纲（EU） | 不超过 12 字节 | 「验证量纲长度不能超过12」 |
| 描述（ED） | 不超过 512 字节 | 「验证描述长度不能超过512」 |
| 特征字（KR） | 不超过 16 字节 | 「验证特征字长度不能超过16」 |
| 地址信息（AD） | 不超过 4096 字节 | 「验证地址信息长度不能超过4096」 |
| 服务名 | 不超过 11 字节 | 【存疑】设备端返回超长错误，确切错误码未在本仓库确证（待真机确认） |
| 通道名 | 不超过 12 字节 | 同服务下唯一 |
| 测点 ID | 有值时不小于 1024 | 「int类型 ， 必须不小于1024」 |
【警告】「不小于 1024」这一约束在导入路径中并未真正实现（服务端只拒绝负数），0 ~ 1023 会被放行。请客户端自行保证不小于 1024。
5.12 服务与通道字段
| 字段 | 取值 | 说明 |
|---|---|---|
das_type | das、upload | 采集服务 / 上传服务 |
服务命令 cmd | start、stop、restart | 其它值静默不执行 |
通道命令 cmd | start、stop、restart | restart 结果被丢弃，响应不可信 |
log_level | 【存疑】服务端 proto 枚举的字符串 key | 合法枚举值未在代码中列举（待真机确认） |
flag | 【存疑】字符串 | 代码全程未读取该字段（待真机确认） |