Create a New Transform View

AdminStudio 2023 | 25.0 | Tuner

This view is displayed when you click Create a new transform or select New from the File menu.

This view contains the following options:

Base Windows Installer Package Subview

Base Windows Installer Package Subview

Field

Description

Select an MSI file

Enter the name and location of the Windows Installer package that you are customizing, or click Browse to locate it.

Provide a list of additional transforms to be applied

If there are transforms already associated with the Windows Installer package, (for example, previous customizations or transforms containing language-specific information), click the New button ().

When an entry appears in the list, click the Browse button (...) to the right of it and locate the transform.

If multiple transforms are associated with this package, use the Move Up () and Move Down () buttons to specify the order in which the transforms are applied.

Caution:When using multiple transforms, keep in mind that the order in which they are applied is critical. For example, if you create a transform for a Windows Installer package that creates a new value for a property, and then create a second transform that changes the value created in the first transform, everything works correctly. However, if you apply the second transform first, that transform is attempting to modify the property’s value, instead of creating it. That will result in an error.

One simple example of where this may be a problem is with the default company name. If the value is not set by default, and you set it in using the first transform, a new value for the property is created. If you create a second transform that modifies the combined original package and first transform, and the second transform changes the default company name, it is only changing the property. However, if you try to apply the second transform without the first one, Windows Installer interprets this as trying to change a null value to another value, which will result in an error.

Windows Installer Transforms Subview

Windows Installer Transforms Subview

Field

Description

Provide a new project name and location (or accept the default) and click Create to create a new Customization project

Provide a new project name and location. By default, the transform will be created in the same directory as the Windows Installer package, and named the same as the base package with an .mst extension.

If you want to change the name and/or location of the transform, click Browse to open the Save Customization File dialog. Navigate to the directory in which you want to store the transform file you are creating. Provide the name of the transform with an .mst extension (for example, MyTransform.mst) and click Save. The dialog box closes and the path and file name appear in the edit field.

Response Transform

If you want to create a Response Transform, select this check box.

If creating a Response Transform, step through the installation, making changes as necessary. When you reach the end of the installation sequence and click Install, the installation will exit and the Tuner interface will open your transform, which contains all of the changes you made during the simulated installation.

Command line properties

If you are using a response transform, you can specify additional command-line properties (in property name/value pairs separated by semicolons) to pass to the response transform. These must be PUBLIC properties, and only control how the dialogs are displayed during creation of the response transform. They are not persisted outside of the UI sequence during creation. For example, you can pass the property/value pair ARPHELPTELEPHONE=1-111-111-1111 to set the value of the Help Telephone field of Add/Remove Programs.

You might pass a property/value pair during response transform creation to display all dialogs during an installation that may not be displayed based on your system configuration (for example, to show Windows 9x-only dialogs on a Windows NT platform). You can then make appropriate responses and have them included in your transform.

Run Microsoft Step Recorder to document response transform creation steps so that they can be reviewed later

Select this option to record the response transform creation steps in a document using the Microsoft Step Recorder. For more information, see Documenting Response Transform Creation Using the Microsoft Step Recorder Tool.

Note:You can access information about the original MSI file and associated transforms by selecting Properties from the File menu.