跳轉到主要內容
標籤端口基於範本生成 Zebra 程式語言 (ZPL) 標籤,該範本在執行時使用 XML 作為輸入進行填充。

核心功能

  • 透過 XML 輸入生成 ZPL 標籤,支援基於範本的自定義
  • 相容 XML Map 端口,實現自動化標籤建立工作流程
  • 使用 ${...} 語法進行動態欄位替換,用於熱敏印表機輸出

概觀

標籤端口基於預定義的 XML 範本將輸入的 XML 轉換為 ZPL 檔案,從而實現自動且一致的標籤建立,以便在 Zebra 熱敏印表機上列印。它與 XML Map 端口 以及原始 XML 輸入相容。但是,主要用例是使用從 XML Map 端口到標籤端口的流程將 XML 對映到 XML 中表示的 ZPL 結構。

端口配置

本節包含所有可配置的端口屬性。

設定索引標籤

配置

與建立連線相關的設定。
設定描述
端口 Id端口的靜態、唯一識別碼。
端口型別顯示端口型別及其用途的描述。
端口描述一個可選欄位,用於提供端口及其在流中的角色的自由格式描述。

範本索引標籤

用作範本的 ZPL 檔案。建立標籤端口時,知行之橋 會使用 ZPL 範本預填充此欄位以用作起點。有關詳細資訊,請參閱生成 ZPL 文件。

進階設定

進階設定

先前類別中未包含的設定。

訊息

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

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

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

日誌

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

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

其他

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

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

自動化索引標籤

自動化配置

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

效能

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

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

通知索引標籤

SLA 索引標籤

生成 ZPL 文件

標籤端口將 XML 輸入檔案讀入範本索引標籤中指定的 ZPL 範本,並使用範本中的資料生成 ZPL 標籤。

預設 ZPL 範本

知行之橋 會使用 ZPL 範本預填充範本欄位,以用作起點。本文件未詳細介紹如何使用 ZPL 語言:需要在 知行之橋 之外學習該語言。可以根據需要修改 ZPL 範本的其他方面和動態欄位,但以下是預設內容:
使用 ${...} 語法的元素(例如上述內容中的 ${name})是 知行之橋 從傳入端口的輸入 XML 中提取的內容。當您將 XML Map 端口放在流中的標籤端口前面時,對映的目標端將顯示這些欄位,如下圖所示。 如果將 XML 對映到這些元素並將其提供給流程,則標籤端口輸出(使用讀取 .zpl 檔案的工具檢視時)將包含相同的 ZPL 資料並填寫以下值:
最後,當透過閱讀器執行 ZPL 來製作標籤時,它看起來像這樣:

宏

範例