> ## 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}) => {extraRows}
设置 描述
端口 Id 端口的静态、唯一标识符。
端口类型 显示端口类型及其用途的描述。
端口描述 一个可选字段，用于提供端口及其在流中的角色的自由格式描述。
; export const SlasTab = ({siteName = "知行之桥"}) => <>

与配置服务级别协议 (SLA) 相关的设置。

SLA 允许配置预期流程中端口发送或接收的数据量，并设置预期达到该数据量的时间范围。当 SLA 未达到时，{siteName} 会发送电子邮件警告用户，并将 SLA 标记为 存在风险，这意味着如果 SLA 未能尽快达到，则会被标记为 已违反。这让用户有机会介入并确定 SLA 未达到的原因，并采取适当的措施。如果在风险时间段结束时仍未达到 SLA，则会将 SLA 标记为已违反，并再次通知用户。

要定义 SLA，请启用 预期数据量，然后点击 设置 选项卡。

SLA Empty

以下示例显示了为端口配置的 SLA，该端口预计在周一至周五每天接收 1000 个文件。如果尚未收到 1000 个文件，则会在时间段结束前 1 小时发送风险通知。

SLA Configuration Example 如果有必要，可以关闭 SLA 通知。这在维护窗口期间非常有用。点击导航栏上的 设置，然后跳转到 通知 > 通用通知。点击平板和铅笔图标进行编辑，并取消勾选 SLA 通知 设置。 ; export const AlertsTab = ({siteNameShort = "知行之桥"}) => <>

与配置通知相关的设置。

在执行服务级别协议 (SLA) 之前，需要设置电子邮件通知以接收通知。默认情况下，{siteNameShort} 使用 通知 选项卡上的全局设置。要为此端口使用其他设置，请启用 覆盖全局设置。

默认情况下，错误通知处于启用状态，这意味着每当出现错误时都会发送电子邮件。要关闭错误通知，请取消选中 启用 复选框。

输入 主题（必填），然后（可选）输入以逗号分隔的 收件人 电子邮件列表。

; export const Message = () => <>

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹 选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案 端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。
; 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%

以下是带有参数的宏的一些示例：

还可以创建更复杂的宏，如以下示例所示：

; export const MacrosTable = ({siteName = "知行之桥", extraMacros = []}) => <>

在文件命名策略中使用宏可以提高组织效率和对数据的上下文理解。通过将宏合并到文件名中，可以动态地包含相关信息，例如标识符、时间戳和消息头信息，从而为每个文件提供有价值的上下文。这有助于确保文件名反映对组织重要的详细信息。

{siteName} 支持这些宏，它们都使用以下语法：%Macro%。

{extraMacros.map(item => )}
宏描述
ConnectorID替换为端口的 ConnectorID。
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计算指定保管库项目的值。
{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 来制作标签时，它看起来像这样： ## 宏 ### 示例