Managing Packages in the Life Cycle › Demote Process › 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.

Package Dependency Report

The Package Dependency Report lets you view the dependent packages of packages and provides the ability to add all the dependent packages, while executing the Promote or Demote process. Using this feature, you can ensure that you promote or demote all the dependent packages together. Thus, you can also avoid any inconsistency in the code.

To maintain consistency, promote and demote the dependent packages together because there could be dependent package for any package.

You can view the package dependency report while performing the following actions:

• Promote packages
• Demote Packages

While performing the Promote or Demote process, you can view the dependent packages details in the Dependent Package tab of the Promote or Demote dialog. Optionally, you can add all the dependent packages to the promote or demote list and promote or demote all the dependent packages together.

View, Add, and Promote Dependent Packages

Follow these steps:

1. Open SCM Explorer.
2. Connect to the broker.
3. Navigate to a state node under a project and expand the state node.
4. Expand the Packages node under the state node.
5. Right click the required package and select the appropriate promote process.
   The Promote Dialog opens.
6. Click the Dependent Packages tab to view the package dependency report.
7. Select the Show Version Details check box
8. Select a package in the Dependent Packages list to view the versions causing dependency and all others versions available in that package.
   The version details appear in the Versions Causing Dependency list and the All Other Versions list.
9. Click the Add All To Promote List button.
   All the dependent packages are added to the Promote List and the Option tab is displayed.

   Note: If the dependent packages are present in other states, appropriate message is displayed.

10. Click OK.
    All the dependent packages are promoted together with the selected package.

View, Add, and Demote Dependent Packages

Follow these steps:

1. Open SCM Explorer.
2. Connect to the broker.
3. Navigate to a state node under a project and expand the state node.
4. Expand the Packages node under the state node.
5. Right click the required package and select the appropriate demote process.
   The Demote Dialog opens.
6. Click the Dependent Packages tab to view the package dependency report.
7. Select the Show Version Details check box.
8. Select a package in the Dependent Packages list to view the versions causing dependency and all others versions available in that package.

   The version details appear in the Versions Causing Dependency list and the All Other Versions list.

9. Click the Add All To Demote List button.
   All the dependent packages are added to the Demote List and the Option tab is displayed.

   Note: If the dependent packages are present in other states, appropriate message is displayed.

10. Click OK
    All the dependent packages are demoted together with the selected package.
    

Add and Promote or Demote Dependent Packages Without Viewing Package Dependency Report

Follow these steps:

1. Open SCM Explorer.
2. Connect to the broker.
3. Navigate to a state node under a project and expand the state node.
4. Expand the Packages node under the state node.
5. Right click the required package and select the appropriate promote or demote process.
   The Promote or Demote Dialog opens.
6. Select the Add Dependent Packages check box.
   All the dependent packages are added to the Promote or Demote list.
7. Click OK.
   All the dependent packages and the selected package are promoted or demoted.