Using Packages › Demote a Package

Demote a Package

The demote process lets you move one or more packages in the current state to a previous state in the lifecycle.

Follow these steps:

1. Navigate to the package you want to demote.
2. Right-click the package, and select demote process from the shortcut menu.

   The demote process dialog appears and lists the package you selected. If a package is part of a bound package group, all packages in the group must be demoted together. To demote a package that belongs to a bound package group, you must first unbind the package.

   Note: The lowercase italic text indicates the process dialog name by the process type, since the process execution dialog names differ to each site.

3. (Optional) Click Add (the plus [+] sign) to open the Select Packages dialog from which you can select packages in the current state. Click OK.

   The packages are added to the demotion list.

4. (Optional) Select packages from the list, and click Remove (the minus [-] sign).

   The packages are removed from the demotion list.

5. (Optional) Select demotion options:

   Note: If an option is enabled by default, it is enforced and you cannot override it.

   Enforce Package Bind

   Enforces that you demote all the packages belonging to a bound package group together; otherwise, an error occurs.

   Verify Package Dependency

   Prohibits you from demoting packages that depend upon other packages. The dependency is based on versions in the view. You cannot demote a package with a lower item-version without also demoting the packages with the higher item-versions in the current view unless the higher item-versions already exist in the view of the destination state. If the demote process is in a state that shares the same view as the one in the destination 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.

   Add Dependent Packages

   Allows adding dependent packages also to the list of packages being demoted. To avoid conflict, it is recommended to demote all the dependent packages together. This option retrieves details of the dependent packages and lists the details in the Dependent Packages tab. The details include the list of dependent packages, their associated versions which made them dependent, and all other versions.

   Demotion options are specified.

6. (Optional) Click Note to view information about the process.
7. Click OK.

   The package is demoted and appears in the destination state.