TIPTOPGPWebServices开发说明PPT课件.ppt

鼎新電腦TIPTOP產品中心 TIPTOPGP5 25WebServices程式開發說明 1 WebServices概念TIPOTPGP整合架構 Server Client Service寫作範例問題檢測方式 課程大綱 2 WebServices概念 3 何謂WebServices 提供一個標準使兩個不同的應用程式可以相互溝通不侷限於某種平台或程式語言由以下的標準所組成 1 XML ExtensibleMarkupLanguage 2 XMLSchema 3 SOAP SimpleObjectAccessProtocol 4 WSDL WebServicesDescriptionLanguage 5 HTTP HyperTextTransfertProtocol 4 XML 定義一種平台獨立的資料交換方式 DEFINEPersonRECORDFirstNameVARCHAR 32 LastNameVARCHAR 32 AgeINTEGERENDRECORD JohnSmith35 5 XMLSchema XML文件的結構可用來檢查XML文件的正確性 6 SOAP Server與Client之間如何溝通的通訊協定 底層走HTTP協定定義Server與Client溝通時的XML資料流 MyCompany 999 99 Request Response 7 WSDL 描述Server端提供哪些服務 XML格式的檔案WSDL紀錄了 1 可供使用的服務及它的輸入 回傳訊息 2 Server所在的網路位置 3 採用的連線及通訊協定等資訊 8 通用接口概念 建立一個通用的服務整合入口共享不同系統整合的共通性功能可隨需求建立新的服務需求或調整原有程式邏輯 9 TIPTOPGP整合架構 TIPTOP為Server端 10 as xcf 84 6384port as xcf ERPWeblogin通道 Apache GeneroApplicationServer aws ttsrv2 aws efsrv2 GP5 25WebService架構圖 11 TIPTOPServiceGetWayV2 TIPTOP為Server端 12 通用接口 CRM TIPTOPServicesGateway PDM GPM CRMServices PDMServices PDMServices 13 通用接口服務模式 CRM TIPTOPServicesGateway PDM GPM CRMServices PDMServices PDMServices 不同系統針對ERP的 整合 功能需求定義為一個一個服務型態 Services 經由統一的存取網址 依照定義可執行不同的服務功能 14 定義服務功能 CRM 建立報價單建立客戶基本資料取得料件基本資料取得員工基本資料 PDM 建立產品結構表建立料件基本資料取得料件基本資料 取得廠商基本資料取得客戶基本資料取得料件基本資料 GPM 15 共通性功能需求 CRM 建立報價單建立客戶基本資料取得料件基本資料取得員工基本資料 PDM 建立產品結構表建立料件基本資料取得料件基本資料 取得廠商基本資料取得客戶基本資料取得料件基本資料 GPM 共通性的整合功能 16 服務功能存取 CRM PDM GPM 取得料件基本資料 建立報價單 建立客戶基本資料 取得員工基本資料 建立產品結構表 建立料件基本資料 取得廠商基本資料 取得客戶基本資料 ERPServiceFunction 17 服務功能存取 CRM 取得料件基本資料 建立報價單 建立客戶基本資料 取得員工基本資料 ERPServiceFunction 建立產品結構表 建立料件基本資料 取得廠商基本資料 取得客戶基本資料 18 服務功能存取 PDM 取得料件基本資料 建立產品結構表 建立料件基本資料 ERPServiceFunction 建立報價單 建立客戶基本資料 取得員工基本資料 取得廠商基本資料 取得客戶基本資料 19 服務功能存取 GPM 取得料件基本資料 取得廠商基本資料 取得客戶基本資料 ERPServiceFunction 建立報價單 建立客戶基本資料 取得員工基本資料 建立產品結構表 建立料件基本資料 20 建立服務功能 定義服務功能需要接受的輸入參數及處理後的回傳參數撰寫服務功能的程式邏輯4GLfunction註冊4GLfunction為一Service 並產生服務列表的WSDLfile提供ERP服務WSDLfile及Servicefunction輸出入參數定義 21 TIPTOPGP整合資料交換規格 22 RequestXML 23 ResponseXML 24 AccessXMLTag user 使用者帳號password 使用者密碼 目前可先填空值 application 呼叫端系統代號source 呼叫端來源IPorHostorganization 存取的ERP營運中心langeuage 訊息語系 目前定義zh tw 繁體 zh cn 簡體 en us 英文 25 ExecutionXMLTag code 錯誤代碼 非 0 則代表發生錯誤sqlcode 若有發生SQLerror 則多記錄ERPSQLerrorcodedescription 訊息說明 26 ParameterXMLTag 參數資料 指定傳遞於ERP的參數名稱及值 依不同服務各自定義參數個數及名稱傳入 單一參數傳遞指定於此 e x 傳入取得料件編號條件回傳 單一參數傳遞指定於此 e x ERP回傳指定客戶的信用額度name 參數名稱value 參數值 27 DocumentXMLTag 單檔資料 應用範例 取得ERP料件主檔欄位 一筆資料id 流水編號 1 2 3 4 表示第N筆 單檔資料節點name 單檔名稱 單檔欄位及其值name 欄位名稱 預設為ERP欄位名稱value 欄位值 呼叫服務時 回傳ERP所有欄位 呼叫端擷取所需要欄位 28 DocumentXMLTag 雙檔資料 應用範例 取得ERPBOM基本資料欄位 一筆雙檔資料id 流水編號 表示第N筆 單頭檔資料name 單頭檔名稱 單身檔資料name 單身檔名稱 一筆單身資料name 欄位名稱 預設為ERP欄位名稱value 欄位值 呼叫服務時 回傳ERP所有欄位 呼叫端擷取所需要欄位 29 參數範例 GetItemData Inputpara 1 RequestXML Outputret 1 ResponseXML 30 TIPTOPServicesGetwayver2 0 31 TIPTOPServicesGateway Gateway ServicesRegister ServicesLibrary ServiceFunctionA ServicesGlobals ServiceFunctionB ServiceFunctionC ServiceFunctionD 32 TIPTOPServicesGateway Gateway ServicesRegister ServicesLibrary ServiceFunctionA ServicesGlobals ServiceFunctionB ServiceFunctionC ServiceFunctionD 服務接口程式 33 TIPTOPServicesGateway Gateway ServicesRegister ServicesLibrary ServiceFunctionA ServicesGlobals ServiceFunctionB ServiceFunctionC ServiceFunctionD 服務註冊程式 服務輸出入參數定義檔 服務共用函式程式 34 TIPTOPServicesGateway Gateway ServicesRegister ServicesLibrary ServiceFunctionA ServicesGlobals ServiceFunctionB ServiceFunctionC ServiceFunctionD 各別服務功能程式 35 TIPTOPServicesGateway Gateway ServicesRegister ServicesLibrary ServiceFunctionA ServicesGlobals ServiceFunctionB ServiceFunctionC ServiceFunctionD RequestServiceA RequestServiceC 36 對應程式名稱 Gateway ServicesRegister ServicesLibrary ServiceFunctionA ServicesGlobals ServiceFunctionB ServiceFunctionC ServiceFunctionD aws ttsrv2 4gl aws ttsrv2 service 4gl aws ttsrv2 global 4gl aws ttsrv2 lib 4gl aws serviceA 4gl aws serviceB 4gl aws serviceC 4gl aws serviceD 4gl 37 程式開發說明 aws ttsrv2 4gl 入口程式 接受需求 aws ttsrv2 service 4gl 定義目前有哪些服務函式 aws xxxA 4gl 實際處理服務A的程式段 aws xxxB 4gl 實際處理服務B的程式段 新增一個服務時 所需要的程式撰寫動作 1 定義新的服務函式 2 實際撰寫處理服務的程式本體 38 Service開發流程說明 定義新的服務函式 AWS 4gl aws ttsrv2 service 4gl中加入新增的ERP服務段落 請新增每一個ERP服務時 於以下加入發佈ServiceFunction段落 此處定義的FunctionName必須與設定作業中輸入的一致 否則執行時將報錯 CASEp func WHEN function name LETl op com WebOperation CreateDOCStyle function name p op name g request g response CASEp funcWHEN aws getItemData LETl op com WebOperation CreateDOCStyle aws getItemData p op name g request g response ENDCASE A 39 Service開發流程說明 FUNCTIONaws getItemData LETg service GetItemData CALLaws get item data ENDFUNCTION 函式名稱 服務名稱 真正執行的函式名稱 e x 程式本體定義於aws get item data 4gl B 2 實際撰寫處理服務的程式本體 AWS 4gl目錄下新增並撰寫服務程式 e x aws get item data 4gl 可能存在五種型態的服務需求 讀取ERP單檔 讀取ERP雙檔 寫入ERP單檔 寫入ERP雙檔 非單據的參數傳入與回傳 40 3 程式撰寫後透過p link將完成的4GLmodule掛到aws ttsrv2中 Service開發流程說明 續前頁 41 需與aws ttsrv2 service 4gl中加入新增的服務函式裡的名稱相同 LETg service GetItemData 需與aws ttsrv2 service 4gl中加入新增的服務函式裡的函式名稱 FUNCTIONaws getItemData 4 執行aws ttcfg2新增TIPTOP整合服務設定 Service開發流程說明 續前頁 42 Service開發流程說明 續前頁 5 產生新的WSDL檔 6 測試此服務 直接與Client端進行測試 使用soapUI軟體進行測試 43 TIPTOPServicesGetway2 0問題檢測 44 Service測試工具介紹 SoupUI操作說明 使用SoupUI進行除錯 45 查看log檔內容 I GASD的LOG目錄是每日產生的 GASD的LOG檔放置路徑 lshttpdispatch log aws ttsr2的LOG檔名稱 是最近一次帶起服務的當天日期 46 查看log檔內容 II 檢視aws ttsrv2logfile 是否有正確記錄傳遞的XML字串 TEMPDIR aws ttsrv2 西元年月日 log TEMPDIR aws ttsrv2 run 西元年月日 log 47 TIPTOPGP整合架構 TIPTOP為Clien端 48 程式開發流程 取得WSDL資訊 產生存取WebServices的程式段 撰寫Client端程式並呼叫服務 錯誤處理 49 取得WSDL檔 WSDL範例 50 透過工具程式產生存取程式碼 使用工具程式 fglwsdl語法 fglwsdl command 產生兩個檔案 inc 定義變數 4GL程式需以GLOBALS包含進來 4gl 存取webservices的程式段 供client端程式呼叫 fglwsdlhttp localhost 8090 WSDL ws calculator 4glws calculator inc 51 fglwsdl 重要參數說明 prefixnamerefix產生固定的字串放置在BDLfunctionandvariablenames ooutputFile改變輸出的outputfiles Theoutputfileswillbe outputFileName inc and outputFileName 4gl 不指定 o參數時 產生的檔案檔名以wsdl的服務名稱為檔名指定 prefix參數時 加入指定字串加在Function開頭 範例 fglwsdl oaws mesgw prefixmesServiceMESService wsdl fglwsdl o欲產生的程式名稱 prefix要在程式裡替代的字串wsdl原始來源檔名 52 撰寫程式並呼叫WebServices 程式有呼叫到GWSfunction需要加入以下語法 將fglwsdl產生的變數定義檔案包含