題注：
發(fā)表這篇解決方案，屬于非盈利目的。主要是為了讓大家了解一種接口技術(shù)解決方案文檔的編寫格式以及讓大家評審在我的這個技術(shù)解決方案中的不足之處，以便大家指出并加以改進。
轉(zhuǎn)載，下載或與各種形式使用這篇文章，必須注明文章的作者，出處。
其他未盡事宜，以國家法律規(guī)定的為準！
作者：南瘋
根據(jù)前面的兄弟和父子關(guān)系的說明，一條記錄中補充上傳文檔的方式就簡單了許多。只要施工系統(tǒng)上傳了文檔，獲得最后的文檔ID，然后，在施工系統(tǒng)中維護最后的文檔ID，再用修改記錄的報文上報更新后的業(yè)務數(shù)據(jù)即可。流程：
上傳補充的文檔 à 獲得最后的文檔ID à 用最后的文檔ID更新業(yè)務數(shù)據(jù) à 上傳修改后的業(yè)務數(shù)據(jù)。
向外協(xié)系統(tǒng)請求刪除一個文檔，只需要向外協(xié)系統(tǒng)提交包含有要刪除的文檔ID即可。
如果需要刪除的是文檔鏈當中的某一個文檔，則需要向外協(xié)請求獲得文檔鏈的信息（參見后面的“如何獲取文檔信息”），然后，從鏈中找到要刪除的文檔ID，向外協(xié)系統(tǒng)提交。外協(xié)系統(tǒng)在刪除文檔的同時，會自動把鏈連接起來成為一個完整的鏈關(guān)系，同時，總是返回鏈的最末尾的文檔ID。施工系統(tǒng)獲得鏈末尾的最后文檔ID之后，更新業(yè)務表中的相應記錄，再用修改的報文上報修改后的業(yè)務數(shù)據(jù)（此步驟不要忘記）。
請求刪除文檔的報文：
<?xml version="1.0" encoding="utf-8"?>
<XmlData>
<UserInfo>
<User>ZhangSan</User>
<PassWord>123456</PassWord>
</UserInfo>
<Description>
</Description>
<Records>
<ID>123456</ID>
</Records>
</XmlData>
響應報文：
<?xml version="1.0" encoding="utf-8"?>
<XmlData>
<Description>
<Result>成功</Result> <!--如果失敗，則返回信息是“失敗：（錯誤信息）”-->
</Description>
<Records>
<Record>
<ID>456789</ID> <!--這個是鏈當中的最后一個文檔ID，如果鏈已經(jīng)不存在，返回 -1 -->
</Record>
</Records>
</XmlData>
報文說明：
|
標簽名
|
說明
|
|
<XmlData>
|
報文數(shù)據(jù)主體
|
|
<Description>
|
報文頭部信息
|
|
<Records>
|
記錄集合
|
|
<Record>
|
一行記錄
|
|
<UserInfo>
|
業(yè)務認證的用戶信息
|
|
<User>
|
業(yè)務用戶登錄名
|
|
<PassWord>
|
業(yè)務用戶驗證口令
|
|
<Result>
|
反饋報文中的保存成功與否信息。
如果文檔刪除成功，則信息是“成功”
如果文檔刪除失敗，則信息是“失?。海ê竺媸清e誤的詳細信息）”
|
|
請求報文中<ID>
|
文檔的ID。要刪除的文檔ID
|
|
反饋報文中<ID>
|
文檔的ID。當刪除鏈中的一個文檔之后，外協(xié)系統(tǒng)自動維護鏈之間的關(guān)系，并返回鏈末尾最后一個文檔的ID
|
施工系統(tǒng)根據(jù)文檔的ID向外協(xié)系統(tǒng)請求獲得文檔的基本信息。外協(xié)系統(tǒng)返回滿足結(jié)果的文檔基本信息。施工系統(tǒng)可以請求一個文檔的基本信息，也可以請求多個（最多100個）文檔的信息。這個接口不考慮文檔鏈的情況，僅僅是按指定文檔ID返回結(jié)果。
請求報文：
<?xml version="1.0" encoding="utf-8"?>
<XmlData>
<UserInfo>
<User>ZhangSan</User>
<PassWord>123456</PassWord>
</UserInfo>
<Description>
</Description>
<Records>
<Record>
<ID>123456</ID>
</Record>
<Record>
<ID>456789</ID>
</Record>
</Records>
</XmlData>
響應報文：
<?xml version="1.0" encoding="utf-8"?>
<XmlData>
<Description>
<Result>成功</Result> <!--如果失敗，則返回信息是“失?。海ㄥe誤信息）”-->
</Description>
<Records>
<Record>
<ID>123456</ID>
<FILE_PRJ_ID>Value1</FILE_PRJ_ID>
<FILE_TYPE>Value2</FILE_TYPE>
<FILE_CREAET_MODE>Value3</FILE_CREAET_MODE>
<FILE_NAME>Value4</FILE_NAME>
<FILE_UNIT>Value5</FILE_UNIT>
<FILE_MAN>Value6</FILE_MAN>
<FILE_CREATE_TIME>Value7</FILE_CREATE_TIME>
<FILE_SIZE>Value8</FILE_SIZE>
<FILE_AUTHOR>Value9</FILE_AUTHOR>
<FILE_TITLE>Value10</FILE_TITLE>
<FILE_BROTHER_ID>Value11</FILE_BROTHER_ID>
<FILE_PARENT_ID>Value12</FILE_PARENT_ID>
</Record>
<Record>
<ID>456789</ID>
<FILE_PRJ_ID>Value1</FILE_PRJ_ID>
<FILE_TYPE>Value2</FILE_TYPE>
<FILE_CREAET_MODE>Value3</FILE_CREAET_MODE>
<FILE_NAME>Value4</FILE_NAME>
<FILE_UNIT>Value5</FILE_UNIT>
<FILE_MAN>Value6</FILE_MAN>
<FILE_CREATE_TIME>Value7</FILE_CREATE_TIME>
<FILE_SIZE>Value8</FILE_SIZE>
<FILE_AUTHOR>Value9</FILE_AUTHOR>
<FILE_TITLE>Value10</FILE_TITLE>
<FILE_BROTHER_ID>Value11</FILE_BROTHER_ID>
<FILE_PARENT_ID>Value12</FILE_PARENT_ID>
</Record>
</Records>
</XmlData>
報文說明：
|
標簽名
|
說明
|
|
<XmlData>
|
報文數(shù)據(jù)主體
|
|
<Description>
|
報文頭部信息
|
|
<Records>
|
記錄集合
|
|
<Record>
|
一行記錄
|
|
<UserInfo>
|
業(yè)務認證的用戶信息
|
|
<User>
|
業(yè)務用戶登錄名
|
|
<PassWord>
|
業(yè)務用戶驗證口令
|
|
<Result>
|
反饋報文中的保存成功與否信息。
如果文檔獲得成功，則信息是“成功”
如果文檔獲得失敗，則信息是“失敗：（后面是錯誤的詳細信息）”
|
|
請求報文中<ID>
|
文檔的ID。要獲取的文檔ID
|
|
反饋報文中<ID>
|
文檔的ID。要獲取的文檔ID
|
|
<FILE_PRJ_ID>
|
文檔所屬項目ID
|
|
<FILE_TYPE>
|
文檔類型
|
|
<FILE_CREAET_MODE>
|
文檔創(chuàng)建方式 默認：用戶上傳
|
|
<FILE_NAME>
|
文檔（文件）名稱
|
|
<FILE_UNIT>
|
創(chuàng)建單位
|
|
<FILE_MAN>
|
創(chuàng)建人
|
|
<FILE_CREATE_TIME>
|
創(chuàng)建日期
|
|
<FILE_SIZE>
|
文檔大小
|
|
<FILE_AUTHOR>
|
文檔作者
|
|
<FILE_TITLE>
|
文檔標題
|
|
<FILE_BROTHER_ID>
|
兄弟節(jié)點ID，如果沒有兄長，則為 -1
|
|
<FILE_PARENT_ID>
|
父親節(jié)點ID, 如果沒有父親，則為 -1
|
獲得文檔所有兄弟信息與獲得文檔基本信息類似，區(qū)別之處在于在獲得文檔所有兄弟信息的時候，施工系統(tǒng)僅僅需要提交一個最小兄弟的節(jié)點，外協(xié)系統(tǒng)自動找出該文檔的所有“兄長”文檔信息返回。
注意，在返回的所有兄弟報文中，最小的兄弟排在記錄的最前面，依序排序往上，最后，最大的兄弟排在最后面。
下面的這個報文雖然和前面的“如何獲得文檔的基本信息”報文一樣，但是，施工系統(tǒng)僅僅需要提交一條文檔的ID。而且，這個求情所調(diào)用的接口和前面的“如何獲得文檔的基本信息”的所調(diào)用的接口是不一樣的。
請求報文：
<?xml version="1.0" encoding="utf-8"?>
<XmlData>
<UserInfo>
<User>ZhangSan</User>
<PassWord>123456</PassWord>
</UserInfo>
<Description>
</Description>
<Records>
<Record>
<ID>123456</ID>
</Record>
</Records>
</XmlData>
響應報文：
<?xml version="1.0" encoding="utf-8"?>
<XmlData>
<Description>
<Result>成功</Result> <!--如果失敗，則返回信息是“失?。海ㄥe誤信息）”-->
</Description>
<Records>
<Record>
<ID>123456</ID>
<FILE_PRJ_ID>Value1</FILE_PRJ_ID>
<FILE_TYPE>Value2</FILE_TYPE>
<FILE_CREAET_MODE>Value3</FILE_CREAET_MODE>
<FILE_NAME>Value4</FILE_NAME>
<FILE_UNIT>Value5</FILE_UNIT>
<FILE_MAN>Value6</FILE_MAN>
<FILE_CREATE_TIME>Value7</FILE_CREATE_TIME>
<FILE_SIZE>Value8</FILE_SIZE>
<FILE_AUTHOR>Value9</FILE_AUTHOR>
<FILE_TITLE>Value10</FILE_TITLE>
<FILE_BROTHER_ID>456789</FILE_BROTHER_ID>
<FILE_PARENT_ID>Value12</FILE_PARENT_ID>
</Record>
<Record>
<ID>456789</ID>
<FILE_PRJ_ID>Value1</FILE_PRJ_ID>
<FILE_TYPE>Value2</FILE_TYPE>
<FILE_CREAET_MODE>Value3</FILE_CREAET_MODE>
<FILE_NAME>Value4</FILE_NAME>
<FILE_UNIT>Value5</FILE_UNIT>
<FILE_MAN>Value6</FILE_MAN>
<FILE_CREATE_TIME>Value7</FILE_CREATE_TIME>
<FILE_SIZE>Value8</FILE_SIZE>
<FILE_AUTHOR>Value9</FILE_AUTHOR>
<FILE_TITLE>Value10</FILE_TITLE>
<FILE_BROTHER_ID>-1</FILE_BROTHER_ID>
<FILE_PARENT_ID>Value12</FILE_PARENT_ID>
</Record>
</Records>
</XmlData>
各種標簽說明：（參見前面的“如何獲得文檔的基本信息”說明）
同“如何獲得文檔的所有兄弟信息”接口一樣，施工系統(tǒng)向外協(xié)系統(tǒng)提交最小輩分的一個文檔的ID，外協(xié)系統(tǒng)自動返回所有的父輩文檔信息，包含父親，爺爺，祖爺爺?shù)取?/span>
請求報文：（參見“如何獲得文檔的所有兄弟信息”請求報文）
響應報文：（參見“如何獲得文檔的所有兄弟信息”響應報文）
各種標簽說明：（參見前面的“如何獲得文檔的基本信息”說明）
獲得文檔的ID之后，施工系統(tǒng)可以向外協(xié)系統(tǒng)請求下載某一個文檔的實體數(shù)據(jù)。外協(xié)系統(tǒng)把文檔用二進制讀取出來之后，轉(zhuǎn)換成base64的格式供施工系統(tǒng)下載。施工系統(tǒng)一次只能請求下載一個文檔。
請求報文：
<?xml version="1.0" encoding="utf-8"?>
<XmlData>
<UserInfo>
<User>ZhangSan</User>
<PassWord>123456</PassWord>
</UserInfo>
<Description>
</Description>
<Records>
<ID>123456</ID>
</Records>
</XmlData>
響應報文：
<?xml version="1.0" encoding="utf-8"?>
<XmlData>
<Description>
<Result>成功</Result> <!--如果失敗，則返回信息是“失?。海ㄥe誤信息）”-->
</Description>
<Records>
<Record>
<FileData>/e5asf@dfgafa#sdgsdg……</FileData>
</Record>
</Records>
</XmlData>
報文說明：
|
標簽名
|
說明
|
|
<XmlData>
|
報文數(shù)據(jù)主體
|
|
<Description>
|
報文頭部信息
|
|
<Records>
|
記錄集合
|
|
<Record>
|
一行記錄
|
|
<UserInfo>
|
業(yè)務認證的用戶信息
|
|
<User>
|
業(yè)務用戶登錄名
|
|
<PassWord>
|
業(yè)務用戶驗證口令
|
|
<ID>
|
文檔的ID。請求下載的文檔ID
|
|
<FileData>
|
文件實體內(nèi)容。文件實體內(nèi)容用二進制讀取出來之后，然后轉(zhuǎn)換成base64的格式提供給施工系統(tǒng)。
|
|
<Result>
|
反饋報文中的下載成功與否信息。
如果下載成功，則信息是“成功”
如果下載失敗，則信息是“失敗：（后面是錯誤的詳細信息）”
|