部署內送 SOAP Web 服務

定義內送 SOAP Web 服務之後，Web 服務用戶端並無法自動使用它來存取系統。「部署狀態」和「現用」標誌 (設為真) 指出 Web 服務是否可供使用。最後一個步驟是將內送 SOAP Web 服務部署至 Java EE Web 應用程式伺服器。此部署階段有數個在起始部署時會自動執行的步驟：

  • 產生 Web 服務檔案，並附加原則。

  • 使用適當的註解和列舉產生 WSDL。

  • 產生並編譯要在 Java EE Web 應用程式伺服器中實作 Web 服務的 Java 存根程式碼。

  • 將 Web 服務建立到有效的 Web 應用程式存檔 (WAR) 檔案中。

  • (選擇性) 將新建立的 Web 服務 WAR 檔案部署至 Java EE Web 應用程式伺服器。也可以針對叢集部署視需要手動執行此步驟。

有兩種方式可用來部署內送 SOAP Web 服務：

  • 在指令列使用 iwsdeploy[.sh] 指令部署，如「伺服器管理指南」中所述。對於原生安裝和生產實作，建議使用此方式。

  • 使用內送 Web 服務部署入口部署。僅在開發 (非生產) 環境中支援此方式。

內送 Web 服務部署入口

若要使用線上「內送 Web 服務部署」入口，請使用管理 > 整合 > 內送 Web 服務部署進行導覽。

下列各個區段描述在入口上提供的基準區域。

部署內送 SOAP Web 服務

「部署內送 SOAP Web 服務」區域提供上一次部署的相關資訊。如果該區域為開發 (非生產) 區域，您可以使用部署按鈕來部署或重新部署內送 Web 服務。將會部署「現用」開關為「是」的所有內送 Web 服務。「現用」開關為「否」的所有服務則會被取消部署。

備註：在部署內送 SOAP Web 服務後，會擷取其服務版次欄位的值。特定組態變更則需要重新部署服務才會生效。發生下列任何一個變更時，內送 Web 服務的服務版次值就會遞增。這會導致部署狀態顯示需要部署。

  • 現用開關已變更

  • 註解已新增或移除

  • 作業已新增或移除

  • 作業的作業名稱、結構類型/結構名稱、要求或回應結構、要求或回應 XSL 已變更。

備註：此外，如果實作支援透過內送 Web 服務來部署 XAI 服務，還會視需要部署或取消部署適當的 XAI 內送服務。

部署狀態

「部署狀態」區域顯示產品中的內送 SOAP Web 服務列表，包括部署狀態。

部署狀態是由每個內送 Web 服務的內部「服務版次」欄位與部署時所擷取的值進行比較所決定。

  • 已部署。指出已部署內送 Web 服務，且沒有偵測到組態發生任何變更。

  • 需要部署。指出尚未部署內送 Web 服務，或是已部署服務，但同時偵測到組態發生變更，因此需要重新部署。

  • 未部署。指出內送 Web 服務標示為停用，且此時找不到要部署的內送 Web 服務。

  • 需要取消部署。指出內送 Web 服務標示為停用，但此時找到要部署的內送 Web 服務。

如果已部署內送 Web 服務，「檢視」資料欄將會包含 WSDL 連結，可讓您啟動個別的視窗來檢視 WSDL 定義。

備註：關於雲端安裝，系統支援透過為變數替代字 URI (@F1_​BASE_​IWS_​URI@) 所定義的替代值來定義 WSDL URI。系統將會為在 URI 替代中所述的每個功能使用此值。如果沒有定義任何值，系統會使用預設 URL，此為適用於內部部署安裝的 URL。

請使用區域中所列出之任何內送 Web 服務旁邊的廣播按鈕，來檢視內送 Web 服務記錄的明細。這會顯示內送 Web 服務區域。這是出現在內送 Web 服務維護入口上的相同區域。

XAI 內送服務部署狀態

只有在外部訊息功能類型上設定功能組態選項透過內送 Web 服務支援 XAI 服務，或是在系統偵測到已部署的 XAI 內送服務時，「XAI 內送服務部署狀態」區域才會顯示。(當實作已部署 XAI 內送服務，然後選擇停止使用此功能時，系統就會檢查第二個條件。將該功能組態選項變更成「假」之後，就需要再進行一次部署來「取消部署」XAI 服務。)區域顯示產品中與頁面服務相關的 XAI 內送服務列表。如需詳細資訊，請參閱透過內送 Web 服務部署 XAI 內送服務。

部署狀態是由記錄的「版本」欄位與部署時所擷取的值進行比較所決定。

  • 已部署。指出已部署 XAI 內送服務，且沒有偵測到組態發生任何變更。

  • 需要部署。指出尚未部署 XAI 內送服務，或是已部署服務，但同時偵測到組態發生變更。

  • 未部署。指出 XAI 內送服務標示為停用，或透過內送 Web 服務支援 XAI 服務未設為真，且此時找不到要部署的 XAI 內送服務。

  • 需要取消部署。指出 XAI 內送服務標示為停用，或透過內送 Web 服務支援 XAI 服務未設為真，但此時找到要部署的 XAI 內送服務。

XAI 內送服務並沒有與內送 Web 服務之「服務版次」欄位對等的欄位；「服務版次」欄位只有在對影響部署的記錄進行變更時才會遞增。對於 XAI 內送服務，會使用記錄上的版本編號。進行任何變更時，此欄位的值就會遞增，即使變更不會影響部署。因此，某些 XAI 內送服務可能會在不需要重新部署的情況下，指出「需要部署」。發生這種情況時，為了安全起見，建議您直接再次「部署」。

如果已部署內送 Web 服務，「檢視」資料欄將會包含 WSDL 連結，可讓您啟動個別的視窗來檢視 WSDL 定義。