Results Variables

InstallAnywhere 2017

Edition • The Get User Input panels are available only in InstallAnywhere Premier Edition.

Results variables store the results of the end user’s input. The default value for the Results Variable name is USER_INPUT_RESULTS.

The variable name of the Results Variable also forms the base name of additional InstallAnywhere variables that will be used to store individual end-user input choices from the end-user input panel. The convention for the naming of the additional variables is to append an underscore and an integer number to the end of the base name. The number, starting at one (1), increases by one (1) for each additional variable that is needed to store data.

The number of additional variables derived from the Results Variable base name depends upon the Input Method/Component Type that you have selected for the panel, the choices made by the end user at install time, and the number of values listed in Defaults.

The following table describe how user input is recorded in variables for each input type:

User Input Results By Input Type

Input Type

Description

Textfields

The Results Variable is the base name for the values returned by the Get User Input panel. Entries in the textfields will be returned in a comma-separated list surrounded by quotes and stored in the Results Variable.

In addition, additional variables derived from the Results Variable will store the values from the individual textfields. For example, if the Results Variable is $X$, and there are three textfields populated with the values Peter, Paul, and Mary, when the end user clicks Next during the install, the following InstallAnywhere variables and values exist:

$X$="Peter","Paul","Mary"

$X_1$=Peter

$X_2$=Paul

$X_3$=Mary

However, if only two values were inserted (Peter and Mary), the values are:

$X$="Peter","","Mary"

$X_1$=Peter

$X_2$=

$X_3$=Mary

Check Boxes

The Results Variable is the base name for the values returned by the Get User Input panel. A comma-separated list containing the Value for choices from selected check boxes (a blank entry in the comma-separated list will be included for check boxes that were not selected) will be returned and stored in the Results Variable. Additional variables derived from the Results Variable will store the values for each check box that was selected.

For example, if the Results Variable is $X$, and there are three check boxes with the labels Paul, John, and George (from the Values for choices list) and Paul and George are selected when the end user clicks Next during the install, the following InstallAnywhere variables and values exist:

$X$="Paul","","George"

$X_1$=Paul

$X_2$=

$X_3$=George

List

The Results Variable is the base name for the values returned by the End-user Input panel. A comma-separated list containing the Value for choices from selected list entries (a blank entry in the comma-separated list will be included for check boxes that were not selected) will be returned and stored in the Results Variable.

Additional variables derived from the Results Variable will store the values for each list entry that was selected.

Lists behave somewhat differently than check boxes. For example, if the Results Variable is $X$, and there are three list entries with the labels Paul, John, and George (from the Values for choices list) and Paul and George are selected when the end user clicks Next during the install, the following InstallAnywhere variables and values will exist:

$X$="Paul","","George"

$X_1$=Paul

$X_2$=

$X_3$=George

Radio Buttons and Popup Menus

The Results Variable is the base name for the values returned by the Get User Input panel. A single value based both on the Value for choices value and what was selected is returned and stored in the Results Variable.

Additional variables are not derived from the Results Variable unless Defaults are specified.

For example, if the Results Variable is $X$, and there are three radio buttons with the labels Michael, Matthew, and David (from the Values for choices: list) and Michael is selected when the end user clicks Next during the install, the following InstallAnywhere variables and values exist:

$X$="Michael","",""