一般服務引用範例
範例程式下載
請先下載教學投影片(參考引用服務資料章節)及範例程式並解壓縮,並以Visual Studio 2008開啟範例程式專案檔
說明
服務引用範例提供林務局內部同仁及委辦計畫廠商能夠進一步瞭解如何引用已註冊在林務局分組服務導向架構流通平台上的服務
準備動作
服務引用模組
- 認證及授權模組服務
使用林務局分組服務導向架構流通平台
服務前,必需先將由認證及授權程序,確認使用者或應用系統身份後, 再進一步檢核是否有存取服務的權限, 確保資料安全
*認證介面:Authenticate(string applicationId, string password)
參數說明:applicationId為應用系統識別碼,可由瀏覽應用系統詳細資料取得;password為應用系統密碼,亦可由應用系統詳細資料取得,唯應用系統密碼需為應用系統申請者才能瀏覽取得
回應資料:XML字串,內容如AuthenticationResponse.xml
*授權介面:Authorize(string token1, string serviceId)
參數說明:token1為執行Authenticate介面取得回應的XML中Token1元素之值;serviceId為服務識別碼,可由瀏覽服務詳細資料取得
回應資料:XML字串,內容如AuthorizationResponse.xml
- 服務整合模組服務
執行平台服務,呼叫後平台會將訊息轉送至服務提供端執行,經由平台的管控可以有效掌握服務的運行狀態
*呼叫服務介面:RequestService(string token2, string serviceId, string requestXml)
參數說明:token2為執行Authorize介面取得回應的XML中Token2元素之值;serviceId為服務識別碼,可由瀏覽服務詳細資料取得;requestXml為呼叫服務所需的XML格式查詢字串如ServiceRequest.xml
,可由瀏覽服務詳細資料下載服務使用規格書取得
回應資料:執行結果,為XML字串,內容如ServiceResponse.xml
服務引用步驟