Adding A Rule That Calls A Custom Action - Symantec WISE PACKAGE STUDIO 8.0 - REFERENCE V1.0 Reference

Adding a Rule That Calls a Custom Action

Wise Package Studio Reference
Example: Suppose you want to check packages for hard-coded references to C:\ or D:\
and replace those references with the Windows Installer directory property INSTALLDIR.
To do this, write a VBScript to find and replace the references and then display a
message. In Package Validation, you specify a new or existing .CUB file and add a rule
that calls the VBScript. When you run Package Validation with the new rule enabled, the
VBScript performs the find and replace operations.
Errors found by a custom action rule are displayed in the View / Correct or View dialog
box only if the custom action contains a message string. When a validation test finds an
error based on a custom action rule, the Correct button on the View / Correct dialog box
is not enabled; the error is fixed based on functions in the custom action. For
information on formatting message strings, see ICE Message Guidelines in the Windows
Installer SDK Help.
For information on creating a custom action to perform validation checks, see Internal
Consistency Evaluators - ICEs and Building An ICE in the Windows Installer SDK Help.
Quality Assurance module only.
Note
When customizing a predefined validation module, customize a copy of the .CUB file to
retain the original file.
To add a rule that calls a custom action
1. Write a custom action (.DLL, .EXE, or VBScript) to perform validation checks.
2. Do one of the following:
On the Projects tab, click the Run link to the right of the task or tool associated
with Package Validation. The package associated with the current project will be
verified. This tool might skip dialog boxes or populate fields based on
command-line options defined in Process Templates Setup.
On the Tools tab, double-click Package Validation.
In Windows Installer Editor, select Tools menu > Package Validation.
3. If the Specify Target Installation File or Folder dialog box appears, select an
installation file or folder and click Next.
4. Click Customize on the Welcome dialog box.
The Customized Validation Rules dialog box appears. Validation Files lists the
predefined validation modules and any validation modules you've added. When you
select a validation module, its rules appear in Validation Rules.
5. In Validation Files, select a validation module to customize.
Note
You cannot add rules to predefined validation modules.
If the validation module you want is not listed, add it.
See Adding a Validation Module to Package Validation
Package Validation
on page 149.
151