将 CMMS 和 EAM 数据接入 FactVerse
当客户需要 FactVerse 读取、标准化并治理一个或多个 CMMS / EAM 来源的工单数据时，使用本指南。目标是形成可靠的运营数据集，支持 CMMS 运营、设施运营、预测性维护、ECM 证据、看板和 AI Agent 工作流。
流程
前置条件
| 要求 | 用途 |
|---|---|
| 来源系统访问 | API、数据库视图、文件、SFTP、中间件或数据湖路径需要确认。 |
| 服务账号 | 读取、导入、附件、写回和排障权限要分离。 |
| 字段字典 | 明确必填、可选、只读、自定义字段和枚举。 |
| 资产引用 | 工单必须能匹配到设备、位置、系统或功能位置。 |
| 样例数据 | 需要打开、完成、关闭、阻塞、取消和重开的样例。 |
连接器模式
| 模式 | 适用场景 |
|---|---|
| REST API | 提供商开放工单、资产、附件和状态接口。 |
| Webhook | 来源系统可以推送变更。 |
| 数据库视图 | 客户允许读取已治理视图。 |
| 文件或 SFTP | 定期导出 CSV、Excel 或 JSON。 |
| 数据湖 | CMMS 记录已进入受治理数据平台。 |
映射字段
核心映射包括来源工单 ID、提供商 ID、标题、描述、资产引用、来源状态、共享状态、优先级、SLA、请求时间、分派时间、开始时间、完成时间、关闭时间、负责人、附件引用和同步状态。生命周期细节见 工单生命周期与状态映射。
质量检查
- 必填字段是否存在。
- 状态、优先级和 SLA 是否可映射。
- 资产引用是否能解析到 MDM。
- 时间戳、时区和排序是否一致。
- 取消、重开和重复记录是否保留原因和来源。
- 导入失败是否进入可审阅队列。
预期输出
- 标准化工单数据集。
- 字段、状态、优先级和 SLA 映射表。
- 资产身份匹配规则。
- 同步频率、失败重试和人工例外流程。
- 可用于验收的样例和检查清单。
两条数据路径
| 路径 | 适用场景 | 实施重点 |
|---|---|---|
| 主数据加载 | 设备、备件、库存引用、预防性维护模板、计划和演示数据 | 使用现有领域的创建和导入流程，保持设备、工单、备件和库存身份一致。 |
| 外部 CMMS 适配 | Honeywell Forge 等下游 CMMS / EAM 继续保留，FactVerse 提供统一运营层 | 通过适配器、同步日志、状态映射和人工冲突处理控制读写边界。 |
加载 CMMS 主数据
上线初期通常先完成设备台账、位置、备件、库存引用、预防性维护模板和计划。演示或试点数据应带有可识别标记，方便后续清理和与生产数据区分。
外部 CMMS 适配器模式
外部 CMMS 工单适配器负责连接客户既有系统、保留来源工单 ID、映射状态和优先级，并记录同步结果。适配类型可以是 Webhook、Generic REST、IBM Maximo、SAP Plant Maintenance，或客户批准的 Honeywell Forge overlay。读写策略应按客户现场确定：只读、交接、双向同步或人工确认。
BACnet、Modbus、SNMP 属于现场协议适配器，用于把设备点位带入资产和工单上下文；它们不替代下游 CMMS 工单适配器。