跳轉到主要內容
RosettaNet 端口按照 RosettaNet Implementation Framework (RNIF) 標準傳送和接收訊息。

核心功能

  • 支援 RNIF 1.1 和 2.0,用於 B2B 文件交換
  • 支援按夥伴配置自動路由訊息,並提供靈活的加密/簽章選項
  • 基於憑證的安全性,支援同步/非同步確認處理

概觀

RosettaNet 連線需要在兩個位置配置。首先在 RosettaNet 個人設定頁面中配置本地 RosettaNet 識別碼和私有憑證。然後為每個交易夥伴配置單獨的 RosettaNet 端口及其連線設定。當 RosettaNet 端口處理輸入檔案時,該檔案會被打包並傳送給指定的交易夥伴。 當 知行之橋 透過 RosettaNet 接收到檔案時,會嘗試將該檔案路由到特定的 RosettaNet 端口。應用程式使用 RosettaNet 訊息中的 RosettaNet 識別碼來確定哪個 RosettaNet 端口應接收該檔案。當檔案被路由到 RosettaNet 端口時,該檔案會放入端口的交易索引標籤,或傳遞給工作流程中的下一個端口。

個人設定配置

必須先配置 RosettaNet 個人設定,才能與各個 RosettaNet 端口建立連線。單擊導覽列上的個人設定,然後單擊 RosettaNet 索引標籤。

RosettaNet 個人設定索引標籤

個人資訊

用於標識本地個人設定的設定。

個人憑證

與私有解密和簽章憑證相關的設定。

應用程式 URL

與從公共 Web 存取 知行之橋 相關的設定和顯示值。

其他設定

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

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

端口配置

配置全域 RosettaNet 個人設定後,在工作流程頁面為每個交易夥伴建立並配置單獨的 RosettaNet 端口。

設定索引標籤

配置

_用於標識和連線到特定 RosettaNet 交易夥伴的設定。

連線資訊

與指定交易夥伴的連線參數相關的設定。

確認

與 RosettaNet 確認相關的設定。

交易夥伴憑證

與交易夥伴提供的公開金鑰憑證相關的設定。

進階選項卡

備用本地個人設定

覆蓋此特定 RosettaNet 端口在個人設定頁面上的配置。設定備用本地個人設定可讓你為某些交易夥伴使用不同的本地憑證和識別碼。

TLS 用戶端身分驗證

與需要雙向 TLS 身分驗證時的用戶端身分驗證相關的設定。

HTTP 身分驗證

與 HTTP 用戶端身分驗證相關的設定。

進階設定

_不屬於前述類別的設定。

代理設定

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

設定描述
代理型別基於代理的防火牆使用的協議。
代理主機基於代理的防火牆的名稱或 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 索引標籤

建立連線

配置新的 RosettaNet 端口時,交易夥伴必須提供部分所需的連線詳細資訊。這些詳細資訊至少應包括:
  • 業務識別碼
  • 夥伴 URL
  • 夥伴憑證

業務識別碼

在 RosettaNet 交易中,交易夥伴由其業務識別碼標識。傳送傳出請求時,業務識別碼用於請求標頭中以指示接收方。 若要建立 RosettaNet 自測,識別碼應設定為與個人設定頁面上的業務識別碼相同的值。
此值區分大小寫。

夥伴 URL

夥伴 URL 是交易夥伴接收 RosettaNet 傳輸的端點。傳出的 RosettaNet 訊息會傳送到此目標端點,該端點對每個交易夥伴必須唯一。你可以使用 Web 瀏覽器測試夥伴 URL,以檢查網路或連線問題。 若要建立 RosettaNet 自測,目標 URL 應與個人設定頁面上的接收 URL 相同或幾乎相同。你可以將個人設定頁面中的域名替換為環回地址 localhost,以使 RosettaNet 交易保留在本地網路中。本地自測 URL 範例為 http://localhost:8001/pub/Receive.rsb。 如果未將域名替換為 localhost,RosettaNet 訊息會路由到本地網路之外。你可以利用此方式檢查網路配置設定,並確保訊息可以透過任何防火牆到達 知行之橋。

夥伴憑證

每個 RosettaNet 端口都必須為目標交易夥伴配置憑證。交易夥伴會提供與其交換 RosettaNet 訊息時進行加密和驗證所需的憑證。知行之橋 接受 X.509 公開金鑰憑證(副檔名為 .cer、.der 或 .pem 的檔案)。 通常,交易夥伴會提供一個憑證,應將其配置在加密憑證欄位中。 如果交易夥伴提供多個憑證,應說明每個憑證的用途。如果夥伴提供完整憑證鏈(例如從商業憑證頒發機構取得),則只需要配置葉憑證(鏈中的最後一個憑證)。

傳送和接收檔案

配置 RosettaNet 個人設定和特定夥伴的 RosettaNet 端口後,即可安全地傳送和接收檔案。

傳送檔案

在 RosettaNet 端口中,交易索引標籤顯示要傳送給目標交易夥伴的檔案。如果在自動化索引標籤上啟用了傳送自動化,到達端口交易索引標籤的檔案會自動打包並傳送。展開與已傳輸檔案關聯的行即可存取所有傳輸的日誌檔案。 在交易索引標籤上,選擇更多 > 建立測試檔案以生成一組簡單的測試檔案並傳送給交易夥伴。

重新傳送和重試

當預期交易夥伴傳回非同步確認,但未能在重新傳送間隔時長內(預設為 60 分鐘)傳回時,會觸發 RosettaNet 重新傳送。隨後應用程式會嘗試重新傳送傳輸。應用程式會繼續重新傳送訊息,直到收到確認為止或**最大次數(非同步)**用盡。 當交易夥伴的 HTTP 回應表明伺服器未收到傳輸時,會觸發重試。這可能表示網路或連線問題,通常是暫時性的。應用程式每隔重試間隔分鐘重試傳輸,直到傳輸被接收或最大次數用盡。

接收檔案

在 RosettaNet 端口中,交易索引標籤顯示應用程式已接收並路由到該端口的檔案(基於傳入 RosettaNet 訊息中存在的 RosettaNet 識別碼)。展開每個檔案行可顯示該傳輸的可用日誌清單。 這些檔案可在端口的交易索引標籤上檢視。如果端口連線到工作流程中的其他端口,檔案會自動從 RosettaNet 端口的交易索引標籤移動到工作流程中下一個端口的交易索引標籤。 RosettaNet 協議不允許主動從交易夥伴拉取檔案:RosettaNet 端口只能被動等待交易夥伴傳送檔案。

配置 PIP

Partner Interface Processes (PIP) 是 RosettaNet 用於傳輸各種業務流程資訊的邏輯 XML 文件。下面列出了常見 PIP:

宏

範例