使用PageOffice 在模板中添加数据区域

模板中必须标记好数据要插入的位置，这样才可以实现用程序插入数据到文件的相应位置，就是说要想生成文件，数据的位置必须用某种元素来标记出来。使用PageOffice开发，常用的是Word书签来标记要插入数据的位置。

一般的开发人员使用Word比较少，可能不清楚Word书签是怎样插入的，下面简单的介绍一下插入书签的方法。

第一种方法： 把光标定位到需要标记数据位置的地方，点Word菜单中的“插入”-“书签”，就会弹出一个标题为“书签”的对话框（如下图所示），输入新书签的名称，注意：书签名必须以字母、汉字、中文标点等开头，可以包含数字但中间不能有空格（用PageOffice开发的时候不推荐使用中文命名书签名）。点右侧的“添加”按钮，新的书签名将出现在下面的列表中。

第二种方法： 选择几个文字、或一段文字、或者选择一段包含表格和图片的内容，为选中的内容指定书签的对象，然后执行第一种方法的同样操作，“插入”→“书签”……

注意：如果新插入位置或新对象采用的是已有的书签名，原有的书签将自动取消。

PageOffice示例代码中的模板在制作的时候，多采用第二中方法定义书签，插入书签之前会先写一个标示性的词语用中括号括起来，比如：[姓名]，然后选中“[姓名]”，再插入书签。这样做的目的是便于在查看或编辑模板数据位置的时候一目了然。

在使用PageOffice开发的过程中，为了避免出现与用户自己定义的书签出现冲突，要求插入的书签名称必须以“PO_”开头。注意是字母o，不是数字0。书签名是不区分大小写的也可以写成“po_”。在PageOffice的概念里提到的数据区域，本质上就是书签，但是只有“po_”开头的书签才叫数据区域，请大家注意这点。

编辑数据区域的注意事项

---

鉴于Word书签的特点：书签可以相互包含、相邻的书签会互相干扰，插入数据区域的时候需要一些技巧和注意事项，在这里一并介绍一下。

1. 插入数据区域前选择的文本内容如果不是故意要跨段的话，不要选择段落末尾的回车换行符“┙”。
2. 如果说“[姓名]”就是要插入的数据区域的文本标示，那么请在“[”前和“]”后分别插入一个空格变成“ [姓名] ”，但是选择的数据区域标示的时候不要选择中括号前后的空格，只选择“[姓名]”，然后点Word菜单中的“插入”-“书签”，命名为：PO_name。
3. 插入的任意的两个数据区域不能首尾相连。不允许前面的数据区域的末尾后面紧接着就是后一个数据区域的开始，中间连空格都没有，这是不允许的。
4. 插入的数据区域不要互相包含。不推荐一个数据区域中完整的包含了另一个数据区域，这样做在程序生成文件的时候，不会出现错误，但是没意义，除了造成使用的混乱之外没有好处。