智慧车间标签制作说明

1.      标签打印

1.1.     应用场景介绍

智慧工厂系统可以实现在HMI端进行条码标签的按需打印，首先要进行Prn标签模版的设计制作，然后进行Prn标签模版数据配置，这样在HMI程序中就可以直接调用实现按需打印了。

具体场景如下：

1.2.     硬件

标签打印相关设备包括：

标签打印机

ü  安卓HMI能够驱动识别的标签打印机，目前仅支持斑马品牌，且必须支持ZPL指令集，一般为USB或蓝牙接口，推荐USB接口；

ü  是否支持ZPL指令集的查看方法：

方式1：咨询客户或销售商

方式2：根据型号官网查看，如下：

进入官网——产品——打印机——桌面打印机：

找到需要确认的型号，点击查看产品说明：

查看技术资料中是否支持ZPL指令集即可：

1.3.     初始化应用流程

标签打印的初始化步骤如下：

1.4.     Prn标签文件制作

如果需要通过HMI在线打印条码标签，则需要制作打印机专属的标签，通过附件的形式上传服务器，在HMI上按需下载，目前支持的打印机只限于斑马（Zebra）。下面详细介绍标签的制作方式：

1、 从网上下载BarTender，安装；

2、 安装BarTender斑马打印机驱动，可参考http://www.bartender.cc/xinshou/dayinji-qudongchengxu.html

3、 通过BarTender制作标签，需要特别注意的是，所有的变量只能使用斑马打印机特有字体，每个打印机支持的字体不完全一样，只要选择Zebra开头的字体就行。如果之前是通过别的品牌打印机制作的标签，那么在通过斑马打印机打开标签后，所有的变量字体会自动调整成Windows的系统字体，所以一定要重新调整后保存。Bartender的标签保存后，文件后缀是.btw。

4、 在Bartender打印，打印机选择斑马打印机，选择“打印到文件”方式，生成Prn后缀的文件。

5、 把该文件在通过金蝶云中工程数据/标签模板中上传服务器。

1.5.     标签模板配置

菜单位置：

1.5.1.      基于系统单据打印标签的配置

ü  场景举例：

系统生成工序汇报单后，根据工序汇报单的数据进行标签打印

ü  配置方法：

新建标签模板，选择对应的分组：

指定相关字段：

ü  适用范围：按需设定

ü  柔性产线：事后打印场景不勾选

ü  适用单据：从列表中选择，目前仅支持列表中可以选定的单据；

ü  标签变量：自定标签变量名，然后选择单据上对应的字段，其中变量名要和PRN文件的需要替换的标签字段名称相同（如下）；

ü  自定义插件：如果需要打印标签的内容无法直接从单据的字段上打印出来，可以通过二开插件的自定义方式实现，具体自定义说明参考下文；

上传标签Prn文件：

1.5.2.      基于柔性缓存打印标签的配置

ü  场景举例：

基于柔性缓存实时打印产品标签或箱号标签，仅适用于柔性产线智慧车间解决方案。

ü  配置方法：

需要勾选柔性产线标志，标签变量的字段选择仅支持从缓存字段选择；

如果需要打印标签的内容无法直接从缓存中打印出来，可以通过二开插件的自定义方式实现，具体自定义说明参考下文；

其他配置过程同上；

1.6.     标签模板支持二开自定义插件开发说明

1、     先用VS增加一个二开插件，例如LableTemplatePlugsTest： 继承AbstractLabelTemplateRegPlugin

2、     覆盖GetParamValueMap方法，编写二开扩展逻辑

传入参数说明：srcDyo， 标签模板中对应的适用单据对象

              labelTempDyo,标签模板对象

返回值：dicParam字典中key 对应于标签模板的模板变量页签分录中的变量名，也是打印模板中key，字典中值中Tuple中的第一个值是变量对应的值，第二个值对应标签模板的转换规则字段，或者随便给一个值也可以。

3、     进入Cloud系统，将插件维护到标签模板自定义插件中，可支持多个插件

1.7.     HMI界面调用打印二开说明

1.7.1.      基于工序汇报单进行标签打印

1、 适用单据：工序汇报单，按汇报单号、分录号打印

2、 描述：

根据汇报单号查找汇报单对象

根据汇报单对象获取产品id

根据产品id获取标签模板

3、 方法名：ISFCMobilePrintService.GetDataByRptBillNo

4、 参数

Context ctx：上下文

string rptBillNo,：汇报单号

int rptBillSeq：汇报单分录序号

string tempType：标签模板组号

5、 返回结果：

返回IOperationResult。先判断IsSuccess，如果为true，则获取FuncResult，将其转换为List<string>，其中第0个元素为待打印的字符串指令，直接发送给打印机即可，只有打印箱号时，如果传入了跟踪号未传入箱号，第1个元素会返回箱号，其他情况下，List<string>只有一个元素。当IsSuccess为false时，将FuncResult转换为List<string>，第0个元素为错误信息。

1.7.2.      基于工序转移单进行标签打印

1、 适用单据： 工序汇报单，按转移单号打印

2、 描述：

根据转移单号查找转移单对象

根据转移单对象获取产品id

根据产品id获取标签模板

3、 方法名：

ISFCMobilePrintService.GetDataByTransBillNo

4、 参数：

Context ctx,：上下文

string transBillNo：转移单号

string tempType：标签模板组号

5、 返回结果：

返回IOperationResult。先判断IsSuccess，如果为true，则获取FuncResult，将其转换为List<string>，其中第0个元素为待打印的字符串指令，直接发送给打印机即可，只有打印箱号时，如果传入了跟踪号未传入箱号，第1个元素会返回箱号，其他情况下，List<string>只有一个元素。当IsSuccess为false时，将FuncResult转换为List<string>，第0个元素为错误信息。

1.8.     标签制作和调用微课件

标签制作过程请参考如下微课件：

https://vip.kingdee.com/school/501