Creating a Custom Destination Path

[#1]

Summary

Create a Custom Destination Path

Synopsis

This article applies to InstallScript projects and explains how to create a custom destination path using script-defined folders or public properties.

Discussion

DevStudio 9.x and later users

InstallScript MSI Projects

Follow these steps to create a custom destination path using public properties:

1. Open the Components view, under Organization.
2. Select a component to create a custom destination path.
3. In the Components property window, select the value for the component?s Destination property.
4. Click the drop down and select "Browse, create, or modify a directory entry?"
5. In the Browse for Directory window, select the Destination Computer.
6. Click the Insert (Ins) key and name the folder, for example My Directory.
7. Set the Directory Identifier to a public property (all capitol letters), for example MY_CUSTOM_PATH.
8. Make sure to select the new folder My Directory and then click OK.

To define the location of the public property, in the OnFirstUIBefore event handler function, after the begin statement, call the function FeatureSetTarget. For example:

FeatureSetTarget ( MEDIA , "MY_CUSTOM_PATH" , TARGETDISK ^ "customfolder" );

The third parameter of this function should be the custom destination path.

InstallScript Projects

Follow these steps to create a custom destination path using script-defined folder:

1. Open the Components view, under Organization.
2. Select a component to create a custom destination path (script-defined folder).
3. In the Components property window, select the value for the component?s Destination property.
4. Click the drop down and select "Browse, create, or modify a directory entry?"
5. In the Browse for Directory window, select Script-defined Folders.
6. Click the Insert (Ins) key and name the folder, for example <MY_CUSTOM_PATH>.
7. Make sure to select the new script-defined folder <MY_CUSTOM_PATH> and then click OK.

To define the location of the script-defined folder, in the OnFirstUIBefore event handler function, after the begin statement, call the function FeatureSetTarget. For example:

FeatureSetTarget ( MEDIA , "<MY_CUSTOM_PATH>" , TARGETDISK ^ "customfolder" );

The third parameter of this function should be the custom destination path.

Professional 7.x and 6.x users

Follow these steps to create a custom destination path using script-defined folder:

1. Open the project workspace?s File Groups pane.
2. Select a file group to create a custom destination path (script-defined folder).
3. In the File Groups property and value window, double-click the file group?s Destination property.
4. In the Destination Properties window, select Script-defined Folders.
5. Click the New Folder button and name the folder, for example <MY_CUSTOM_PATH>, then click OK.

To define the location of the script-defined folder, in the OnFirstUIBefore event handler function, after the begin statement, call the function ComponentSetTarget. For example:

ComponentSetTarget ( MEDIA , "<MY_CUSTOM_PATH>" , TARGETDISK ^ "customfolder" );

The third parameter of this function should be the custom destination path.

Additional Information

For more information, see Help Library topic FeatureSetTarget.