跳转到主要内容
标签端口基于模板生成 Zebra 编程语言 (ZPL) 标签,该模板在运行时使用 XML 作为输入进行填充。

核心功能

  • 通过 XML 输入生成 ZPL 标签,支持基于模板的自定义
  • 兼容 XML Map 端口,实现自动化标签创建工作流
  • 使用 ${...} 语法进行动态字段替换,用于热敏打印机输出

概述

标签端口基于预定义的 XML 模板将输入的 XML 转换为 ZPL 文件,从而实现自动且一致的标签创建,以便在 Zebra 热敏打印机上打印。它与 XML Map 端口 以及原始 XML 输入兼容。但是,主要用例是使用从 XML Map 端口到标签端口的流程将 XML 映射到 XML 中表示的 ZPL 结构。

端口配置

本节包含所有可配置的端口属性。

设置选项卡

配置

与建立连接相关的设置。
设置描述
端口 Id端口的静态、唯一标识符。
端口类型显示端口类型及其用途的描述。
端口描述一个可选字段,用于提供端口及其在流中的角色的自由格式描述。

模板选项卡

用作模板的 ZPL 文件。创建标签端口时,知行之桥 会使用 ZPL 模板预填充此字段以用作起点。有关详细信息,请参阅生成 ZPL 文档。

高级设置

高级设置

先前类别中未包含的设置。

消息

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

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

日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型:
  • 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 来制作标签时,它看起来像这样:

宏

示例