Windows Installer Editor Reference
331
Merge Modules and Transforms
Creating a Configurable Merge Module
¾
Available in merge module files (.WSM, .MSM) only.
To create a configurable merge module, you add configuration items to a standard
merge module. On the Substitutions page, you specify the:
z
Substitution item, which is the field that can be configured.
z
Configuration item, which determines how a field can be configured.
This creates a substitution value, which consists of one or more values specified by
configuration items. When a configurable merge module is added to an installation, the
installation author can specify values for the substitution item based on the
configuration item settings.
See
Adding a Merge Module to an Installation
on page 338.
Configurable merge modules are supported only by Windows Installer 2.0 or later.
For information on creating a standard merge module, see
Creating a Merge Module As a
New Installation
on page 328.
To add a configuration item to a merge module
1. Select Installation Expert > Substitutions page.
If there is no Substitutions page, you are not in a merge module file.
2. Click Add at the right of the page.
The Module Substitution dialog box appears.
3. From Table, select the table that contains the item to be configured when the
merge module is added to an installation.
4. In the table, click a table cell to select the substitution item.
5. Click Add and select from the button menu:
Configurable Item
Select to add a configuration item to the selected substitution item.
See
Setting Configuration Item Details
on page 332.
Constant
Select to add a constant value in combination with configurable items. Example:
After adding a configuration item, select this option to add a pipe character (|)
before adding another configuration item.
6. Click OK.
The value you defined for the configurable item appears in the Value field, and the
item appears in the Configuration Items list box.
7. To add more values for the item, repeat the preceding two steps.
If you add multiple values, multiple rows appear in the list box and the values are
concatenated to create the entire substitution value.
See
Example: Configuring an Item for a Merge Module
on page 336.
8. Click OK.
The new configuration item is listed on the Substitutions page.
