超简单Python将指定数据插入到docx模板渲染并生成
最近有一个需求，制作劳动合同表，要从excel表格中将每个人的数据导入到docx劳动合同中，重复量很大，因此可以使用python高效解决。为了让模板内容不变动，这里使用了类似jinja2的渲染引擎，使用{{ }}插值表达式把数据插入进去。也可以使用{% %}循环，条件语法等。
docx模板如下(在需要插值的位置填充 {{}} 表达式)：
首先安装docxtpl$ pip install docxtpl
python代码如下：from docxtpl import DocxTemplate
tpl = DocxTemplate('劳动合同.docx')
#这些字段从csv中获取
context = {
"name": name,
"department": department,
"position": position,
"time": time,
"id": id_card,
"addr": addr,
}
tpl.render(context)
tpl.save("{}的劳动合同.docx".format(name))
运行后就可以在docx中看到效果，{{ field }}这里已经被context里面的字段替换了，非常简单！

一、xdocReport支持的报告模板有三种：Docx格式，PPTX格式，ODT格式。

二、重点讲如何用FreeMaker语法设计docx的文档报告模板）：

 虽然可以采用word宏来定义变量设计文档报告模板，但我个人不建议，因为无法做一些高级功能（例如条件，复杂循环等）。

XdocReport提供一个XDocReport的工具，适用于采用word宏的定义法。

1.这里建议用word本身的"设计"类别上打开“字段对话框与字段”按纽，去设计文档报告模板，必须Mergefield来设置脚本（不能手工敲入，因为word会对打字内容进行编码），如下所示：

插入字段：



 

2. 在表中插处字段列表：

如果您希望从Java列表生成表，则必须使用FieldsMetadata将fiels名称标记为“list”（有关详细信息，请参阅此处。这里developers.Mail标记为列表，因此您可以直接在表中插入developers.Mail 单元格就像我们在下面做的简单字段（插入字段部分）。



3.段落中插入字段列表：将添加3个合并域（开如循环+体循环+结束循环）。

 



4.可以用json模拟数据和XdocReport工具来的预览模板最终的生成效果。

5.高级应用，循环表格行中的字段与模板引擎脚本。

6.条件支持：

#if（对于Velocity。
	
[ #if for Freemarker。
7.word中插入动态图片

8.word的页眉与页脚设置变量

 

 

三、web app如何应用XdocReport上下文java api：

 

Hello，今天向大家简单介绍一下如何使用word制作出漂亮的表格！
一、创建“DOCX”文档；
二、准备一张漂亮的背景图片，然后如下图所示：点击“页面布局”选择“背景”，在弹出的窗口中点击“图片”后，继续点击“选择图片”，然后选取我们提前准备好的背景图，如此便可将之置入文档。
三、背景图搞定后，接下来我们要插入表格，如下图所示：首先选择“插入”，再选择“表格”一项，插入表格。(表格行列数随意，稍后我们还会对其进行调整^_^)
四、表格初始边框颜色为黑色，且无填充色，为了让大家看得清楚一些，我将表格边框加粗，且增加了填充色，正好也可与大家一起分享一下如何修改表格边框与填充色。
如下图所示：首先选择“表格工具”，再点击下图“2”处的“表格属性”(也可直接在表格中单击右键选择)，如此便会弹出一个属性窗口，接下来我们点击进入“边框和底纹”。
进入“边框和底纹”后，有三个选择项：“边框、页面边框、底纹”(sorry，图中又忘记给大家标注了 ^_^)，我们首先选择"边框"选项，界面如下：其作用就是修改表格边框的“线型”、“颜色”还有“宽度”。
调整好表格边框后，我们再点击“底纹”选项，界面如下：此处我们可以修改表格的底纹(即填充色)
五、调整过表格的边框与底纹以后，我再顺便介绍一下现有表格的行列添加或删减。
如下图所示：凡有“+”标识的小按钮都是起添加作用，反之“-”则有删减作用。我们可根据实际所需的行列数量，单击“+”或“-”按钮，便可增减行列。
六、表格框架制作好后，我们便可进行文字输入。
下图所示：我以KTV会员价目表为例，输入了相应内容。
此段仅供新手参考，高手请忽略，^_^
在输入大标题时，我们可将整行表格框选(如下图所示，框选处颜色会有加深效果)，框选表格后单击右键，则会弹出“合并单元格”选项，点击“合并单元格”，被框选的表格便会进行合并，即由N个小格变为一个大格。
七、文字输入完成以后呢，我们会发现还是有许多用不到的表格，此时，方才所讲的合并单元格的操作就起作用了！
 我们可以将多余的无用表格与相临的有用表格进行合并，合并后的效果请见下图3处。(除了采用合并单元格的方式，我们还可以点击“表格工具”，选择“擦除”功能键，像橡皮擦一样把不需要的线条给它擦掉。)
另：如果我们的表格需要添加“斜线”分割时，我们可以选中要添加斜线的表格，继而如下图所示：点击“表格样式”，选择“绘制斜线表头”，挑选一款斜线样式，点击“确定”即可。
表格彻底调整完成以后，我们就可以对内容进行精修啦。
下图便是我简单将行列布局，文字的大小、字体与居中调整后的一个效果展示！喜欢的朋友就请给个赞吧！或是哪里不明白的朋友也可在评论留言，我必知无不言~
此号将会持续发布诸多关于WPS的小技巧，喜欢的朋友请点击关注，感谢啦！^_^

关于如何使用freemarker制作word模板并填充数据，然后使用spire导出自己想要的格式（svg、pdf、word）


首先你需要一份word文档（.docx），然后将需要替换的地方用${xxx}进行替换。例如下面这样




第二步，将自己做的模板另存为.xml。




用编译器打开（建议使用vscode）。打开之后是这种样式，很乱。建议将全文复制，到  https://tool.oschina.net/codeformat/xml 这个网址进行格式化




如果出现如下图这种情况，去掉上面的一整个<w:tr>即可




如果你有循环，（比如表格）你需要freemarker的一些循环语法，



上图中，<#list xskcList as t1> 就是将xskcList这个集合进行循环，变量是t1，里面的map集合可用${t1.xxx}取出（记住，所有的集合都应该是List<Map<String,Object>>这种类型）


修改好了之后，再直接将文件后缀改成.ftl


好了，至此我们的模板创建成功，开始准备数据


这里我们制作一个以xsxm为数据的例子，其他都是一样的。(注意如果一个值为空，也必须注入一个向map集合中注入这个key-value。不然会报错)



Map<String,Object> xsJbxx = new HashMap<String, Object>();

if(StrUtil.isNotBlank(curriculum.getXm())) {

xsJbxx.put(“xsxm”,curriculum.getXm());

}else {

xsJbxx.put(“xsxm”," ");

}

	OutputStreamWriter write = null;
	Configuration configuration = new Configuration();
	configuration.setDefaultEncoding("UTF-8"); // 设置编码
	configuration.setClassForTemplateLoading(this.getClass(), "/");
	//将你的模板放在resources目录下，这样就是读取到了你的模板
	Template temp = configuration.getTemplate("ytjzwcjd.ftl");		
	ByteArrayOutputStream bs = new ByteArrayOutputStream();
	write = new OutputStreamWriter(bs);
	//这个xsJbxx就是我们的map.写入OutputStreamWriter
	temp.process(xsJbxx, write); 
	write.close();

10 模板对应的位置

11.
Document doc = new Document();
ByteArrayInputStream buffer = new ByteArrayInputStream(bs.toByteArray());
doc.loadFromStream(buffer, FileFormat.Word_Xml);
//转换成svg，会在d盘下生成1一个1.svg文件
doc.saveToSVG("D:\\1.svg");
//转换成pdf
doc.saveToFile("D:\\1.svg", FileFormat.PDF);
//如果你想生成一个io流 spire也是支持的。
ByteArrayOutputStream byteos = new ByteArrayOutputStream();
doc.saveToStream(byteos, FileFormat.PDF);

总结：我们使用freemarker，spire，将制作的模板生成文件，目前来看比较兼容，在模板里加入二维码，水印也是可以的。好了，这篇文章就说到这里，有问题可以私信我奥。

下期见！