Share this page

# Promote objects

Use the Promote operation to move objects from their current stage to another stage higher up the Global Stage Lifecycle (GSL).

Note: This functionality is not available for external requests.

In this topic:

## Overview

Promoting moves objects upwards through the Global Stage Lifecycle (GSL).

Tip: You can set up email notifications to alert users when a promotion occurs.

Promote rules:

- You must have a privilege on the stage to which you are promoting.

- Item revisions and requests in an off-normal lifecycle state cannot be promoted.

- If an associated deployment area for the project or stream has the Deploy by Default option set, the deployment occurs automatically upon promotion, and you don't need the Deploy privilege. If there are other deployment areas associated with the project or stream, you can also deploy to those areas if you have the necessary privilege.

- You can promote through more than one stage in the GSL in the same operation.

- Promotion can also take place when actioning items, requests, or baselines if the next lifecycle state has been associated with a deployment stage in the GSL. If there are any default areas associated with the project/stream for that stage, the item files are also automatically deployed to those areas.

- If you have the appropriate privileges on the source and target stages, you can bypass the promotion to all the intermediate stages. For example, you might promote from DEV straight to PRE-PROD, bypassing the SIT and QA intermediate stages.

  Note: Items are promoted to all intermediate stages so that they can be deployed manually to areas defined for those stages at a later time.

Back to top

## Promote items

Promote item revisions to move them to a higher stage in the Global Stage Lifecycle, and optionally, have the item files deployed to the associated areas.

To promote item revisions, you need the following privileges:

ITEM_PROMOTE_NEXTSTAGE | Promote an item to the next stage in the GSL.
ITEM_PROMOTE_ANYSTAGE | Promote an item to any stage in the GSL.
ITEM_DEPLOY | Deploy promoted items to a non-default area (the privilege for the area to which you want to deploy).

To promote item revisions:

1. Open the Promote wizard in your OpenText Dimensions CM client:

   Web client | In the My Current Project view or Items view, select one or more OpenText Dimensions CM item revisions. Then click Promote on the toolbar.
   Desktop client | In an Items list, select one or more items. Then select Item > Promote in the menu bar.

2. In the Promote wizard, specify the following options:

   Option | Description
   --- | ---
   Next Stage | Select the next stage to which you want to promote the items.
   Reason for Promotion | (Optional) Provide a reason for promoting these items.

3. Click Next.

4. (Optional) On the Deploy to Areas page, select the scheduling options:

   - If you want the deployments to be queued immediately, leave as soon as possible selected.

   - To schedule the deployments for a particular time, select at specified time, and then select a date and time.

   - Under Area(s) for Deployment, select the areas to which you want to deploy.

     You can select areas other than the default ones, or clear any default areas, only if you have the necessary privileges.

5. Click Next.

6. On the Summary page, review the actions to be carried out and click Finish.

Back to top

## Promote requests

Promote requests to move their related item revisions to a higher stage in the Global Stage Lifecycle, and optionally, have the related item files deployed to the associated areas. Promoting a request promotes item revisions related as In Response To the request, and optionally, any child requests.

This method of promotion enables you to group the item revisions that belong to a particular change and promote those items together.

Any refactoring changes related to the request are also deployed.

To promote requests, you need the following privileges:

REQUEST_PROMOTE_NEXTSTAGE | Promote a request to the next stage in the GSL.
REQUEST_PROMOTE_ANYSTAGE | Promote a request to any stage in the GSL.
REQUEST_DEPLOY | Deploy promoted requests to a non-default area (the privilege for the area to which you want to deploy).

To promote requests:

1. Open the Promote wizard in your OpenText Dimensions CM client:

   Web client | In the My Current Project view or Requests view, select one or more requests. Then click Promote on the toolbar.
   Desktop client | Select one or more requests. Then select Request > Promote in the menu bar.

2. In the Promote wizard, specify the following options:

   Option | Description
   --- | ---
   Promote child requests | Select this option to also promote any related child requests. This option is displayed only if you have selected a request. If this option is selected, child requests related as Dependent and related to the current project are included.
   Next Stage | Select the next stage to which you want to promote the requests.
   Reason for Promotion | (Optional) Provide a reason for promoting these requests.

3. Click Next.

4. (Optional) On the Deploy to Areas page, select the scheduling options:

   - If you want the deployments to be queued immediately, select as soon as possible.

   - To schedule the deployments for a particular time, select at specified time, and then select a date and time.

   - Under Area(s) for Deployment, select the areas to which you want to deploy.

     You can select areas other than the default ones, or clear any default areas, only if you have the necessary privileges.

5. Click Next.

6. On the Summary page, review the details and click Finish.

Back to top

## Promote baselines

Promote baselines to move their item revisions to a higher stage in the Global Stage Lifecycle, and optionally, have the item files deployed to the associated areas. This method of promotion enables you to group the item revisions that belong to a particular project/stream or design part and promote them in one operation.

Note: Refactoring changes may not be deployed. We recommend that you deploy refactoring changes using requests.

To promote baselines, you need the following privileges:

BASELINE_PROMOTE_NEXTSTAGE | Promote a baseline to the next stage in the GSL.
BASELINE_PROMOTE_ANYSTAGE | Promote a baseline to any stage in the GSL.
BASELINE_DEPLOY | Deploy promoted baselines to a non-default area (the privilege for the area to which you want to deploy).

To promote baselines:

1. Open the Promote wizard in your OpenText Dimensions CM client:

   Web client | In the My Current Project view or Baselines view, select one or more baselines. Then click Promote on the toolbar.
   Desktop client | In a content window, select one or more baselines. Then select Baseline > Promote in the menu bar. OR In the My Current Project window, expand the subprojects node, right-click a baseline, and select Promote.

2. In the Promote wizard, specify the following options:

   Option | Description
   --- | ---
   Next Stage | Select the next stage to which you want to promote the items.
   Reason for Promotion | (Optional) Provide a reason for promoting these items.

3. Click Next.

4. (Optional) On the Deploy to Areas page, select the scheduling options:

   - If you want the deployments to be queued immediately, select as soon as possible.

   - To schedule the deployments for a particular time, select at specified time, and then select a date and time.

   - Under Area(s) for Deployment, select the areas to which you want to deploy.

     You can select areas other than the default ones, or clear any default areas, only if you have the necessary privileges.

5. Click Next.

6. On the Summary page, review the details and click Finish.

Back to top

See also:

- Promote and deploy in the same operation
- Deployment privileges

https://admhelp.microfocus.com Dimensions CM 8942
Tips to improve your search results... OpenText™ Dimensions CM Help Center OpenText™ Dimensions CM Help 25.2 All View Local Help Center View Online Help Center Version: