HOWTO Abort an Install ConditionallyDocument ID: IR02035
The information in this article applies to:
- Setup Factory 6.0
This article describes how to abort an installation conditionally in Setup Factory 6.0.
It is always a good development practice to safeguard your install against as many potential failures as possible by forcing the user to abort the install if certain conditions are not met. In the end this will result in less frustration for the end users and the developers supporting the install.
Setup Factory 6.0 contains a series of pre-made screens all of which can be found in the Screen Gallery. You can get to the Screen Gallery dialog by first bringing up the Screens dialog via the menu under: Design | Screens, and then pressing the Add button. One of the pre-made screens is the Abort Install screen. This is the screen that you will use to abort the install if certain conditions are not met.
To add the Abort Install screen to your screen list, double-click it, or select it and press the Ok button.
Note: If you are performing compatibility checks (i.e. Does the user have administrative privileges?) it is a good idea to place the Abort Install either first or second, in your "Before Installing" screens list.
Once you have the Abort Screen in your screen list, and positioned properly, double-click on it to view it's properties. On the Settings tab you will see a section labeled Screen Condition. A screen condition is simply a conditional expression that determines whether a screen will be hidden or displayed at run time. If the expression is blank, or evaluates to a true result, the screen will be shown. If the expression evaluates to a false result, the screen will not be shown.
You can type an expression directly into the Screen Condition field, or you can press the Build button to build the expression with the help of the Build Expression dialog.
In the case of the Abort Install screen, if it is displayed during the install it will abort once the end user presses the Close button.
Once you have entered your screen condition you will have to edit the text that will be displayed on the screen. Edit the text on the Custom tab in the Text field. You should usually tell the user why the installation is being aborted, and what they can do about it. It might also be a good idea to include a technical support e-mail address or phone number they can use.
Here is a list of common situations when you might want to abort your installation, and what the screen condition to accomplish this might look like.
|User does not have Administrative permissions.||(!%IsUserNTAdmin%)|
|The user is on an incorrect operating system (e.g. Windows 95)||(%IsWindows95)|
|The user does not have a specific amount of RAM (e.g. 128)||(%SystemRAM% < 128)|
|The user is attempting to run the installation on a date later than allowed (e.g. The setup has expired)||(%JulianDate% > 2453006)|
Note: In the last example you would have to replace 2453006 with the Julian date that you wanted your setup to expire on.
For more information please see the following topics in the Setup Factory 6.0 help file.
KEYWORDS: Setup Factory 6.0, Abort, Screen Condition, Condition
Last reviewed: February 20, 2003
Copyright © 2003 Indigo Rose Corporation. All rights reserved.