设计新的电子报告解决方案打印 ZPL 标签
本文说明系统管理员、电子报告开发人员或电子报告功能顾问角色的用户如何配置电子报告 (ER) 框架的参数,设计新的 ER 解决方案所需的 ER 配置来访问仓库管理系统的数据,并以 Zebra 编程语言 (ZPL) II 格式生成自定义仓库位置标签。 这些步骤可以在 USRT 公司完成。
业务方案
您代表一家在 Microsoft Dynamics 365 Finance 中实施仓库管理的公司。 每个仓库位置都必须贴有包含条码的不干胶标签。 仓库工作人员将使用手持条码阅读器来扫描条码。
所有仓库位置都已在上线前活动的范围内标出。 但是,如果现有标签损坏或重新配置仓库货架,您还必须能够按需打印仓库位置标签。 使用最近发布的 ER 功能,您可以配置新的 ER 解决方案,让仓库主管将标签直接打印到热敏标签打印机。
配置 ER 框架
按照配置电子报告框架中的步骤设置最低限度的电子报告参数集。 在开始使用 ER 框架设计新 ER 解决方案之前,您必须完成此设置。
设计域特定数据模型
为仓库管理域创建一个包含数据模型组件的新 ER 配置。 此数据模型将在以后您设计 ER 格式以生成仓库位置标签时用作数据源。
导入数据模型配置
按照以下步骤从 Microsoft 提供的 XML 文件导入所需的数据模型。 或者,您可以创建自己的数据模型,如下一节所述。
- 下载 Warehouse model.version.1.xml 文件,并将其保存到本地计算机。
- 转到组织管理>工作区>电子申报。
- 在电子报告工作区中,选择报告配置。
- 在配置页上的“操作”窗格中,选择交换>从 XML 文件加载。
- 选择浏览,然后找到并选择 Warehouse model.version.1.xml 文件。
- 选择确定导入配置。
创建数据模型配置
您可以从头开始创建数据模型,而不是导入 Microsoft 提供的数据模型文件。 有关显示如何完成此任务的示例,请参阅创建新数据模型配置。
查看数据模型
您可以在数据模型设计器页面上查看已配置数据模型的可编辑版本。
为配置的数据模型设计模型映射
作为电子报告开发人员角色的用户,您必须为仓库数据模型创建一个新的 ER 配置,其中包含模型映射组件。 此组件实现为 Dynamics 365 Finance 配置的数据模型,并且特定于该应用。 您必须配置此组件来指定将用于在运行时使用应用程序数据填充配置的数据模型的应用程序对象。 要完成此任务,您必须了解仓库管理业务域的数据结构在 Finance 中是如何实现的。
导入模型映射配置
按照以下步骤从 Microsoft 提供的 XML 文件导入所需的模型映射。 或者,您可以创建自己的模型映射,如下一节所述。
- 下载 Warehouse model mapping.version.1.1.xml 文件,并将其保存到本地计算机。
- 转到组织管理>工作区>电子申报。
- 在电子报告工作区中,选择报告配置。
- 在配置页上的“操作”窗格中,选择交换>从 XML 文件加载。
- 选择浏览,然后找到并选择 Warehouse model mapping.version.1.1.xml 文件。
- 选择确定导入配置。
创建模型映射配置
您可以从头开始创建模型映射,而不是导入 Microsoft 提供的模型映射文件。 有关显示如何完成此任务的示例,请参阅创建新模型映射配置。
查看模型映射
您可以在模型映射设计器页面上查看已配置模型映射的可编辑版本。
设计格式
作为电子报告功能顾问角色的用户,您必须创建一个新的 ER 配置,其中包含格式组件。 要配置此组件,您将使用 ZPL II 代码来指定仓库位置标签的布局。
导入格式配置
按照以下步骤从 Microsoft 提供的 XML 文件导入所需的格式。 或者,您可以创建自己的格式,如下一节所述。
- 下载 Warehouse location labels.version.1.1.xml 文件,并将其保存到本地计算机。
- 转到组织管理>工作区>电子申报。
- 在电子报告工作区中,选择报告配置。
- 在配置页上的“操作”窗格中,选择交换>从 XML 文件加载。
- 选择浏览,然后找到并选择 Warehouse location labels.version.1.1.xml 文件。
- 选择确定导入配置。
创建格式配置
您可以从头开始创建格式,而不是导入 Microsoft 提供的格式文件。 有关显示如何完成此任务的示例,请参阅创建新格式配置。
查看格式
您可以在格式设计器页面上查看已配置格式的可编辑版本。
此格式的 model.Location.Label
数据源配置为生成包含以下信息的标签:
- 文本形式的仓库标题
- 条码形式的仓库标题
- 位置标题
- 校验位
在数据源的公式设计器页面上,用于生成标签的 ER 公式包含一个 CONCATENATE
函数,该函数将信息组合到所需的布局中。
提示
标签布局经过设计,以使位置标题和校验位在标签的中心对齐。 但是,ZPL II 不支持条码在中心对齐。 因此,model.Location.Warehouse.Alignment
数据源的公式用于在标签中心对齐条码。 此公式根据仓库标题中的字符数计算条码的左偏移量。
准备您的环境以预览生成的标签
以下示例为 ZPL 标签使用打印机模拟器应用程序在屏幕上显示生成标签的预览。 请按照以下步骤启用此选项。
- 为仓库位置标签 ER 格式添加打印机 ER 目标,并将其配置为将生成的标签从 Finance 发送到文档路线选择代理 (DRA)。
- 安装和配置 DRA 以将生成的标签从 Finance 传递到可从当前工作站访问的本地打印机。
- 为当前工作站添加本地打印机,并将其配置为将生成的标签从 DRA 传递到打印机模拟器应用程序。
- 作为 Chrome Web 浏览器的扩展安装打印机模拟器应用程序,并将其配置为将生成的标签从本地打印机传递到 Web 服务,该服务将呈现生成的标签并将它们返回到打印机模拟器进行预览。
Finance ER 报表 打印机目标 |
文档路线选择代理 | 本地打印机 | 打印机模拟器 | 呈现 Web 服务 |
安装和配置打印机模拟器应用程序
将 ZPL 呈现引擎的打印机模拟器应用程序添加到您的 Chrome Web 浏览器。 此示例使用基于 Labelary ZPL Web 服务的 Zpl 打印机模拟器。 打印机模拟器应用程序会将生成的 ZPL 格式的标签从本地打印机传递到 Web 服务,然后将标签作为 PDF 或 PNG 文件返回以供预览。
在 Chrome Web 商店中,找到并选择您要使用的打印机模拟器应用程序。 然后选择添加到 Chrome 将其添加到 Chrome Web 浏览器。
选择启动应用,从 Chrome Web 浏览器运行打印机模拟器应用程序。
配置正在运行的应用程序:
关闭应用程序。
在打印机设置中,将主机设置为 127.0.0.1。
将端口设置为 9100。
重新打开应用程序。 您应该会收到一条消息,指出打印机已在指定的主机和端口上启动。
注释
由于本示例中使用的打印机模拟器应用程序依赖于 Web 服务来呈现标签,因此请确保您的安全设置允许您与服务进行通信。 否则,应用程序不会收到呈现的标签,这些标签将不能提供预览。
添加和配置本地打印机
添加新的本地打印机,当前设备可以使用它将生成的标签从 DRA 传递到打印机模拟器应用程序。
在 Windows 中,选择开始>设置>设备>打印机和扫描仪。
选择打印机和扫描仪设置。
对于添加打印机或扫描仪,添加设备。
如果显示我需要的打印机不在列表中,选择手动添加。
在按其他选项查找打印机字段中,选择通过手动设置添加本地打印机或网络打印机。
在选择打印机端口字段中,选择创建新端口,然后按照以下步骤操作:
在端口类型字段中,选择标准 TCP/IP 端口。
在主机名或 IP 地址字段中,输入 127.0.0.1。
在端口名称字段中,输入 ZPL。
等待检测 TCP/IP 端口操作完成。
在设备类型字段中,选择自定义,然后选择设置。
确保指定了以下端口设置:
- 端口名称:ZPL
- 打印机名称或 IP 地址:127.0.0.1
- 协议:原始
- 端口号:9100
在安装打印机驱动程序字段中,选择通用/仅文本。
在打印机名称字段中,输入 ZebraPrinter。
安装和配置 DRA
准备 DRA 以将生成的标签从 Finance 传递到配置的本地打印机。
配置 ER 目标
准备 ER 目标以将生成的标签从 Finance 传递到 DRA。
- 转到组织管理>电子申报>电子申报目标。
- 在电子报告目标页面的操作窗格上,选择新建。
- 在引用字段中,选择仓库位置标签。
- 在文件目标快速选项卡上,选择新建。
- 在名称字段中,输入标签。
- 在文件组件名称字段中,选择报表。
- 选择设置。
- 在目标设置对话框的打印机选项卡上,将已启用选项设置为是。
- 在打印机名称字段中,选择 ZebraPrinter。
- 在文档路线类型字段中,选择 ZPL。
- 选择确定。
查看仓库位置
- 转到仓库管理>设置>仓库>位置。
- 在位置页面上,进行筛选以仅查看在校验位字段中具有值的位置。
打印仓库位置标签
- 转到组织管理>电子申报>配置。
- 在配置页面,在配置树中,展开仓库模型,然后选择仓库位置标签。
- 在操作窗格上,选择运行。
- 在电子报表参数对话框的要包括的记录选项卡上,选择筛选器。
- 在范围选项卡上,找到表字段设置为位置、字段字段设置为位置的行。 在条件字段中,输入 LPEnabled。
- 选择确定。
- 选择确定。 将生成一个标签,显示在打印机模拟器应用程序的预览页面上。
修改标签的布局
您可以更改仓库位置标签的当前布局。 以下示例显示如何更改布局以使生成的标签包含位置配置文件 ID。
转到组织管理>电子申报>配置。
将将目标用于草稿状态ER 用户参数设置为是。
在配置页面,在配置树中,展开仓库模型,然后选择仓库位置标签。
选择设计器。
在格式设计器页上的映射选项卡上,选择
model.Location.Label
数据源。在数据源属性对话框中,选择编辑>编辑公式。
在公式设计器页面上,在公式字段中,查看用于生成标签的 ER 公式。
CONCATENATE( "^XA",CrLf, "^CF0,30,30^FO0,30^FB800,1,0,C,0^FD",Warehouse,"\&^FS",CrLf, "^BY2,2,50^FT",@.Warehouse.Alignment,",126^BCN,,N,N,N,A^FD",Warehouse,"\&^FS",CrLf, "^FO0,150^FB800,1,0,C,0^FD",@.Name,"\&^FS",CrLf, "^CF0,20,20^FO0,200^FB800,1,0,C,0^FD",@.CheckDigits,"\&^FS",CrLf, "^XZ")
更新公式以将位置配置文件 ID 添加到生成的标签。
CONCATENATE( "^XA",CrLf, "^CF0,30,30^FO0,30^FB800,1,0,C,0^FD",Warehouse,"\&^FS",CrLf, "^BY2,2,50^FT",@.Warehouse.Alignment,",126^BCN,,N,N,N,A^FD",Warehouse,"\&^FS",CrLf, "^FO0,150^FB800,1,0,C,0^FD",@.Name,"\&^FS",CrLf, "^CF0,20,20^FO0,200^FB800,1,0,C,0^FD",@.CheckDigits,"\&^FS",CrLf, "^CF0,40,40^FO0,240^FB800,1,0,C,0^FD",@.ProfileID,"\&^FS",CrLf, "^XZ")
选择保存。
选择确定。
在操作窗格上,选择运行。
在电子报表参数对话框的要包括的记录选项卡上,选择筛选器。
在范围选项卡上,找到表字段设置为位置、字段字段设置为位置的行。 在条件字段中,输入 Bay。
选择确定。
选择确定。 将生成一个标签,显示在打印机模拟器应用程序的预览页面上。
编码
注释
您必须同步可编辑 ER 格式的 Common\File 组件的编码设置和设计后的标签的适当设置。 Common\File 组件的 Encoding 字段的值不应与用于控制标签编码的 ZPL 命令相矛盾(例如,^CI
命令)。 ER 不验证是否同步了这些设置。