快麦云打印插件 - 简道云

1. 简介

1.1 插件简介

快麦云打印插件支持连接快麦云打印机，远程自动打印标签/小票，支持最大打印宽度 108mm，支持动态子表数据打印，支持快麦便携式云打印机，可编辑打印模板。

1.2 应用场景

常用于物流仓储、生产管理、产品管理等业务场景中。可打印物料标签、托盘标签、货架标签、批次标签、生产标签、工艺标签、检验标签、产品出库小票等。

1.3 预期效果

开启快麦云打印插件，在「主表数据打印」表单中新增数据后，自动打印产品标签/小票。效果如下所示：

1.4 使用说明

1）该插件包含 3 种事件，如下所示：

主表数据打印
动态子表打印
小票连续纸打印

2）快麦云打印插件为付费插件，请联系我们进行增购。插件购买流程如下所示：

2. 快麦平台配置

2.1.注册账号

进入快麦云开放平台，点击「立即注册」，输入手机号、密码等信息后点击「注册」按钮，完成账号注册。

2.2 登录开放平台

注册完成后，在登录页面输入快麦云平台的账号密码进行登录。

2.3 获取appID和appSecret

完成登录后，进入「系统集成」页面中，在顶部即可获取 appID 和 appSecret 。

2.4 在管理后台添加设备

登录成功后，进入「设备管理 >> 添加设备」页面，微信扫码添加设备，扫码后输入或扫描设备序列号完成设备添加。

2.5 快麦打印模板配置

该插件支持的三种执行事件，所配置的模板有所区别，其中：

主表数据打印：配置标签模板，对应【2.5.3 新建标签模板】；
动态子表/小票连续纸打印：配置小票模板，对应【2.5.4 新建小票模板】。

2.5.1 新建应用

在「快麦后台 >> 应用管理」中，添加新增应用，填写应用名称和应用描述，点击确定。

2.5.2 新建表格和字段

在「快麦后台 >> 模板管理 >> 字段管理」中，选择建好的应用，并添加新增字段，填写表名、字段名、中文名称和字段值示例，填写完成后点击保存。

2.5.3 新建标签模板

1）标签模板用于主表数据打印，在「快麦后台 >> 模板管理 >> 标签编辑」中新增公共标签模板，填写标签信息后点击确定。

2）根据业务需求，在左侧和上方工具栏选择对应的功能，需要动态获取的打印数据，将右侧数据类型选择为动态获取。

2.5.4 新建小票模板

1）小票模板用于动态子表打印，在「快麦后台 >> 模板管理 >> 小票编辑」中新增公共小票模板，填写信息后点击确定。

2）根据业务场景需求，在左侧和上方工具栏选择对应的功能，需要打印动态子表数据需选择动态表格，并在右侧工具栏进行相关设置。

注：

1）因模板管理中的小票编辑支持动态表格功能，故标签打印中需要动态子表打印时也选择小票模板进行模板编辑，不涉及动态子表数据的标签打印的主表数据打印选择标签编辑即可。

2）如需打印连续纸小票，不论是否涉及动态子表数据均选择小票编辑模板，因不同纸张接受指令不同，不能选择标签编辑进行模板编辑。

3）为保证打印效果，打印模板尺寸填写时，尽量填写小于纸张尺寸的数值。

4）目前接口不支持动态图片打印，如需图片打印可在模板设置静态图片。

5）搭建应用和表格字段的视频教程见「快麦后台 >> 系统集成」。

3. 插件安装及配置

3.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：快麦云打印插件安装。
安装成功后，可参考本文【3.2 配置插件】和【3.3 启用插件】，前往「开放平台 >> 插件管理」处配置并启用插件。

2）插件市场处安装

在简道云「插件市场」处，安装「快麦云打印」插件。插件市场处安装方法可参见文档：插件市场中【2.3插件安装】。

3.2 配置插件

安装后，在插件管理中，点击插件右侧「设置」按钮，将【2.3 获取 appID 和 appSecret 】获取到的「appID」和「appSecret」配置到「快麦应用 ID 」和「快麦应用密钥」中。

3.3 启用插件

在插件管理中，打开快麦云打印右侧开关，启用插件。

4. 表单搭建

插件使用体验可先安装：快麦云打印模板表单。本文将按照示例表单进行讲解。

以自动打印主表产品标签为例，新建「主表数据打印」流程表单，字段设置如下所示：

字段名称	字段类型	字段说明
公司名称	单行文本	——
座机
QQ号
条码
采购单号
产品名称
产品型号
产品数量	数字
批次	单行文本
物料
描述
贴纸
数量	数字
WBS	单行文本
供应商批次	单行文本
生产日期	日期时间-年月日
有效日期	日期时间-年月日
生产日期文本	单行文本	在「字段属性 >> 默认值」处设置公式编辑，公式设置如下所示： TEXT(DATE(生产日期),'yyyy-MM-dd')
有效日期文本		在「字段属性 >> 默认值」处设置公式编辑，公式设置如下所示： TEXT(DATE(有效日期),'yyyy-MM-dd')
标识		——
库位
任务编号
打印内容		在「字段属性 >> 默认值」处设置公式编辑，公式设置如下所示： CONCATENATE('{','"normal":[{"company":公司名称,"tel": 座机,"qq": QQ号,"code":条码,"product_code":采购单号,"product_name":产品名称,"product_type":产品型号,"product_number":产品数量,"batch":批次,"material":物料,"desc": 描述,"stickers":贴纸,"number":数量,"WBS": WBS,"suplly_batch":供应商批次,"product_date":生产日期文本,"expired_date":有效日期文本,"mark": 标识,"location": 库位 }]','}')

注：打印内容字段公式中的表格名称和字段名称，需和「快麦后台 >> 模板管理 >> 字段管理」中的表名和字段名保持一致。如公式中的 normal 对应「快麦后台 >> 模板管理 >> 字段管理」中的表名 normal 。

5. 流程配置

该插件支持在前端事件、智能助手 Pro 和插件节点中调用触发。本文以插件节点触发为例，进行插件的调用配置。如下所示：

5.1 流程发起节点

点击流程发起节点，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」「可编辑」权限：

5.2 审批节点

点击流程审批节点，进行以下操作：

在「节点属性 >> 节点负责人」处，设置节点处的负责人；
在「节点属性 >> 字段权限」处，勾选部分字段的「可见」、「可编辑」权限。

5.3 插件节点

点击插件配置节点，进行以下操作：

插件：选择「快麦云打印 >> 主表数据打印」插件；
打印机序列号：设置为「自定义」，并且输入打印机序列号；
快麦模板 ID：设置为「自定义」，即「快麦后台 >> 模板管理 >> 标签编辑」中的模板 ID；
打印内容：设置为「字段值」，即「打印内容」字段；
打印份数：设置为「自定义」，输入需要打印的份数；
序号字段：设置为「自定义」，即「快麦后台 >> 模板管理 >> 字段管理」中需要打印自动序号的字段；
字段存储关系：点击「添加」按钮，设置「任务编号」的值存储到「任务编号」中。

注：

1）序号字段用于打印需要自动添加流水号的字段，默认在所选字段编号后添加「-01，-02，-03……」，自动添加流水号最大值为 99，超过 99 插件执行失败。

2）当打印份数大于等于 2 时，序号字段才会执行，填写的序号字段需和「快麦后台 >> 模板管理 >> 字段管理」中的字段名保持一致。

3）如需打印动态子表数据，则选择快麦云打印插件同时选择执行事件为「动态子表打印」；参考【6. 注意事项】编辑表单。

5.4 效果演示

效果参见本文【1.3 预期效果】。

6. 注意事项

6.1 动态子表打印

若打印包含动态子表数据，需要对子表单数据进行处理，然后通过单行文本聚合子表单信息，传递给插件。新建「动态子表打印」流程表单，如下所示：

字段名称	字段类型	字段说明
订单编号	单行文本	在「字段属性 >> 默认值」处设置公式编辑，公式设置如下所示： CONCATENATE(TEXT(SYSTIME(),"yyMMddHHmmss"),RIGHT("000"+RECNO(),3),"C")
下单时间	日期时间	——
下单时间文本	单行文本	在「字段属性 >> 默认值」处设置公式编辑，公式设置如下所示： TEXT(DATE(下单时间),'yyyy-MM-dd')
收件姓名		——
电话		在「字段属性 >> 格式」处设置格式，格式设置为电话号码或手机号码
收件地址		——
动态数据	子表单
动态数据.产品名称	子表单-单行文本
动态数据.单位	子表单-单行文本
动态数据.单价	子表单-数字
动态数据.数量
动态数据.总价		在「字段属性 >> 默认值」处设置公式编辑，公式设置如下所示：动态数据.总价=动态数据.单价*动态数据.数量
动态数据.数据聚合	子表单-单行文本	在「字段属性 >> 默认值」处设置公式编辑，公式设置如下所示： CONCATENATE('{','"good_name":动态数据.产品名称,"unit":动态数据.单位,"good_price":动态数据.单价,"number":动态数据.数量，"total":动态数据.总价','}')
任务编号	单行文本	——
打印内容	单行文本	在「字段属性 >> 默认值」处设置公式编辑，公式设置如下所示： CONCATENATE('{','"order":[{"order_code":订单编号,"order_date":下单时间文本,"name":收件姓名,"phone":电话,"address":收件地址}]',',"goods":['+TEXT(动态数据,数据聚合)+']','}')

注：动态数据.数据聚合和打印内容字段公式中的表格名称和字段名称，需和「快麦后台 >> 模板管理 >> 字段管理」中的表名和字段名保持一致，如公式中的 order 对应「快麦后台 >> 模板管理 >> 字段管理」中的表名 order 。

6.2 小票连续纸打印

6.2.1 表单搭建

若需使用连续纸打印小票，可先根据快麦机型自行切换连续纸模式，可参考新建小票连续纸表单如下：

字段名称	字段类型	字段说明
订单编号	单行文本	在「字段属性 >> 默认值」处设置公式编辑，公式为： CONCATENATE(TEXT(SYSTIME(),"yyMMddHHmmss"),RIGHT("000"+RECNO(),3),"C")
下单时间	日期时间	——
下单时间文本	单行文本	在「字段属性 >> 默认值」处设置公式编辑，公式为： TEXT(DATE(下单时间),'yyyy-MM-dd')
收件姓名		——
电话
收件地址
动态子表数据	子表单	——
产品名称	子表单-单行文本	——
单位
单价
数量	子表单-数字	在「字段属性 >> 格式」处设置格式，格式设置为数值
总价	子表单-数字	在「字段属性 >> 默认值」处设置公式编辑，公式为：动态子表数据.单价*动态子表数据.数量
数据聚合	子表单单行文本	在「字段属性 >> 默认值」处设置公式编辑，公式为： CONCATENATE('{','"good_name":动态子表数据.产品名称,"unit":动态子表数据.单位,"good_price":动态子表数据.单价,"number":动态子表数据.数量,"total":动态子表数据.总价','}')
任务编号	单行文本	——
打印内容	单行文本	在「字段属性 >> 默认值」处设置公式编辑，公式为： CONCATENATE('{','"order":[{"order_code":订单编号,"order_date":下单时间文本,"name":收件姓名,"phone":电话,"address":收件地址}]',',"goods":['+TEXT(动态子表数据.数据聚合)+']','}')

6.2.2 插件配置

小票连续纸打印和标签打印流程配置相似，故流程发起节点和审批节点的配置参考本文档【5.1流程发起】和【5.2审批节点】，此处不做示范，仅对插件节点配置做示范：

点击插件配置节点，进行以下操作：

插件：选择「快麦云打印 >> 小票连续纸打印」插件；
打印机序列号：设置为「自定义」，并且输入打印机序列号；
快麦模板 ID：设置为「自定义」，即「快麦后台 >> 模板管理 >> 标签编辑」中的模板 ID；
打印内容：设置为「字段值」，即「打印内容」字段；
打印份数：设置为「自定义」，输入需要打印的份数；
序号字段：设置为「自定义」，即「快麦后台 >> 模板管理 >> 字段管理」中需要打印自动序号的字段；
字段存储关系：点击「添加」按钮，设置「任务编号」的值存储到「任务编号」中。

6.3 支持快麦云打印插件的机型

目前支持快麦云打印插件的打印机机型为：KM118DW，KM118MW，UL410和E20W，如购错型号，可联系客服退货。

因云打印机型为快麦定制款，如需购买，可点击快麦官方店淘宝店铺链接，或者点击 KM118DW，KM118MW 、 UL410，E20W 商品购买链接，勾选对应型号进行购买。如需帮助，可联系店铺客服。

7. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：

公司：成都轻如燕企业服务有限公司
联系人：赵鹏
联系电话：18583980516（微信同号）