Custom Action Properties Dialog Box

In the Custom Action Properties dialog box, you can define and edit custom actions, such as running a program or deploying a package, and assign these actions to certain conditions.

To define a custom action that runs a specific program:

1. Click the New Custom Action button. The Custom Action Properties dialog box opens.
2. In the Name box, type a name for the new action.
3. In the Custom Action Type list, select Run A Program.
4. In the Path box, type the path and name of the executable. You can click the Browse button to browse for the file.
5. In the And Pass This Information box, you can specify a command line that is used by the program once it is executed.

   Note:

   The And Pass This Information box is optional.

6. Select the Enable This Custom Action check box if you want this action to be enabled for this deployment project. Otherwise, clear the check box.
7. In the Trigger Type list, select one of the following types of events that triggers the action that you have just defined:
8. • New Installation—The first time that HostExplorer is installed on the end user's machine, the defined action is triggered.
   • Registry Key Exists—If the specified registry key already exists in the Windows Registry, the defined action is triggered. Specify the registry key in the Key To Check box.
   • Registry Key Does Not Exist—If the specified registry key does not exist in the Windows registry, the defined action is triggered. Specify the registry key in the Key To Check box.

     Note:

     For more information, see Naming Conventions for Windows Registry Keys.

   • Compare Registry Value—If the comparison that you specified in the Comparison Type drop-down list exists between the registry key value that you specify in the Value To Query box and the value that you specify in the Compare To box, the defined action is triggered.
8. Select Execute Before Any HostExplorer Components Install box if you want the program to execute before the HostExplorer packages are downloaded to the end user's machine. For example, you can select this box if you specified an uninstaller that is to install a previous version of HostExplorer, and you want it to do this before the current version of HostExplorer is downloaded.
9. Click OK to return to the Deployment Custom Action Information screen.

To define a custom action that deploys a package:

1. Click the New Custom Action button. The Custom Action Properties dialog box opens.
2. In the Name box, type a name for the new action.
3. In the Custom Action Type list, select Deploy A Package.
4. Next to the Package box, click the Browse button to open the Available Packages dialog box which displays the package (.dpf) files and/or assembly (.dpa) files that you made available using the previous Custom Packaging screen.
5. Select the package file or assembly file that you want to make available for deployment and click OK.
6. Select the Enable This Custom Action check box if you want this action to be enabled for this deployment project. Otherwise, clear the check box.
7. In the Trigger Type list, select the type of event that triggers the custom action. For descriptions of these event types, refer to step 7 in the previous procedure.
8. Select Execute Before Any HostExplorer Components Install box if you want the custom package to be deployed before the HostExplorer packages are downloaded to the end user's machine.
9. Click OK to return to the Deployment Custom Action Information screen.

---

Related Topics

Step 6: Assigning Custom Actions