How can source paths be defined, changed and created?
(NOTE: This article was originally published in the January 2002 TechInfo! Newsletter. The information contained in this article is accurate for the product(s) referenced, and has not been updated for later product releases.)
Wise for Windows Installer 4 offers you new, more robust functionality for working with source paths. Using an improved Convert Source Path dialog and a new Path Variables page in Installation Expert, you can define a source path by a property, change a source path to a UNC name, and create source paths relative to the .MSI. This functionality lets users modify the locations of the source files easily and efficiently. It also minimizes the number of issues that arise from the source locations not being updated when another user is modifying the installation.
DEFINING A SOURCE PATH BY A PROPERTY
To define properties for source locations, use the new Path Variables page. On this page, you can create user-defined, registry, or environment variables. The registry defines the SystemFolder and ProgramFolder variables, which cannot be modified. Instead, these variables are read automatically from the registry when the .MSI or .WSI is opened.
When source paths are defined by properties, the user does not have to update the paths when the installation is modified. This is not the case with a user-defined property. Any source paths created and specified by this property type require the user to change the location to a new source path whenever the installation is changed.
To reference source path properties:
1. From the Tools menu, select Convert Source Paths. The Convert Source Paths dialog appears.
2. Select the source path, then click the Change Selected Path button. The Change Selected Path dialog box appears.
3. In the Change to field, replace the file path with the property name and enclose it in brackets. You must use brackets in order to utilize the information stored in the property. For example, if the property SystemFolder is set to C:\WINNIT\System32, enter a property of [SystemFolder].
4. Click OK.
5. Click OK to close the Convert Source Paths dialog.
CHANGING A SOURCE PATH TO A UNC NAME
The ability to change the source path to a UNC name lets users convert all mapped drives to the UNC location. Not only does this utilize the UNC location, it eliminates the need to change the source path to a mapped drive location. The UNC path also gives any user modifying the script access to the source files, which occurs once all the source files have been added to the installation.
To change a source path in your installation:
1. From the Tools menu, select the Convert Source Paths. The Convert Source Paths dialog appears.
2. Click the Change All Paths to UNC button for the paths to be converted automatically.
3. Click OK.
CREATE SOURCE PATHS RELATIVE TO THE .MSI
When you are working in the Convert Source Paths dialog, you now have the ability to create the source path relative to the .MSI. This functionality is particularly helpful for users who have files located in a directory structure relative to the .MSI.
To create source paths relative to the .MSI:
1. Save your .WSI or .MSI file.
2. From the Tools menu, select Convert Source Paths. The Convert Source Paths
3. Click the Change All Paths to Relative button to convert the relative location of
4. Click OK.
Defining, changing, and creating source paths are simple tasks when you use the Convert Source Path command and the new functionality available in the Convert Source Path dialog. You can also use the new Path Variables page to create different types of variables in your installation.