> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Label 端口
> 知行之橋Label 端口的配置與使用指南。
export const NameDescription = ({extraRows}) =>
| 設定 |
描述 |
| 端口 Id |
端口的靜態、唯一識別碼。 |
| 端口型別 |
顯示端口型別及其用途的描述。 |
| 端口描述 |
一個可選欄位，用於提供端口及其在流中的角色的自由格式描述。 |
{extraRows}
;
export const SlasTab = ({siteName = "知行之桥"}) => <>
與配置服務級別協議 (SLA) 相關的設定。
SLA 允許配置預期流程中端口傳送或接收的資料量，並設定預期達到該資料量的時間範圍。當 SLA 未達到時，{siteName} 會傳送電子郵件警告使用者，並將 SLA 標記為 存在風險，這意味著如果 SLA 未能儘快達到，則會被標記為 已違反。這讓使用者有機會介入並確定 SLA 未達到的原因，並採取適當的措施。如果在風險時間段結束時仍未達到 SLA，則會將 SLA 標記為已違反，並再次通知使用者。
要定義 SLA，請啟用 預期資料量，然後點選 設定 索引標籤。
- 如果端口具有單獨的傳送和接收操作，請使用選項按鈕指定 SLA 適用的方向。
- 在視窗的 預計至少 部分中：
- 設定預計處理的最小交易數量（交易量）
- 使用 每個 欄位指定時間範圍
- 指示 SLA 生效的時間。如果選擇 開始於，請填寫日期和時間欄位。
- 勾選希望 SLA 生效的星期幾對應的核取方塊。如有必要，請使用下拉功能表選擇 每天。
- 在視窗的 將狀態設定為“有風險” 部分中，指定應將 SLA 標記為有風險的時間。
- 預設情況下，只有在違反 SLA 的情況下才會傳送通知。要更改此設定，請勾選 傳送“有風險”通知。
以下範例顯示了為端口配置的 SLA，該端口預計在週一至週五每天接收 1000 個檔案。如果尚未收到 1000 個檔案，則會在時間段結束前 1 小時傳送風險通知。
如果有必要，可以關閉 SLA 通知。這在維護視窗期間非常有用。點選導覽列上的 設定，然後跳轉到 通知 > 通用通知。點選平板和鉛筆圖示進行編輯，並取消勾選 SLA 通知 設定。
;
export const AlertsTab = ({siteNameShort = "知行之桥"}) => <>
與配置通知相關的設定。
在執行服務級別協議 (SLA) 之前，需要設定電子郵件通知以接收通知。預設情況下，{siteNameShort} 使用 通知 索引標籤上的全域設定。要為此端口使用其他設定，請啟用 覆蓋全域設定。
預設情況下，錯誤通知處於啟用狀態，這意味著每當出現錯誤時都會傳送電子郵件。要關閉錯誤通知，請取消選中 啟用 核取方塊。
輸入 主題（必填）。勾選允許在主題中使用 ArcScript，即可在主題欄位中使用 ArcScript。選中後會顯示 ArcScript 編輯器按鈕（
）。
（可選）輸入以逗號分隔的收件人電子郵件地址清單。
;
export const Message = () => <>
訊息設定確定端口如何搜尋訊息並在處理後管理它們。
注意：以下設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇顯示成功路徑，然後將成功路徑連線到 File 端口。
| 設定 | 描述 |
|---|
| 儲存到已傳送資料夾（已棄用） |
將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。 |
| 已傳送資料夾方案（已棄用） |
按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。 |
;
export const MiscConnector = () => <>
特殊設定適用於特定用例。
| 設定 |
描述 |
| 其他設定 |
允許在以分號分隔的清單中配置隱藏的端口設定，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。 |
;
export const Logging = () => <>
用於管理日誌建立和儲存的設定。
| 設定 |
描述 |
| 日誌級別 |
指定要記錄在端口日誌目錄中的資訊型別：
- None - 不建立任何日誌。
- Error - 僅當端口遇到錯誤時才建立日誌。
- Warning - 僅當端口發出警告時才建立日誌。
- Info - 記錄工作流程的一般資訊，包括任何錯誤和警告（如果適用）。
- Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。
- Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。
請注意：Debug 和 Trace 級別的日誌可能會記錄敏感資訊，包括訊息內容和 SSL 憑證。儘管連線屬性（例如密碼）被遮蔽了，但在與您的組織外部共享它們之前，請檢視此級別的日誌以避免洩漏敏感資訊。 |
| 日誌資料夾結構 |
指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，Weekly 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。 |
| 保留訊息副本 |
指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。 |
;
export const MacrosExamples = ({extraMacros = []}) => <>
某些宏（例如 %Ext% 和 %ShortDate%）不需要參數，但其他宏則需要。所有帶有參數的宏都使用以下語法：%Macro:argument%
以下是帶有參數的宏的一些範例：
- %Header:headername%：其中
headername 是訊息上訊息頭的名稱。
- %Header:mycustomheader% 解析為輸入訊息上設定的
mycustomheader 訊息頭的值。
- %Header:ponum% 解析為輸入訊息上設定的
ponum 訊息頭的值。
- %RegexFilename:pattern%：其中
pattern 是規則運算式模式。例如，%RegexFilename:^([\w][A-Za-z]+)% 匹配並解析為檔名中的第一個單詞，並且不區分大小寫（test_file.xml 解析為 test）。
- %Vault:vaultitem%：其中
vaultitem 是 vault 中專案的名稱。例如，%Vault:companyname% 解析為儲存在保管庫中的 companyname 項的值。
- %DateFormat:format%：其中
format 是可接受的日期格式（有關詳細資訊，請參閱 範例日期格式）。例如，%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% 解析為檔案上的日期和時間戳。
{extraMacros.filter(item => item.example).map(item => - {item.example}
)}
還可以建立更復雜的宏，如以下範例所示：
- 將多個宏組合在一個檔名中：
%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%
- 包括宏之外的文字：
MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%
- 在宏中包含文字：
%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%
;
export const MacrosTable = ({siteName = "知行之桥", extraMacros = []}) => <>
在檔案命名策略中使用宏可以提高組織效率和對資料的上下文理解。透過將宏合併到檔名中，可以動態地包含相關資訊，例如識別碼、時間戳和訊息頭資訊，從而為每個檔案提供有價值的上下文。這有助於確保檔名反映對組織重要的詳細資訊。
{siteName} 支援這些宏，它們都使用以下語法：%Macro%。
| 宏 | 描述 |
|---|
| ConnectorID | 替換為端口的 ConnectorID。 |
| ConnectorName | 替換為端口名稱。可用於在檔名或路徑中包含連線名稱，例如按生成備份檔案的資料庫連線標記檔案。 |
| Ext | 替換為端口當前正在處理的檔案的副檔名。 |
| Filename | 替換為端口當前正在處理的檔案的檔名（包括副檔名）。 |
| FilenameNoExt | 替換為端口當前正在處理的檔案的檔名（不帶副檔名）。 |
| MessageId | 計算端口輸出的訊息的 MessageId。 |
| RegexFilename:pattern | 將規則運算式模式應用於端口當前正在處理的檔案的檔名。 |
| Header:headername | 替換為端口正在處理的當前訊息的目標訊息頭（headername）的值。 |
| LongDate | 以常規格式計算系統的當前日期時間（例如，2024 年 1 月 24 日星期三）。 |
| ShortDate | 以 yyyy-MM-dd 格式計算系統的當前日期時間（例如 2024-01-24）。 |
| DateFormat:format | 以指定格式（format）計算系統的當前日期時間。有關可用的日期時間格式，請參閱 範例日期格式。 |
| Vault:vaultitem | 計算指定保管庫專案的值。 |
{extraMacros.map(item =>
| {item.name} |
{item.description} |
)}
;
export const Performance = () => <>
與端口資源分配相關的設定。
| 設定 |
描述 |
| 最大工作執行緒數 |
此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定，則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
| 最大檔案數 |
分配給端口的每個執行緒傳送的最大檔案數。如果設定，則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
;
export const siteNameShort = "知行之橋";
export const siteName = "知行之橋";
標籤端口基於範本生成 Zebra 程式語言 (ZPL) 標籤，該範本在執行時使用 XML 作為輸入進行填充。
## 核心功能
* 透過 XML 輸入生成 ZPL 標籤，支援基於範本的自定義
* 相容 XML Map 端口，實現自動化標籤建立工作流程
* 使用 `${...}` 語法進行動態欄位替換，用於熱敏印表機輸出
## 概觀
標籤端口基於預定義的 XML 範本將輸入的 XML 轉換為 ZPL 檔案，從而實現自動且一致的標籤建立，以便在 Zebra 熱敏印表機上列印。它與 [XML Map 端口](./xml-map/xml-map) 以及原始 XML 輸入相容。但是，主要用例是使用從 XML Map 端口到標籤端口的流程將 XML 對映到 XML 中表示的 ZPL 結構。
## 端口配置
本節包含所有可配置的端口屬性。
### 設定索引標籤
#### 配置
*與建立連線相關的設定。*
### 範本索引標籤
用作範本的 ZPL 檔案。建立標籤端口時，{siteNameShort} 會使用 ZPL 範本預填充此欄位以用作起點。有關詳細資訊，請參閱[生成 ZPL 文件](#生成-zpl-文件)。
### 進階設定
#### 進階設定
*先前類別中未包含的設定。*
| 設定 | 描述 |
| ---------- | ----------------------------------------------------------- |
| **本地檔名格式** | 為端口輸出的訊息分配檔名的方案。可以在檔名中動態使用宏來包含識別碼和時間戳等資訊。有關更多資訊，請參閱[宏](#宏)。 |
#### 訊息
#### 日誌
#### 其他
### 自動化索引標籤
#### 自動化配置
*與端口自動處理檔案相關的設定。*
| 設定 | 描述 |
| ------ | ---------------------- |
| **傳送** | 選中此項可讓端口在檔案準備好時自動傳送檔案。 |
#### 效能
### 通知索引標籤
### SLA 索引標籤
## 生成 ZPL 文件
標籤端口將 XML 輸入檔案讀入[範本](#範本索引標籤)索引標籤中指定的 ZPL 範本，並使用範本中的資料生成 ZPL 標籤。
### 預設 ZPL 範本
{siteNameShort} 會使用 ZPL 範本預填充範本欄位，以用作起點。本文件未詳細介紹如何使用 ZPL 語言：需要在 {siteNameShort} 之外學習該語言。可以根據需要修改 ZPL 範本的其他方面和動態欄位，但以下是預設內容：
```
^XA
^FX Top section with logo, name and address.
^CF0,60
^FO50,50^GB100,100,100^FS
^FO75,75^FR^GB100,100,100^FS
^FO93,93^GB40,40,40^FS
^FO220,50^FDIntershipping, Inc.^FS
^CF0,30
^FO220,115^FD1000 Shipping Lane^FS
^FO220,155^FDShelbyville TN 38102^FS
^FO220,195^FDUnited States (USA)^FS
^FO50,250^GB700,3,3^FS
^FX Second section with recipient address and permit information.
^CFA,30
^FO50,280^FD${name}^FS
^FO50,320^FD${address}^FS
^FO50,360^FD${address2}^FS
^FO50,400^FD${city}^FS
^FO175,400^FD${state}^FS
^FO225,400^FD${zip}^FS
^FO50,440^FD${country}^FS
^CFA,15
^FO600,300^GB150,150,3^FS
^FO638,340^FDPermit^FS
^FO638,390^FD123456^FS
^FO50,500^GB700,3,3^FS
^FX Third section with barcode.
^BY5,2,270
^FO100,550^BC^FD${barcode}^FS
^FX Fourth section (the two boxes on the bottom).
^FO50,900^GB700,250,3^FS
^FO400,900^GB3,250,3^FS
^CF0,40
^FO100,960^FDCtr. X34B-1^FS
^FO100,1010^FDREF1 F00B47^FS
^FO100,1060^FDREF2 BL4H8^FS
^CF0,190
^FO470,955^FDCA^FS
^XZ
```
使用 `${...}` 語法的元素（例如上述內容中的 `${name}`）是 {siteNameShort} 從傳入端口的輸入 XML 中提取的內容。當您將 XML Map 端口放在流中的標籤端口前面時，對映的目標端將顯示這些欄位，如下圖所示。
如果將 XML 對映到這些元素並將其提供給流程，則標籤端口輸出（使用讀取 .zpl 檔案的工具檢視時）將包含相同的 ZPL 資料並填寫以下值：
```
^FO50,280^FDCharlie^FS
^FO50,320^FD123 Address Street^FS
^FO50,360^FDUnit 2^FS
^FO50,400^FDGotham^FS
^FO175,400^FDNY^FS
^FO225,400^FD12345^FS
^FO50,440^FDUnited States^FS
...
^FO100,550^BC^FD02271994^FS
```
最後，當透過閱讀器執行 ZPL 來製作標籤時，它看起來像這樣：
## 宏
### 範例