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