Editing a Document Template

Overview

Document Templates are Microsoft Word-based documents used to merge data from specific functional areas, such as permits, evaluations, and compliance actions. Document templates are used to create letters, permits, inspection reports, or just about any other document. For more information on how to edit and format documents using Microsoft Word, visit the Microsoft Word Help Center.

In order to use the Document Template editor, the AceOffix browser plugin must be installed on the client desktop browser. In addition, Microsoft Office must also be installed on the client computer.

To edit document templates, navigate to Admin > Document Templates. This page displays a list of existing document templates. To edit a template, click the corresponding Open button. Or, to create a new template, click the Add New Document Template button. In either case, a page opens, allowing you to configure the document template. To view an existing document template with data merged in from the database, click Preview. To edit an existing document template, click Edit. If either Preview or Edit is clicked, an AceOffix window opens (as the New Document Template or Edit Document Template page).

Note that, when editing or viewing a document template in the AceOffix window, a popup window will be displayed over the main nVIRO page, indicating that AceOffix is open in another window. 

Editing a Document Template Using AceOffix

The AceOffix window contains the Editor section, which displays the document itself as an editable Word document, along with a list of merge fields available for insertion into the document. These merge fields appear to the left of the document, under the heading Insertable Fields.

Editing a document template is the same as editing a document in Microsoft Word; the only difference is that the document template contains the insertable fields, which act as placeholders for values that will change dynamically based on the data from the database, such as permit, site, or inspection information.

Insertable Fields Type

There are two types of fields: single insertable fields (non-bold) and Looping insertable fields (bold). These fields can be filtered at the top of the fields list by adding text in the fillable field, resulting in predictive results:

Single Insertable Fields

Listed in a non-bold typeface. To insert a field in the document, double click on any non-bold insertable fields from the list and a text will be inserted in the document (at the location of the cursor) in the form of

image-20240202-190454.png
<<[FieldName]>>

 this field will be changed to its corresponding value when previewing or generating the document. 

 

Looping Insertable Fields

Which is listed as a bold insertable field in the list. The bold insertable field groups multiple fields that represent a table of values. For example, a site usually has multiple contacts associated with it. To insert all contacts in a document, double click contacts, and a text will be inserted in the document (at the location of cursor) in the form of 

<<foreach [contact in contacts]>> <</foreach>>

 which will loop through all contacts available for that document. For more details on loops visit Using Loops in Document Templates.

To display the items available within a bold insertable field, single-click on any bold insertable fields, which will display the available fields.

For more details on how to use loops in a document check Using Loops in Document Templates.

Document Template Possibilities

The Document Template tool is a powerful tool that can regenerate complicated documents based on logic and data sources. It can also perform data manipulation and calculations. Some of the codes that could be used in a document template can be found at Document Template Syntax Guide page.

Standard Document/Notification Template Fields

See page Standard Document/Notification Template Merge Field List for a list of standard merge fields.