核心功能
- 完整的 SOAP Web 服務用戶端，支援透過 WSDL 匯入實現自動配置
- 支援 WS-Security，包括訊息簽章、加密和憑證管理
- 多種身分驗證方法，包括 HTTP、Token 和 TLS 用戶端身分驗證
- 透過 WSDL 與 XML Map 端口整合生成 SOAP 範本
- 支援 SOAP 1.1 和 1.2 版本，並提供可配置的安全權杖格式
概觀
SOAP 端口的輸入應是要傳送到 Web 服務的完整 SOAP 訊息。可以透過為目標 Web 服務匯入 WSDL 來生成 SOAP 訊息範本。有關詳細資訊，請閱讀 SOAP 範本部分。 SOAP 端口支援 HTTP 身分驗證、Token 身分驗證和 TLS 用戶端身分驗證，並且可以向傳出的 SOAP 訊息新增數字加密和簽章以保障 Web 服務安全。傳送 SOAP 請求後，端口會儲存回應，或將其傳遞到 知行之橋 工作流程中的下一個端口。端口配置
本節包含所有可配置的端口屬性。設定索引標籤
交易夥伴資訊
用於標識目標 Web 服務的設定。| 設定 | 說明 |
|---|---|
| 端口 ID | 端口的靜態唯一識別碼。 |
| 端口型別 | 顯示端口名稱及其功能說明。 |
| 端口說明 | 可選欄位，用於提供端口及其在工作流程中作用的自由格式說明。 |
| 服務地址 | SOAP 請求應傳送到的 URL。 |
| 允許在服務地址中使用 ArcScript | 允許在發出查詢前計算服務地址 URL 中的 ArcScript 運算式。選中後會顯示 ArcScript 編輯器按鈕（ |
| SOAP 操作 | 要在遠端伺服器上觸發的 Web 服務操作。 |
| SOAP 版本 | 你正在使用的 SOAP 版本。 |
| 從 WSDL 匯入 | 可以從 URL 或本地檔案匯入 WSDL，然後自動填充端口中的配置欄位。匯入 WSDL 還允許在連線到 XML Map 端口時為 SOAP 請求生成 XML 範本。有關詳細資訊，請參見 SOAP 範本。 |
WS-Security
與保護 Web 服務傳輸相關的設定。用戶端憑證
與本地私有憑證相關的設定。伺服器憑證
與伺服器公開金鑰憑證相關的設定。進階選項卡
Token 身分驗證
與 Token 用戶端身分驗證相關的設定。TLS 用戶端身分驗證
與需要雙向 TLS 身分驗證時的用戶端身分驗證相關的設定。
| 設定 | 描述 |
|---|---|
| 私有憑證 | TLS 用戶端身分驗證期間提供的私有憑證。 |
| 憑證密碼 | 存取 TLS 用戶端憑證所需的密碼。 |
HTTP 身分驗證
與 HTTP 用戶端身分驗證相關的設定。自定義請求頭
作為傳出訊息一部分包含的一組自定義請求頭。進階設定
前面類別中未包含的設定。代理設定
這是一組用於識別連線所經代理並對其進行身分驗證的設定。預設情況下，本節使用 安全設定 頁面的 代理設定 部分中的全域設定。清除此核取方塊可為您的端口提供特定的設定。
| 設定 | 描述 |
|---|---|
| 代理型別 | 基於代理的防火牆使用的協議。 |
| 代理主機 | 基於代理的防火牆的名稱或 IP 地址。 |
| 代理端口 | 基於代理的防火牆的 TCP 端口。 |
| 代理使用者 | 用於透過基於代理的防火牆進行身分驗證的使用者名稱。 |
| 代理密碼 | 用於對基於代理的防火牆進行身分驗證的密碼。 |
| 身分驗證方案 | 保留預設值 None 或選擇以下身分驗證方案之一：Basic、Digest、Proprietary 或 NTLM。 |
訊息
訊息設定確定端口如何搜尋訊息並在處理後管理它們。
注意：以下設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇顯示成功路徑，然後將成功路徑連線到 File 端口。
| 設定 | 描述 |
|---|---|
| 儲存到已傳送資料夾（已棄用） | 將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。 |
| 已傳送資料夾方案（已棄用） | 按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。 |
日誌
用於管理日誌建立和儲存的設定。
| 設定 | 描述 |
|---|---|
| 日誌級別 | 指定要記錄在端口日誌目錄中的資訊型別：
|
| 日誌資料夾結構 | 指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，Weekly 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。 |
| 保留訊息副本 | 指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。 |
其他設定
特殊設定適用於特定用例。
| 設定 | 描述 |
|---|---|
| 其他設定 | 允許在以分號分隔的清單中配置隱藏的端口設定，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。 |
自動化索引標籤
自動化設定
與端口自動處理檔案相關的設定。效能
與端口資源分配相關的設定。
| 設定 | 描述 |
|---|---|
| 最大工作執行緒數 | 此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定，則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
| 最大檔案數 | 分配給端口的每個執行緒傳送的最大檔案數。如果設定，則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
告警索引標籤
SLA 索引標籤
建立連線
建立連線需要目標 Web 服務的服務地址和 SOAP 操作。某些 Web 服務可能要求 SOAP 請求具備一個或多個安全功能：- 加密/簽章 (WS-Security)
- 用戶端 SSL 身分驗證
- HTTP 身分驗證
SOAP 範本
透過使用 WSDL 檔案以及工作流程中連線到 SOAP 端口的 XML Map 端口，SOAP 端口可以簡化生成 SOAP 請求的過程。WSDL 檔案為 SOAP 請求定義適當的 XML 結構，而 XML Map 端口可以將任意 XML 結構轉換為此目標結構。 使用匯入 WSDL按鈕匯入檔案後，將 XML Map 端口連線到 SOAP 端口（這樣，XML Map 端口處理的檔案隨後會傳送到 SOAP 端口）。儲存這些工作流程更改後，XML Map 端口可以動態讀取 WSDL XML，並將其用作目的檔案範本。然後，在 XML Map 端口中將任意源 XML 結構上傳為來源檔案。 在 XML Map 端口中設定來源檔案和目的檔案後，視覺化設計器會填充源結構和目標結構。將元素從源拖放到目標，以對映兩個 XML 結構之間的關係。對映完成後，與來源檔案匹配的檔案會由 XML Map 端口自動轉換為 SOAP 請求。回應事件
可以使用回應事件與從伺服器接收的回應（包括主體、標頭、Cookie 等）互動，並豐富端口產生的輸出訊息。可以在Response 事件中使用以下特殊項目。
回應事件範例
此指令碼讀取從伺服器接收的 XML 回應，解析出 XML 中包含的存取權杖，並將其作為標頭新增到端口建立的輸出訊息上：-
透過
_response.body存取伺服器傳送回端口的回應正文，並將其設定為 xmlDOMGet 操作的 text 屬性。xmlDOMGet 的其他屬性也會被填充，例如map屬性，其中包含回應正文中所需權杖的 XPath。 -
呼叫 xmlDOMGet 操作。如果在回應 XML 正文中找到權杖，則會透過
_message.header:access_token語法將其作為訊息標頭新增到端口的輸出訊息。如果未找到權杖，則access_token標頭的值會設定為靜態字串：Token not found!。