Creating a Template from a Word File

Creating Document Templates from a Microsoft Word file is a powerful alternative when your documents require advanced functionality and special formatting.

Due to major updates on Microsoft Word, the templates used in eBECAS/EDMISS Classic are not compatible with the Next Generation template engine. See this article for details on how to migrate your templates.

This article is based on Microsoft 365 version of Word. Please note that the user interface may vary slightly depending on the version of Microsoft Word you are using.

Create a Template in Microsoft Word

Before you start creating a template, make sure you are familiar with the concepts of bookmarks for fields and grids.

• Bookmarks

• Grids in Templates

1. Create/Open a Word Template

Create a Word Document with your desired format/structure, or open a Word Document with the format/structure that you want for the template. You can add header, footer, images, tables, text etc.

2. Insert Single Fields/Grid Tables/Grid or Section Templates

For dynamic content, which will be replaced with data during the merge process, you will need to add fields. Fields is the equivalent of bookmarks, and they represent dynamic data.

From the Insert tab, select Quick Parts and then on Field. The field properties window will display.

The following step, depends on whether you are inserting a:

• Single field that represents a single value (e.g Student First Name). Or;

• Grid Table that represent a group of structured values in tables, or a Grid/Section template that represents another template that can be embedded in another template.

Insert a Single Field

From the Field properties windows:

1. Select MERGEFIELD from the Field names panel.

2. As the Field name, enter the Bookmark (API name) of the field you want to add without any curly brackets.
   For example, for the student’s first name, add the Field name as students-first_name.
   The fields name must match exactly the bookmark (API name) of the field.

3. Click OK to insert.

   

4. You’ll see the field inserted through MERGEFIELD as { MERGEFIELD students-first_name }.

   

Tip. If you need to set a specific date format (for date fields only), you can specify the format within the MERGEFIELD using \@ "DateFormat".

For example: { MERGEFIELD students-dob \@ "dd/MM/yyyy" }

Insert Grids in Tables

You can insert a Grid in a Table in a Word Template in the same way as in HTML. Please refer to the instructions in the link below for details on how to do this: Grids in Tables.

Insert Grid Templates or Section Templates

From the Field properties window:

1. Select DOCVARIABLE from the Field names panel.

2. Enter the API Name of the Grid Template or the Section Template that you’d like to insert in the Word Template on the New name field without any curly brackets.
   For example, if the API name of the grid that you want to insert is offer_items_gross_grid, enter that as the name.
   The name must match exactly the template’s API name.

3. Click OK to insert.

   

4. You’ll see the field inserted through DOCVARIABLE as {DOCVARIABLE offer_items_gross_grid}.

   

3. Save the Word Template

Once you have finished inserting fields into your Word template, you can save the template in ‘.doc' or ‘.docx’ formats.

In eBECAS/EDMISS NextGen, the Word template files must have the .doc or .docx extension.

Upload a Microsoft Word Template

When you have the Word file ready, it is time to create the template in eBECAS/EDMISS NextGen.

1. Go to Step3 of Creating a template.

2. Select Document as the Channel and enable the option Word Document Template.
   Note that Email and SMS templates cannot be created from a Word document.

3. Select Template as the type.
   Note that Templates of type Section and Grid cannot be created from a Word document.

4. Click on Next.

5. Enter the details and choose the template file to upload.

6. Click Save and Exit to finish.

   

Example of Creating a Template from a Word File

The following example explains how to create a Word file that can be used as a template in eBECAS/EDMISS NextGen.

Simple Invoice Template

1. Open a new document in Word.

2. Create the basic layout for the template.

   

3. Insert data fields by using MERGEFIELD , as highlighted in yellow in the screenshot below.

   For example, to insert the Student First Name field, we need to know the bookmark for that field: {{students-first_name}}
   Next, add the data field in the Word template.
   

   To do so, Go to Insert > Field, select MERGEFIELD, enterstudents-first_name in Field name, then click OK
   You’ll see { MERGEFIELD students-first_name }.
   

4. Insert grid tables using a table and {{#grid ObjectApiName}} as highlighted in the red box in the screenshot below.
   For more detailed instruction, please refer to the article on: Grids in Tables
   

5. Next, we are going to insert a Grid/Section template using DOCVARIABLE, as highlighted in cyan in the screenshot below.

   Let's insert a section template (must exist in NextGen) that will display the Bank Details of the college.
   

   Go to Insert > Field, select DOCVARIABLE, and enter sample_branded_bank_detail (api name of the grid we want to insert) in the New name. Then click on OK.
   You’ll see { DOCVARIABLE sample_branded_bank_detail }.
   

6. The document will look like this one:

   

Microsoft Word already has lots of useful fields such as Today’s date, Current page number etc in Fields that you can use together in eBECAS/EDMISS Templates. For more details, visit List of field codes in Word.

7. Upload the word template to Next Gen templates.
   For more detailed instruction, please refer to the above section on: Upload a Microsoft Word Template.
   

8. When merging the document on the offer, the result will look like this: