::: 略過巡覽連結首頁 / 開發及支援 / 服務開發 / 服務引用範例

一般服務引用範例

範例程式下載

請先下載教學投影片(參考引用服務資料章節)及範例程式並解壓縮,並以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

服務引用步驟

  • 1. 呼叫服務引用模組,網址為http://econgisdw.forest.gov.tw/SOA/WebServices/SoaFacade.asmx
  • 2. 執行應用系統認證介面Authenticate:確認應用系統身份
  • 3. 執行應用系統授權介面Authorize:確認應用系統是否有使用服務的權限
  • 4. 執行呼叫服務介面RequestService:執行服務呼叫,取得執行結果