Scheduling a Suite/Advanced UI Action

InstallShield 2016

Project • This information applies to Suite/Advanced UI projects.

Edition • The Advanced UI project type is available in the Professional edition of InstallShield. The Suite/Advanced UI project type is available in the Premier edition of InstallShield. For information about the differences between these two project types, see Advanced UI Projects vs. Suite/Advanced UI Projects.

Once you have added an action to your project, you can schedule when at run time you want it be launched. You can also define one or more conditions that the Suite/Advanced UI engine should evaluate before launching the action.

InstallShield has support for scheduling actions in different types of places:

•

You can schedule an action to run during one or more of the built-in events that the Suite/Advanced UI manages. For example, shortly after a Suite/Advanced UI installation is loaded, the Suite/Advanced UI engine triggers the execution of an event called OnBegin. This event specifies the instructions that need to be carried out when the OnBegin event occurs.

•

You can schedule an action to run before or after the Suite/Advanced UI engine installs, removes, modifies, or repairs a package.

•

You can associate an action with an element of the wizard interface, such as a wizard page or a control on one of the wizard pages.

For more detailed information, see Types of Events in a Suite/Advanced UI Installation.

Scheduling an Action During an Event

The events and actions that are listed under the Events explorer in the Events view are organized by chronological order, according to when they are launched at run time. When you add an action to an event, you specify when the action should be launched by adding it to the appropriate event.

To schedule an action during an event:

In the View List under Behavior and Logic, click Events.

In the Events explorer, right-click the event or action that you want your action to follow, point to Add Existing Action, and then click the name of the action that you are scheduling. InstallShield adds the action to the Events explorer.

Configure the settings in the grid on the right. One of the settings lets you build conditional statements that control whether the action is launched. For details on how to define conditions, see Building Conditional Statements in Advanced UI and Suite/Advanced UI Projects.

To indicate that an action should run only during certain modes, use the Suite/Advanced UI property ISInstallMode in a Property Comparison condition. For more information on this and other built-in properties, see Advanced UI and Suite/Advanced UI Property Reference.

Tip • The Events view supports drag-and-drop editing:

•

To sequence a new action, you can drag it from the Actions explorer to the appropriate event under the Events explorer. When you drop it, drop it onto the item that should be directly before it in the sequence.

•

To move an action to a different point in an event (or from one event to another), drag it from the old location and drop it onto the item that should be directly before it in the sequence.

•

To copy an action from one event to another, press and hold CTRL while dragging the action from one event to another event, and drop it onto the action or event that should be directly before it.

Scheduling an Action Before or After the Suite/Advanced UI Engine Installs, Removes, Modifies, or Repairs a Package

To schedule an action before or after a package is installed, removed, modified, or repaired:

In the View List under Organization, click Packages.

In the Packages explorer, click the package that you want to be associated with the action.

On the Common tab, expand the Events area if it is not already expanded.

Do one of the following:

•

To schedule an action before the package is installed, removed, modified, or repaired: In the Package Configuring setting, point to the New Action button, and then click the name of the action that you are scheduling. InstallShield adds an Action subsetting and sets its value to the name of the action that you selected.

•

To schedule an action after the package is installed, removed, modified, or repaired: In the Package Configured setting, point to the New Action button, and then click the name of the action that you are scheduling. InstallShield adds an Action subsetting and sets its value to the name of the action that you selected.

Optionally, to build a conditional statement so that you can further control when the action is launched, click the Add a condition button. For details on how to define conditions, see Building Conditional Statements in Advanced UI and Suite/Advanced UI Projects.

To indicate that an action should be run only if a specific package in the installation is running in a particular state, create a Package Operation condition.

Adding an Action to an Element in the Wizard Interface

InstallShield lets you define actions that are launched when a wizard page or secondary window is opened or closed. In addition, InstallShield lets you define actions that an end user triggers when using some of the various wizard interface controls—for example, when an end user clicks a button. To learn how to schedule an action through the wizard interface, see Configuring an Action for an Element in the Wizard Interface.

Scheduling a Suite/Advanced UI Action

InstallShield 2016 Help Library

August 2016