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、憑據模式、資產歸屬、工單歸屬、警報流向、狀態流向，以及允許寫回的欄位。
預測性維護場景還應包含設備身分、狀態、優先級、診斷或故障碼、結案說明、根因和完成時間。