卓正PageOffice 如何在模板中添加数据区域

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

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

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

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

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

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

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

编辑数据区域的注意事项

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

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