Show/Hide Toolbars

 PhraseExpander 5 Manual

Navigation: Designing templates > Variables > Fill-in variables

Fill-in Overview

Scroll Prev Top Next More

Available in PhraseExpander Professional

The Fill-in variable allows you to request additional information when executing a template. This information will be requested by displaying the Input form at the time the template is executed.

 

The Input form window requests additional data. When clicking on the Send Text button, the generated template will be sent to the active application.

The Input form window requests additional data. When clicking on the Send Text button, the generated template will be sent to the active application.

 

To create a new Fill-in variable

1.In the Quick edit or the Template editor, right-click on the position where you want to insert the new variable placeholder, and choose Variables and then New fill-in
PhraseExpander opens the new fill-in variable window

2.Fill in the required fields and click on the Preview button to see how the fill-in looks like

3.Click OK to confirm
The template now contains a new variable and its placeholder has been inserted into the document

 

An overview of the Fill-in variable design window

Each fill-in has a set of standard properties which are described below.

PhraseExpander allows you to use different fill-ins that are specialized based on the data you need to gather.

The fill-in variable design window lets you define how the additional  information will be requested.

The fill-in variable design window lets you define how the additional  information will be requested.

 

Here's a brief overview of the fill-in variable design form:

1.Name: the unique name of the variable. The variable name cannot contain blanks and can be up 30 characters long. Click on the pencil icon to make changes

2.Label: a description of the fill-in. It's shown when executing the template

3.Additional instructions: additional instructions to display to guide people when they are entering the data

4.Display as: define how the fill-in should be displayed. The available options are: List, Grid, Text, and Calendar.

5.Encode text for URLs: if you are using an fill-in variable to generate URLs, you want to make sure that this option is checked, so that the generated web address doesn't contain characters that don't play nice with browsers (like Internet Explorer, Chrome or Firefox).

6.Additional options related to the type of display: based on the chosen display type, PhraseExpander adapts the interface to display additional settings and options

7.Pre & Post: customize the text that will be inserted before (pre) and after (post) the fill-in. This text will be inserted only if the fill-in produces some text. You can also use the #LABEL# placeholder to insert the contents of the Label field of the variable.

8.Adapt casing: it tells if the casing of the generated text has to be adapted (e.g. converting the first letter to uppercase) when placed into the template

9.Display all variables: opens the Manage variables window to edit all the variables contained in the template

10.Preview: it gives you a quick way to see how the fill-in will look like, without having to trigger the entire template

 

NOTE: right-clicking in any field will give access to macros that can be inserted in virtually any field of the variable.

 

Variables placeholders

All the variables placed inside the template contents will be displayed as

 

{{varname}}

 

Fill-in types available

PhraseExpander can display different kinds of fill-ins, and you can choose the most appropriate one based on the kind of information you need to request.

 

1. List

Display a list of predefined values that the user can check. The list can be displayed expanded or as a dropdown, single or multi-selection.

list-variable

2. Grid

Display a grid selection with multiple available options for each row.

userinput-grid-run

3. Text

Display a text box with an optional predefined text (it can be single line or multi-line).

userinput-text-run

4. Calendar

Display a calendar selection box.

userinput-calendar-run

Created with Help & Manual 7 and styled with Premium Pack Version 3 © by EC Software