12目录第1章打印模板.41.1概述..41.2预览、打印、输出..4第2章场景及案例..152.1普通单据..152.2套打模板..152.3合同..172.4小票..202.5标签..212.6二维表..222.7M*N矩阵打印.242.8自定义纸张..262.9按不同主体循环打印..30第3章常见问题..333.1自定义尺寸套打预览正常，发送到打印机后文字位置偏了.333.2如何自定义纸张尺寸？打印时自定义纸张看不到？.363.3预览正常但打印结果和纸张横纵向颠倒.373.4旧版设计中数据集中没有元数据定义的字段.373.5针式打印机打印清晰度提升..383.6针式打印机横纵向问题..383.7输出Excel有很多小细格子..403.8动态行高时网格/卡片中文本框如何实现垂直居中效果.403.9表单场景，表单中的审批意见控件字段在打印模板中设置样式为什么不生效？.4133.10表单场景打印审批意见.423.11图章场景，图章和文字整体移动.453.12如何设置枚举类型的复选框效果.463.13热敏激光标签打印机打印不清晰.503.14打印计数..504第1章打印模板1.1概述主要解决客户在业务应用中需要的不同类型的打印能够按照模版打印，通过设计器的能力将单据上的数据转化为打印的服务。在业务应用中可以是小票打印、可以是合同打印、可以是凭证打印、可以套打、图片、二维码、主子表等多种单据的打印。随着业务的不断扩展，对于打印不同组织也会有不同的需求，可以通过分级管控解决各级组织的模版打印。而全球化在国际业务中也能够按照不同的语言或者格式展示本地区适合的模版，按照当地的语言格式打印。1.2预览、打印、输出打印模板预览打印支持切换多模板预览打印、指定模板预览打印，使用模板范围分根据分类（单据类型）过滤、根据交易类型过滤、根据组织过滤等等，具体使用哪种方式取决于单据调用打印服务时传递了哪些参数。目前比较常见的有：在单据列表页面触发预览打印，进入预览页可切换选择模板，选择范围是根据分类（单据类型）过滤，例如采购订单列表、销售订单列表等。在单据详情页面切换选择模板，模板选择范围为根据组织orgId过滤，选中一个模板后打印跳入预览打印页，预览打印页无法再切换选择模板，例如采购订单详情页、销售订单详情等。5在单据详情页切换选择模板，模板选择范围为根据当前单据交易类型过滤，选中一个模板后打印跳入预览打印页，预览打印页无法再切换选择模板，例如费控模块的单据。1.2.1预览打印打印模板设计器中设计好之后，就可以在对应单据页面来进行打印查看效果了，目前预览打印支持在单据列表和卡片页面打印两种方式（实际以各单据配置按钮情况为准）。以销售订单为例，在销售订单列表页面，可以勾选1条或多条数据后点【打印】-【打印预览】按钮，见下图：触发后，浏览器会新开一个页签用于显示预览页面，当存在多个可用模板时，左上角会显示模板下拉控件来供切换。进入销售订单详情页，根据orgId过滤显示可以模板的下拉控件，选择一个模板后，点打印进入预览打印页。由于已在详情页选择了指定模板，所以在预览打印页不再有模板下拉选择能力。61.2.2直接打印直接打印指使用打印插件（即云打印助手）进行打印，通常在单据列表页面的直接打印（如销售订单）/快速打印（如凭证查询）按钮触发。使用打印插件打印具备了浏览器端预览打印能力，1、但主要用于解决以下场景：批量打印、静默打印。部分用户于固定时间需要批量打印多条单据，如年底时打印凭证、每天下午五点打印当天的所有发货单，打印时无需再进入预览页，能够精简操作步骤快速发送到打印机，即静默打印。针式打印机清晰度问题解决。新版打印默认生成PDF文件，但针式打印机打印PDF文件存在不清晰情况，打印插件提供原生打印方式发送打印内容以保证打印效果清晰。2、客户端下载安装使用直接打印需客户端安装打印插件，安装使用过程如下：（1）在列表页选择数据点击直接打印/快速打印（2）若本地未安装打印插件，页面会弹出提示框引导下载插件7（3）点击确定，进入下载引导页，根据本地系统选择适配的插件下载，引导页（4）插件下载完成后双击exe文件运行即可（5）若本地已安装过打印，点直接打印时会尝试自动调起程序，在提示框中点【打开运营云打印助手】即可启动插件。（6）进入打印插件界面，选择左侧的模板、打印机等点击【保存设置】后会将本次设置保存到本地，后续直接使用无需再次选择。8（7）点【打印】按钮将文件发送到指定打印机（8）右上角最小化按钮，点击按钮插件界面会最小化到系统托盘。在未勾选“跳过预览”且再次触发直接打印时，插件页面会自动弹出以展示预览效果。（9）最小化后插件会任务栏的系统托盘中，右键点击图标显示【设置】、【退出】按钮。（10）设置：点击后会重新打开插件页面。（11）退出：插件程序安全退出。3、属性设置打印插件中左侧为属性设置，右侧为预览显示区，插件页面功能介绍如下：（1）选择模板：有多个模板可用时，显示模板列表（2）打印机：读取客户端中添加的打印机列表（3）布局：页面布局，支持横向、纵向（4）边距：仅旧版设计器支持预览后添加边距，新版边距需要在设计器中设置（5）纸张尺寸：读取客户端打印机中的纸张尺寸，自定义纸张尺寸详见【如何自定义纸张尺寸】章节9（6）打印设置：支持打印所有页、自定义打印，自定义打印包括打印奇数页（1、3、5……）、打印偶数页（2、4、6……）、指定页数范围打印（打印1到3页则输入1-3，打印第5页则输入5）（7）打印份数：指定打印机中打印几份（8）跳过预览：即静默打印，不勾选时，点击直接打印按钮时，插件中会显示预览效果（如果此时插件最小化状态插件页面会自动弹出显示预览），点击插件的【打印】按钮后发送打印机。勾选后，点击直接打印后会直接发送到打印机（插件最小化时不会自动弹出插件）。（9）pdf打印：不勾选时使用原生打印方式将内容发送打印机，解决针式打印机不清晰问题。勾选后为PDF方式打印，发送PDF文件到打印机，默认不勾选。（10）黑白打印（针式打印机建议勾选）：大多数针式打印机只支持黑白，有用户在设计器中会设置字体颜色为彩色或灰色等，如使用灰色时会导致打印出来文字颜色浅，勾选后会将彩色或灰色置为黑色打印。（11）保存设置：将本次设置保存本地，后续打印直接使用本次设置，无需二次选择。10（12）预览区：显示预览文件内容，多页时可以点击上一页/下一页查看效果。直接/快速打印按钮触发的打印任务均发送到打印插件，各任务在插件中以任务队列顺序存储，执行顺序为先到先执行、后到后执行。只有本次任务发送到打印机后完成或本次任务取消，任务队列中的下一个任务才会执行。（13）取消：取消本次任务，如果队列中有下一个任务则自动执行。（14）打印：发送打印任务到指定打印机，发送完成后如果队列中有下一个任务则自动执行下一个打印任务。1.2.3输出Excel打印预览默认生成PDF文件，除此之外还支持输出为Excel文件，供用户使用或进行再编辑。输出Excel文件后内容样式保持和PDF预览内容样式一致。输出Excel按钮位于预览页右上角。如，模板设计页面11预览效果如下：点击预览页面右上角的【输出】—【Excel】按钮可以输出Excel文件，下图以Chrome浏览器为例，点输出Excel后下载文件效果。Excel内容如下12Excel文件内容生存规则：（1）设计器中每个模板页面生成Excel中的一个sheet。（2）选择多天数据批量打印时，同一个模板页面的内容在Excel的同一个sheet中纵向排列显示。（3）Excel内容布局与PDF内容布局保持一致。（4）Excel中格子或合并的格子宽高均为设计器预览后每个控件占位的大小计算。（5）受Excel本身特性限制而展现的效果若与PDF不一致，属于正常现象不算问题。【输出Excel注意事项】Excel中实际为N*N的格子，不同于PDF可以随意布局甚至支持控件重叠，要输出Excel的模板对设计器内的设计标准要求略高，要求控件间整齐排列，不允许出现控件重叠，否则无法计算单元格合并。如下图，上部分控件未重叠，可以在Excel中计算位置以及单元格合并，但下部分控件出现了重叠，在Excel中无法实现，所以必须保证控件不能出现重叠。为了保证输出效果和预览一致，Excel中内容的输出需要按模板设计来严格计算每个控件的位置及宽高，所以当模板控13件没有完全对齐的时候，会出现有小格子的情况，下图通过彩色线展示每个控件的起始结束位置。如上图，橘蓝绿三色列是由于3406控件右侧边、销售订单控件左侧边、审批人控件左侧边横向X轴位置不一样导致出现，蓝色线是销售订单控件的左侧边线，橘色线是3406控件右侧边线，蓝色是审批人控件左侧边线。如果不希望出现这些小细格子，可以通过调整模板解决，将出现小细格子的控件进行调整对齐。比如，将“审批人”控件往右移（也可以选中“审批人”控件，在控件左侧矩形锚点上拉窄控件宽度）使审批人左边线与“销售订单”左边线对齐，这样就会减少一个小格子。调整后设计态效果14调整后的预览效果：调整后的输出Excel效果：15第2章场景及案例2.1普通单据普通单据模板使用较多，通常布局以卡片+列表组合形式展示。比如凭证打印模板，模板中显示标题、格式规范的单据头、子表明细列表等，设计效果如下，预览效果：2.2套打模板套打模板用于打印纸为套打纸的场景，不同于普通白纸套打纸通常带有文字表格等信息，打印时要求打印的变量信息严格展示在固定的格子区域内，比较常见的套打纸如凭证、快递单。如凭证打印纸，见下图：16设计效果，上传套打底图，使用套打列表控件。带底图预览效果，点击画布上的页面区域，【样式】-开启【打印时显示套打底图】，开关开启功能通常用于调试状态时查看预览效果。17不带底图打印预览效果，关闭【打印时显示套打底图】后效果见下图，真实打印时因打印纸上已带图所以开关需要关闭。2.3合同合同模板特点是一份合同多页，不同页内容不同，常见于人力合同、销售合同场景。合同模板的绘制有使用多个页面模板和同一页面模板中内容顺延两种方式，不同方式适用于不同场景，也可两种方式组合使用。1、使用多个页面模板此方式常用于解决多页内容均不同，且每页内容固定的场景。如人力员工签订合同，共五页，首页封皮，其他页分别为不同条款内容：18设计页面效果，页面模板2一共五个页面模板，其余不再截图，此合同模板预览后效果如下：2、同一页面模板中内容顺延当合同模板内某一页面模板存在列表动态扩展控件来展示明细子表，预览时不同单据的明细条数不同会导致列表动态撑高而产生换页，因不同页面模板之间相互独立，所以会出现换页后和下一页面模板之间出现空白区域。如页面模板1中有列表控件显示商品明细，页面模板2中显示剩余合同条规，设计如下：19当商品明细多条时，预览效果如下，会出现第2页中有空白：因此，此时应该使用一个页面模板，模板内增大设计态高度，使预览时内容顺延，以解决预览页面出现空白问题。设计态高度默认等于纸张高度，当设计态高度大于纸张高度时，只20是改变的设计态页面的高度，真实预览打印时，依然以纸张高度进行分页显示。设计态效果如下：设计态高度为400mm，纸张高度为A4的297mm，使设计时一页中可以放置更多内容，但在预览时以A4的297mm高度自动进行分页渲染打印，内容之间顺序衔接无空白。预览效果如下：2.4小票用于零售场景消费小票定制，小票通常宽度较窄，且常以指定的小票打印机输出。打印模板仅支持小票场景的定制和使21用普通打印机打印小票，对于小票打印机的打印方式需要业务方进行开发。使用mock数据预览2.5标签在资产、制造等领域绘制设备标签，或零售绘制货架上商品标签场景，用于标注显示设备或商品的关键信息，打印出来后常贴在资产设备上或商品货架上。标签类模板通常包含文本及条码（条形码或二维码等用于扫码），且标签纸张大小略小。以资产为例，标签设计页面：22选择两条资产数据，预览如下：2.6二维表销售领域商品属性为动态列，如尺码、颜色等，不同商品动态列数不同，且在设计态无法预知，需要在预览时，根据实际情况动态扩展显示。动态列的列表头最多三行，动态列列表头实际显示行数又业务返回数据及打印模板配置决定。动态列列表头一行效果（红色为动态列列表头）：行数商品编码SMLXLXXLXXXL1AA1234562……动态列列表头两行效果（红色为动态列列表头）：行数商品编码尺码SMLXLXXLXXXL1AA1234562……23动态列列表头三行效果（红色为动态列列表头）：行数商品编码尺码常规码大码SMLXLXXLXXXL1AA1234562……以销售发货单尺码为动态列为例，在打印模板中选中列表“尺码”的列表头，属性页签中打开【是否动态列】开关。销售发货单如下：二维打印时，选择二维模板，点击【二维打印】按钮24预览效果：【动态列表头是否显示】开关用于设置预览时列表头是否显示，开启后，列表头区域显示设计态列表头内容+动态列列表头。关闭后，仅显示动态列的列表头内容。对比效果如下，开启后效果：关闭后效果：2.7M*N矩阵打印在制造领域打印标签时，存在一张纸上排列打印多个场景，矩阵打印支持在设计态自由定义横向、纵向打印个数。以真实纸横向：宽420（84*5）mm高120（60*2）mm为例，需要横向打印5个标签，纵向打印2个标签。操作步骤：选中左侧【层级】页签中的一级节点或者画布的边缘模板区域，在右25侧【属性】页签，输入矩阵打印的横向打印个数、纵向打印个数。矩阵打印个数设置：选中模板内设计区，设置纸张大小。矩阵打印时，设计态纸张大小为最小单元的页面大小。预览效果：262.8自定义纸张打印模板设计器支持自定义纸张大小，此场景下纸张大小通常等于实际纸张大小，需要在打印机配置中添加纸张。步骤：1、控制面板-打印机，添加纸张【注意】纸张定义默认为纵向，宽度要小于高度，填错打印页可能会查不到该纸张。可以参考A4纸的定义来理解，A4纵向：21*29.7(cm)272、在设计器页面设计，使用自定义纸张横向纸张设计效果：纵向纸张设计效果：283、预览横向设计模板的预览效果：纵向设计模板预览效果：294、打印，选择打印机，选择纸张302.9按不同主体循环打印循环主体只按哪个主体进行分页渲染打印，包括当前数据集的主表、子表，默认为主表。对于元数据为主子表场景的模板，通常是按主表进行分页。若需要设置为按某子表分页打印，可将循环主体设为该子表。循环主体位于模板属性页，以销售订单打印模板为例：循环主体不进行设置，或设置为“销售订单”时，按销售订单主表进行分页打印。预览效果：31以销售订单子表进行分页显示时，设置循环主体为“销售订单子表”，设计页面（通常以子表进行分页时，子表在画布中不会以列表控件设置）：预览效果：若画布设置子表列表+循环主体为“销售订单子表”，预览时，则所有销售订单的子表连打，其中前15条数据为一个销售订单的子表明细，最后两条为第二个销售订单的明细。3233第3章常见问题3.1自定义尺寸套打预览正常，发送到打印机后文字位置偏了场景：根据套打纸尺寸定制的套打模板，预览页面效果正常，打印时选择同尺寸纸张，发送到打印机后文字位置发生偏移。如以模板【(新)KPJ103-激光金额记账凭证】为例，使用系统预制的标准模板，纸张尺寸241*140（mm），设计如下：预览效果正常，如下：34打印时选择的纸张大小设置如下：但发送到打印机后，文字位置偏移，效果如下：35原因分析：正常情况下，设计模板尺寸和打印纸张尺寸要相同，这样打印效果才能保证和预览效果一致，同时预制的系统模板都是经过测试验证没有问题。但由于打印机类型及设置等不同，会造成当某些客户打印效果出现如上问题。从上面打印结果可以看出，真实数据偏左、偏上，可以判断打印机打印时起始位置没有在当前纸张的起始位置。解决办法：方案1：标准操作应该是调整打印机中的配置或者纸盒中纸张的放置，这种只能现场调试。方案2：当无法通过方案1来解决时，通过调整模板来解决。比如上面这个，可以通过加大模板纸张大小，并设置边距。调整方式：纸张大小改为宽301，高175。页面左边距设为301-241=60，上边距=175-140=35。（要保证套打纸区域大小不变，241*140是套打纸的宽高，偏移量60、35需要根据打印后效果调整，非统一大小标准）模板页面设置如下：36边距设置如下：打印后效果正常3.2如何自定义纸张尺寸？打印时自定义纸张看不到？原因：控制面板-打印机纸张设置中默认为纵向，纸张宽度<高度，写反的话会导致打印时读不到或者打印结果横纵向颠倒。解决办法：调整纸张设计，添加纸张参考373.3预览正常但打印结果和纸张横纵向颠倒效果：解决办法：（1）首先检查控制面板-打印机纸张定义，宽<高（2）检查模板设计，必须和打印机纸张定义保持一致，比如打印机纸张定义宽13.9cm，高22cm，则打印模板页面纸张必须是横向：宽220mm，高139mm，或纵向：宽139mm，高220mm3.4旧版设计中数据集中没有元数据定义的字段旧版设计器不支持字段名称重复，所以当遇到数据集中找不到字段时，请检查元数据定义，将重复的字段名称区别开来383.5针式打印机打印清晰度提升方法一：打印PDF类型时，针式打印机可以调整打印机首选项配置方法二：使用直接打印插件，不勾选【PDF打印】，此时默认发送打印机内容为指令方式3.6针式打印机横纵向问题打印模板设置纸张240mm*140mm，方向横向，预览时正常，但连接针式打印机打印后方向旋转了90度变成了纵向。39如下图：原因：打印模板设置正常，横向，宽度240mm，高度140mm。但针式打印机遇到宽度大于高度的情况会自动旋转方向，导致打印后方向不对。解决办法：打印模板的画布中设置矩阵打印，如果本例中设置矩阵打印1*2，即纵向为2张，预览后纸张会变为宽度240mm，高度280mm，此时宽度会打印高度，针式打印机不会再进行方向旋转。矩阵打印使用参考【M*N矩阵打印】章节。设置后效果：403.7输出Excel有很多小细格子详见【输出Excel】章节介绍。3.8动态行高时网格/卡片中文本框如何实现垂直居中效果卡片或网格中分多列时，单元格及内部文本框均为动态行高，见下图，文本框样式为垂直居中，当第二列中内容较多动态撑高一行单元格高度时，希望第一列文本框内容实现对单元格的垂直居中效果。第二富文本内容撑高行时，第一列内容实现了文本框内的垂直居中效果，但是没有实现单元格内垂直居中效果。解决办法：将文本框的大小和位置均调整为单元格的大小和位置，当大小和位置值相同时，文本框的样式效果会自动生效到单元格上。如，“部门经理意见”文本框所在单元格X:0.00,Y：159.00，W:29.72,H:9.91。41原始文本框大小位置图，值不同于单元格的，因此样式只会生效到文本框上。将“部门经理意见”文本框的大小及位置调整为和单元格一致，即X:0.00,Y：159.00，W:29.72,H:9.91。预览后“部门经理意见”单元格中垂直居中。单元格垂直居中效果：3.9表单场景，表单中的审批意见控件字段在打印模板中设置样式为什么不生效？表单场景打印模板中申购部门负责人、采购单编号值等字段均设置了仿宋字体。但预览页面采购单编号值是仿宋、申购部门负责人却不是。（其他样式类问题同理）设计页面：42预览页面：原因：表单场景表单的审批意见控件值在返回给打印模板时是以富文本方式返回，对富文本方式约定规则必须严格按照富文本样式显示，打印模板上设置的样式不在生效。解决办法：只能从表单入手。（1）看是否可以更换为其他非富文本样式的控件，这样打印模板上的样式就会生效。（2）或者在表单中设置控件的字体为仿宋3.10表单场景打印审批意见表单场景打印审批意见、审批历史需要在表单中自建，不能使用打印模板中自带的审批历史子表，见下图。打印模板自带的审批历史子表为：printSystemApproveHistory[审批历史]，该审批历史要求审批流的businessKey必须为单据的billno_id格式，符合改要求能够使用自带审批历史的单据有采购订单、销售订单等，像人力模块部分单据、表单场景单据因审批流businessKey不符合格式均不能使用自带printSystemApproveHistory审批历史，只能使用单据自建的审批历史或审批意见。43表单场景中，表单自建的审批历史或审批意见分主表字段和子表两种形式（需要表单上配置实现），拖入主表字段到画布，打印时多条审批意见会合在一起以一个字段的形式展示；审批意见子表则通常结合列表控件使用，显示时以列表多行形式循环展示。如设计器中单独拖主表字段“审批意见”、卡片中选择主表字段“审批意见”、列表中选择子表中的“审批意见”字段。设计效果见下图：44当流程中多个环节时，审批人有多个：预览效果见下图，只有列表控件选择子表字段的方式会以列表形式显示多行：即，如果表单场景希望以列表形式打印审批意见，需要使用打印模板的列表控件并选择子表中的字段才能实现（子表审批意见需要在表单中进行配置才会出现）。453.11图章场景，图章和文字整体移动使用图章场景，通常是底部文字图章盖于文字上方，打印时无论上部分内容多少图章和文字都连在一起打印，如果发生换页，图章和文字也整体换页。设计要点：1、文字使用卡片或者网格，这样能够保持文字部分位置发生变动时保持一致2、图章顶部高度略高于卡片的顶部预览是发生换页的效果：463.12如何设置枚举类型的复选框效果场景：某字段值为枚举类型，如何在打印单据中显示全部枚举值+复选框，且能根据单据的值使复选框为变色选中效果。如：订单状态■审批中□待发货□待收货解决办法：使用iif函数+Word中的复选框符号。有两种效果参考：复选框和文字独立、复选框和文字一体，独立方式可以单独设置复选框或者文字大小或样式等，一体的则只能一起设置样式等。操作步骤：订单状态字段有枚举值：审批中、待发货、待收货复选框和文字独立效果（1）网格的一行中拖入7个文本控件（也可以在画布上复制文本控件），第一个文本控件输入值“订单状态”，第3、5、7个分别输入枚举值审批中、待发货、待收货。47（2）第2、4、6个文本框则输入公式，用于展示复选框第2个文本框用于显示是否为审批中，公式配置为（注意iif中的==为两个=）：status={voucher_order.nextStatus},iif(status=='审批中','■','□')即，当订单状态值为审批中时，“审批中”三个字前的复选框为黑色选中效果，否则为白色未选中效果。其中复选框需要使用Word中的特殊符号，复制粘贴到打印模板的公式编辑区域中，见下图【注意】并非所有特殊符号都能使用，部分特殊符号因字体等原因在打印模板中可能存在无法显示问题，使用特殊符号时请以实际情况为准48同理，第4个文本框用于显示是否是待发货，公式配置为：status={voucher_order.nextStatus},iif(status=='待发货','■','□')第6个文本框用于显示是否是待收货，公式配置为：status={voucher_order.nextStatus},iif(status=='待收货','■','□')（1）分别设置第2、4、6个文本框字号为16pt使复选框变大一些。（2）设置完成，保存复选框和文字一体（1）网格的一行中拖入4个文本控件（也可以在画布上复制文本控件），第一个文本控件输入值“订单状态”。（2）第2、3、4个文本框分别配置公式49第2个文本框用于显示是否为审批中，公式为：status={voucher_order.nextStatus},iif(status=='审批中','■审批中','□审批中')即，当为审批中时，显示■审批中，否则显示□审批中。同理，第3个文本框用于显示是否为待发货，公式为：status={voucher_order.nextStatus},iif(status=='待发货','■待发货','□待发货')第4个文本框用于显示是否为待收货，公式为：status={voucher_order.nextStatus},iif(status=='待收货','■待收货','□待收货')设置完成，保存。最终两种效果的预览对比503.13热敏激光标签打印机打印不清晰.3.14打印计数打印模板支持打印计数能力，分预览打印计数和直接打印计数两种方式。预览打印计数：为模糊计数，预览成功就会计一次数。操作51步骤：点击单据页面的【打印预览】按钮，会在浏览器端新开一个页签进入打印预览页面，预览渲染界面成功后自动计数，若预览失败则不会计数。直接打印计数：为精确计数，点插件上的打印按钮时计一次数。直接打印需要使用打印插件（云打印助手）。操作步骤：点击单据页面的【直接打印】按钮（有的单据页面叫【快速打印】），打印任务发送到插件，在插件端预览显示效果，点击插件端右下角的的【打印】按钮，将文件发送到打印机，此时计一次数。即，使用【直接打印】按钮打印时，点击插件端的打印按钮时才会计数。（若，插件端勾选了“跳过预览”，插件端接收请求后渲染不会进行预览会自动发送到打印机，此时会计数）52
