1

目录

第 1 章 打印模板..........................................................................................................…...................................................................4

1.1 概述........................................…...................................................................…............................................…...............................................................4

1.2 预览、打印、输出........................................................................................................................................………......................................................4

第 2 章 场景及案例........................................................................................…….............................................................................15

2.1 普通单据............................................................................….......................................................................................................................................15 

2.2 套打模板...........….................................................................…...................................................................................................................................15 

2.3 合同.........................................................................................................…….............................................................…...............................................17 

2.4 小票......................................................................................…..…...…........…...................….........................................................................................20

2.5 标签.................................................…..............................…..........................................................................................................................................21

2.6 二维表...............................….......................................................................................................................................................................................22

2.7M*N 矩阵打印.......................................................................................................................…...…............................................................................24

2.8 自定义纸张.........................................................................…….........................…............................…........................................................................26

2.9 按不同主体循环打印......................................................................................................................…..…..…......................…....................................30

第 3 章 常见问题........................................................................................................................………............................................33

3.1 自定义尺寸套打预览正常，发送到打印机后文字位置偏了........…......…........…........................................................................…........….........36 

3.3 预览正常但打印结果和纸张横纵向颠倒..............................................................................................……..….......................................................37 

3.4 旧版设计中数据集中没有元数据定义的字段..........................................................................…...........................…..……........…........................37 

3.5 针式打印机打印清晰度提升................…..................................….....................…....................................................................................................38 

3.6 针式打印机横纵向问题.........................................................................................................................…....…..........................................................38 

3.7 输出 Excel 有很多小细格子...................................................................................................….…….......................................................................40 

3.8 动态行高时网格/卡片中文本框如何实现垂直居中效果............................................……....…..........…..............................................................40 

3.9 表单场景，表单中的审批意见控件字段在打印模板中设置样式为什么不生效？………................….......…...................................................41

2

3.10 表单场景打印审批意见................................………………………………………………………………………………………………….............................42 

3.11 图章场景，图章和文字整体移动........................................…......................................…...…..............................................................................45 

3.12 如何设置枚举类型的复选框效果.......................................................................................….............................................……...........................46

3.13 热敏激光标签打印机打印不清晰...............................................................................................................................…......................................50 

3.14 打印计数.........................…......................................................................................................................................................................................50

3

第 1 章 打印模板

1.1 概述

主要解决客户在业务应用中需要的不同类型的打印能够按 照模版打印，通过设计器的能力将单据上的数据转化为打印的 服务。在业务应用中可以是小票打印、可以是合同打印、可以 是凭证打印、可以套打、图片、二维码、主子表等多种单据的 打印。随着业务的不断扩展，对于打印不同组织也会有不同的 需求，可以通过分级管控解决各级组织的模版打印。而全球化 在国际业务中也能够按照不同的语言或者格式展示本地区适合 的模版，按照当地的语言格式打印。

1.2 预览、打印、输出

         打印模板预览打印支持切换多模板预览打印、指定模板预 览打印，使用模板范围分根据分类（单据类型）过滤、根据交 易类型过滤、根据组织过滤等等，具体使用哪种方式取决于单 据调用打印服务时传递了哪些参数。目前比较常见的有：
在单据列表页面触发预览打印，进入预览页可切换选择模板，         选择范围是根据分类（单据类型）过滤，例如采购订单列表/销售订单列表等。

在单据详情页面切换选择模板，模板选择范围为根据组织 orgId 过滤，选中一个模板后打印跳入预览打印页，预览打 印页无法再切换选择模板，例如采购订单详情页、销售订单 详情等。

4

在单据详情页切换选择模板，模板选择范围为根据当前单据 交易类型过滤，选中一个模板后打印跳入预览打印页，预览 打印页无法再切换选择模板，例如费控模块的单据。

1.2.1 预览打印 
                打印模板设计器中设计好之后，就可以在对应单据页面来 进行打印查看效果了，目前预览打印支持在单据列表和卡片页 面打印两种方式（实际以各单据配置按钮情况为准）。以销售 订单为例，在销售订单列表页面，可以勾选 1 条或多条数据后 点【打印】-【打印预览】按钮，见下图：

                触发后，浏览器会新开一个页签用于显示预览页面，当存 在多个可用模板时，左上角会显示模板下拉控件来供切换。

                进入销售订单详情页，根据 orgId 过滤显示可以模板的下 拉控件，选择一个模板后，点打印进入预览打印页。

                由于已在详情页选择了指定模板，所以在预览打印页不再 有模板下拉选择能力。

5

1.2.2 直接打印 
         直接打印指使用打印插件（即云打印助手）进行打印，通 常在单据列表页面的直接打印（如销售订单）/快速打印（如凭 证查询）按钮触发。使用打印插件打印具备了浏览器端预览打 印能力，
1、但主要用于解决以下场景：
批量打印、静默打印。部分用户于固定时间需要批量打印多条单据，如年底时打印凭证、每天下午五点打印当天的所有   发货单，打印时无需再进入预览页，能够精简操作步骤快速  发送到打印机，即静默打印。

针式打印机清晰度问题解决。新版打印默认生成 PDF 文件，但针式打印机打印 PDF 文件存在不清晰情况，打印插件提供 原生打印方式发送打印内容以保证打印效果清晰。

2、客户端下载安装 
使用直接打印需客户端安装打印插件，安装使用过程如下：

（1）在列表页选择数据点击直接打印/快速打印

（2）若本地未安装打印插件，页面会弹出提示框引导下载插件

6

（3）点击确定，进入下载引导页，根据本地系统选择适配的插

件下载，引导页

（4）插件下载完成后双击 exe 文件运行即可

（5）若本地已安装过打印，点直接打印时会尝试自动调起程序，在提示框中点【打开运营云打印助手】即可启动插件。

（6）进入打印插件界面，选择左侧的模板、打印机等点击【保存设置】后会将本次设置保存到本地，后续直接使用无需再次

选择。

7

（7）点【打印】按钮将文件发送到指定打印机

（8）右上角最小化按钮，点击按钮插件界面会最小化到系统托盘。在未勾选“跳过预览”且再次触发直接打印时，插件页 面会自动弹出以展示预览效果。

（9）最小化后插件会任务栏的系统托盘中，右键点击图标显示【设置】、【退出】按钮。

（10）设置：点击后会重新打开插件页面。

（11）退出：插件程序安全退出。

3、属性设置 
                打印插件中左侧为属性设置，右侧为预览显示区，插件页 面功能介绍如下：
（1）选择模板：有多个模板可用时，显示模板列表
（2）打印机：读取客户端中添加的打印机列表
（3）布局：页面布局，支持横向、纵向
（4）边距：仅旧版设计器支持预览后添加边距，新版边距需要 在设计器中设置
（5）纸张尺寸：读取客户端打印机中的纸张尺寸，自定义纸张 尺寸详见【如何自定义纸张尺寸】章节

（6）打印设置：支持打印所有页、自定义打印，自定义打印包 括打印奇数页（1、3、5……）、打印偶数页（2、4、6……）、指定页数范围打印（打印 1 到 3 页则输入 1-3，打印第 5 页则 输入 5）

（7）打印份数：指定打印机中打印几份
（8）跳过预览：即静默打印，不勾选时，点击直接打印按钮时，插件中会显示预览效果（如果此时插件最小化状态插件页面会 自动弹出显示预览），点击插件的【打印】按钮后发送打印机。勾选后，点击直接打印后会直接发送到打印机（插件最小化时 不会自动弹出插件）。

（9）pdf 打印：不勾选时使用原生打印方式将内容发送打印机，解决针式打印机不清晰问题。勾选后为 PDF 方式打印，发送 PDF 文件到打印机，默认不勾选。

（10）黑白打印（针式打印机建议勾选）：大多数针式打印机 只支持黑白，有用户在设计器中会设置字体颜色为彩色或灰色 等，如使用灰色时会导致打印出来文字颜色浅，勾选后会将彩 色或灰色置为黑色打印。

（11）保存设置：将本次设置保存本地，后续打印直接使用本 次设置，无需二次选择。

9

（12）预览区：显示预览文件内容，多页时可以点击上一页/ 下一页查看效果。

直接/快速打印按钮触发的打印任务均发送到打印插件，各 任务在插件中以任务队列顺序存储，执行顺序为先到先执行、后到后执行。只有本次任务发送到打印机后完成或本次任务取 消，任务队列中的下一个任务才会执行。

（13）取消：取消本次任务，如果队列中有下一个任务则自动 执行。

（14）打印：发送打印任务到指定打印机，发送完成后如果队 列中有下一个任务则自动执行下一个打印任务。

1.2.3 输出 Excel 
                打印预览默认生成 PDF 文件，除此之外还支持输出为 Excel 文件，供用户使用或进行再编辑。输出 Excel 文件后内容 样式保持和 PDF 预览内容样式一致。输出 Excel 按钮位于预览 页右上角。

如，模板设计页面

10

预览效果如下：

点击预览页面右上角的【输出】—【Excel】按钮可以输出Excel 文件，下图以 Chrome 浏览器为例，点输出 Excel 后下载文件效果。

Excel 内容如下

11

Excel 文件内容生存规则：
（1）设计器中每个模板页面生成 Excel 中的一个 sheet。

（2）选择多天数据批量打印时，同一个模板页面的内容在Excel的同一个 sheet 中纵向排列显示。

（3）Excel 内容布局与 PDF 内容布局保持一致。

（4）Excel 中格子或合并的格子宽高均为设计器预览后每个控 件占位的大小计算。

（5）受 Excel 本身特性限制而展现的效果若与 PDF 不一致，属于正常现象不算问题。

【输出 Excel 注意事项】Excel 中实际为 N*N 的格子，不同于 PDF 可 以随意布局甚至支持控件重叠，要输出 Excel 的模板对设计器内的设计 标准要求略高，要求控件间整齐排列，不允许出现控件重叠，否则无 法计算单元格合并。如下图，上部分控件未重叠，可以在 Excel 中计算 位置以及单元格合并，但下部分控件出现了重叠，在 Excel 中无法实现，所以必须保证控件不能出现重叠。

                为了保证输出效果和预览一致，Excel 中内容的输出需要 按模板设计来严格计算每个控件的位置及宽高，所以当模板控

12

件没有完全对齐的时候，会出现有小格子的情况，下图通过彩 色线展示每个控件的起始结束位置。

如上图，橘蓝绿三色列是由于 3406 控件右侧边、销售订 单控件左侧边、审批人控件左侧边横向 X 轴位置不一样导致出 现，蓝色线是销售订单控件的左侧边线，橘色线是 3406 控件 右侧边线，蓝色是审批人控件左侧边线。

如果不希望出现这些小细格子，可以通过调整模板解决，将出现小细格子的控件进行调整对齐。比如，将“审批人”控 件往右移（也可以选中“审批人”控件，在控件左侧矩形锚点 上拉窄控件宽度）使审批人左边线与“销售订单”左边线对齐，这样就会减少一个小格子。调整后设计态效果

13

调整后的预览效果：

调整后的输出 Excel 效果：

14

第 2 章 场景及案例

2.1 普通单据

普通单据模板使用较多，通常布局以卡片+列表组合形式 展示。比如凭证打印模板，模板中显示标题、格式规范的单据 头、子表明细列表等，设计效果如下，

预览效果：

2.2 套打模板

                套打模板用于打印纸为套打纸的场景，不同于普通白纸套 打纸通常带有文字表格等信息，打印时要求打印的变量信息严 格展示在固定的格子区域内，比较常见的套打纸如凭证、快递 单。如凭证打印纸，见下图：
                15

设计效果，上传套打底图，使用套打列表控件。

带底图预览效果，点击画布上的页面区域，【样式】-开启【打印时显示套打底图】，开关开启功能通常用于调试状态时查看预览效果。

16

                不带底图打印预览效果，关闭【打印时显示套打底图】后 效果见下图，真实打印时因打印纸上已带图所以开关需要关闭。

2.3 合同

合同模板特点是一份合同多页，不同页内容不同，常见于 人力合同、销售合同场景。合同模板的绘制有使用多个页面模 板和同一页面模板中内容顺延两种方式，不同方式适用于不同 场景，也可两种方式组合使用。

1、使用多个页面模板 
                此方式常用于解决多页内容均不同，且每页内容固定的场 景。如人力员工签订合同，共五页，首页封皮，其他页分别为 不同条款内容：

17

设计页面效果，页面模板 2

                一共五个页面模板，其余不再截图，此合同模板预览后效 果如下：

2、同一页面模板中内容顺延 
                当合同模板内某一页面模板存在列表动态扩展控件来展示 明细子表，预览时不同单据的明细条数不同会导致列表动态撑 高而产生换页，因不同页面模板之间相互独立，所以会出现换 页后和下一页面模板之间出现空白区域。

                如页面模板 1 中有列表控件显示商品明细，页面模板 2 中 显示剩余合同条规，设计如下 ：

18

当商品明细多条时，预览效果如下，会出现第 2 页中有空白：

因此，此时应该使用一个页面模板，模板内增大设计态高度，使预览时内容顺延，以解决预览页面出现空白问题。设计态高度默认等于纸张高度，当设计态高度大于纸张高度时，只是改变的设计态页面的高度，真实预览打印时，依然以纸张高 度进行分页显示。

19

设计态效果如下：

设计态高度为 400mm，纸张高度为 A4 的 297mm，使设 计时一页中可以放置更多内容，但在预览时以 A4 的 297mm 高度自动进行分页渲染打印，内容之间顺序衔接无空白。预览 效果如下：

2.4 小票

用于零售场景消费小票定制，小票通常宽度较窄，且常以 指定的小票打印机输出。打印模板仅支持小票场景的定制和使

20

用普通打印机打印小票，对于小票打印机的打印方式需要业务方进行开发。

使用 mock 数据预览

2.5 标签

在资产、制造等领域绘制设备标签，或零售绘制货架上商品标签场景，用于标注显示设备或商品的关键信息，打印出来后常贴在资产设备上或商品货架上。标签类模板通常包含文本及条码（条形码或二维码等用于扫码），且标签纸张大小略小。

以资产为例，标签设计页面：

21

选择两条资产数据，预览如下：

2.6 二维表

销售领域商品属性为动态列，如尺码、颜色等，不同商品 动态列数不同，且在设计态无法预知，需要在预览时，根据实 际情况动态扩展显示。动态列的列表头最多三行，动态列列表 头实际显示行数又业务返回数据及打印模板配置决定。

动态列列表头一行效果（红色为动态列列表头）：

动态列列表头两行效果（红色为动态列列表头）：

22

动态列列表头三行效果（红色为动态列列表头）：

以销售发货单尺码为动态列为例，在打印模板中选中列表“尺码”的列表头，属性页签中打开【是否动态列】开关。

销售发货单如下：

二维打印时，选择二维模板，点击【二维打印】按钮

23

预览效果：

【动态列表头是否显示】开关用于设置预览时列表头是否显示，开启后，列表头区域显示设计态列表头内容+动态列列表头。关闭后，仅显示动态列的列表头内容。对比效果如下，

开启后效果：

关闭后效果：

2.7M*N 矩阵打印

在制造领域打印标签时，存在一张纸上排列打印多个场景，矩阵打印支持在设计态自由定义横向、纵向打印个数。以真实纸横向：宽 420（84*5）mm 高 120（60*2）mm 为例，需要横向打印 5 个标签，纵向打印 2 个标签。操作步骤：选中左侧【层级】页签中的一级节点或者画布的边缘模板区域，在右侧【属性】页签，输入矩阵打印的横向打印个数、纵向打印个数。

24

矩阵打印个数设置：

选中模板内设计区，设置纸张大小。矩阵打印时，设计态纸张大小为最小单元的页面大小。

预览效果：
                                                                                                          25

2.8 自定义纸张

打印模板设计器支持自定义纸张大小，此场景下纸张大小通常等于实际纸张大小，需要在打印机配置中添加纸张。步骤：

1、控制面板-打印机，添加纸张

【注意】纸张定义默认为纵向，宽度要小于高度，填错打印页可能会 查不到该纸张。

可以参考 A4 纸的定义来理解，A4 纵向：21*29.7(cm)

26

2、在设计器页面设计，使用自定义纸张

横向纸张设计效果：

纵向纸张设计效果：

27

3、预览

横向设计模板的预览效果：

纵向设计模板预览效果：

28

4、打印，选择打印机，选择纸张

29

2.9 按不同主体循环打印

循环主体只按哪个主体进行分页渲染打印，包括当前数据 集的主表、子表，默认为主表。对于元数据为主子表场景的模 板，通常是按主表进行分页。若需要设置为按某子表分页打印，可将循环主体设为该子表。

循环主体位于模板属性页，以销售订单打印模板为例：

循环主体不进行设置，或设置为“销售订单”时，按销售 订单主表进行分页打印。

预览效果：

30

以销售订单子表进行分页显示时，设置循环主体为“销售订单子表”，设计页面（通常以子表进行分页时，子表在画布中不会以列表控件设置）：

预览效果：