【文章內(nèi)容簡(jiǎn)介】 （3） 業(yè)務(wù)邏輯：?新增一個(gè) WebService 時(shí)，系統(tǒng)自動(dòng)解析得到所有的方法信息，管理人員可以指定每一個(gè)方法的唯一標(biāo)識(shí)，并自動(dòng)包含該 WebService 的唯一標(biāo)識(shí)作為前綴。系統(tǒng)會(huì)檢查方法唯一標(biāo)識(shí)的唯一性！?新增一個(gè)數(shù)據(jù)庫(kù)服務(wù)后，可以手工添加數(shù)據(jù)獲取接口。數(shù)據(jù)庫(kù)類型方法的參數(shù)，通過(guò) @參數(shù)名 @的方式在腳本中引用。如果是日期類型參數(shù)，必須進(jìn)行 Convert(datetime,’@參數(shù)名 @’)進(jìn)行轉(zhuǎn)換；如果是字符串類型參數(shù)，使用 ’@參數(shù)名 @’。字段名 取值舉例methodName 獲取部門列表methodID [服務(wù)唯一標(biāo)識(shí)前綴]GetDeptListServiceGuid paramsFormat paramsparam 第19頁(yè)name/type/value//param/paramsresultSchema resultSample pageXSLT pageSchema isMtom ?新增一個(gè)文件類型服務(wù)后，系統(tǒng)自動(dòng)添加兩個(gè)方法：獲取文件信息、獲取文件詳細(xì)信息字段名 取值舉例methodName 獲取文件基本信息methodID [服務(wù)唯一標(biāo)識(shí)前綴]GetFileInfo。 [服務(wù)唯一標(biāo)識(shí)前綴]GetFileDetailInfo。ServiceGuid paramsFormat resultSchema FileInfoFileName/FileSize/FileDate/FileContent//FileInforesultSample pageXSLT pageSchema isMtom 調(diào)用客戶端分類為了方便對(duì)客戶端進(jìn)行管理，對(duì)客戶端進(jìn)行分類。實(shí)現(xiàn)方式參考服務(wù)類別管理。相關(guān)數(shù)據(jù)表：SOA_Client_Category 調(diào)用客戶端管理登記管理所有 SOA 調(diào)用客戶端的資料。為每個(gè)調(diào)用方提供一套認(rèn)證賬號(hào)、數(shù)字證書。相關(guān)數(shù)據(jù)表：SOA_Client 第20頁(yè) 客戶端用戶范圍設(shè)定對(duì)于業(yè)務(wù)系統(tǒng)來(lái)說(shuō)，每個(gè)業(yè)務(wù)系統(tǒng)中的用戶可能只是中心中的一部分，在業(yè)務(wù)系統(tǒng)獲取組織架構(gòu)信息的時(shí)候，需要過(guò)濾返回的信息。 服務(wù)授權(quán)管理 對(duì)中心注冊(cè)的服務(wù)進(jìn)行權(quán)限管理，可以控制到每一個(gè)服務(wù)或方法。服務(wù)類型樹 服務(wù)列表?點(diǎn)擊“授權(quán)”列，對(duì)每一個(gè)服務(wù)可以設(shè)置授權(quán)，授權(quán)對(duì)象為已注冊(cè)的客戶端 相關(guān)數(shù)據(jù)表：SOA_Invoke_Right 系統(tǒng)運(yùn)行監(jiān)控（1） 對(duì)服務(wù)的調(diào)用日志進(jìn)行查詢統(tǒng)計(jì)，相關(guān)表：SOA_InvokeLog（2） 對(duì)服務(wù)調(diào)用過(guò)程中出現(xiàn)的錯(cuò)誤信息進(jìn)行查詢，相關(guān)表：SOA_InvokeException 第21頁(yè) SRC 的核心 WebService 接口服務(wù)SRC 提供的 WebService 接口主要包括：服務(wù)發(fā)現(xiàn)、服務(wù)發(fā)布、服務(wù)更新、服務(wù)列表、第三方服務(wù)調(diào)用代理、身份認(rèn)證等。 身份認(rèn)證接口? String ClientAuthenticate(string strLoginID,string strPwd)? 作用：為調(diào)用方提供身份驗(yàn)證，如果成功會(huì)返回 TokenGuid。? 參數(shù)：登錄帳號(hào)、密碼 ? 返回值：TokenGuid，如果未通過(guò)驗(yàn)證，返回空字符串。? 業(yè)務(wù)邏輯：如果賬號(hào)合法，隨機(jī)生成一個(gè) Token，保存到 SOA_Token表中，并記錄它對(duì)應(yīng)的客戶端唯一標(biāo)識(shí) ClientGuid。 服務(wù)調(diào)用權(quán)限判斷接口? Bool CheckInvokeRight(string Token,string MethodID)? 作用：提供給服務(wù)開發(fā)方調(diào)用，根據(jù)客戶端提供的 Token 確定是否需要為他提供服務(wù)。? 參數(shù)：? Token：客戶端從 SRC獲取的令牌 Guid? MethodID:客戶端調(diào)用的方法唯一標(biāo)識(shí)，如：? 返回值：true/false? 業(yè)務(wù)邏輯：? 根據(jù) Token到 Token表取得客戶端 Guid? 到 SOA_Invoke_Right中檢查該客戶是否具備調(diào)用當(dāng)前方法的權(quán)限。 服務(wù)地址獲取接口? String [] GetRealUrlAndMethod(string methodID)? 作用：為調(diào)用方提供真實(shí)的 WebService 地址。? 參數(shù)：? MethodID:客戶端調(diào)用的方法唯一標(biāo)識(shí)，如：? 返回值：長(zhǎng)度為 2的數(shù)組，分別對(duì)應(yīng)實(shí)際的 wsdl地址（前）和方法名稱（后） 第22頁(yè)? 業(yè)務(wù)邏輯： 服務(wù)調(diào)用審計(jì)接口? InvokeAudit(string InvokerName,string InvokeDate,string FromIP,string methodID, string Params,bool IsAuth,string Description)? 作用：提供給服務(wù)開發(fā)方調(diào)用，在為客戶端提供服務(wù)時(shí)，向 SRC 登記調(diào)用日志記錄。? 參數(shù)：? InvokerName：調(diào)用者名稱? InvokeDate：調(diào)用日期? FromIP：調(diào)用方的 IP地址? MethodID:客戶端調(diào)用的方法唯一標(biāo)識(shí)，如：? Params：調(diào)用參數(shù)? IsAuth:是否通過(guò)權(quán)限認(rèn)證? Description：補(bǔ)充描述? 業(yè)務(wù)邏輯：? 根據(jù)客戶端調(diào)用的方法唯一標(biāo)識(shí)和版本號(hào)，取得服務(wù)對(duì)應(yīng)的 Wddl地址、服務(wù)名稱等補(bǔ)充信息，向 SOA_InvokeLog 表添加一條記錄。 服務(wù)調(diào)用接口? InvokeMethod(string Token,string MethodID, Object[] parameters)? 作用：SRC 提供的代理方式訪問(wèn)目標(biāo)服務(wù),并取得返回值。? 參數(shù)：? Token：客戶端從 SRC獲取的令牌 Guid? MethodID:客戶端調(diào)用的方法唯一標(biāo)識(shí)，如：? Parameters：調(diào)用目標(biāo)服務(wù)需要提供的參數(shù)，如果目標(biāo)服務(wù)的調(diào)用參數(shù)中包含 Token，需要重復(fù)傳入和第一個(gè)參數(shù)相同的 Token 值。? 返回值：ReturnInfo StatusTrue|False/ Status Description描述信息/ DescriptionReturnInfoUserArea ![CDATA[相關(guān)返回?cái)?shù)據(jù)的 XML文本]] 第23頁(yè)/UserArea? 業(yè)務(wù)邏輯：? 根據(jù) Token到 Token表取得客戶端 Guid? 到 SOA_Invoke_Right中檢查該客戶是否具備調(diào)用當(dāng)前方法的權(quán)限。 服務(wù)提供方開發(fā)說(shuō)明 WebService 開發(fā)如果需要對(duì)調(diào)用方的身份進(jìn)行驗(yàn)證，可以在服務(wù)方法中添加對(duì) SRC 核心 WebService—服務(wù)調(diào)用權(quán)限判斷接口的調(diào)用。 if ((token, )) { xmlData = (False, 沒(méi)有權(quán)限!!, null)。 return xmlData。 } WebService 注冊(cè)、測(cè)試、發(fā)布服務(wù)唯一 ID 必須由注冊(cè)方指定，并且在全局保持唯一。方法唯一 ID 由服務(wù)唯一 ID+‘.’+方法名稱組成。提交時(shí)系統(tǒng)檢測(cè)其唯一性。 服務(wù)消費(fèi)方 我們需要開發(fā)一個(gè)通用的服務(wù)調(diào)用客戶端類庫(kù)：，幫助消費(fèi)方更加方便地調(diào)用服務(wù)。這個(gè)類庫(kù)的主要功能包括以下幾點(diǎn)： 對(duì)電子政務(wù)基礎(chǔ)支撐平臺(tái)的 WebService 的調(diào)用接口直接在項(xiàng)目中建立 Web 引用，并重新封裝成供客戶端程序調(diào)用的代理類。 對(duì) SRC 核心 WebService 的調(diào)用接口直接在項(xiàng)目中建立 Web 引用，并重新封裝成供客戶端程序調(diào)用的代理類。 第24頁(yè) 通用的動(dòng)態(tài) WebService 調(diào)用接口實(shí)現(xiàn)通過(guò) WSDL 來(lái)調(diào)用 WebMethod 的功能 電子政務(wù)基礎(chǔ)支撐平臺(tái)提供的服務(wù) 組織架構(gòu)類接口說(shuō)明（其他接口標(biāo)準(zhǔn)請(qǐng)參考制定）1)獲取所有組織單元 public string GetAllOU(string Token)?參數(shù)：?Token：?jiǎn)吸c(diǎn)登錄令牌?返回值 XML 格式 第25頁(yè)? XML 舉例：OUListOUOUGuid/OUGuid 部門Guid標(biāo)識(shí)OUCode/OUCode 部門CodeOUName/OUName 部門名稱OUShortName/OUShortName 部門簡(jiǎn)稱OrderNumber/OrderNumber 部門排序Description/Description 部門描述Address/Address 部門所在地址PostalCode/PostalCode 郵編Tel/Tel 電話BaseOUGuid/BaseOUGuid 獨(dú)立管理部門Guid標(biāo)識(shí)IsSubWebFlow/IsSubWebFlow 子流轉(zhuǎn)部門標(biāo)識(shí)ParentOUGuid/ParentOUGuid 父部門標(biāo)識(shí) 第26頁(yè)OUCodeLevel/OUCodeLevelHasChildOu/HasChildOu 子部門數(shù)HasChildUser/HasChildUser 部門人員數(shù)UpDateTime/UpDateTime 最近更新部門信息時(shí)間IsIndependence/IsIndependence 是否獨(dú)立管理部門（0否，1是）OuFax/OuFax 傳真/OUOU/OU/OUList2)獲取所有用戶資料： public string GetAllUser (string Token)特別說(shuō)明：不提供用戶照片的下載，如果需要照片，可通過(guò)單獨(dú)的 DetailUser 接口來(lái)獲取。?參數(shù)：?Token：?jiǎn)吸c(diǎn)登錄令牌?返回值 XML 格式UserListUserUserGuid/UserGuid 用戶Guid標(biāo)識(shí)LoginID/LoginID 登陸賬號(hào)IDpassword/password 加密的密碼OUGuid/OUGuid 用戶所在部門Guid標(biāo)識(shí)DisplayName/DisplayName 用戶顯示名稱IsEnabled/IsEnabled 是否啟用（0否，1是）Title/Title 職務(wù)LeaderGuid/LeaderGuid 領(lǐng)導(dǎo)Guid標(biāo)識(shí)OrderNumber/OrderNumber 排序TelephoneOffice/TelephoneOffice 辦公電話Mobile/Mobile 移動(dòng)電話Email/Email Email地址Description/Description 描述TelephoneHome/TelephoneHome 家庭電話Fax/Fax 傳真AllowUseEmail/AllowUseEmail 是否允許使用Email（1是，0否）Sex/Sex 性別（男或女）OUCodeLevel/OUCodeLevelUpDateTime/UpDateTime 最近更新信息時(shí)間birthday/birthday 出生日期Number/Number MSNNumber/MSNNumber MSNPostalAddress/PostalAddress 地址PostalCode/PostalCode 郵編 第27頁(yè)IdentityCardNum/IdentityCardNum 身份證/UserUser．．．．．．．．/User/UserList3)根據(jù)組織單元 Guid 獲取詳細(xì)資料：DetailOU4)根據(jù)用戶 Guid 獲取詳細(xì)資料：DetailUser5)根據(jù) BaseOUGuid 取得所有下級(jí) OU 信息 獲取支撐數(shù)據(jù)版本接口Public int GetSPDataVersion(string DataName) 對(duì)應(yīng)框架開發(fā)的業(yè)務(wù)系統(tǒng)的服務(wù)接口在框架系統(tǒng)中，調(diào)用 SOA 服務(wù)，獲取組織架構(gòu)的時(shí)候，不同注冊(cè)的系統(tǒng)獲取的數(shù)據(jù)有可能是不同的，如：權(quán)利陽(yáng)光系統(tǒng)和審批系統(tǒng)獲取的數(shù)據(jù)是不同的。我們?cè)诜?wù)中，通過(guò)系統(tǒng)注冊(cè)客戶端對(duì)應(yīng)的組織架構(gòu)范圍信息來(lái)獲取對(duì)應(yīng)的用戶列表。在中心提供的 Web 服務(wù)中，需要增加這樣的功能。目前還有的問(wèn)題： 效率可能不高。 對(duì)于跨多級(jí)目錄下用戶的時(shí)候，有些問(wèn)題，目前對(duì)于部門不過(guò)濾無(wú)用戶的部門。問(wèn)題描述： /// summary /// 將DataTable 轉(zhuǎn)換為XML字符串 /// /summary /// param name=dt/param /// returns/returns public static