卓正PageOffice 如何在模板中添加數據區域

模板中必須標記好數據要插入的位置，這樣才能夠實現用程序插入數據到文件的相應位置，就是說要想生成文件，數據的位置必須用某種元素來標記出來。使用PageOffice開發，經常使用的是Word書籤來標記要插入數據的位置。

通常的開發人員使用Word比較少，可能不清楚Word書籤是怎樣插入的，下面簡單的介紹一下插入書籤的方法。

第一種方法： 把光標定位到須要標記數據位置的地方，點Word菜單中的「插入」-「書籤」，就會彈出一個標題爲「書籤」的對話框（以下圖所示），輸入新書籤的名稱，注意：書籤名必須以字母、漢字、中文標點等開頭，能夠包含數字但中間不能有空格（用PageOffice開發的時候不推薦使用中文命名書籤名）。點右側的「添加」按鈕，新的書籤名將出如今下面的列表中。

第二種方法： 選擇幾個文字、或一段文字、或者選擇一段包含表格和圖片的內容，爲選中的內容指定書籤的對象，而後執行第一種方法的一樣操做，「插入」→「書籤」……

注意：若是新插入位置或新對象採用的是已有的書籤名，原有的書籤將自動取消。

PageOffice示例代碼中的模板在製做的時候，多采用第二中方法定義書籤，插入書籤以前會先寫一個標示性的詞語用中括號括起來，好比：[姓名]，而後選中「[姓名]」，再插入書籤。這樣作的目的是便於在查看或編輯模板數據位置的時候一目瞭然。

在使用PageOffice開發的過程當中，爲了不出現與用戶本身定義的書籤出現衝突，要求插入的書籤名稱必須以「PO_」開頭。注意是字母o，不是數字0。書籤名是不區分大小寫的也能夠寫成「po_」。在PageOffice的概念裏提到的數據區域，本質上就是書籤，可是隻有「po_」開頭的書籤才叫數據區域，請你們注意這點。

編輯數據區域的注意事項

鑑於Word書籤的特色：書籤能夠相互包含、相鄰的書籤會互相干擾，插入數據區域的時候須要一些技巧和注意事項，在這裏一併介紹一下。

1. 插入數據區域前選擇的文本內容若是不是故意要跨段的話，不要選擇段落末尾的回車換行符「┙」。
2. 若是說「[姓名]」就是要插入的數據區域的文本標示，那麼請在「[」前和「]」後分別插入一個空格變成「 [姓名] 」，可是選擇的數據區域標示的時候不要選擇中括號先後的空格，只選擇「[姓名]」，而後點Word菜單中的「插入」-「書籤」，命名爲：PO_name。
3. 插入的任意的兩個數據區域不能首尾相連。不容許前面的數據區域的末尾後面緊接着就是後一個數據區域的開始，中間連空格都沒有，這是不容許的。
4. 插入的數據區域不要互相包含。不推薦一個數據區域中完整的包含了另外一個數據區域，這樣作在程序生成文件的時候，不會出現錯誤，可是沒意義，除了形成使用的混亂以外沒有好處。