CMMS 提供商专项集成指南
提供商专项指南应在项目确认来源系统、访问方式、必需字段和客户批准的运营模式后编写。请结合 CMMS 工单适配器 使用本页，把通用适配类型转成客户专项实施指南。
指南结构
- 提供商范围和版本。
- 访问方式：REST、数据库视图、文件、中间件或数据湖。
- 工单、资产、状态、优先级、SLA、附件和关闭字段。
- 认证、服务账号和网络要求。
- 同步频率、写回行为、失败处理和验收样例。
提供商集成类型
| 类型 | 适用场景 | 备注 |
|---|---|---|
| IBM Maximo | 客户使用 Maximo 工单、资产、故障码、站点、位置和服务记录。 | 确认 Maximo 状态词表、对象结构定制、站点或组织默认值、API key 访问。 |
| SAP Plant Maintenance | 客户使用 SAP PM 维护订单、功能位置、设备、工厂、通知和关闭数据。 | 确认 SAP OData 根路径、认证方式、CSRF 写入流程、工厂、订单类型和状态码。 |
| Generic REST | 客户、承包商、中间件或提供商开放项目专用 REST API。 | 确认 Base URL、认证方式、推送路径、拉取路径、字段映射、响应结构和外部 ID 字段。 |
| Honeywell Forge / IBMS 集成类型 | 客户批准的 Forge 项目通过 overlay 暴露工单、资产、告警或状态路径。 | 确认 endpoint 形态、OAuth2 或 API key 认证、payload 契约、流向和客户批准记录。 |
| Infor EAM | 客户使用 Infor EAM 工单、资产、状态值和维护记录。 | 需要先取得提供商 schema 和访问细节。 |
| 承包商工单系统 | 服务商维护自己的派工或工单系统。 | 通常通过 Generic REST、Webhook、计划导出或中间件实现。 |
基线字段映射
| 提供商集成类型 | 原生工单 ID | 资产字段 | 状态字段 | 描述字段 | 其他字段 |
|---|---|---|---|---|---|
| SAP PM | ORDER_NR | EQUNR | STATTEXT | LTXT | QMEL.LTXT, PRIOKX |
| IBM Maximo | WONUM | ASSETNUM | STATUS | DESCRIPTION | FAILURECODE, WOPRIORITY |
| Infor EAM | WORKORDERID | EQUIPMENTID | STATUS | DESCRIPTION | 客户自定义优先级和关闭字段 |
| Custom REST | id | equipment_id | status | description | 项目批准字段 |
适配器专项规划
IBM Maximo
按提供商拥有工单的方式规划 Maximo。需要确认 Maximo 根 URL、服务账号、API key header、默认站点或组织、资产号映射、位置映射、状态词表、优先级词表和变更时间拉取窗口。验收样例应包括打开、完成、取消、状态更新，以及至少一条带自定义状态或可选字段的记录。
SAP Plant Maintenance
按维护订单集成规划 SAP PM。需要确认 OData 服务根路径、认证方式、工厂、订单类型、设备或功能位置映射、必填订单字段，以及写入请求的 CSRF token 处理。验收样例应覆盖客户实际使用的创建、释放、确认、技术完成、关闭和取消状态。
Generic REST
当来源开放稳定 API、但不属于打包提供商集成类型时，使用 Generic REST。指南应写明推送路径、拉取路径、认证方式、JSON 字段映射、结果数组路径、外部 ID 字段、时间戳字段和错误响应样例。
Honeywell Forge / IBMS
Forge 集成应作为客户批准的 overlay 集成类型处理，不假设所有项目使用同一套 endpoint。指南应写明批准的 Base URL、凭据模式、资产归属、工单归属、告警流向、状态流向，以及允许写回的字段。
预测性维护场景还应包含设备身份、状态、优先级、诊断或故障码、关闭说明、根因和完成时间。