物資主資料
縱向整合介面規範
國家電網公司
主資料專案組
2023年8月9日
文件編號版本：1.0
文件資訊
變更歷史
目錄1. 前言 1
1.1. 導讀 1
1.2. 範圍 1
1.3. 術語 1
1.4. 參考資料 2
2. 原則 1
3. 主資料管理整合規範 1
3.1. 整合架構 1
3.2. 介面整合描述 1
3.2.1. sg-mdm分發主資料到業務應用 2
3.2.2. sg-mdm傳送主資料狀態到業務應用 5
3.2.3. 業務應用申請主資料 8
附錄一主資料型別碼對照表 12
附錄二接收端編號對照表 12
1. 前言
1.1. 導讀
目前，sg-mdm物資主資料範圍包含物資分類（含水電）、物料（含水電），**商等三類主資料。本文件也僅限於描述這三類主資料與其他外部應用的資料互動介面規範定義。
1.2. 範圍
sg-mdm管理的物資主資料範圍包含物資分類（含水電）、物料（含水電），**商主資料等三類主資料。本文件也僅限於描述這三類主資料與其他外部應用的資料互動介面規範定義。
1.3. 術語
sg-mdm：sg-mdm指國家電網主資料管理系統。採用總部集中部署，總部/網省兩級應用的方式進行主資料管理。
webservice：webservice是業務系統對外暴露的能夠通過web進行呼叫的api。
接收端：指各個單位要接入sg-mdm的業務系統。為了更好的描述和全域性定義要接入的業務系統，我們採取「業務模組_業務系統拼音簡稱_流水號」方式命名接收端的id，採用「單位名稱+系統名稱」命名接收端的中文名稱。
為了便於sg-mdm系統對接入系統的統一管理，在採用webservice方式進行資料交換時，請求方都需要在接入引數中提供根據本介面規範中預先分配的「接收端id」來進行系統接入，詳情可見附錄二「接收端編號對照表」。具體見附錄二接收端編號對照表。
1.4. 參考資料
本規範參考以下檔案制定，並參考公司系統部分單位研究成果：
《主資料管理功能模組建設方案_v0.9》
《應用整合平台典型設計手冊v2.6》
《sgcc_成熟套裝軟體縱向貫通技術實現v2》
《資料交換介面規範v2.1（列印版）》
《國家電網公司成熟套裝軟體資訊分類編碼方案（使用版）》
《國家電網公司資料中心典型設計》
《物資管控實施_整合技術架構_確認版.rar》
《國家電網公司「sg186」工程一體化平台-應用整合典型設計（下發稿）》
2. 原則
本文件僅定義webservice方式的介面定義，具體的實現由各系統參考本規範文件和其它技術文件自行開發實現。
本方案中使用的編碼值使用國網公司下發的編碼。如果外部應用的編碼值與本方案中使用的編碼值定義不一致，應由各外部應用在其系統內部自行做編碼對映工作。
3. 主資料管理整合規範
3.1. 整合架構
3.2. 介面整合描述
根據國網公司統一要求，參照應用整合典型設計，整合架構採用通用整合平台的方式進行整合，這種應用模式中各業務應用通過通用的、基於soa架構的整合平台實現整合，將套裝軟體看做乙個普通的業務應用，可以按照介面規範將業務功能封裝成webservice，註冊到esb，同時能夠呼叫整合平台的服務。呼叫系統通過標準方式（soap over http 或者 soap over jms）呼叫服務匯流排上的服務，資料採用xml格式組織，當請求資料進入服務匯流排後，服務匯流排呼叫相應的業務服務。整合模式下圖所示：
3.2.1. sg-mdm分發主資料到業務應用
1) 功能描述：本介面用於sg-mdm主動分發主資料到業務應用。
2) 實現方式：
a) 介面發布方：業務應用
b) 介面呼叫方：sg-mdm
c) 資料流向：sg-mdm 業務應用
d) 實現說明：
1. sg-mdm把要分發的資料打包成xml資料報。
2. sg-mdm呼叫本介面，把xml資料報以引數的方式傳遞給業務應用。
3. 業務應用解析xml，進行內部操作，完成資料同步，並根據返回值協議返回主資料處理情況。
4. sg-mdm根據返回值，記錄主資料同步情況。
3) 介面方法定義：
string syncmasterdata(string masterdatatype,string xmldata)
4) 引數說明：
物資主資料
水電物資主資料
物料主資料
水電物料主資料
**商主資料
3.2.2. sg-mdm傳送主資料狀態到業務應用
1) 功能描述：本介面用於sg-mdm主動同步主資料的狀態到業務應用。
2) 實現方式：
a) 介面發布方：業務應用
b) 介面呼叫方：sg-mdm
c) 資料流向：sg-mdm 外部應用
d) 實現說明：
1. sg-mdm把要同步狀態的主資料打包成xml資料報。
2. sg-mdm呼叫本介面，把xml資料報以引數的方式傳遞給外部應用。
3. 外部應用解析xml，進行內部操作，完成資料狀態同步，並根據返回值協議返回主資料處理情況。
4. sg-mdm根據返回值，記錄主資料狀態同步情況。
3) 介面方法定義：
string syncmasterdatastatus(string masterdatatype,string xmldata)
4) 引數說明：
物資分類主資料
水電物資分類主資料
物料主資料
水電物料主資料
**商主資料
注意: 該規範中的主資料型別編碼與之前橫向和縱向整合規範中的型別碼有所變化，mdm平台會同時支援早期的主資料型別碼(01:物資分類 02:
物料主資料 03:**商主資料),但建議後續的介面開發統一採用該對照表中的5位主資料型別碼。
主資料庫建設方案
資料庫建設目標2 資料當前面臨的問題2 相關技術分析2 資料庫設定的要點 重點與盲點2 需求分析2 資料項3 資料結構11 資料流13 資料儲存13 處理過程15 資料流圖16 概念結構 er圖18 邏輯結構 關係圖19 完整性約束21 使用者檢視29 儲存結構35 filegroup35 分割槽函...
1 2供應商主資料
為了促進採購流程,企業在實際執行過程中要為 商建立 商主資料。商主資料中包含企業的 商資訊,除了 商的名稱位址等常規資料外,商主資料還應該包括與 商交易時所用的貨幣,付款條件,重要聯絡人的姓名等採購資料。處於會計目的，商主資料中還應該包含財務資料，例如總帳會計核算中用的統御科目。業務示例 為了促進採...
資料庫物資管理系統
目錄0 引言 1 系統需求分析 2 總體設計 1 專案規劃 2 系統功能結構 3 設計目標 3 系統設計 1 開發及執行環境 2 資料庫設計 4 主要功能模組設計 1 建立工程框架 2 主視窗設計 3 登入模組設計 4 物資基本資訊新增模組設計 5 物資入庫資訊新增模組設計 6 物資出庫資訊新增模組...