Field Editor: Other Expression
You can use the Other Expression options in the Field Editor to create and edit fields for the output of a HotDocs expression or Instruction that isn't available elsewhere in the field editor.
To view the Field properties for an other expression field, in the Field Editor select Add a placeholder > Other expression.
Field Type
The Field Type element of the HotDocs Field Editor declares whether the currently selected HotDocs Field is a placeholder field or an instruction field.
Simple Expression/Instruction Editor
You can create a simple one-line expression or instruction using the expression editor in the Field Editor.
Property Name | Explanation |
Expression | Type a simple one-line expression or instruction here. |
Format |
Enables you to set the format HotDocs uses when an answer replaces the (currently selected) field during assembly by typing a custom format. The Format box does not provide syntax highlighting and error validation. |
Existing Fields Editor
Appears when you select an existing HotDocs expression or instruction field in the template, that you cannot edit elsewhere in the Field Editor.
Property Name | Explanation |
Field Type | Shows the type of field (for example, "Other instruction") you select. |
Expression/Instruction Text Box | Enables you to type the expression you want. |
Format | Enables you to set the format HotDocs uses when an answer replaces the (currently selected) field during assembly by typing a custom format.
The Format box does not provide syntax highlighting and error validation. |
Advanced Properties
Select the Advanced Properties expander to see further properties for the placeholder field:
Property Name | Explanation |
Unanswered text | You can provide a word or set of characters that HotDocs uses
in the template in place of an answer if none is given in the
interview. This overrides the unanswered text you can set at the
component level in the appropriate editor in Component
Studio and at the template level in the Template
Properties dialog.
If you have previously set default unanswered text for the variable in component studio, you will see the text grayed and italicized in the text box. If you set new unanswered text, this overrides the default unanswered text, but only for this specific instance of the placeholder field. In addition, when you override default unanswered text, any other property defaults (Format, Font, Padded width, Answer alignment, Pad character) you have set in component studio are copied into the respective text box and set for that property at the field level. |
Font | Enables you to specify a different font for the answer in the
assembled document.
When you set a font for the variable, any other property defaults (Format, Font, Padded width, Answer alignment, Pad character) you have set in component studio are copied into the respective text box and set for that property at the field level. |
Pad answer to fixed number of characters | Enables you to change how answers are displayed in the assembled
document by altering the padding of the answer according to the
characteristics you specify using the following properties:
The default fill character is a space. If you have previously set pad answer properties for the variable in component studio, you will see those defaults reflected in the field editor. If you set new pad answer properties, this overrides the defaults, but only for this specific instance of the placeholder field. In addition, when you override pad answer properties, any other property defaults (Format, Font, Unanswered text) you have set in component studio are copied into the respective text box and set for that property at the field level. |
Revert | (Only appears if you have modified the Format, Unanswered text, and Pad answer-related field properties) Enables you to revert back to the default state (the defaults defined in Component Studio) for the Format, Unanswered text, Font, Padded width, Answer alignment, and Pad character field properties. |
Preserve empty paragraph | Enables you to force HotDocs to keep an empty paragraph left behind when HotDocs removes a HotDocs field when assembling a document. |
Comment | You can use this to add notes about the field. A field with a comment attached displays a grey C next to the field name on the template. |
Replace Multiple
When you select a piece of text to replace with a placeholder field, select Replace Multiple to use the following options to find and replace other instances of that text in the template:
Options | What it Does |
Replace | Replaces the selected text in the template with the placeholder field. |
Replace All | Replaces all instances of the selected text in the template
with the placeholder field.
You must be careful when you select the text before a replace all. If you accidentally include the paragraph mark at the end of a selection HotDocs will remove it and any other instances of a paragraph mark following the selected text when you click Replace All. This can lead to a poorly formatted document. |
Skip | Moves to the next instance of the selected text in the template without replacing the current selection. |
Done | Deselects the text and closes the replace multiple options. |
Field Toolbar
At the bottom of the HotDocs Field Editor, you have access to the following actions:
Buttons | What it Does |
Add Field | Adds the placeholder field to the template in the selected location. |
Navigation | When a placeholder field is selected, navigation buttons show. Use < and > to navigate to the next HotDocs field. When a conditional instruction is selected, such as ELSE IF, navigation buttons help you to match the corresponding instructions, such as END IF. |
Delete Field Button [X] | Selecting anywhere in a HotDocs field causes the Delete field button to appear. If you select outside a HotDocs field, or include anything besides a single HotDocs field, the button disappears (if it was previously visible), or else does not appear. Clicking the Delete field button removes the selected field completely. Clicking Microsoft Word's Undo button restores the field completely.
The Delete field button exists to solve a particular problem: In Microsoft Word, you can delete a HotDocs field by clicking in the field, then clicking the field's handle, and then pressing the DELETE key on the keyboard. However, if you select the field using only the keyboard, Word does not easily enable you to delete the field. You can do so by deleting all the content of the field and then pressing the DELETE key again, or if your cursor is just to the right of the field, you can press the Backspace button once to select the field's content, a second time to delete the content, then a third time removes the field. HotDocs provides the Delete field button to simplify this process. |