跳轉到主要內容
Partner Mailbox 端口為交易夥伴提供一個私人的、基於瀏覽器的信箱,用於自助檔案交換。交易夥伴登入後可下載為其暫存的檔案,也可上傳要傳送的檔案。

核心功能

  • 每個交易夥伴一個信箱,每個信箱都有各自的憑證、URL 和資料夾樹
  • 為不具備一般 MFT 能力的交易夥伴提供自助檔案交換
  • 結構清楚的傳送和接收資料夾樹,支援拖放管理
  • 針對已下載檔案的檔案保留控制,支援重新下載
  • 副檔名篩選,用於控制交易夥伴可以上傳的檔案
  • 可為面向交易夥伴的信箱頁面自訂頁面標題和 Logo 品牌
  • 使用標準 SubFolder 訊息頭依資料夾路由,與其他 MFT 端口保持一致

概觀

每個 Partner Mailbox 端口代表一個交易夥伴的信箱。交易夥伴開啟專用網頁,使用使用者名稱和密碼進行身分驗證,然後即可下載為其暫存的檔案並上傳要傳送的檔案。多個交易夥伴需要多個端口執行個體。 交易夥伴的信箱頁面分為兩個部分:暫存供交易夥伴下載的檔案(傳送資料夾),以及交易夥伴可以上傳檔案的資料夾(接收資料夾)。每個部分都使用一棵獨立的資料夾樹,由管理員在端口設定中進行管理。 交易夥伴上傳的檔案會像來自任何其他端口的檔案一樣,以訊息的形式進入知行之橋工作流程。工作流程中的路由由 SubFolder 訊息頭處理,詳見路由的運作方式。
目前,網頁是唯一的存取方式。透過 SFTP 和 FTP 存取同一信箱的功能計劃在未來版本中提供。

端口配置

信箱設定索引標籤

此索引標籤頂部顯示的 交易夥伴信箱 URL 是交易夥伴存取其信箱所使用的位址。該 URL 的格式為 .../connector/<workspace>/<connectorId>/mailbox.rst。完成設定後,請將此 URL 分享給交易夥伴。

信箱身分驗證

交易夥伴登入信箱頁面時使用的憑證。

檔案管理 - 交易夥伴下載

控制為交易夥伴暫存的檔案在下載後如何管理的設定。

檔案管理 - 交易夥伴上傳

控制允許交易夥伴上傳哪些檔案的設定。

交易夥伴信箱頁面

面向交易夥伴的信箱頁面外觀設定。

交易夥伴信箱資料夾

資料夾設定分為兩個索引標籤:傳送資料夾 用於存放暫存供交易夥伴下載的檔案,接收資料夾 是交易夥伴上傳檔案的資料夾。每個索引標籤都有一棵獨立的資料夾樹,從一個根資料夾開始。區段標題 欄位用於設定交易夥伴頁面上該部分上方顯示的標題。 您可以在根資料夾下新增、重新命名、移動和刪除任意層級的子資料夾。資料夾名稱只能包含字母、數字和底線,並且在同一父資料夾中必須唯一(比較時不區分大小寫)。根資料夾無法刪除。 將滑鼠懸停在資料夾上,必要時可使用寫字板和鉛筆圖示將其重新命名。使用帶加號的資料夾圖示可向樹中新增子資料夾。頂層資料夾無法刪除,但可以點選垃圾桶圖示刪除子資料夾。如需詳細資訊,請參閱管理資料夾樹。
傳送資料夾
接收資料夾

設定索引標籤

端口資訊

用於識別和描述端口的一般設定。

進階索引標籤

進階設定

日誌

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

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

其它

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

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

通知索引標籤

SLA 索引標籤

路由的運作方式

Partner Mailbox 端口中的路由使用其他 MFT 端口所採用的標準 SubFolder 訊息頭機制。 交易夥伴上傳(接收資料夾) 當交易夥伴上傳檔案時,檔案會被寫入交易夥伴在信箱頁面上選擇的接收子資料夾。產生的訊息帶有一個 SubFolder 訊息頭,其值為該資料夾的路徑。隨後,Branch 等下游端口可以根據該訊息頭的值對訊息進行路由。這正是定義多個接收子資料夾的主要原因:交易夥伴可以透過選擇相應的資料夾來表明所傳送檔案的類型,工作流程則據此進行分支處理。 為交易夥伴暫存檔案(傳送資料夾) 若要將檔案投遞到交易夥伴頁面上的特定傳送子資料夾,上游端口或指令碼必須在訊息到達 Partner Mailbox 端口_之前_將 SubFolder 訊息頭設定為目標子資料夾路徑。端口本身沒有路由 UI。您必須在工作流程的前段設定該訊息頭,通常使用 Script 端口。
在上游端口中設定 SubFolder 訊息頭時請格外注意。如果該訊息頭缺失或設定為不存在的路徑,檔案將被回報為無法投遞,並新增到出錯訊息檢視中。如需詳細資訊,請參閱管理資料夾樹。

管理資料夾樹

重新命名、移動或刪除傳送或接收資料夾,可能會影響已暫存或正在傳輸中的檔案。在確認此類變更之前,知行之橋會顯示受影響資料夾中目前的檔案數量。請在繼續作業之前確認不會有檔案被滯留。 重新命名或移動資料夾後,已暫存在舊路徑下的檔案不會自動更新。任何將 SubFolder 訊息頭設定為舊路徑的上游端口或指令碼,也必須更新為使用新路徑。 被回報為無法投遞的檔案會顯示在出錯訊息檢視中。新增缺失的資料夾或更正上游指令碼後,可以將這些檔案重新排入佇列。

保留期與檔案生命週期

以下規則決定了傳送資料夾中的檔案在暫存後如何管理:
  • 下載後刪除:檔案在首次下載後會從交易夥伴的信箱頁面中移除。將 已下載檔案的保留期 設定為 0 具有相同的效果。
  • 保留檔案直到保留期結束:在保留期到期之前,交易夥伴可以重新下載該檔案。每次下載都會在端口的交易日誌中記錄為一次成功傳送。
  • 保留期從首次下載開始計算,而不是從檔案暫存之時開始計算。重新下載不會重設保留期。
  • 從未被下載的檔案永遠不會因保留期設定而被清除。這些檔案會一直可用,直到被手動移除。
  • 應用程式層級和工作區層級的傳送資料夾清理設定不會影響 Partner Mailbox 的傳送資料夾。 Partner Mailbox 端口會獨立管理其保留期。

交易夥伴信箱檢視

交易夥伴透過存取 信箱設定 索引標籤上顯示的 交易夥伴信箱 URL 並輸入其憑證來存取信箱。身分驗證使用瀏覽器原生的基本驗證。 信箱頁面包含兩個部分,如下圖所示: 交易夥伴信箱頁面,並排顯示「給您的檔案」和「您提交的檔案」兩個部分

給您的檔案(傳送資料夾)

列出暫存供交易夥伴下載的檔案。每一列顯示檔名、檔案大小、檔案暫存日期和狀態。對於交易夥伴尚未下載的檔案,狀態為 Available;對於已下載的檔案,狀態為 Downloaded 並附帶首次下載的日期。下載按鈕僅顯示在可用的列上。下載整個資料夾時,會傳回一個以該資料夾命名的 zip 檔案。保留期已過的檔案會從清單中無聲消失。

您提交的檔案(接收資料夾)

列出交易夥伴已上傳的檔案。每一列顯示檔名、檔案大小、提交日期和時間以及狀態。若要上傳檔案,交易夥伴可以將檔案拖放到上傳區域,或使用檔案選擇器,檔案將上傳到目前選取的接收子資料夾。上傳成功和失敗均以 Toast 通知的形式顯示;因副檔名篩選器而被封鎖的上傳會附帶一則說明拒絕原因的通知。