Defining Lifecycle Processes › Define a Demote Process

Define a Demote Process

The Demote Properties dialog lets you define a demote process. The setting of the options on this dialog determine the choices the user can make when executing the demote process:

• If the option is not selected on the Demote Properties dialog, the option is not selected on the Demote Process Execution dialog. The user executing the demote process can decide to select the option.
• If the option is selected on the Demote Properties dialog, the option is selected by default on the Demote Process Execution dialog. When the demote process is executed the option is enforced and the user cannot override it.

Pre-Linked processes execute before packages change states, and Post-Linked processes execute after packages change states. The failure of a Pre-Linked process generates an error and causes the demote process to fail. The state of the packages changes only after the successful completion of all Pre-Linked processes. Typically, a notify process is pre-linked to the demote process.

Follow these steps:

1. Click the Lifecycles tab of the Administrator application, and expand the state in which you want to define the process.

   The Processes folder is listed in the workspace.

2. Right-click the Processes folder, and select New, Demote Process from the shortcut menu.

   The Demote Properties dialog appears.

3. Name the process and specify a destination state.
4. Specify the options that you want to be available to users on the process execution dialog:

   Enforce Package Bind

   Enforces all the packages belonging to a bound package group be demoted together; otherwise, an error occurs.

   Verify Package Dependency

   Prevents demotion of packages upon which other packages depend. Dependency is based on versions in the current view. In the current state, a package with a lower item-version cannot be demoted without also demoting the packages with the higher item-versions in the current view. If the demote process is in a state that shares the same view as the one in the Demote To state, this option is not enforced.

   Note: The higher item-version causes a dependency error when it is on the trunk or on the branch.

   The process is defined.

5. Click Apply.

   Saves the process definition, but does not close the dialog.

6. Click the Access tab and set access for the process. Click OK.

   The demote process is added to the state and the process name appears in the Processes menu and in the title bar of the process execution dialog.