跳至主要内容

CMMS 排障

當 CMMS 營運、多提供商彙整、資料整合、附件同步或 AI Agent 工作流與客戶預期不一致時，使用本指南。

排障流程​

常見症狀​

症狀檢查
工單缺失來源記錄、過濾器、提供商 ID、必填欄位、拒絕列和同步時間。
工單重複提供商 ID、來源工單 ID、重試行為、重複規則和匯入窗口。
狀態不一致來源狀態映射、同步方向、最近寫回、衝突規則。
資產錯誤MDM 別名、退役資產、父子層級、Inspector 綁定。
使用者看不到工單角色、租戶、場站、提供商、狀態範圍和權限。
附件缺失檔案大小、檔案類型、ECM 權限、附件映射和同步日誌。
Agent 摘要缺少最新工作資料新鮮度、工單過濾器、狀態映射和權限範圍。

診斷缺失工單​

  1. 確認來源 CMMS 中存在該工單。
  2. 檢查連接器同步時間和錯誤日誌。
  3. 檢查來源狀態是否被過濾。
  4. 按來源工單 ID 和共享工單 ID 查詢。
  5. 檢查資產引用是否被拒絕或等待 steward 審閱。

預期輸出​

每次排障應留下：問題 ID、受影響工單、來源記錄、檢查步驟、修正動作、重跑結果、負責人和後續防範措施。

啟用和執行專項排障​

現象檢查
CMMS 選單不可見租戶目錄中的 cmms 模組鍵、模組啟用狀態、導航白名單和使用者角色。
概覽返回 403使用者或服務帳號是否具備 cmms.read，以及是否在正確租戶內存取。
概覽為空或 MTTR / MTBF 暫無資料是否存在目前租戶的工單、逾期計畫、完成記錄和故障標籤。
技師或班組無法分派工單狀態、工單操作權限、技師或班組記錄、服務商歸屬和同步錯誤。
到期計畫未生成工單計畫到期日、計畫狀態、生成配置和同一窗口是否已有生成記錄。
備品扣減失敗備品主資料、庫存位置、可用數量、交易權限和庫存交易日誌。
AI Agent 無法調用 CMMS 工具模組啟用、cmms.read、寫入動作權限、服務帳號範圍和審閱門。

相關文件​