DFS API 边界
规划 DFS Lite、DFS Pro、BI 和 Agent 集成时可依赖的接口边界。
适用场景
- 需要执行该 DFS 任务并留下可审阅记录。
- 需要把源数据交给下游运营、AI 或报表工作流。
- 需要让项目团队对输入、处理和输出有共同理解。
工作流
操作步骤
- 识别调用方
- 确认 endpoint
- 选择 scope
- 测试只读路径
- 记录版本
检查清单
- 输入来源、负责人和允许用途已确认。
- 处理结果可追溯到源路径、字段和时间戳。
- 失败、冲突、拒绝或异常数据已有审阅结论。
交付结果
- 可审阅的配置、运行记录、质量说明、处理输出和下游交接记录。
MDM API 区域
| 区域 | Endpoint family | 用途 |
|---|---|---|
| Reference data | /api/v1/dfslite/mdm/reference-sets | 管理受控词表和值。 |
| Entity types | /api/v1/dfslite/mdm/entity-types | 列出或创建主数据实体类型。 |
| Master entities | /api/v1/dfslite/mdm/entities | 查看、创建和检查 golden records。 |
| Entity aliases | /api/v1/dfslite/mdm/entities/{id}/aliases | 查看一个实体的源系统别名。 |
| Alias resolve | /api/v1/dfslite/mdm/xref/resolve | 将 source-system ID 解析为 master entity ID。 |
| Steward queue | /api/v1/dfslite/mdm/fuzzy-candidates | 审阅模糊身份候选。 |
实施说明
保留源系统、字段含义、时间戳、单位、负责人和审阅记录。DFS 输出只有在完成映射、质量检查和交接记录后，才应进入 Inspector、FactVerse AI Agent、BI 或 Physical AI 工作流。
相关页面
| 继续阅读 | 适用场景 |
|---|---|
| 连接器类型 | 按源系统类型选择 REST、CSV、MQTT、OPC UA、BACnet、Modbus、JDBC 等连接路径。 |
| 映射字段参考 | 说明源字段、目标身份、时间戳、单位、转换表达式和质量规则。 |
| DFS 权限 | 规划 dfs:read、dfs:write、dfs:delete 和 BI 相关权限。 |
| MDM API 参考 | 查看 MDM reference data、entities、aliases 和 steward APIs。 |