CMMS 工單配接器
FactVerse CMMS 營運可以透過受治理的工單配接器連接下游 CMMS / EAM 系統。當客戶希望 FactVerse 建立、交接、同步或監控維護工單，同時保留既有系統時，請使用本指南。
工單配接器與現場協定配接器不同。工單配接器用於和 Maximo、SAP Plant Maintenance、Honeywell Forge、自訂 REST 服務或 Webhook 端點交換維護記錄。BACnet、Modbus、SNMP 等現場協定配接器用於把設備點位值帶入資產和工單脈絡。
前置條件
配置工單配接器前，請先確認：
- 下游 CMMS 或 EAM 負責人，以及預期的記錄系統歸屬；
- 已批准的服務帳號存取、憑證保存和輪換規則；
- 已部署 FactVerse 環境到提供商 endpoint 的網路可達性；
- 開啟、已派工、已完成、已取消、失敗和重開工單樣例；
- 用於映射的資產、位置、站點、工廠或功能位置標識；
- 需要進入統一工單生命週期的提供商狀態和優先級值；
- 已批准的寫入邊界：唯讀、草稿、交接、同步或寫回。
配接器選擇流程
支援的配接設定檔
| 配接設定檔 | 適用場景 | 典型方向 | 準備重點 |
|---|---|---|---|
| Webhook | 下游系統或中介軟體可以接收事件 payload，並透過入站 webhook 回傳狀態 | FactVerse 推送，提供商回呼 | 目標 URL、共享密鑰、payload 契約、重試策略 |
| Generic REST | 提供商或客戶開放專案專用 REST API | 可配置推送和拉取 | Base URL、認證方式、推送路徑、拉取路徑、欄位映射、回應結構 |
| IBM Maximo | 客戶使用 Maximo 工單、資產、站點和狀態值 | 推送新建工單並拉取狀態變更 | Maximo 根 URL、API key、站點或組織預設值、資產映射、狀態映射 |
| SAP Plant Maintenance | 客戶使用 SAP 維護訂單、設備、功能位置和工廠範圍 | 推送維護訂單並拉取狀態變更 | SAP OData 根路徑、Basic 或 API key 認證、工廠、訂單類型、CSRF 寫入流程 |
| Honeywell Forge | 客戶專案透過已批准 overlay 使用 Honeywell Forge 或 IBMS 設定檔 | 按 overlay 定義推送、拉取、資產或警報路徑 | Forge Base URL、API key 或 OAuth2 用戶端憑據、overlay payload 契約 |
配接器是否可用仍取決於部署範圍、客戶存取批准、提供商版本和最終整合契約。每個設定檔都是實施起點，不能替代提供商發現和客戶確認。
核心配接模型
| 能力 | 需要確認 |
|---|---|
| 推送工單 | 哪些 FactVerse 工單需要交接或建立到提供商系統，哪些欄位必填 |
| 拉取狀態更新 | 哪些提供商狀態、負責人和時間戳會更新統一工單視圖 |
| 健康檢查 | 哪個 endpoint 或探針用於判斷提供商連接是否可達 |
| 資產映射 | FactVerse 設備如何映射到提供商資產、位置、站點或功能位置 |
| 同步日誌 | 成功、失敗、重試和提供商回應如何被審閱 |
| 歸屬規則 | 提供商是否仍是記錄系統，FactVerse 是否作為主工作區，或該流程是否唯讀 |
配置輸入
| 輸入 | 作用 |
|---|---|
| 配接器類型 | 選擇 webhook、rest、maximo、sap-pm 或客戶 overlay 設定檔 |
| Base URL 或 endpoint | 定義請求傳送位置和網路存取邊界 |
| 認證方式 | 定義服務帳號、令牌、憑據輪換和提供商稽核歸屬 |
| 欄位映射 | 將 FactVerse 工單欄位映射到提供商欄位，並保留來源值 |
| 狀態映射 | 將提供商狀態映射到 CMMS 共享生命週期，同時保留原始狀態 |
| 資產映射 | 將 FactVerse 設備 ID 對齊到提供商資產、位置、站點或功能位置 ID |
| 拉取頻率 | 定義狀態變更讀取頻率，或確認由提供商 webhook 回呼 |
| 寫入邊界 | 明確唯讀、草稿、交接、寫回等模式 |
Generic REST
當客戶、提供商、中介軟體或承包商系統開放穩定的專案專用 REST API 時，使用 Generic REST。需要確認 Base URL、網路白名單、認證方式、推送路徑、HTTP 方法、拉取路徑、時間戳參數、結果陣列結構、狀態欄位、FactVerse 欄位到 JSON key 的映射、成功建立後返回的外部 ID 欄位，以及健康檢查路徑。
Generic REST 是可配置的配接框架。生產上線前仍需審閱客戶側 API 契約。
IBM Maximo
客戶使用 IBM Maximo 管理維護時，可使用 Maximo 設定檔與 Maximo 工單 API 交換記錄。
| 領域 | 準備內容 |
|---|---|
| 存取 | Maximo 根 URL，以及透過批准 header 傳遞的 API key |
| 建立工單 | 描述、長描述、優先級、狀態、外部引用、站點、組織、資產和位置欄位 |
| 優先級映射 | 將 FactVerse 優先級映射到 Maximo 工單優先級，並按部署複核本地詞表 |
| 狀態映射 | 將已建立、已分派、進行中、已完成、已取消等狀態映射到客戶 Maximo 狀態模型 |
| 拉取變更 | 確認變更時間窗口、選擇欄位、分頁大小和自訂狀態處理 |
| 資產身分 | 將 FactVerse 設備映射到 Maximo assetnum、location、站點和組織 |
Maximo 常會客製狀態值、物件結構和必填欄位。上線前要用真實的開啟、完成、取消、阻塞、重開工單驗證。
SAP Plant Maintenance
客戶使用 SAP S/4HANA Plant Maintenance 管理維護訂單時，可使用 SAP PM 設定檔進行工單交接或同步。
| 領域 | 準備內容 |
|---|---|
| 存取 | SAP OData 服務根路徑，以及批准的 Basic 或 API key 認證 |
| 寫入流程 | 建立或更新請求所需的 CSRF token 與 session cookie 處理 |
| 範圍 | 維護工廠、訂單類型、設備和功能位置欄位 |
| 建立工單 | 描述、訂單類型、工廠、優先級和可追溯引用 |
| 狀態映射 | 將 SAP 訂單狀態碼映射到 FactVerse 生命週期，同時保留原始 SAP 狀態 |
| 拉取變更 | 確認最後變更時間格式、選擇欄位和提供商側過濾條件 |
SAP 環境會因 Gateway 配置、SSO 策略、擴充欄位和訂單類型而不同。最終服務表面應由客戶 SAP 負責人確認。
Honeywell Forge 和 Overlay 設定檔
Honeywell Forge 或 IBMS 類型整合應作為客戶批准的 overlay 設定檔處理。它可以使用 API key 或 OAuth2 用戶端憑據，但 endpoint 形態、payload 欄位和營運方向取決於專案。
使用該路徑前，應確認客戶已批准 Forge 存取和憑據，payload 形態已由客戶或整合夥伴確認，資產主資料歸屬、警報流向和工單歸屬已達成一致，寫回或交接行為也明確在範圍內。
與現場協定配接器的邊界
BACnet、Modbus 和 SNMP 不是下游 CMMS 工單配接器。它們用於把設備點位值、控制器狀態、UPS 讀數、環境測量值或受管設備狀態帶入 FactVerse 脈絡。
需要把工單記錄與下游維護系統交換時，使用工單配接器。需要在分診、證據複核、設施營運、預測性維護或 Agent 解釋中引用設備點位時，使用現場協定配接器。
驗收清單
- 已確認配接器類型和提供商歸屬。
- 憑據、endpoint、防火牆規則和服務帳號已批准。
- 資產映射已用真實設備和位置樣例測試。
- 狀態和優先級映射保留提供商原始值。
- 推送、拉取、健康檢查、同步日誌、重試和失敗路徑已測試。
- 寫回行為限制在已批准欄位和角色內。
- 操作員能看到工單是原生、已交接、已同步、失敗，還是等待提供商動作。