Windows Installer Editor Reference
482
Custom Action Reference
it in the Execute Deferred sequence, you must hard-code the destination and source
paths.
See
Guidelines for Custom Action Location
on page 454 and Formatted in the
Windows Installer SDK Help.
z
Because of Windows Installer limitations, to display progress bar text to the user,
you must place the action in the Execute Deferred sequence.
z
To give end users control over whether to post data to your HTTP server, put this
custom action in a conditional block. Set the conditional block so that it only posts
data if the end user has agreed to this posting. Example: Add a check box the user
marks to accept posting of data. Associate the check box with a property and set up
the conditional block to run if the property is true.
To create a condition, use an If Statement.
See
If Statement
on page 477.
Usage
Double-click the custom action and complete the dialog box:
z
Destination URL
The URL of the CGI program or ASP page that will accept the posted data.
z
Text to Post
The text to post should be one or more lines in the format field=data, where field is
the name of the field expected by the Web application, and data is the data to
populate the field. If a line does not appear to contain a field name followed by =, it
is assumed to be a continuation of the previous line, and the data on the two lines is
concatenated and sent with a single field identifier. For information on using
formatted text, see the tips above.
z
Error Handling
Determines how errors in the posting operation are handled.
Ignore Errors
The script continues regardless of any errors.
Abort Installation
The installation stops if the posting operation cannot be completed.
z
Progress Bar Text
Enter text to display in the progress bar while data is posted to the server. This
action must be placed in the Execute Deferred sequence for progress bar text to
work.
See also:
Download File From Internet
on page 473
Launch Web Page
on page 480
Guidelines for Custom Action Conditions
on page 455
Remark
The Remark action lets you put comments in sequences to document what is happening
in the script.
In Remark, type the comment. To place a blank line in the sequence, add a Remark
action, but leave Remark blank.
