Lesson 3: Create a New Template

Overview

When you create a template, you must specify what text will be used in the template. For example, you can either use text from an existing document as the basis for the template, or you can create a new, empty template and just add the text as you automate it. For this lesson, you will use text from an existing employment agree­ment. When the template is created, special HotDocs toolbars are added to the word processor window. Automating a template in the word processor lets you use all of the functionality of the word processor, while also providing full HotDocs function­ality through these custom HotDocs toolbars. Once you have created a template, you can use HotDocs template-building features to automate the template. The next several lessons teach you how to create and automate an Employment Agreement template like the one you assembled in Lesson 1.

Start the Tutorial

If you are continuing immediately from Lesson 2, skip the instructions for starting HotDocs and proceed to “Create the Template.” If you closed HotDocs at the end of Lesson 2, complete the following steps.

To start HotDocs

  • Choose StartProgramsHotDocs 11 > HotDocsDeveloper. The Test Templates library appears.

If the My Test Templates library does not appear, choose Open Library (File menu), select the library in the default Libraries folder (for example, My Test Templates.hdl), and click Open.

Create the Template

You will now create the Employment Agreement template. You will use an existing document as the basis for the template.

To create a template

inset_1700080.png

inset_1800085.png

inset_1900086.png

Template titles and descriptions help the user identify the template at the HotDocs library.

inset_2000089.png

If you performed a custom installation, the document will be located in the default Documents folder you specified during installation. Use your com­puter’s Find command (Start > Search > For Files or Folders) if you are having a difficult time finding the file.

The text in this document will be used as the text for the template you are creating.

inset_2100093.png

The document’s folder path and file name appear in the Other file box.

  1. In the My Test Templates library, click on the My Test Templates folder.
  2. Click newtemplate.jpgNew Template. The New Template dialog box appears.
  3. Select the type of template you want to create from the Type drop-down list. Base your selection on which word processor you have installed. For example, to create a Microsoft Word template, select Word DOCX Template.
  4. Type Employment Agreement in the File name box.
  5. Click in the Title box and accept the suggested title, Employment Agreement.
  6. Type This template is to be used with the HotDocs tutorial in the Description box.
  7. In the Initial contents group, select Other file and click the browse00090.jpgBrowse button. The New Template Initial Contents dialog box appears.
  8. Select either Employment Agreement.doc (Word users) or Employment Agreement.wpd (WordPerfect users), located in the default word processor Documents folder.
  9. Click OK to return to the New Template dialog box.
  10. Click OK. The new template file is created and opened in the word processor. The template is also added to the template library.

inset_2200094.png

When you create a template, HotDocs automatically creates a companion file for the template called a component file. This component file is necessary for a template to work, since it stores all of the information about the template’s automation (such as component names, template properties, and so forth).

The component file works automatically in the background—as you create variables and other components in the template, they are automatically stored in the compo­nent file.

HotDocs gives the component file the same name as the template file. In this instance, HotDocs has created a component file named Employment Agreement.cmp (since your template file is named Employment Agreement.docx or Employment Agree­ment.wpt).

Components are elements in a HotDocs template that display or store information about the answers that are merged. Examples of components include variables, dialogs, dialog elements, merge text groups, and formats.

Familiarize Yourself with the HotDocs Toolbar

At any time during these lessons, you can click the inset_2300095.pngHotDocs Help button to display the HotDocs Help file. You can then search for more infor­mation about anything in the tutorial you don’t under­stand or about which you would like to learn more.

When you create a new template, HotDocs adds custom toolbars to the template. These toolbars appear below the word processor toolbars. You use these toolbars to edit the HotDocs template. (The appearance and location of the buttons vary slightly, depending on the word processor you are using.)

In Word 2007, 2010 and 2013, all HotDocs editing and navigation buttons can be found on the HotDocs tab of the Word ribbon.

The buttons are:

save.jpg   Save

close.jpg   Save and Close

testassemble00100.jpg   Test Assemble

variable.jpg   Variable Field

if.jpg   IF Field

repeat.jpg   REPEAT Field

insert.jpg   INSERT Field

ask.jpg   ASK Field

inset_000113.gif   Other Fields

edit.jpg   Edit Component

componentmanager.jpg   Component Manager

inset_100118.gif   Create Model

clauselibrary.jpg   Clause Library

inset_2400121.png   HotDocs Help

applycolor.jpg   Apply Colors

labelfields.jpg   Label Fields

matchfields.jpg   Match Fields

gotofield.jpg   Go to Field

previousfield.jpg   Previous Field

nextfield.jpg   Next Field

In addition to these buttons, you can use the hotdocs.jpgHotDocs button to display the HotDocs library. Click on the arrow below it to display a list of further options.

  You should always use the save00136.jpgSave button to save your work, or the close00139.jpgSave and Close button to save and close a template, rather than your word processor’s Save and Close commands. Using these buttons ensures the template and component file are both properly saved and closed.

Conclusion

You are now finished with this lesson. In it, you learned how to create a text template and add it to the template library. Additionally, you learned about the buttons on the HotDocs toolbar.

If you do not want to go on to Lesson 4 at this time, click the HotDocs close00142.jpgSave and Close button to close the template. Then exit HotDocs.