OMIT VAR

The OMIT VAR instructionA command in a script or template that performs a special task, such as inserting a template or asking a dialog at a specific place in the interview., which you use in a dialogIn template development, represents the component in which the developer groups variables and other components. In document assembly, represents the group of questions in the Interview tab of the assembly window where users enter their answers. scriptOne or more instructions and/or expressions that generate a value or execute some kind of procedure., keeps variables from appearing in the Edit Answer Source dialog box of an answer source.

Answer sources are associated with specific dialogs in a templateA word processor or form document that has been converted to HotDocs format so that it can be automated. When in template format, changeable text in the template can be replaced with variables. Other instructions can be added as well, such as instructions that create lists, condition text, and insert other templates.. When users view the dialog during the interviewA series of dialogs, each containing one or more questions which HotDocs generates from the variables you add to your template. The template's user must answer the questions in the interview before HotDocs can assemble a custom document. You can view the interview by clicking the Interview tab of the assembly window. The left pane of the assembly window displays an outline of the interview. As the user answers questions, the outline tracks the user's progress through the interview., they can click a special button, which displays a listTwo or more answers to one question merged in the document. of answers that were entered during previous interview sessions. They can either select an existing set of answers or add a new set to the list.

After creating an answer source for one dialog, you can use it with other dialogs, including dialogs in other templates. When using an answer source with multiple dialogs, each variable must be represented in both the answer source file and in each dialog. If a variable that is referenced in the answer source file isn’t included in the dialog (or vice-versa), answers in the answer source will get “mixed together” whenever you add, edit, or delete records.

In some situations though, it isn’t always practical or relevant to showAn instruction used in a dialog script to show variables that have been hidden in the dialog. (See also HIDE.) Usually this instruction is conditioned so that variables hide and show dynamically, based on answers the user enters. the userThe customer, client, or person who assembles documents from templates. (See also template developer.) every variable—either in the dialog or in the Select From Answer Source dialog box. To accommodate this, you can use the HIDEAn instruction used in a dialog script to hide variables in the dialog. (See also SHOW.) Usually this instruction is conditioned so that questions in the dialog hide and show dynamically, based on answers the user enters., CONCEAL, and OMIT instructions to manipulate these variables in both the dialog and the answer source. Specifically, HIDE keeps a variable from appearing in the dialog, while CONCEAL keeps it from appearing in the answer source spreadsheet. OMIT keeps it from appearing in the answer source altogether, but still allows you to use it in the dialog. Often, you must use a combination of these instructions to achieve your desired result.

For example, say you have a dialog that shows information about a client, including how much a client owes in payments to the firm. Because information about amounts owed changes, it would not make sense to include it in the answer source. To keep it from appearing in the answer source—both in the Select From Answer Source dialog and in the Edit Answer Source dialog—you would use the OMIT instruction, like this:

OMIT Amount Owed

The variable would be asked on the dialog, however, so the user could answer it.

See Suggest an Answer Source for Dialogs for more information.