跳到主要内容

Word/Excel打印模板中选项、图片和关联记录设计细则

在如何制作Word/Excel打印模板中，我们学会一般的打印方法，本文再进一步介绍打印时的解析规则细节。

1、单选、多选字段打印未选中选项​

平铺类型的单选和多选字段如需打印未选中的选项，可在字段代码的内结尾处填写“_Alloptions”，例如：#{单选_Alloptions}。默认是横向平铺打印，如果需要竖向打印，结尾处继续添加[V]标记，如#{单选_Alloptions[V]}

例如一个保密级别字段，有秘密、机密、绝密三个选项，记录中选择了“机密”，打印时如果需要打印另外两个选项，则字段代码为#{保密级别_Alloptions}, 如果还需要竖向平铺打印，字段代码为#{保密级别_Alloptions[V]}

2、图片的打印规则​

2.1图片的宽度和高度设置​

本记录中的图片支持打印，图片支持设定宽度和高度。如下图中的附件字段代码 #{附件$[90*auto]$} 中，[90auto]表示的是[宽度高度]。

图片的尺寸有4种配置方式：

  • 宽度固定、高度自适应 ：#{附件$[90*auto]$}

    表示图片的宽度固定90，高度自适应。90是默认数字，可以自定义。

  • 宽度自适应、高度固定 ：#{附件$[auto*80]$}

    表示图片的宽度自适应，高度固定80，数字可以自定义。

  • 宽度固定、高度固定 ：#{附件$[70*90]$}

    表示图片的宽度固定为70,高度固定为90， 数字可以自定义。

  • 固定范围内宽和高自适应 ：#{附件$[45*90_auto]$}

    表示图片在45*90的范围内宽高自适应显示，数字可以自定义。

高度和宽度不支持完全自适应，例如不支持这样的设置 #{附件$[auto*auto]$}。

2.2图片的质量设置​

为了满足不同场景对图片清晰度的要求，模板中的图片支持解析为低、中、高三种图片质量。

  • 低（L）——对应图片分辨率75，按照X3的倍数取图片的宽和高；生成速度快，用于一般打印。

  • 中（M）——对应图片分辨率150，按照X6的倍数取图片的宽和高；生成速度适中，打印较清晰。

  • 高（H）——对应图片分辨率300，按照X12的倍数取图片的宽和高；生成速度慢，用于高质量彩色打印。

字段代码示例：

#{附件$[auto*90_M]$}、#{附件$[auto*90_H]$}、#{附件$[45*90_auto_H]$}

  • 1、不添加图片质量标签，表示默认按照低质量的方式解析图片

  • 2、为了保证解析的图片不会比原图大，故需要将转换后的图片尺寸与原图做对比，若转换后的图片比原图大，则返回原图

2.3打印图片名称​

附件字段的默认代码中不包含文件名，需要同时打印名称时可拼接_name。支持仅打印图片名称或同时打印图片和名称。

  • 同时打印图片缩略图和文件名

    示例代码： #{附件字段代码$[90*auto_L]$_name}

  • 只获取文件名

    示例代码：#{附件字段代码_name}

示例和效果：

提示

  1. Excel模版不支持图片与文件名同时显示

  2. 文档类型仅支持打印文件名称，不支持打印内容

3、字段的二维码条形码打印​

可通过代码获取任意字段的二维码或条形码，字段代码如下:

  • 二维码：#{[qrcode]字段名$[20*20]$}

  • 条形码：#{[barcode]字段名$[40*10]$}

代码中，字段名可以使用字段ID，图片大小的数字可以调整，其他内容和符号不能更改。

二维码编码方式：QR-code，最大包含150个字（支持汉字）；条形码编码方式：code128，最大包含30个字符（仅支持数字、字母、符号）。

代码示例和效果：

几个系统字段的字段ID

  • 公开分享链接: sharelink
  • 内部访问链接：privatelink
  • 记录ID：recordid

4、子表和关联表（多条）的几种打印方式​

方式1、显示方式为列表时​

明细表中的序号​

如果打印关联表/子表时需要显示行序号，可以使用序号的专有代码sequencenumber。

其格式为：#{明细字段名称.sequencenumber}或#{明细字段代码.sequencenumber}

模板设计示范：

打印效果：

合并相同单元格​

当同列的上下单元格内容相同时，可以合并单元格。

合并上下单元格的字段代码写法：

#{子表名.字段名[M]}

只需在原字段代码的字段名和大括号之间写个[M]即可。

如下图：

效果：

以下情况不会合并单元格

单价列设置了可合并，上下单元格都是2000，并没有全部合并。这是因为前一列（SKU）也是设置了合并列，如果前一列(sku列)值不同没有合并，当前列（单价列）也不合并。

方式2、逐条打印​

如果需要将关联记录（列表）或子表中每一条记录作为一个整体依次逐条打印，既每一行记录打印时都能显示字段标题，则可在表格上一行和下一行插入以下代码：

#Relation.Repeat[start]#

#Relation.Repeat[end]#

代码之间的所有内容每条记录都会复制一份，并填充对应数据，所以可以是多行多列排版格式

代码不能和其他内容放在一个单元格中，需单独一行。

例如：采购单中，将每一条采购明细单独打印。

打印范例:

格式1比较常见的场景是工资条打印。

模板范例:

TIPS：

如果每条记录之间需要空一行，模板中也空一行并设置为无边框。

方式3、拼接打印​

此方式会将同一个字段的所有值拼接在一起，用逗号隔开。

模板范例:

只需要在字段代码的最后一个大括号前加上 [S]即可识别。 英文的[],大写的S。

方式4、填充打印​

例如，子表中有10行记录，如果您只打印明细表中的指定行的记录，则可以通过此方法打印。

如下图示范代码，只需在表名后面添加序号即可，下面代码表示只打印前两行记录内容。

模板范例:

效果：

子表或关联表为空时不打印​

如需不打印没有数据的关联表/子表，请将代码两个代码标签：#NoDataNotPrint[start]# 和 #NoDataNotPrint[end]# 插入到模板中，代码之间的关联记录/子表没有数据则不会打印,如下图配置:

当关联表有数据时：

当关联表无数据时：

注意

如果无数据的开始标签和结束标签之间有多个子表/关联表，只要有一个子表/关联表有数据，无数据的子表/关联表也会打印。

因此建议一个子表/关联表单独配置一组标签。并且，不同子表/明细表不能放在一个大表格中，都要独立配置一个表格。

5、成员字段打印手机号邮箱​

打印成员字段内容时，除了打印姓名，还可以打印此账户三个信息：工号（代码 _ID ）、邮箱(代码 _Email )和手机号(代码 _Phone ),只需将代码按格式插入到成员字段代码中。

代码格式为：#{[member]成员字段ID$[账号信息代码]$}，其中成员字段ID和账号信息代码是变量，在$[]$的[]内可以插入工号、邮箱、手机号的代码，也可以使用其他字符拼接信息。

举例：负责人（成员字段）,选择了Jeff，其工号为101，邮箱Jeff@md.com。

  • 仅打印姓名时：#{负责人}，打印结果：Jeff

  • 打印姓名+工号:#{[member]负责人$[_ID]$} ，打印结果：Jeff101

  • 打印姓名、工号和邮箱:#{[member]负责人$[(_ID;_Email)]$}，打印结果：Jeff（101;Jeff@md.com）

    在账户信息代码中，使用了（）表示了账号扩展信息的内容，使用；对工号和邮箱进行间隔。

6、日期时间打印格式​

日期时间字段打印时默认按yyyy-MM-dd HH:mm:ss（2025-01-01 12:00:00） 格式打印，可在字段代码后拼接格式代码来自定义打印时的方式。

代码格式为：#{日期时间字段ID$[自定义格式规则]$}，其中日期时间字段ID是变量，在$[]$的[]内插入自定义格式

  • #{ctime}， 打印结果：2025-01-01 12:00:00。

  • #{ctime$[yyyy/M/d]$}，打印结果：2025/1/1。

  • #{ctime$[yyyy/M/d HH:mm]$}，打印结果：2025/1/1 12:00 。

点此查看日期字段的自定义规则

7、打印时间和打印人​

除了打印记录中的字段数据，有时显示打印时间、打印人、记录的二维码、条形码、创建时间、修改时间等信息。只需将其对应的字段代码/字段别名粘贴到模板中的相应位置，即可自动填充数据。

8、批量打印​

批量打印的常见问题，点此查看