集團(tuán)標(biāo)準(zhǔn)數(shù)據(jù)訪問接口規(guī)范(修訂版)

ii集團(tuán)有限公司信息系統(tǒng)技術(shù)標(biāo)準(zhǔn)標(biāo)準(zhǔn)數(shù)據(jù)訪問接口規(guī)范（修訂稿）#-fIdentifier:ILI【信息資源標(biāo)識(shí)IIj^DisplaYNanie:［信息資源顯示名【稱I1-II--~II-—~-II~-1-rExplanatoryConunent:

【麗性西……DataUnitTypeIDName—DisplayName數(shù)據(jù)元素名蘇定義-Definitioni\定義〔DHta5tructLi「ET￥PEEH二EhrComments:-遠(yuǎn)Unit筍三1.?-遠(yuǎn)Unit筍三1.?I!數(shù)據(jù)元素|—Datatype:數(shù)扌居類型r--MaximumSize;^■■_MininiumSize；II-Ji最小長度L-iScale:精度|ExtendAttributeType—AttributeValueS擴(kuò)展屬性—AttributeValueS擴(kuò)展屬性屬性值圖7.2數(shù)據(jù)結(jié)構(gòu)示意圖

交換數(shù)據(jù)集（數(shù)據(jù)包）數(shù)據(jù)集用來封裝結(jié)構(gòu)化數(shù)據(jù)。數(shù)據(jù)集由一個(gè)或多個(gè)數(shù)據(jù)記錄組成，如圖7.3所示：|DataSet!ype數(shù)據(jù)集KecordData45^3-數(shù)據(jù)集KecordData45^3-1..G0l..x數(shù)搖元素魏據(jù)rUnitlQNnme救粧兀素礪識(shí)"UnitDisplayName'Unitvalue申圖7.3數(shù)據(jù)集示意圖交換附件集附件集用來封裝非結(jié)構(gòu)化數(shù)據(jù)，如文本、圖像、音頻、視頻文件等。附件由一個(gè)或多個(gè)附件組成，如圖7.4所示：IAttachmentsTypeIDNamo標(biāo)im名稱:DisplayNameAttachniEnts申尸二AttachniEnts申尸二EH附件集Attachnient討一）B-1..單個(gè)附件Description；+TypeDescription■HontEnt肖岡容，可以是一個(gè)文件,或著是—段二進(jìn)制數(shù)據(jù)整-rj-圖7.4附件集示意圖文件共享類型的接口規(guī)范9.3.1.共享文件格式（1）文件種類接口文件為純文本文件，各行尾以回車換行碼（ASCII碼13和10）或換行碼（ASCII10）分割均可，可用各種文本編輯器編寫或通過應(yīng)用程序生成。（2）注釋行文件中以兩個(gè)斜杠（//）置于行首的行為注釋行，系統(tǒng)讀入文件時(shí)忽略注釋行和空行。（3）分割符每行中各個(gè)項(xiàng)目之間以兩個(gè)波浪號(hào)目均省略時(shí)可省略相應(yīng)的分隔符。（4）日期格式日期以四位年份+兩位月份+兩位日期表示：YYYYMMDD，例：1998年5月22日19980522。（5）項(xiàng)目格式說明文件中按填寫要求可分為固定項(xiàng)、選擇項(xiàng)和任意項(xiàng)。在項(xiàng)目格式說明的括號(hào)中，固定項(xiàng)為雙引號(hào)引住的內(nèi)容，不可變化；選擇項(xiàng)在備注欄中說明可選的值。任意項(xiàng)按項(xiàng)目內(nèi)容分為文本、整數(shù)和數(shù)值，文本由任意可顯示字符組成，限定的最大長度為字符個(gè)數(shù)（一個(gè)漢字或全角符號(hào)算兩個(gè)字符）；整數(shù)限定最大位數(shù)；數(shù)值以不帶千位分隔符的十進(jìn)制浮點(diǎn)數(shù)表示，限定總長度和最大小數(shù)位數(shù)。如“稅額（數(shù)值14.2）”表示最大為“99999999999.99”的數(shù)。必有項(xiàng)數(shù)欄限定各行最少應(yīng)有的項(xiàng)目數(shù)，少于該數(shù)則該行無效。各行項(xiàng)目數(shù)不小于必有項(xiàng)目數(shù)，但小于總項(xiàng)目數(shù)時(shí)，未填寫的各項(xiàng)將由系統(tǒng)自動(dòng)補(bǔ)上適當(dāng)?shù)闹怠?0.接口編碼根據(jù)集團(tuán)信息標(biāo)準(zhǔn)化技術(shù)規(guī)范數(shù)據(jù)接入數(shù)據(jù)需求，集團(tuán)所涉及的編碼規(guī)范包括單位編碼、維度編碼、指標(biāo)編碼、應(yīng)用系統(tǒng)編碼、數(shù)據(jù)采集表編碼等與數(shù)據(jù)接口相關(guān)的編碼規(guī)范。各集團(tuán)公司在非統(tǒng)推系統(tǒng)數(shù)據(jù)接口設(shè)計(jì)開發(fā)過程中，存在相關(guān)編碼進(jìn)行修改、增加、刪除需求需上報(bào)總部，由集團(tuán)統(tǒng)一進(jìn)行編碼后下發(fā)各下屬子公司使用。11.1.單位編碼單位編碼規(guī)范是以組織與機(jī)構(gòu)編碼為依據(jù)，具體包括集團(tuán)總部、下屬子公司、直屬單位。具體單位編碼表如下：單位編碼_v1?0?xlsx11.2.維度編碼維度編碼類型分為公共編碼類型及按各業(yè)務(wù)條線實(shí)例化編碼類型。公共編碼類型為同類維度的全集，業(yè)務(wù)條線實(shí)例編碼是在公共編碼基礎(chǔ)上對維度編碼的實(shí)例化。公共編碼類型規(guī)則為：GGD+4位流水號(hào)。實(shí)例化編碼類型規(guī)則：業(yè)務(wù)條線編碼D+4位流水號(hào)。注意，實(shí)例化編碼的4位流水號(hào)必須與對應(yīng)的公告編碼的4位流水號(hào)一致。各業(yè)務(wù)條線編碼清單如下表8.1業(yè)務(wù)線條編碼專業(yè)條線涉及部門編碼規(guī)范人資人力資源部RZ

財(cái)務(wù)計(jì)劃財(cái)務(wù)部/控股財(cái)務(wù)部CW規(guī)劃戰(zhàn)略管理部GH建設(shè)項(xiàng)目發(fā)展部JS資本資本運(yùn)營部ZB運(yùn)營地產(chǎn)運(yùn)營管理部/商業(yè)管理部YY綜合重事會(huì)秘書處/重事會(huì)辦公室黨群辦公室/監(jiān)察室（企業(yè)文化部）綜合管理部，辦公室/安全生產(chǎn)辦公室ZH業(yè)務(wù)數(shù)據(jù)需求表所涉及維度編碼如下：維度編碼V1.6.xlsx11.3.指標(biāo)編碼根據(jù)業(yè)務(wù)數(shù)據(jù)需求表，按業(yè)務(wù)條線+6位流水號(hào)的原則對的指標(biāo)進(jìn)行編碼。業(yè)務(wù)條線：為綜合的代碼，其中，人資-RZ、財(cái)務(wù)-CW、資本-ZB、規(guī)劃-GH、建設(shè)-JS、運(yùn)營-YY、綜合-ZH；6位流水號(hào)：指標(biāo)在指標(biāo)數(shù)據(jù)需求表中的行次號(hào)，不足位數(shù)前面補(bǔ)0。具體編碼表如下：數(shù)據(jù)需蠶（含指標(biāo)數(shù)據(jù)需蠶（含指標(biāo)11.4.系統(tǒng)編碼應(yīng)用系統(tǒng)完成數(shù)據(jù)推送數(shù)據(jù)中心后，通過數(shù)據(jù)資源管理工具的數(shù)據(jù)接入日志W(wǎng)ebService服務(wù)寫入數(shù)據(jù)推送日志，推送日志需指定應(yīng)用系統(tǒng)編碼，其中系統(tǒng)編碼規(guī)則如下表：表8.2系統(tǒng)編碼規(guī)則

編碼規(guī)則（一）規(guī)則說明：部署情況+業(yè)務(wù)線+流水號(hào)+單位編碼部署情況0統(tǒng)推系統(tǒng)1個(gè)性系統(tǒng)業(yè)務(wù)線01人資02財(cái)務(wù)03規(guī)劃04建設(shè)05資本06運(yùn)營07綜合08信息流水號(hào)兩位數(shù)字組成單位編碼詳見：單位編碼表（二）規(guī)則示例金蝶K3系統(tǒng)002011財(cái)務(wù)系統(tǒng)明源ERP系統(tǒng)001021個(gè)性系統(tǒng)業(yè)務(wù)系統(tǒng)編碼及規(guī)

貝業(yè)務(wù)系統(tǒng)編碼及規(guī)

貝Lvl.2.xls11.5.數(shù)據(jù)表編碼應(yīng)用系統(tǒng)完成數(shù)據(jù)推送數(shù)據(jù)中心后，通過數(shù)據(jù)資源管理工具的數(shù)據(jù)接入日志W(wǎng)ebService服務(wù)寫入數(shù)據(jù)推送日志，其中表編碼如下：表8.3數(shù)據(jù)表編碼所屬區(qū)域中文名稱業(yè)務(wù)名稱表編號(hào)

接口數(shù)據(jù)模型人資指標(biāo)數(shù)據(jù)接口ID_IDX_HR_INCEAT000001財(cái)務(wù)指標(biāo)數(shù)據(jù)接口ID_IDX_FIN_INCEAT000002規(guī)劃指標(biāo)數(shù)據(jù)接口ID_IDX_PLAN_INCEAT000003建設(shè)指標(biāo)數(shù)據(jù)接口ID_IDX_BIULD_INCEAT000004運(yùn)營指標(biāo)數(shù)據(jù)接口ID_IDX_OP_INCEAT000005資本指標(biāo)數(shù)據(jù)接口ID_IDX_AS_INCEAT000006綜合指標(biāo)數(shù)據(jù)接口ID_IDX_G_INCEAT000007非數(shù)值類指標(biāo)數(shù)據(jù)接口ID_IDX_CHAR_INCEAT00000811.6.技術(shù)編碼表8.4技術(shù)編碼序號(hào)類型名稱技術(shù)代碼分類名稱說明1統(tǒng)計(jì)口徑01合并口徑202地區(qū)口徑3數(shù)據(jù)頻度01日402月503季604半年705年806周907旬由于目前尚未使用，預(yù)留。12.安全規(guī)范由于SOAP協(xié)議是基于HTTP協(xié)議的，在網(wǎng)絡(luò)上傳輸數(shù)據(jù)會(huì)存在非法訪問、被截取、被篡改的風(fēng)險(xiǎn)。由于系統(tǒng)運(yùn)行在集團(tuán)內(nèi)部網(wǎng)絡(luò)上，只有一些公共查詢部分裸露在Internate上,所以截取和篡改的風(fēng)險(xiǎn)就不用考慮。而對于非法訪問，本接口規(guī)定在訪問時(shí)需出示認(rèn)證碼，只有驗(yàn)證之后才提供數(shù)據(jù)，因此避免了非法訪問。集團(tuán)系統(tǒng)應(yīng)保證接口訪問的安全。集團(tuán)系統(tǒng)可以建立接口源系統(tǒng)IP地址與接口單元編號(hào)對應(yīng)表，并按對應(yīng)表進(jìn)行認(rèn)證。當(dāng)源系統(tǒng)訪問集團(tuán)系統(tǒng)的服務(wù)接口時(shí)，集團(tuán)系統(tǒng)提取出源系統(tǒng)IP地址，并從源系統(tǒng)消息中解析接口單元編碼(Interface_Unit_Code),然后用IP地址與Interface_Unit_Code查找源系統(tǒng)IP地址與接口單元編號(hào)對應(yīng)表，如果找到匹配表項(xiàng)，則集團(tuán)系統(tǒng)認(rèn)為該接口訪問合法；如果沒有找到匹配表項(xiàng)，則認(rèn)為該接口訪問非法，并拒絕源系統(tǒng)對該接口的訪問。源系統(tǒng)可通過判斷接口訪問對端的IP地址是否是集團(tuán)系統(tǒng)的IP地址的方式來保證接口安全。如果接口訪問對端的IP地址不是集團(tuán)系統(tǒng)的IP地址，則源系統(tǒng)認(rèn)為該接口訪問合法，否則認(rèn)為該接口訪問非法。為保證接口數(shù)據(jù)在傳輸過程中的安全，當(dāng)服務(wù)接口使用SOAP作為接口協(xié)議時(shí)，接口雙方可使用WS-Security協(xié)議對SOAP消息進(jìn)行加密傳送；當(dāng)服務(wù)接口使用HTTP+XML作為接口協(xié)議時(shí)，接口雙方可利用HTTPS對數(shù)據(jù)進(jìn)行加密傳送。

附錄現(xiàn)有系統(tǒng)及接口目錄系統(tǒng)名稱系統(tǒng)架構(gòu)開發(fā)平臺(tái)數(shù)據(jù)庫平臺(tái)供應(yīng)商版本號(hào)產(chǎn)品已存在的接口是否有升級(jí)計(jì)劃惠大高速公路工程管理系統(tǒng)（含OA）BS微軟.netSqlserver2005微軟財(cái)務(wù)系統(tǒng)BS金蝶Sqlserver金蝶財(cái)務(wù)接口是銷售管理系統(tǒng)BS微軟.netMssql2008明源軟件256財(cái)務(wù)接口是OA系統(tǒng)BSPhpmysql北京通達(dá)2013增強(qiáng)版是地產(chǎn)項(xiàng)目計(jì)劃管理BS微軟.netmssql深圳賽普3地產(chǎn)項(xiàng)目成本管理BS微軟.netmssql深圳賽普3金蝶KASCSmssql深圳金蝶12金蝶EAS系統(tǒng)（含財(cái)務(wù)、租賃）CSJAVAOracle金蝶7.0.11.EAS租賃模塊2.OA接口無OA系統(tǒng)BSJAVAOracle金蝶6.21.EAS租賃模塊2?檔案系統(tǒng)接口無

移動(dòng)辦公系統(tǒng)CSJAVA+HTMLOracle金蝶5.0.6無檔案管理系統(tǒng)CSSQLServer2000世紀(jì)科怡3.2.1OA接口無藍(lán)凌OABS微軟.net/J2eeMssql2008藍(lán)凌5明源ERP系統(tǒng)（含成本、計(jì)劃、銷售、會(huì)員）BS微軟.netMssql2005明源軟件256財(cái)務(wù)接口是移動(dòng)辦公系統(tǒng)C/SJava+HTMLMYSQL建喬無線xMas1.7OA\明源接口標(biāo)準(zhǔn)化平臺(tái)B/SJAVAMYSQL上海筑想1OA門戶B/S微軟.netMSSQL靈狐kap2.01租賃合同2.OA接口愛德成本管理系統(tǒng)BS微軟.netMssql2005賽普愛德V2.0OA接口無協(xié)同辦公系統(tǒng)（0A）Mssql2008金蝶軟件6.1否金蝶K3系統(tǒng)財(cái)務(wù)軟件BSJ2eeoracle金蝶軟件V10.1無協(xié)同辦公管理系統(tǒng)BS微軟.netSQLServer2008賽普軟件V3.0是成本管理系統(tǒng)BS微軟.netSQLServer2008賽普軟件V3.0是采購管理系統(tǒng)BS微軟.netSQLServer2008賽普軟件V3.0是

手機(jī)APP移動(dòng)審批CS微軟.netSQLServer2008賽普軟件V1.0是內(nèi)控管理系統(tǒng)BS自已公司獨(dú)自平臺(tái)慧點(diǎn)科技1.2是檔案管理系統(tǒng)CS微軟.netSybase5.0世紀(jì)科怡3.1是樓宇租賃系統(tǒng)CS微軟.netSQLServ