根据NVeloDocx Word模板引擎生成Word(二)

ops/2024/11/15 6:09:02/

前面讲到了根据“永久免费开放的E6低代码开发平台”的NVeloDocx Word模版引擎生成Word文件的基础取数方法,包括取本表单字段以及引用字段,详见《根据NVeloDocx Word模板引擎生成Word(一)》。

针对这种基本的取数方法,有朋友认为还不如用Word的“书签”,其实如果仅仅只是本表单的字段,不涉及子表、图片、图表等等,书签确实是可行的,也有人这么干!但是哪怕VB年代,我们也做过类似的,只不过用的是#TagName#这样的方式在Word中进行查找替换。

但是当涉及到子表、涉及到循环、条件判断等等的时候,发现书签#TagName#这种方式都不是很好,当然约定一些特殊的书签名称或者TagName用于表示子表,循环,条件貌似也没有问题,但是引入了特殊的标记,易用性和扩展性上就大打折扣。

进入正题:

怎么基于NVeloDocx实现填充Word中的表格呢?比如我们要填充客户联系人表格,希望每个联系人一个表格,多个联系人则显示多个表格,先来一张图:

基于NVeloDocx填充子表

由上图可以看到,要填充子表首先需要获得子表数据,我们使用下面的语法获得子表数据,语法基于NVelocity,只不过我们的data数据对象中提供了GetChild方法,可以获得子表数据对象,参数“CustomerContact”表示子表“客户联系人”编号(在E6开发平台中,每个表单都有一个唯一的自定义编号

#set($child=${data.GetChild("CustomerContact")})

得到子表后,就可以使用NVelocity语法遍历填充表格了,上面得到的子表数据对象赋值给了NVelocity变量$child,这是一个可遍历对象,所以可以用#foreach进行遍历:

#foreach($item in ${child})

......

#end

剩下的就是取子表字段填充表格了,比如要填充联系人名,则使用NVelocity语法如下:

${child.GetValue($item,"__Name__")}

子表对象$child和主表对象$data一样,可以通过GetValue取某个字段的值,区别在于子表对象由于有多行,所以需要加一个#foreach循环因子参数$item(主表对象的取值其实也是类似的,由于主表只有一条,那么可以这么取值:${data.GetValue("__Name__")}或者${data.GetValue(0, "__Name__")},所以主表子表的取值方式是一致的)。

由于NVeloDocx基于NVelocity,所以整个语法很简单易学。设计好模版后发布测试效果如下:

效果

那如果不是每条子表记录一个表格,而是所有子表记录输入成一个表格怎么做呢?如下图所示,在下图中,我们做了一些技巧上的处理(这个处理比很多其他的子表循环输出的处理方式易用了很多,且不需要特殊的标记):

在表格正文行前后分别增加一行并且合并所有单元格后,用于填写#foreach#end命令,中间行就是正文即可,非常易于理解的处理方式,用这种方式进行处理,还可以有#if条件判断命令等等。

子表数据输出在同一个表格中

生成的Word文档效果如下:

 效果

基于#foreach循环,我们也可以不把子表数据输出到表格,而是直接输出到文本列表,比如下面这样的:

编辑好模版格式:

然后生成后效果如下: 

  

通过这两个例子我们可以看到,基于NVeloDocx,我们不仅仅可以直接在Word中编辑模版(可视化编辑),还可以很好地保留了文档的格式,比如上图,我们模版中设置了列表、粗体、红色等等,生成Word后都很好地保留了这些格式。

如果您正在使用E6,也需要输入Word报告或者文档,那么相信您看完这两篇文章后已经可以上手了。下一篇我们将介绍图表。

 


http://www.ppmy.cn/ops/108113.html

相关文章

深入理解 Milvus:新一代向量数据库的基础技术与实战指南

一、什么是 Milvus? Milvus 是一个开源的向量数据库,专门设计用于存储和检索大规模的高维向量数据。无论是图像、视频、音频还是文本,通过将这些数据转换为向量,Milvus 都能通过近似最近邻搜索(Approximate Nearest N…

数据填充-随机森林填充

文章目录 一、简介2.随机森林的主要特点 二、代码应用1.数据预处理2.数据集填充3.rm_test_fill 函数 三、总结 一、简介 随机森林(Random Forest)是一种集成学习方法,它通过构建多个决策树并将它们的预测结果进行汇总来做出最终的预测。结合…

Redis Sentinel(哨兵)详解

目录 一:什么是Sentinel(哨兵) 二:Sentinel有什么用 1.监控 2.故障转移 3通知 4.配置提供 三:Sentinel如何检测master节点宕机 1.主观下线 2.客观下线 四:Sentinel是如何选举出新的master 1.s…

计算机网络--第六章应用层

应用层概述 虚拟终端可以使个人计算机的用户直接使用他人的个人计算机来和大型计算机进行联系而不必使用一些专门的终端,从而方便地使用大型计算机的一些功能 一、网络应用模型 ①客户/服务器模型(Client/Server) 有一个总是打开的服务器&am…

报表生成---JFreeChart

JFreeChart 是一个开源的 Java 图表库,它提供了丰富的图表类型和灵活的定制选项,用于在 Java 应用程序中生成和显示图表。以下是 JFreeChart 的一些关键特点和功能: 多种图表类型:JFreeChart 支持多种图表类型,包括但不…

在亚马逊云科技上利用Agent和生成式AI写小说(上篇)

今天小李哥将介绍亚马逊推出的国际前沿人工智能AI大模型平台Amazon Bedrock上的Agent的功能。我们将利用Agent结合代码应用工作流服务Step Functions创建链式提示词(Prompt Chaining),通过提示词调用Amazon Bedrock上AI大模型写一篇小说。其中…

动态规划---打家劫舍

题目: 你是一个专业的小偷,计划偷窃沿街的房屋。每间房内都藏有一定的现金,影响你偷窃的唯一制约因素就是相邻的房屋装有相互连通的防盗系统,如果两间相邻的房屋在同一晚上被小偷闯入,系统会自动报警。 给定一个代表…

防封!数字人直播防封!铭顺科技AI数智人抖音直播防封落地方案!!

数字人直播防不防封? 数字人直播有没有流量? 数字人直播能不能落地? 这是目前所有想入局AI数字人赛道、想用数字人直播、想做数字人项目的老板们最担心、最关心的问题!但是,同行友商对此都噤若寒蝉,不敢跟…