当需要把表单输出到word文档时，需要提供一个模板， 模板中通过一些占位符来定义动态数据。当输出时，占位符被实际的数据替换，并生成一个新的文件供下载。

下面是一个模板示例 ：

占位符定义

         占位符，就是用来占住一个位置，并表示需要用某个数据来替换的符号，它可以是如下形式

• ${字段名} ： 对于一个模板中的主表字段，直接使用此格式即可，不需要指定表的名称 ， 比如上图示例中的 ${sqr} 就表示用主表的 sqr 字段的数据填充
  
  
• ${表.字段} : 对于非主表的单行数据源字段，需要指定表的名称 ， 比如 ${table1.col1}
  
  
• ${表.字段.行号} : 对于多行数据源字段，还需要指明行号，比如 ${query_1.content.1} 表示query_1中的字段 content的第一行数据。 注意；这里行号从1开始计
  
  
• ${别名} : 对于没有绑定数据库的表单上的数据，可以用别名来指定 。不能用单元格名
  
  
• ${别名.行号} : 对于没有绑定数据源的多行数据（通常是带公式计算的单元格），可以通过行号来指明是第几行数据

有100或更多行的数据要输出怎么办？

        对于明细数据，需要指定行号，如果行数很多，那么定义是比较繁琐的，所以通常在数据较少时，且需要格式文档时，才输出为 docx 格式。如果数据较多，比如100行，甚至更多，显然输出到excel更合理。

占位符定义要注意的几点：

1 占位符中不能用空格，回车等字符

2 占位符如果在一行的最后被自动分行到下一行，是可以的，但不能手工加回车换行于占位符中

3 表格中，如果位置太小，占位符也可能被自动换行，这个是没问题的，不要手工加回车换行符

word模板文件的位置

    如果word模板文件是绝对文件路径，那么直接到服务器上该绝对路径中去找word模板文件。如果是相对路径，则会在当前表单模板目录下去找word模板文件。注意 ：word模板文件是在服务器上的，不是在客户端。因为输出操作是在服务器上进行，并在浏览器中进行下载。

空的明细行是否删除

       这个可以根据需要进行设置， 下面是删除空行，与不删除空行生成的文件对比