w接入技術(shù)商城軟件接口

1、修訂歷史第2頁 共50頁編號章節(jié)修訂說明修訂日期修訂前版本號修訂后版本號修改人審批人012.3權(quán)限服務(wù)接口20090531豐立新022.4服務(wù)接口20090601豐立新032.1-2.4描述內(nèi)容標(biāo)準(zhǔn)化200911230.51.0042.1-2.5增加 XML 協(xié)議描述200911301.01.1052.1修改 TokenInfo 返回內(nèi)容，增加應(yīng)用軟件權(quán)限起止時(shí)間200912251.11.2062.42.5為了便于理解，平臺用戶服務(wù)方法GetSingleUser 名稱改為GetPlatformUserInfo；為獲取用戶在公司的，公司用戶服務(wù)增加方法GetCompanyUserInfo2010

2、01061.21.3072.5啟用方法 GetCompanyUserInfo 中IsSuperAdmin 標(biāo)記，一個(gè)公司只能有一個(gè)超級管理員201001081.31.402.1：TokenInfo 方法返回中增加<AppInfoList>節(jié)點(diǎn)，為改用戶具有使用 權(quán)限的軟件應(yīng)用列表；2.4 ：GetPlatformUserInfo 方法返回中去掉<MobileNumber1>節(jié)點(diǎn)，因?yàn)橛脩粜畔榭諘?dǎo)致節(jié)點(diǎn)不存在；2.5 ：GetCompanyUserInfo 方法返回中去掉<MobileNumber1>和< OfficeNumber

3、>節(jié)點(diǎn)，因?yàn)橛脩粜畔榭諘?dǎo)致節(jié)點(diǎn)不存在。201003241.41.5D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5目錄1.簡介4444678目的參考資料調(diào)用方式調(diào)用格式返回格式異常信息說明2.接口調(diào)用說明101010121214161618202224252729313234363739414143454547482.1登錄信息獲取2.1.1 TokenInfo公司賬戶服務(wù)2.2.1 ModifyUserProfileDef2.2.2 GetCompanyInfo公司組織機(jī)構(gòu)服務(wù)2.3.1 CreateCompany

4、DeptRelation2.3.2 ModifyCompanyDeptRelation2.3.3 DeleteCompanyDeptRelation2.3.4 GetCompanyDeptList2.3.5 GetCompanyDeptInfo2.3.6 CreateCompanyUserInDept2.3.7 ModifyCompanyUserInDept2.3.8 DeleteCompanyUserInDept2.3.9 DeleteAllUserInDept...14GetCompanyUserInDept GetPrinci

5、palUserInDept GetUserInDeptListByUser GetUserInDeptListByDept GetDeptUserListByCompany2.4平臺用戶帳戶服務(wù)2.4.1 GetUserList2.4.2 GetPlatformUserInfo公司用戶帳戶服務(wù)2.5.1 GetCompanyID2.5.2 GetUserID2.5.3 GetCompanyUserInfo2.5第3頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5統(tǒng)一認(rèn)證軟件接口文檔1. 簡介此文檔包含統(tǒng)一認(rèn)證接口說明。所牽涉的內(nèi)容：個(gè)人賬戶、用戶公司

6、賬戶、公司組織機(jī)構(gòu)。1.1目的本文檔旨在說認(rèn)證的接口相關(guān)說明，方便第軟件開發(fā)商進(jìn)行接口調(diào)用。1.2參考資料Microsoft Geneva Framework.Net Framework 3.5Enterprise Library 4.1SQL Server 20052008UDDI1.3調(diào)用方式調(diào)用方按照約定協(xié)議封裝好調(diào)用的 XML 格式文本（1.4 節(jié)），將 XML 文本采用 POST 方式傳遞到開放的頁面，地址：；然后頁面的響應(yīng)內(nèi)容，應(yīng)為返回的 XML 格式文本（1.5 節(jié)），按約定協(xié)議內(nèi)容，完成整個(gè)調(diào)用過程。需要注意的是：在將 XML 文本 POST 到頁面前，要對 XML 文本進(jìn)行

7、URL 編碼，采用 UTF-。8，接收到頁面的響應(yīng)，也應(yīng)進(jìn)行 URL第4頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5Wissip Web ServiceLogin.aspxWissip CA ServerWissip Proxy ServerProxy.aspx LoginISV 應(yīng)用Index步驟說明：1.鑒權(quán)：此步驟是用戶在ISV 應(yīng)用（簡稱 RP）的時(shí)候，假設(shè)系統(tǒng)需要進(jìn)行鑒權(quán)，RP 根據(jù)如下順序進(jìn)行：（1）是否登錄，依據(jù)是否在緩存中有 wissip 平臺的用戶令牌(token)若有，進(jìn)行；（2）使用用戶當(dāng)前令牌調(diào)用 WISSIP的方法驗(yàn)證用

8、戶時(shí)候有對RP 的權(quán)限，若有，；若上面兩步任一步失敗，跳轉(zhuǎn)到 RP 的 login 登錄2.Login 頁面負(fù)責(zé)構(gòu)造一個(gè)到有：String AuthenticationURL="rk:requestKey 是指發(fā)起登錄的申請的標(biāo)識傳遞的參數(shù)?"AuthenticationURL +="rk=e27bb0e9-d2a3-4f1e-a0c6-f585aa6bd6e4" dk: 目的應(yīng)用程序的標(biāo)識即 RP 應(yīng)用程序在平臺上的唯一標(biāo)識AuthenticationURL +="&dk=e27bb0e9-d2a3-4f1e-a0c6-f585aa6

9、bd6e4"du：目的應(yīng)用程序的 URL，需要做 URL 編碼，采用 utf8 的格式，當(dāng)平臺對用戶認(rèn)證完畢后會第5頁 共50頁4.Clien1.2.轉(zhuǎn)到請求令牌6.通過服務(wù)，獲取用戶信息5.令牌緩存3.轉(zhuǎn)到請求令牌返回當(dāng)前用戶令牌D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5回調(diào)此，并 post 數(shù)據(jù)給他，故此必須能在到。AuthenticationURL +="&du="+ URLEncoder.encoginUrl, "utf-8"); tm：調(diào)用時(shí)間，采用用格林威治標(biāo)準(zhǔn)時(shí)間:GMT 都柏林，愛丁

10、堡，里斯本， 采用 ISO8601 標(biāo)準(zhǔn)格式：yyyy-MM-ddTHH:mm:ssZ例如：2009 年 6 月 1 日上午 9 點(diǎn) 30 分 30 秒，表示為：2009-06-01T09:30:30Z AuthenticationURL +="&tm=" +URLEncoder.encode(time, "utf-8");3.請求令牌RP 的 LogIn 跳轉(zhuǎn)到將組裝的 AuthenticationURL 地址4.平臺對用戶進(jìn)行認(rèn)證，并將認(rèn)證后的結(jié)果 Post 到 AuthenticationURL 中指定的 du 參數(shù)表示的頁面,已 Post

11、 方式返回,具體內(nèi)容包括：tk：的安全令牌rk：發(fā)起登錄的申請的標(biāo)識dk：目的應(yīng)用程序的標(biāo)識du：目的應(yīng)用程序的URLtm：調(diào)用時(shí)間這些參數(shù)可以通過獲取 form 值的方式得到5. 建議做法是將 tk 緩存在 session 里，可以在用戶會話范圍內(nèi)復(fù)用。6.通過明手冊.doc平臺服務(wù)，獲取認(rèn)證和信息：具體調(diào)用方法參考SSIP 平臺 API 調(diào)用簡1.4調(diào)用格式<WebServiceProxy><SecurityToken> Token</SecurityToken><LoginKey>LoginKey</LoginKey ><

12、ResquestKey>ResquestKey</ResquestKey><ProductKey>ProductKey</ProductKey><Call><Assembly>Assembly</Assembly><Function>DoWork</Function><Parameters><Name>arg</Name><Value>value</Value></Parameters></Call></

13、WebServiceProxy>說明:根節(jié)點(diǎn)(<WebServiceProxy>): 表示為 Web Service 的調(diào)用安全令牌(<SecurityToken> 3-5):第6頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5XML，以用戶為登錄時(shí)返回的安全令牌，可以得到所有的信息登錄標(biāo)記(<LoginKey> 6):GUID，登錄后寫在令牌中的信息之一，以便快速識別令牌請求標(biāo)記(<ResquestKey > 7): GUID，調(diào)用方的請求標(biāo)記 標(biāo)記(<ProductKey> 7):

14、GUID，調(diào)用方的標(biāo)記調(diào)用信息(<Call> 10- 19)<Assembly>:文本，表示名<Function>:文本，調(diào)用的函數(shù)名<Parameters> :所有參數(shù)<Parameter>:單個(gè)參數(shù)<Name>文本，參數(shù)名<Value>文本，參數(shù)值1.5返回格式<WebServiceProxy><LoginKey>LoginKey</ LoginKey ><ResquestKey>ResquestKey</ResquestKey><Produ

15、ctKey>ProductKey</ProductKey><Result><Succeed>TRUE</Succeed><Error><ErrorID>1001</ErrorID><Message>ErrMessage</Message></Error><Value>value</Value></Result></WebServiceProxy>說明:根節(jié)點(diǎn)(<WebServiceProxy>):表示為 Web

16、 Service 的調(diào)用登錄標(biāo)記(<LoginKey> 2):GUID，與調(diào)用相同請求標(biāo)記(<ResquestKey GUID，與調(diào)用相同標(biāo)記(<ProductKey>GUID，與調(diào)用相同返回信息(<Result> 5-> 3):4):12)<Succeed>:，調(diào)用是否<Error>:文本，失敗時(shí)的錯(cuò)誤信息<ErrorID>:文本，錯(cuò)誤代碼<Message>:文本，錯(cuò)誤信息<Value>文本，返回值：經(jīng)過 XML 處理的文本第7頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1

17、000 接口文檔工件版號: 0.51.6異常信息說明l<Result>以下為返回信息為異常信息的一個(gè)樣例：<Succeed>False</Succeed><Error><ErrorID>1</ErrorID><Message><Exceptions><RootMessage>調(diào)用發(fā)生錯(cuò)誤</RootMessage><Exception><Type>System.Reflection.TargetInvocationException</Type&

18、gt;<Message>調(diào)用發(fā)生了異常</Message><Source>mscorlib</Source><StackTrace>在中</StackTrace><Exception><Type>System.ServiceM.FaultException1CompanyDeptService_Proxy.CompanyDeptService.ServiceFaultContract</Type><Message>"rn 錯(cuò)誤編碼：1050rn 錯(cuò)誤描述：找不到指定

19、 ID 的公司部門信息rn 處理您的請求發(fā)生一個(gè)錯(cuò)誤，請技術(shù)支持n 內(nèi)部信息：Doxt.SSIP.SSOWCFService.FaultContracts.ServiceFaultContra ct"</Message><Source>mscorlib</Source><StackTrace>在中</StackTrace><Reason>"rn 錯(cuò)誤編碼：1050rn 錯(cuò)誤描述：找不到指定 ID 的公司部門信息rn 處理您的請求發(fā)生一個(gè)錯(cuò)誤，請技術(shù)支持n 內(nèi)部信息：Doxt.SSIP.SSOWCFSer

20、vice.FaultContracts.ServiceFaultContra ct"</Reason><ErrorCode>1050</ErrorCode><ErrorMessage>找不到指定 ID 的公司部門信息</ErrorMessage></Exception></Exception></Exceptions></Message></Error></Result>l如下是用 C#語言編寫的處理異常的示例代碼，粗黑體字是服務(wù)接口定義的異常類，通過捕

21、獲該服務(wù)接口拋出的異常類來獲得詳細(xì)異常信息：tryreturnValue = companyServiceClient.Create(companyEntity);MessageBox.Show("增加公司信息!");第8頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5catch(FaultException< CompanyService_Proxy.CompanyService.ServiceFaultContract> ex)CompanyService.ServiceFaultContract error =

22、ex.Detail;string errorMsg = string.Format("An Fault is thrown.ntFault Type:0ntFault Reason:1ntError Code:2ntError Message:3", ex.GetType().ToString(), ex.Reason, error.ErrorCode, error.ErrorMessage);catch (Exception ex)string errorMsg = string.Format("An Exception is thrown.ntExceptio

23、n Type:0ntError Message:1",ex.GetType(),ex.Message);MessageBox.Show(errorMsg);第9頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.52. 接口調(diào)用說明2.1 登錄信息獲取2.1.1 TokenInfo1） 功能描述獲取登錄信息2） 調(diào)用參數(shù)3） 調(diào)用返回信息4） XML 協(xié)議約定調(diào)用：<WebServiceProxy><SecurityToken>CiAgICA8b24+CiAg</SecurityToken><LoginK

24、ey>a36c0c4c-5656-451a-a93b-3a6867a88a44</LoginKey><ResquestKey>4d133795-18d6-4cc0-a01a-da9f28a60571</ResquestKey><ProductKey>AA6C3F87-46DD-4C06-86D6-57CC9239DA95</ProductKey><Call><Assembly></Assembly><Function>TokenInfo</Function><Pa

25、rameters /></Call></WebServiceProxy>返回:<WebServiceProxy><LoginKey>a36c0c4c-5656-451a-a93b-3a6867a88a44</LoginKey><ResquestKey></ResquestKey><ProductKey>AA6C3F87-46DD-4C06-86D6-57CC9239DA95</ProductKey><Result><Succeed>True</Succ

26、eed><Value><LoginInfo><UserID>10</UserID>第10頁 共50頁返回值返回值說明返回類型LoginInfo登錄信息正常返回名稱類型是否必須描述D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5<LoginName>登錄名（用戶名/公司<RealName>真實(shí)姓名</RealName>）</LoginName><CompanyID>65（Int64）</CompanyID><CompanyName&g

27、t;公司名稱</CompanyName><CompanyUserID>92（Int64）</CompanyUserID><AppStartTime>登錄應(yīng)用的開始時(shí)間</AppStartTime><AppEndTime>登錄<AppInfoList><AppInfo><Key>應(yīng)用的結(jié)束時(shí)間</AppEndTime>1 的序列號</Key><StartTime><EndTime></AppInfo><AppInfo>

28、1 的開始時(shí)間</StartTime>1 的結(jié)束時(shí)間</EndTime><Key>2 的序列號</Key><StartTime><EndTime></AppInfo></AppInfoList></LoginInfo></Value></Result></WebServiceProxy>2 的2 的開始時(shí)間</StartTime> 結(jié)束時(shí)間</EndTime>5） Dotnet 平臺調(diào)用范例ProxyStream.Product

29、Key = ProductKey; ProxyStream.ProxyUrl = ProxyHost; ProxyStream ps = new ProxyStream();ps.Token = formStsHelper.SSO_STS_POSTHTMLTAG_TOKEN; ps.LoginKey = Guid.NewGuid().ToString();if (ps.Call(true)return (FederationUserInfo)ps.ResultValue;elsereturn new FederationUserInfo(ps.ErrorMessage);6）2009-6-6

30、21:00:00第11頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.52.2公司賬戶服務(wù)2.2.1 ModifyUserProfileDef1） 功能描述單個(gè)或批量修改用戶公司用戶擴(kuò)展字段定義信息，此方法只維護(hù)傳入公司實(shí)體中<Configuration>節(jié)點(diǎn)的內(nèi)容，除了<CompanyID>之外其他節(jié)點(diǎn)內(nèi)容請保持為空。2） 調(diào)用參數(shù)3） 調(diào)用返回信息4） XML 協(xié)議約定調(diào)用：<WebServiceProxy><SecurityToken>CiAgICA8b24+CiAg</SecurityTok

31、en><LoginKey>0a5eff78-70b3-411c-87fc-f95f78288465</LoginKey><ResquestKey>b3c6f25d-7736-4478-b092-2045fa17231a</ResquestKey><ProductKey>AA6C3F87-46DD-4C06-86D6-57CC9239DA95</ProductKey><Call><Assembly>CompanyService</Assembly><Function>Mo

32、difyUserProfileDef</Function><Parameters><Name>request</Name><Value><ReqModifyUserProfileDef1><ReqModifyUserProfileDef><CompanyInfoList><DACCompanyEntity><CompanyID>65（Int64）</CompanyID><CompanyRegisterDate/><IsApproved/>&

33、lt;ApproveMan/><ApproveDate/><Status /><Configuration>擴(kuò)展字段定義信第12頁 共50頁返回值返回值說明返回類型code返回代碼,包含在消息契約 ResCompanyValue 中Code:0修改用戶公司用戶擴(kuò)展定義信息正常返回Code:1003修改用戶公司用戶擴(kuò)展定義信息失敗異常返回名稱類型是否必須描述requestReqModifyUserProfileDef1必須用戶公司實(shí)體集合消息契約傳入?yún)?shù)D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5息</Confi

34、guration></DACCompanyEntity></CompanyInfoList></ReqModifyUserProfileDef></ReqModifyUserProfileDef1></Value></Parameters></Call></WebServiceProxy>返回:<WebServiceProxy><LoginKey>0a5eff78-70b3-411c-87fc-f95f78288465</LoginKey><Resqu

35、estKey>b3c6f25d-7736-4478-b092-2045fa17231a</ResquestKey><ProductKey>AA6C3F87-46DD-4C06-86D6-57CC9239DA95</ProductKey><Result><Succeed>True</Succeed><Value><ResCompanyValue><ReturnValue>0</ReturnValue></ResCompanyValue></Value&g

36、t;</Result></WebServiceProxy>5） Dotnet 平臺調(diào)用范例Using Doxt.SSIP.SSO.Federated.Proxy.Company;CompanyProxy companyChannel = new CompanyProxy(bodyXml, loginKey); DACCompanyEntity companyEntity;ReqModifyUserProfileDef1 request = new ReqModifyUserProfileDef1(); ReqModifyUserProfileDef reqUserPro

37、fileDef = new ReqModifyUserProfileDef(); companyEntity = new DACCompanyEntity();companyEntity.CompanyID = 36;companyEntity.Configuration = "<UserDef><UserName Type='nvarchar(20)' /><RealName Type='nvarchar(20)' /><Sex Type='int' /><Brthday Type

38、='datetime' /><IdentityCardNumber Type='nvarchar(25)' /><OICQ Type='nvarchar(20)' /><Photo Type='binary(50)' /><Province Type='int' /><City Type='int' /><PrivyWebSite Type='nvarchar(50)' /><WorkingHours

39、 Type='datetime' /><GoIntoCalling Type='int' /><Station Type='int' /><BankBookType='nvarchar(20)' /><Type='nvarchar(256)' /><MobileNumber1 Type='nvarchar(15)'/><OfficeNumber Type='nvarchar(20)' /><HomeP

40、honeNumber Type='nvarchar(20)' /><OfficeNumber Type='nvarchar(20)' /><OfficeAddress Type='nvarchar(100)' /><HomeAddress Type='nvarchar(100)' /></UserDef>"DACCompanyEntityList companyEntityList = new DACCompanyEntityList(); companyEntity

41、List.Add(companyEntity);ResCompanyValue returnValue; reqUserProfileDef.CompanyInfoList = companyEntityList; request.ReqModifyUserProfileDef = reqUserProfileDef;第13頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5returnValue = companyChannel.ModifyUserProfileDef(request); long code = returnValue.ReturnV

42、alue;6）2009-6-6 21:00:002.2.2 GetCompanyInfo1） 功能描述根據(jù)公司 ID用戶所在公司信息2） 調(diào)用參數(shù)3） 調(diào)用返回信息4）2009-6-6 21:00:005） XML 協(xié)議約定調(diào)用：<WebServiceProxy><SecurityToken>CiAgICA8b24+CiAg</SecurityToken><LoginKey>0a5eff78-70b3-411c-87fc-f95f78288465</LoginKey><ResquestKey>e679affe-76c2-4

43、273-9f14-0ca6fda59c0d</ResquestKey><ProductKey>AA6C3F87-46DD-4C06-86D6-57CC9239DA95</ProductKey><Call><Assembly>CompanyService</Assembly><Function>GetCompanyInfo</Function><Parameters><Name>request</Name><Value><ReqCompanyID1

44、><ReqCompanyID><CompanyID>65（Int64）</CompanyID></ReqCompanyID></ReqCompanyID1></Value>第14頁 共50頁返回值返回值說明返回類型DACCompanyEntity存在信息，返回用戶公司數(shù)據(jù)契約實(shí)體信息,包含在消息契約ResCompanyInfo 中正常返回Null不存在此 ID 的用戶公司信息正常返回Code:1007用戶所在公司信息失敗異常返回名稱類型是否必須描述requestReqCompanyID1必須用戶公司 ID 消息契約傳

45、入?yún)?shù)D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5</Parameters></Call></WebServiceProxy>返回:<WebServiceProxy><LoginKey>0a5eff78-70b3-411c-87fc-f95f78288465</LoginKey><ResquestKey>e679affe-76c2-4273-9f14-0ca6fda59c0d</ResquestKey><ProductKey>AA6C3F87-46DD

46、-4C06-86D6-57CC9239DA95</ProductKey><Result><Succeed>True</Succeed><Value><ResCompanyInfo><CompanyInfo><ExtensionData>擴(kuò)展數(shù)據(jù)</ExtensionData><CompanyID>65（Int64）</CompanyID><CompanyDomain></CompanyDomain><CompanyName>公司

47、名</CompanyName><CompanyAddress>公司地址</CompanyAddress><Contact>人</Contact><ContactNumber>人</ContactNumber></CompanyWebSite><CompanyWebSite>公司<CompanyIndustry>行業(yè)</CompanyIndustry><CompanyLicense><CompanyArtificial<CompanyZipC

48、ode></CompanyLicense>></CompanyArtificial></CompanyZipCode><Company></Company><CompanyPhone>公司</CompanyPhone><CompanyRegisterDate>企業(yè)日期</CompanyRegisterDate><IsApproved>是否審核</IsApproved><ApproveMan>審核人</ApproveMan><

49、;ApproveDate>審核日期</ApproveDate><Status>公司賬戶狀態(tài)（0 未激活 1 已激活 2 已注銷 3 已凍結(jié) 4 已刪除）</Status><CompanyShortName>公司簡稱</CompanyShortName></CompanyInfo></ResCompanyInfo></Value></Result></WebServiceProxy>6） Dotnet 平臺調(diào)用范例Using Doxt.SSIP.SSO.Federated

50、.Proxy.Company;CompanyProxy companyChannel = new CompanyProxy(bodyXml, loginKey); CompanyServiceChannel companyChannel =ReqCompanyID1 request = new ReqCompanyID1(); ReqCompanyID reqCompanyID = new ReqCompanyID();第15頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5reqCompanyID.CompanyID = 25; request.Re

51、qCompanyID = reqCompanyID;ResCompanyInfo resCompanyInfo = companyChannel.GetCompanyInfo(request);DACCompanyEntity entity = resCompanyInfo.CompanyInfo;2.3公司組織機(jī)構(gòu)服務(wù)2.3.1 CreateCompanyDeptRelation1） 功能描述批量創(chuàng)建用戶公司組織機(jī)構(gòu)信息2） 調(diào)用參數(shù)3） 調(diào)用返回信息4） XML 協(xié)議約定調(diào)用：<WebServiceProxy><SecurityToken>CiAgICA8b24+C

52、iAg</SecurityToken><LoginKey>0a5eff78-70b3-411c-87fc-f95f78288465</LoginKey><ResquestKey>4518b9ed-5238-43b8-9a64-848d77828c6b</ResquestKey><ProductKey>AA6C3F87-46DD-4C06-86D6-57CC9239DA95</ProductKey><Call><Assembly>CompanyDeptService</Assembl

53、y><Function>CreateCompanyDeptRelation</Function><Parameters><Name>request</Name><Value><ReqCompanyDeptList1><ReqCompanyDeptList>第16頁 共50頁返回值返回值說明返回類型code返回代碼,包含在消息契約 ResCompanyDeptValue 中Code:0創(chuàng)建正常返回Code:1030創(chuàng)建用戶公司組織機(jī)構(gòu)失敗異常返回Code:1048用戶公司部門名重復(fù)異常返回Cod

54、e:1049部門名稱不能為空異常返回Code:1050找不到指定 ID 的公司部門信息異常返回Code:1051部門名稱長度大于最大長度 100異常返回Code: 1100找不到指定的用戶公司信息異常返回名稱類型是否必須描述requestReqCompanyDeptList1必須用戶公司組織機(jī)構(gòu)實(shí)體集合消息契約傳入?yún)?shù)D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5<CompanyDeptEntityList><DACCompanyDeptEntity><DeptID>1（Int64）</DeptID><De

55、ptName>部門 1 名</DeptName><DeptNote>部門 1 備注</DeptNote><ParentDeptID>0（Int64）</ParentDeptID><CompanyID>82（Int64）</CompanyID><DeptType>部門類型（1 公司部門，2 司）</DeptType></DACCompanyDeptEntity><DACCompanyDeptEntity><DeptID>2（Int64）</D

56、eptID><DeptName>部門 2 名</DeptName><DeptNote>部門 2 備注</DeptNote>子公<ParentDeptID>0（Int64）</ParentDeptID><CompanyID>82（Int64）</CompanyID><DeptType>部門類型（1 公司部門，2 司）</DeptType></DACCompanyDeptEntity></CompanyDeptEntityList></ReqC

57、ompanyDeptList></ReqCompanyDeptList1></Value></Parameters></Call></WebServiceProxy>返回:<WebServiceProxy><LoginKey>81275bc8-cc06-4937-8143-4ce30cfd10d8</LoginKey><ResquestKey>4518b9ed-5238-43b8-9a64-848d77828c6b</ResquestKey><ProductKey

58、>AA6C3F87-46DD-4C06-86D6-57CC9239DA95</ProductKey><Result><Succeed>True</Succeed><Value><ResCompanyDeptValue><ReturnValue>0</ReturnValue></ResCompanyDeptValue></Value></Result></WebServiceProxy>子公5） Dotnet 平臺調(diào)用范例Using Doxt.SS

59、IP.SSO.Federated.Proxy.CompanyDept;CompanyDeptProxy companyDeptChannel = new CompanyDeptProxy(bodyXml, DACCompanyDeptEntity companyDeptEntity;ReqCompanyDeptList1 request = new ReqCompanyDeptList1();loginKey);第17頁 共50頁D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5ReqCompanyDeptList reqCompanyDeptList = new

60、 ReqCompanyDeptList(); DACCompanyDeptEntityList companyDeptEntityList = new DACCompanyDeptEntityList(); ResCompanyDeptValue returnValue;for (int i = 0; i < 5; i+)companyDeptEntity = new DACCompanyDeptEntity(); companyDeptEntity.CompanyID = 21;companyDeptEntity.DeptName = "Department Top"

61、; + i.ToString();companyDeptEntity.DeptNote = "教工路 690 號百鬧會companyDeptEntity.DeptType = 2; companyDeptEntityList.Add(companyDeptEntity);3-315 信箱"reqCompanyDeptList.CompanyDeptEntityList = companyDeptEntityList; request.ReqCompanyDeptList = reqCompanyDeptList;returnValue = companyDeptChanne

62、l.CreateCompanyDeptRelation(request); long code = returnValue.ReturnValue;6）2009-6-6 21:00:002.3.2 ModifyCompanyDeptRelation1） 功能描述批量修改用戶公司組織機(jī)構(gòu)信息2） 調(diào)用參數(shù)3） 調(diào)用返回信息4） XML 協(xié)議約定調(diào)用：<WebServiceProxy><SecurityToken>CiAgICA8b24+CiAg</SecurityToken><LoginKey>0a5eff78-70b3-411c-87fc-f95

63、f78288465</LoginKey>第18頁 共50頁返回值返回值說明返回類型code返回代碼,包含在消息契約 ResCompanyDeptValue 中Code:0修改正常返回Code:1031創(chuàng)建用戶公司組織機(jī)構(gòu)失敗異常返回Code:1048用戶公司部門名重復(fù)異常返回Code:1049部門名稱不能為空異常返回Code:1050找不到指定 ID 的公司部門信息異常返回Code:1051部門名稱長度大于最大長度 100異常返回Code: 1100找不到指定的用戶公司信息異常返回名稱類型是否必須描述requestReqCompanyDeptList1必須用戶公司組織機(jī)構(gòu)實(shí)體集合消息契約傳入?yún)?shù)D-06-F-03/2.1工件標(biāo)識: SSO1000 接口文檔工件版號: 0.5&l