系統(tǒng)數(shù)據(jù)對接接口說明設(shè)計

1、XXXXXX管理系統(tǒng)數(shù)據(jù)接口說明版 本：1.0修改時間：2014年11月定稿時間：*年*月目錄目錄2一、 主要內(nèi)容2二、 流程文件及風(fēng)險點數(shù)據(jù)接口2（1） 流程文件及風(fēng)險點概念說明2（2） 使用過程說明3（3） 接口說明32.3.1. 接口概述32.3.2. 接口調(diào)用方式42.3.3. 接口文件概述5一、 主要內(nèi)容門戶對外提供如下接口：n XXXXXX系統(tǒng)流程文件及風(fēng)險點數(shù)據(jù)接口二、 流程文件及風(fēng)險點數(shù)據(jù)接口（1） 流程文件及風(fēng)險點概念說明流程文件n 指包含業(yè)務(wù)流程的制度文件n 一個業(yè)務(wù)流程可對應(yīng)多個子流程，子流程即為流程文件所包含的各個業(yè)務(wù)流程圖n 一個子流程一定被包含在某個業(yè)務(wù)流程關(guān)系的節(jié)

2、點風(fēng)險點n 指流程文件中的子流程在某個環(huán)節(jié)可能涉及到的風(fēng)險n 一個業(yè)務(wù)流程文件可對應(yīng)多個子流程，一個子流程可以對應(yīng)多個業(yè)務(wù)環(huán)節(jié)，一個業(yè)務(wù)環(huán)節(jié)可對應(yīng)多個風(fēng)險點（2） 使用過程說明使用過程如下：n 外部系統(tǒng)開發(fā)者和XX系統(tǒng)管理員協(xié)商，確定外部系統(tǒng)的IP地址及權(quán)限協(xié)議等（XX系統(tǒng)提供的是FTP文件傳輸協(xié)議提供數(shù)據(jù)）n 外部系統(tǒng)想要獲取文件必輸建立與XX系統(tǒng)連接的FTP協(xié)議通道n 外部系統(tǒng)獲取的文件為完整的XML文件，通過FTP下載到本地后解析能獲取完整的數(shù)據(jù)（3） 接口說明2.3.1. 接口概述由于XX系統(tǒng)中已入庫的流程文件及風(fēng)險點不允許二次修改，所以不提供修改增量數(shù)據(jù)，但提供廢止、刪除增量數(shù)據(jù)。數(shù)

3、據(jù)接口如下：n 導(dǎo)出完整的流程文件及風(fēng)險點數(shù)據(jù)外部系統(tǒng)可以通過XX接口獲得一整套全量數(shù)據(jù)，從而建立起本系統(tǒng)所需要的流程文件及風(fēng)險點，而無須從零開始建立。n 導(dǎo)出廢止流程文件增量數(shù)據(jù)外部系統(tǒng)還可以通過XX接口獲得這些流程文件的最新狀態(tài)，是否已被廢止。使得外部系統(tǒng)可以方便地和XX數(shù)據(jù)保持一致。n 導(dǎo)出刪除流程文件增量數(shù)據(jù)外部系統(tǒng)還可以通過XX接口獲得這些流程文件的最新狀態(tài)，是否已被刪除。使得外部系統(tǒng)可以方便地和XX數(shù)據(jù)保持一致。2.3.2. 接口調(diào)用方式數(shù)據(jù)導(dǎo)出接口是以FTP方式提供的，需要通過FTP協(xié)議向XX系統(tǒng)發(fā)送請求，服務(wù)器地址是：http:/服務(wù)器域名/CMS/$DATE/cmpfile.

4、xmlURL解釋：http:/服務(wù)器域名/cms：XX系統(tǒng)的訪問地址 $DATE：XX系統(tǒng)建立的當(dāng)天的文件夾，通過日期文件夾管理數(shù)據(jù)，避免數(shù)據(jù)重復(fù)以及提供了完整的歷史記錄 cmpfile.xml：當(dāng)天具體的數(shù)據(jù)文件（這里為流程文件數(shù)據(jù)） Risk.xml：當(dāng)天具體的數(shù)據(jù)文件（這里為風(fēng)險點數(shù)據(jù)）調(diào)用舉例：在瀏覽器中，輸入http:/服務(wù)器域名/CMS/$DATE/cmpfile.xml，服務(wù)器會輸出一個以gbk方式編碼的xml文本，文本內(nèi)容是XX系統(tǒng)當(dāng)天流程文件的新增、廢止、刪除的完整數(shù)據(jù)。（第一次同步時XX系統(tǒng)會提供一個日期為2088/08/08的文件夾，里面存放了XX系統(tǒng)的全量數(shù)據(jù)，如果日后

5、有需要XX系統(tǒng)可以更新該文件下的全量數(shù)據(jù)內(nèi)容）2.3.3. 接口文件概述如果外部系統(tǒng)沒有獲得授權(quán)就調(diào)用上述接口， 則有可能返回如下的信息：1，無法訪問，如下圖：2，提示無權(quán)限訪問如果調(diào)用正常，可直接獲取xml格式文件。（參照第四部分）（4） 接口操作明細2.4.1. 外部系統(tǒng)（下面簡稱系統(tǒng)A）從XX取數(shù)據(jù)分為三步：獲取XX系統(tǒng)當(dāng)天存儲文件的文件地址根據(jù)獲取的文件地址通過FTP協(xié)議將需要同步的文件下載到系統(tǒng)A服務(wù)器中通過代碼對該XML文件進行解析，通過節(jié)點<Datatype>來判斷數(shù)據(jù)同步類型，一共三個值：1、新增；2、廢止；3、刪除。然后進行對應(yīng)的數(shù)據(jù)庫操作下面為樣例（實際節(jié)點名稱

6、以開發(fā)為準）：<?xml version="1.0" encoding="GBK"?> /文件編碼方式<Root>/文件根節(jié)點<Datatype>true</Datatype> /數(shù)據(jù)同步類型，一共三個值：1、新增；2、廢止；3、刪除。<Doc>/一條記錄的根節(jié)點<Field>/表單信息<Filename>標題</Filename> /流程文件名稱 <Fiilcode>XXXX121號</Fiilcode>/發(fā)文文號<Fiilty

7、pe>辦公室</Fiiltype> /業(yè)務(wù)條線<Bankid>10000000.1000</Bankid>/所屬部門id<Bankname>辦公室</Bankname> /所屬部門名稱<FawenDate>2014-01-01</FawenDate> /發(fā)文日期<ShishiDate>2014-01-20</ShishiDate> /實施日期<.></Field><Files>/附件列表<File><FileName>XXXXXXXX業(yè)務(wù)流程.doc</FileName><Content>AAAABBBBCCCCZZZ</Content><FileSize>1000</FileSize> /base64編碼后的文件大小</File><File><FileName>XXXXX.doc</FileName><Content>AAABBBBC