維護 XAI 內送服務

XAI 內送服務是一項舊有機制,用來將系統服務以 Web 服務形式對外部系統公開。目前支援來定義 Web 服務的機制為內送 Web 服務,這應該用於所有新的 Web 服務。

有些架構型產品和現有實作可能有需要檢視的現有 XAI 內送服務。針對這些服務,本產品支援將它們部署成 SOAP 內送 Web 服務以供執行。請參考透過內送 Web 服務部署 XAI 內送服務

下列各節描述關於維護頁面的基本資訊。請注意,部分資訊與不再支援的舊有功能相關。

XAI 內送服務 - 主要

若要檢視內送服務,請開啟管理 > XAI > XAI 內送服務

頁面描述

XAI 內送服務名稱是用來在系統中識別該服務。此服務名稱也是 XML 要求/回應文件中 <Body> 元素後的第一個 XML 元素。XAI 服務 ID 會作為主索引鍵。

擁有者可指出此 XAI 內送服務是基準套件所擁有,還是您的實作 (客戶修改) 所擁有。此資訊僅限顯示。

轉接器會定義與目標應用程式伺服器的介面。

如果此服務的轉接器會叫用系統服務,便可以看見適當的服務名稱

如果轉接器是業務轉接器,則結構類型結構名稱會參考要叫用的物件。

如果 XAI 內送服務與一或多個 Web 服務類目連結,就可以看見 Web 服務類目

請使用描述詳細描述來描述服務。

如果此服務已啟用且可供執行,請勾選現用開關。

Post 錯誤不適用。

追蹤不適用。

除錯不適用。

結構定義

備註:要求結構與回應結構不適用於叫用結構型物件的服務。使用業務轉接器時,它們不會出現。

接下來兩個特性定義要求與回應 XML 結構。結構與 SOAP 相容。結構 XML 檔案應儲存在執行 XAI 伺服器之 Web 伺服器上的結構目錄中。

要求結構是定義服務要求的 XML 結構。傳送至伺服器的要求必須符合結構定義。

回應結構是定義服務回應的 XML 結構。XAI 伺服器產生的回應會與回應結構定義對應。

同一個服務可能對業務物件執行數個動作。請使用交易類型來定義服務所執行的預設動作。您可以在叫用服務時,藉由在 XML 要求的「服務」元素上動態指定交易類型屬性來提供交易類型。此欄位可接受下列值:讀取新增變更更新刪除列表搜尋

備註:變更更新之間的差異在於就變更而言,所有欄位值都必須與要求一起傳入。未傳入要求的欄位值會設為 Null。針對更新,您只需傳遞主索引鍵欄位值,以及要更新之欄位的值。所有其他欄位會保留其現有值。

執行搜尋的服務可能允許根據不同的準則進行搜尋。當「交易類型」值為搜尋時,請使用搜尋類型來定義預設搜尋準則。可能的值為主要替代1替代2替代3替代4替代5替代6

備註:這只是預設定義,叫用服務時,可能在執行階段置換預設定義。若要在執行階段置換搜尋類型,您應該在 XML 要求的「服務」元素上指定 searchType 屬性。

XSL 轉換定義

有時,XML 要求文件會不符合要求結構,或服務要求者所預期的回應文件不是轉接器所產生的回應文件。在這類情況下,必須轉換要求與/或回應文件。XAI 伺服器支援透過 XSL 轉換指令檔進行轉換。轉換指令檔可以先套用至要求,然後再傳遞給轉接器,或先套用至回應文件,然後再傳送給服務要求者。

要求 XSL 是要在處理要求文件前先套用至該文件的 XSL 轉換名稱。當傳入文件未對應 XAI 服務要求結構時,通常需要轉換,因此必須先進行轉換,才能由轉接器處理。

回應 XSL 是當服務的要求者預期回應的 XML 文件結構與服務回應結構所定義的結構不同時,要套用至回應文件的 XSL 轉換名稱。

按一下 WSDL URL 超連結,即可啟動包含內送服務之 WSDL 定義的個別視窗。請注意,URL 的伺服器名稱與埠號是使用通用特性檔中的設定以 XAI HTTP 呼叫端 URL 設定來建立的。