DFS API 邊界
規劃 DFS Lite、DFS Pro、BI 和 Agent 整合時可依賴的介面邊界。
適用場景
- 需要執行該 DFS 任務並留下可審閱記錄。
- 需要把來源資料交給下游營運、AI 或報表工作流。
- 需要讓專案團隊對輸入、處理和輸出有共同理解。
工作流
操作步驟
- 識別呼叫方
- 確認 endpoint
- 選擇 scope
- 測試唯讀路徑
- 記錄版本
檢查清單
- 輸入來源、負責人和允許用途已確認。
- 處理結果可追溯到來源路徑、欄位和時間戳。
- 失敗、衝突、拒絕或異常資料已有審閱結論。
交付結果
- 可審閱的設定、執行記錄、品質說明、處理輸出和下游交接記錄。
MDM API 區域
| 區域 | Endpoint family | 用途 |
|---|---|---|
| Reference data | /api/v1/dfslite/mdm/reference-sets | 管理受控詞表和值。 |
| Entity types | /api/v1/dfslite/mdm/entity-types | 列出或建立主資料實體類型。 |
| Master entities | /api/v1/dfslite/mdm/entities | 查看、建立和檢查 golden records。 |
| Entity aliases | /api/v1/dfslite/mdm/entities/{id}/aliases | 查看一個實體的來源系統別名。 |
| Alias resolve | /api/v1/dfslite/mdm/xref/resolve | 將 source-system ID 解析為 master entity ID。 |
| Steward queue | /api/v1/dfslite/mdm/fuzzy-candidates | 審閱模糊身分候選。 |
實施說明
保留來源系統、欄位意義、時間戳、單位、負責人和審閱記錄。DFS 輸出只有在完成對應、品質檢查和交接記錄後，才應進入 Inspector、FactVerse AI Agent、BI 或 Physical AI 工作流。
相關頁面
| 繼續閱讀 | 適用場景 |
|---|---|
| 連接器類型 | 按來源系統類型選擇 REST、CSV、MQTT、OPC UA、BACnet、Modbus、JDBC 等連接路徑。 |
| 對應欄位參考 | 說明來源欄位、目標身分、時間戳、單位、轉換表達式和品質規則。 |
| DFS 權限 | 規劃 dfs:read、dfs:write、dfs:delete 和 BI 相關權限。 |
| MDM API 參考 | 查看 MDM reference data、entities、aliases 和 steward APIs。 |