How do I conditionally show the "UpgradeDlg" dialog?

Answer

The feature explained in this how-to can be used only if the installation package is created by following the steps mentioned in the Upgrades page for side by side installations. Also, this can be done only in an Enterprise project.

When using side by side installation packages, you can add the "UpgradeDlg" dialog in the Dialogs page. This dialog allows the user to choose if the old versions of the installation package will be removed or the current version will be installed side by side with them.

Since the installation package can also be installed on a clean machine (there is no older version present), this dialog should be shown only if an older version of the installation package is found. For this, you can follow these steps:

• make sure that the original package has the "Allow side by side installs of different product versions" option set in the Upgrades page
• create the upgraded package by following the steps in the "Upgrades" page
• go to the "Dialogs" page and add the "UpgradeDlg" dialog between "WelcomeDlg" and "FolderDlg"
• select the Next button on the WelcomeDlg dialog and go to the Published Events tab
• double-click the "NewDialog" control event which points to "UpgradeDLg" and set the Condition field to OLDPRODUCTS
• create a "NewDialog" control event which points to "FolderDlg" and set the condition to NOT OLDPRODUCTS
• select the Back button on FolderDlg
• double-click the "NewDialog" control event which points to "UpgradeDLg" and set the Condition field to OLDPRODUCTS
• create a "NewDialog" control event which points to "WelcomeDlg" and set the condition to NOT OLDPRODUCTS
• build and run the project

The control events for the "Next" button on "WelcomeDlg" should look like this:

NewDialog      FolderDlg       AI_INSTALL AND NOT OLDPRODUCTS
NewDialog      UpgradeDlg      AI_INSTALL AND OLDPRODUCTS

The control events for the "Back" button on "FolderDlg" should look like this:

NewDialog      WelcomeDlg      AI_INSTALL AND NOT OLDPRODUCTS
NewDialog      UpgradeDlg      AI_INSTALL AND OLDPRODUCTS