Advertise Variables Dialog Box

InstallAnywhere 2020

When you are creating a merge module, you need to specify which variables in the merge module can be set by the parent installer and which variables in the parent installer can be set by the merge module. You do this on the Advertise Variables dialog box.

Advertised variables are used to inform the parent installer of settings that are required for a merge module’s configuration, and to return information—such as status or return codes—back to the parent installer. Advertised variables must be set before a merge module can be installed.

To open the Advertise Variables dialog box:

1. On the Project page, click Variables.
2. Click the Advertise Variables button.

The following settings are available on the Advertise Variables dialog box.

Advertise Variables Dialog Box

Setting

Description

Pre-Install, Install, Post-Install tabs

Select the appropriate tab to indicate the sequence for which you want to advertise variables: Pre-Install, Install, or Post-Install.

Note • Advertised variables are defined by sequence:

Variables that are set as advertised as Pre-Install affect only the dynamic merge module in pre-install.
The only advertised variables that the Install Merge Module action checks are those that are set in the Install sequence.

Input Variables list

To advertise an input variable so that it will be visible in the parent project (the project that is going to install this merge module), click the Add button next to the input variables list, and then enter the following information:

Variable Name—Enter the name of a variable that has been defined in one of the panels of this project, using the syntax $VARIABLE_NAME$.
Default Value—If you want to hard code a value for this variable, enter text here. If you want the value of this variable to be entered by the end user during installation, leave this setting blank.
Comment—Enter text to describe the purpose of this variable.

To remove a selected variable from the list, click the Remove button.

Parent Variables list

To advertise a variable in the parent project (the project that is going to install this merge module) so that it will be visible in this project, click Add next to the parent variables list to add an entry to the list, and then enter the following information:

Variable Name—Enter the name of a variable that you want to pass to the parent project using the syntax $VARIABLE_NAME$.
Comment—Enter text to describe the purpose of this variable.

To remove a selected variable from the list, click the Remove button.

Note • For each build configuration, you can specify whether you want to create a merge module installer as part of the build output. For more information, see Creating Merge Modules.

See Also