Forms collects one or multiple user input, that replaces placeholders in the phrase contents.
This phrase example contains static text and form macro place holders:
Customer Name: Name?
The user is an IsCustomer? existing customer.
The customer is using version version number.
If you trigger such phrase, PhraseExpress would not immediately output the phrase but scan the phrase for all form macros first, and render a form which prompts for input:
After filling the form, PhraseExpress replaces the form macro place holders in the phrase contents with the user input and outputs the phrase:
Customer Name: Mike
The customer is an existing customer.
The customer is using version 14.
Form macros are an exception to the normal sequential macro processing as they are processed before any other phrase content.
If the same input is required at multiple positions throughout a phrase, use the identical label for all related form macros. Only one instance of the objects that have the same label will be shown in the form.
How to create a form:
- Open the main program window.
- Select the phrase, you wish to extend with user input.
- Place the cursor at the position in the phrase where you wish to insert user input and select
- Configure the form macro.
- Repeat from step 2 for all desired user inputs.
The form input provides multiple different types of input controls.
WYSIWYG forms allow you to place text input boxes, dropdowns, phrase selection dropdowns, checkboxes and date selection within a formatted phrase. Any form input is inserted the actual position of the input control.
If nesting with other macro functions is required, we recommend that you use the form functions described above.