The HotDocs Field Editor is a pane the HotDocs Author plug-in adds to Microsoft Word to enable you to add HotDocs fields to a HotDocs template and then edit the properties within each field. When you edit the field properties using the HotDocs Field Editor, HotDocs saves your changes as you make them. There are two types of properties you can edit within a given field:
A blue bar appears to the left of properties you edit that affect the contents of a component file. Once you have entered a valid component name, you can edit any such properties by clicking the Edit icon to the right – as long as you didn't first open Component Studio from the Workspace Explorer. In that case, clicking the Edit button opens a read-only copy of that component editor where the values are grayed out and not editable. If this happens, close Component Studio and the component editor, then reopen the component editor by clicking the Edit icon.
The Field Editor is available when editing a DOCX template in Microsoft Word, a plain text template in Composer, or in Component Studio (when you want to add a placeholder field to a component).
In this topic ShowHide
Among others, the Field Editor enables you to perform the following common tasks:
Microsoft Word does not scan HotDocs field names to check for spelling errors.
The Field Editor's interface includes keyboard shortcuts to enable you to work more rapidly than you can by clicking with a mouse.
To enable you complete these tasks, the Field Editor presents one of two separate interfaces at the top of the field editor:
|Interface Name||Access Method|
|Action||Appears when you select any part of the template text that is not already a HotDocs Field.|
|Field Type||Appears when you select any part of an existing HotDocs field.|
To add a field or pair of fields into the template, select one of the following actions:
Subheaders and some actions are only visible when you click the More button at the bottom right of the Action menu.
|Subheader||Action||What it Does|
||Add a Placeholder||Displays the Placeholder Type pane so you can choose the kind of content you want to create a placeholder for:
Once you select a placeholder type, the Field Editor displays the Field properties for that type of placeholder field.
Variable placeholder field types determine the kind of answers you can gather from your template users in a HotDocs interview. You can edit the properties of the field, which can enable you to edit the way variables appear in the interview, how HotDocs formats the template user's answers to those variables, etc. You can edit the field properties when you select from the following variable types:
Enables you to browse to, and choose the templates or image files you want HotDocs to embed in your current template during assembly:
Enables you to choose the kind of calculation you want HotDocs to perform during assembly so it can make that calculation and place the resulting value into the space saved by the placeholder field when assembling the document:
|Regions and Rules||Create a Conditional Region||Displays the Select a condition type pane which enables you to choose what type of condition you want to create that needs to be met in the interview before this region of the template is placed into the assembled document.|
|Modify a Conditional Region
Only appears when you place your cursor inside an existing conditional region.
|Displays the editor for modifying the conditional region by adding ELSE or ELSE IF fields. During document assembly, an ELSE or ELSE IF field causes HotDocs to add alternative regions of text to the assembled document if the first condition isn't met.|
|Create a Repeated Region||Displays the editor for creating a repeated region; this enables your template users to repeat that region one or more times during the interview.|
|Create a punctuated list||Displays the editor for adding list marker fields.|
|Add formatting markers||Displays the editor for adding formatting marker fields.|
|Other Operations||Place a Dialog in the Interview||Displays the editor for adding a dialog to the interview during assembly.|
|Assemble Another Template||Displays the editor for assembling another template directly after this assembly.|
|Add a punctuation marker||Displays the editor for adding punctation marker fields.|
|Change the Formatting Language||Displays the editor for adding a LANGUAGE instruction to the template.|
When you select any existing placeholder field in a HotDocs template, the Field Type interface appears to help you edit an existing placeholder or instruction field. The interface presents you with the field type and then displays the existing fields details for editing.
|Elements||What it Does|
|Field Type||Displays the type of HotDocs field you added previously.
Except in the case of an IF instruction field, the Field Type pane is a static label.
If your template contains an error, an Errors interface appears at the bottom of the HotDocs Field Editor, otherwise, the Errors interface remains hidden.
|Elements||What it Does|
|Inconsistent Field Appearance Notification||(Only appears when applicable) Whenever HotDocs detects an invalid field modification, a red icon next to the text Inconsistent Field Appearance alerts you to the error. The Update button enables you to correct the error.|
(Only appears when applicable)
If your template uses any auxiliary templates, an Auxiliary Template interface appears at the bottom of the HotDocs Field Editor, otherwise the interface remains hidden.
|Elements||What it Does|
(Only appears when applicable.) Displays the number of auxiliary templates the currently selected template uses to assemble properly. Clicking Auxiliary Templates toggles the list of templates the current template references using either:
The list displays the current template's auxiliary templates and a list of any auxiliary templates these may use. Double-clicking an auxiliary template's name opens the template.
If any of the auxiliary templates contain an error, the title bar displays a red error icon overlaying the auxiliary template icon. In addition, individual auxiliary templates containing an error display a small red exclamation mark. Clicking an error icon opens the auxiliary template that contains the error and places focus on the element in the template that contains the error.