CN111950247A

CN111950247A - 一种基于配置的Word文档生成方法

Info

Publication number: CN111950247A
Application number: CN202010650612.0A
Authority: CN
Inventors: 王海滨; 王启孟; 何龙
Original assignee: Beijing Mininglamp Software System Co ltd
Current assignee: Beijing Mininglamp Software System Co ltd
Priority date: 2020-07-08
Filing date: 2020-07-08
Publication date: 2020-11-17

Abstract

本发明提出一种基于配置的Word文档生成方法，包括：建立Word模板文档步骤；定位目标对象步骤，解压缩所述Word模板文档，并提取所述Word模板文档的XML文件以定位待操作的XML目标对象；建立配置文件步骤，所述配置文件用于标记所述目标对象、替换类型及其替换内容；生成Word文档步骤，根据配置文件对文档中的目标对象进行替换操作后生成配置后的Word文档，所述替换操作还包括：循环替换操作、条件替换操作。采用上述方案的Word文档生成方法，实现对Word文档中内容、图片文件的替换、循环替换及条件替换，保证文档结构和样式不被篡改，提高格式文档生成效率。

Description

一种基于配置的Word文档生成方法

技术领域

本发明属于文档处理技术领域，尤其涉及一种基于配置的Word文档生成方法。

背景技术

Word文档是现有的一些office***，Word2007之后大家都使用*.docx，*.docx是基于新的XML压缩文件格式，其解压后，在word下的文件夹或XML文件中保存word文档的主要内容。

在政府或企业***内部中，由于法制检查的要求常常需要将文档打印出来，找到相关负责人签字和盖章，有时需要重新扫描留存。

现有技术中，常常通过POI、jacob、java2word等技术手段操作word文档，通过在word文档里直接添加${name}格式的显式参数来填充数据实现文档修改，但如此一来，整个word模板会不纯净，而且该显式参数万一被篡改，会导致填充数据功能不可用；同时这样的操作方式对存在循环和条件需求的操作支持较少。

发明内容

为解决上述的技术问题，本发明提出一种基于配置的Word文档生成方法，实现Word文档中内容、图片文件的替换、循环替换及条件替换，保证文档结构和样式不被篡改，提高格式文档生成效率。

本发明公开了一种基于配置的Word文档生成方法，包括：

建立Word模板文档步骤S1，根据所需格式文档建立一Word模板文档；

定位目标对象步骤S2，解压缩所述Word模板文档，并提取所述Word模板文档的XML文件以定位待操作的XML目标对象；

建立配置文件步骤S3，所述配置文件用于标记所述目标对象、替换类型及其替换内容，以保证文档结构和样式不被篡改；

生成Word文档步骤S4，根据配置文件对文档中的目标对象进行替换操作后生成配置后的Word文档，为了实现对Word文档中的段落内容根据条件进行替换或对文档中表格的多行数据需要循环操作的对象进行多次替换，所述替换操作还包括：循环替换操作、条件替换操作。

进一步，所述目标对象为目标文件或目标节点，具体的，为所述目标对象的节点路径或文件名，所述目标文件包括但不限于图片文件，所述目标节点包括但不限于文本内容节点、表格节点，所述替换内容包括变量名表达式；。

进一步，所述生成Word文档步骤进一步包括：

替换目标文件步骤，解析所述配置文件获取目标文件对应变量名表达式，并获取配置参数中对应变量名的值以替换所述变量名表达式，得到配置后的XML文件；

替换目标节点步骤，解析所述配置文件的目标节点及对应变量名表达式后，通过将所述目标节点替换为变量名表达式生成一Freemarker模板，同时获取配置参数中对应变量名的值，经过Freemarker渲染后得到配置后的XML文件；

Word文档生成步骤，获取配置后的XML文件，并将配置后的XML文件通过压缩方式生成配置后的Word文档，

其中，采用对于替换目标节点步骤的情况，通过生成Freemarker模板将Word模板化，可以通过Freemarker模板将文档内的动态内容，即所述目标节点，用变量名表达式代替，用配置参数替换变量名表达式即可完成文档的生成，减少文档操作耗时，相较于直接在Word中添加变量名表达式，降低出错率。

进一步，所述循环替换操作通过***循环标签<#list></#list>包围所述目标节点实现循环替换。

进一步，所述条件替换操作通过***条件标签<#if></#if>包围所述目标节点实现条件替换。

进一步，所述替换类型进一步包括：内容替换、文件替换、条件替换、循环替换其一或其任意组合。

进一步，所述定位目标对象步骤通过一XML文件编辑软件定位所述目标对象。

进一步，所述XML文件编辑软件为XMLQuire。

进一步，所述配置文件通过一Excel表格存储。

进一步，所述配置参数的数据结构为JSON类型。

与现有技术相比，本发明的优点和积极效果在于：

本发明的Word文档生成方法可以支持循环、条件语句，适用于多种应用场景，有效提高格式文档的生成效率；

本发明将固定模板文件结合配置参数和收集到的签名和公章文件即可生成所需要的的文档，直接打印即可，节省人工成本，提高工作效率。

附图说明

为了更清楚地说明本发明实施例中的技术方案，下面将对实施例中所需要使用的附图作简单地介绍，显而易见地，下面描述中的附图仅仅是本发明的一些实施例，对于本领域普通技术人员来讲，在不付出创造性劳动性的前提下，还可以根据这些附图获得其他的附图。

图1为本发明实施例的Word文档生成方法的流程示意图；

图2为本发明实施例Word模板文档解压后的结构示意图；

图3为本发明实施例配置文件优选实施方式示意图。

具体实施方式

下面将结合本发明实施例中的附图，对本发明实施例中的技术方案进行清楚、完整的描述，显然，所描述的实施例仅仅是本发明一部分的实施例，而不是全部的实施例。

图1为本发明实施例的Word文档生成方法的流程示意图，参考图1所示，本发明实施例公开了一种基于配置的Word文档生成方法，包括：

定位目标对象步骤S2，解压缩Word模板文档，并提取Word模板文档的XML文件以定位目标对象定位待操作的XML目标对象；

建立配置文件步骤S3，配置文件用于标记目标对象、替换类型及其替换内容，利用Excel表格进行存储，其中，目标对象为目标文件或目标节点，所述目标文件包括但不限于图片文件，所述目标节点包括但不限于文本内容节点、表格节点，具体的，通过获取目标节点的节点路径或文件名得到该目标对象，替换内容包括变量名表达式，替换类型包括内容替换、文件替换、条件替换、循环替换其一或其任意组合，在应用过程中，可根据格式文档需求选择替换类型；

生成Word文档步骤S4，根据配置文件对文档中的目标对象进行替换操作后生成配置后的Word文档，为了实现对Word文档中的内容根据条件进行替换或对文档中需要循环操作的对象进行多次替换，替换操作还包括：循环替换操作、条件替换操作，循环替换操作通过***循环标签<#list></#list>包围目标节点实现；条件替换操作通过***条件标签<#if></#if>包围目标节点。

其中，生成Word文档步骤S4进一步包括：

替换目标文件步骤S41，解析配置文件获取目标文件对应变量名表达式，并获取配置参数中对应变量名的值以替换变量名表达式，得到配置后的XML文件；

替换目标节点步骤S42，解析配置文件的目标节点及对应变量名表达式后，通过将目标节点替换为变量名表达式生成一Freemarker模板，同时获取配置参数中对应变量名的值，经过Freemarker渲染后得到配置后的XML文件；

Word文档生成步骤S43，获取配置后的XML文件，并将配置后的XML文件通过压缩方式生成配置后的Word文档。

举一例说明本实施例的Word文档生成方法。

建立Word模板文档步骤S1，根据所需格式文档建立一Word模板文档，该Word模板文档的格式为docx；

定位目标对象步骤S2，参考图2所示的Word模板文档解压后的结构示意图可知，解压缩docx文档后其Word文件目录下，media文件夹用于存放文档内的图片等文件，document.xml文件存放Word主要内容，若待操作的XML目标对象为图片可通过路径定位，若待操作XML对象为document.xml的内容，则通过XMLQuire搜索内容进行定位，得到目标对象的路径表达式；

建立配置文件步骤S3，参考图3所示的配置文件示意图一实施方式，其中，目标对象的列用于存放路径表达式，路径表达式为document..xml中的XPath或Word文件夹下图片文件的存储路径，替换类型为内容替换CONTENT、循环替换WRAP_LOOP、条件替换WRAP_IF或图片替换MEDIA，替换内容根据目标对象不同分别规定，内容替换或图片替换类型的替换内容采用变量名表达式${变量名}，如${user.username}、${user.image}，条件替换类型或循环替换类型的替换内容为对应标签语句；

生成Word文档步骤S4，程序解析配置文件，执行配置文件中目标对象对应的替换操作：

替换目标文件步骤S41，主要用于对图片文件的替换，通过程序解析配置文件获取目标文件对应变量名表达式，如${user.image}，并获取配置参数中对应变量名的值以替换变量名表达式，得到配置后的XML文件；

替换目标节点步骤S42，主要用于对Word文档document.xml文件中内容的替换，首先解析配置文件的目标节点及对应变量名表达式后，通过将目标节点替换为变量名表达式生成一Freemarker模板：同时获取配置参数中对应变量名的值，经过Freemarker渲染后结合对应数据即可生成配置后的XML文件；

步骤S42中，对于内容替换CONTENT类型，将XPATH下的内容替换为${user.username}、${user.image}更新至XML文件内容对应的节点，如“/w:document/w:body/w:tbl/w:tr[2]/w:tc[2]”，对于条件内容条件替换，用<#if></#if>包围该内容所在的节点，如“/w:document/w:body/w:tbl/w:tr[2]/w:tc[2]”，对于列表需要循环替换，用<#list></#list>包围所需要替换的节点，如/w:document/w:body/w:tbl/w:tr[2]，值得注意的是，在***标签时，可先***注释标签<！---->，如通过下述语句：<！--<#list userListas user>-->将循环替换标签进行注释，只需在freemarker渲染前删掉该注释标签即可，通过注释标签保护XML文件，以免编辑过程破坏XML语法结构。

本实施例的配置参数的数据结构为JSON类型，举例如下：

以上所述，仅是本发明的较佳实施例而已，并非是对本发明作其它形式的限制，任何熟悉本专业的技术人员可能利用上述揭示的技术内容加以变更或改型为等同变化的等效实施例应用于其它领域，但是凡是未脱离本发明技术方案内容，依据本发明的技术实质对以上实施例所作的任何简单修改、等同变化与改型，仍属于本发明技术方案的保护范围。

Claims

1.一种基于配置的Word文档生成方法，其特征在于，包括：

建立Word模板文档步骤，根据所需格式文档建立一Word模板文档；

定位目标对象步骤，解压缩所述Word模板文档，并提取所述Word模板文档的XML文件以定位待操作的XML目标对象；

建立配置文件步骤，所述配置文件用于标记所述目标对象、替换类型及其替换内容；

生成Word文档步骤，根据所述配置文件对文档中的目标对象进行替换操作后生成配置后的Word文档，所述替换操作还包括：循环替换操作、条件替换操作。

2.如权利要求1所述的基于配置的Word文档生成方法，其特征在于，所述目标对象为目标文件或目标节点，所述替换内容包括变量名表达式。

3.如权利要求2所述的基于配置的Word文档生成方法，其特征在于，所述生成Word文档步骤进一步包括：

Word文档生成步骤，获取配置后的XML文件，并将配置后的XML文件通过压缩方式生成配置后的Word文档。

4.如权利要求1或3所述的基于配置的Word文档生成方法，其特征在于，所述循环替换操作通过***循环标签<#list></#list>包围所述目标节点实现循环替换。

5.如权利要求4所述的基于配置的Word文档生成方法，其特征在于，所述条件替换操作通过***条件标签<#if></#if>包围所述目标节点实现条件替换。

6.如权利要求5所述的基于配置的Word文档生成方法，其特征在于，所述替换类型进一步包括：内容替换、文件替换、条件替换、循环替换其一或其任意组合。

7.如权利要求6所述的基于配置的Word文档生成方法，其特征在于，所述定位目标对象步骤通过一XML文件编辑软件定位所述目标对象。

8.如权利要求7所述的基于配置的Word文档生成方法，其特征在于，所述XML文件编辑软件为XMLQuire。

9.如权利要求1中任一项所述的基于配置的Word文档生成方法，其特征在于，所述配置文件通过一Excel表格存储。

10.如权利要求3所述的基于配置的Word文档生成方法，其特征在于，所述配置参数的数据结构为JSON类型。