跳轉到主要內容
進階訊息佇列協議(AMQP)端口允許透過對資料執行 Produce 和 Consume 操作,將 AMQP 整合到資料流中。

核心功能

  • 具有生產和消費操作的雙向訊息佇列
  • 支援多種身分驗證方案(None、SASL Anonymous、SASL Plain)
  • 支援安全連線的 TLS 加密
  • 靈活的訊息值型別,包括對 JSON 複合資料的支援
按照以下步驟將 知行之橋 連線到 AMQP。

建立連線

必須首先透過以下兩種方法之一建立到 AMQP 的連線:
  • 將 AMQP 端口新增到工作流程。然後,在設定面板中,單擊連線下拉式清單旁邊的 建立。
  • 開啟 知行之橋 系統設定 頁面,然後開啟 連線 索引標籤。點選 新增,選擇 AMQP,然後點選 下一步。
  • 僅在第一次建立連線時才需要登入過程。
  • 與 AMQP 的連線可以跨多個 AMQP 端口重複使用。
開啟連線對話方塊後,按照以下步驟操作:
  1. 輸入連線資訊:
    • 名稱 — 連線的靜態名稱。
    • 型別 — 始終設定為 AMQP。
    • 遠端主機地址 — AMQP 遠端主機的主機名或 IP 地址。
    • 遠端主機端口 — 遠端主機連線的端口。
    • 使用 TLS — 是否使用 TLS 加密連線。根據 AMQP 配置進行設定。
    • 容器 Id —(可選)要存取的 AMQP 連線中容器的 ID 值。
    • 認證方式 — 用於連線的身分驗證方案。選項有 None、SASL Anonymous 和 SASL Plain。
    如果選擇 SASL Anonymous 或 SASL Plain 身分驗證,請輸入以下資訊:
    • User — 連線到 AMQP 時使用的使用者名稱。
    • Password — 使用者的密碼。
  2. 點選 測試連線 以確保 知行之橋 可以使用提供的資訊連線到 AMQP。如果發生錯誤,請檢查所有欄位並重試。
  3. 點選 新增連線 以完成連線。

端口配置

此部分包含所有可配置的端口屬性。

設定索引標籤

配置

AMQP 訊息

JSON 複合資料值型別
值型別 選項之一是 JSON(複合資料)。複合資料 JSON 架構由 type-value 物件組成,其中包含 AMQP 型別名稱和值。type-value 物件的語法為:
下表提供了有效型別名稱的完整清單,並描述了相關值的表示方式:
型別名稱必須是小寫才能正確解析。

進階選項卡

其他設定

代理設定

這是一組用於識別連線所經代理並對其進行身分驗證的設定。預設情況下,本節使用 安全設定 頁面的 代理設定 部分中的全域設定。清除此核取方塊可為您的端口提供特定的設定。

設定描述
代理型別基於代理的防火牆使用的協議。
代理主機基於代理的防火牆的名稱或 IP 地址。
代理端口基於代理的防火牆的 TCP 端口。
代理使用者用於透過基於代理的防火牆進行身分驗證的使用者名稱。
代理密碼用於對基於代理的防火牆進行身分驗證的密碼。
身分驗證方案保留預設值 None 或選擇以下身分驗證方案之一:Basic、Digest、Proprietary 或 NTLM。

訊息

訊息設定確定端口如何搜尋訊息並在處理後管理它們。

注意:以下設定已棄用,預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本,請在工作流程中右鍵單擊該端口,選擇顯示成功路徑,然後將成功路徑連線到 File 端口。

設定描述
儲存到已傳送資料夾(已棄用)將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。
已傳送資料夾方案(已棄用)按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。

日誌

用於管理日誌建立和儲存的設定。

設定描述
日誌級別指定要記錄在端口日誌目錄中的資訊型別:
  • None - 不建立任何日誌。
  • Error - 僅當端口遇到錯誤時才建立日誌。
  • Warning - 僅當端口發出警告時才建立日誌。
  • Info - 記錄工作流程的一般資訊,包括任何錯誤和警告(如果適用)。
  • Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。
  • Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。
請注意:Debug 和 Trace 級別的日誌可能會記錄敏感資訊,包括訊息內容和 SSL 憑證。儘管連線屬性(例如密碼)被遮蔽了,但在與您的組織外部共享它們之前,請檢視此級別的日誌以避免洩漏敏感資訊。
日誌資料夾結構指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如,Weekly 選項指示端口每週建立一個新的子資料夾,並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口,使用子資料夾有助於保持日誌的有序性並提高效能。
保留訊息副本指示端口在日誌目錄中儲存最新訊息副本的切換。請注意,端口每個子資料夾只保留一個訊息,並且端口在再次執行時會覆蓋以前儲存的訊息。

其他

特殊設定適用於特定用例。

設定描述
其他設定允許在以分號分隔的清單中配置隱藏的端口設定,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。

自動化索引標籤

自動化設定

與端口自動處理檔案相關的設定。

效能

與端口資源分配相關的設定。

設定描述
最大工作執行緒數此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。
最大檔案數分配給端口的每個執行緒傳送的最大檔案數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。

警示索引標籤

SLA 索引標籤

日誌索引標籤

日誌索引標籤列出該端口生成的服務日誌。每一行代表一個日誌檔案,並顯示修改日期、檔名、大小和狀態。可以使用搜尋欄或狀態篩選器查詢特定日誌,點選檔名進行預覽或下載,或點選下載全部日誌將所有日誌下載為一個 zip 檔案。

選擇操作

與 AMQP 建立連線後,必須選擇 AMQP 端口將執行的操作。下表概觀了每個操作及其在 知行之橋 工作流程中的位置:

Produce

Produce 操作將輸入資料傳送到 AMQP 連線。此資料可能來自其他端口,也可能來自你手動上傳到 AMQP 端口 交易 索引標籤的檔案。 在某些 AMQP 配置中,可以將 目標 欄位的值設定為應充當接收者的節點的地址。並非所有配置都需要此項。

Consume

Consume 操作檢查 AMQP 佇列中的訊息。透過 Consume 端口處理的資料會進入 交易 索引標籤,並向下傳遞到 知行之橋 工作流程的後續步驟。 在某些 AMQP 配置中,可以將 目標 欄位的值設定為端口應從中接收資料的節點的地址。並非所有配置都需要此項。

宏

範例