Rolling Back the Current View Configuration

By default, a view has a current configuration – that is, it displays the latest revisions of the items in the project. However, you can roll back a view to a past state based on a label, promotion state, or a point in time. Note that rolling back a view in this way configures it for the current user only.

Rolling Back View Configuration Overview

When you roll back a view, this action prevents it from changing, until you select Current Configuration or close the project, which automatically changes the view to Current. You cannot check in files, update change requests, and so on in a rolled-back view because you cannot change the past.

When you configure a view, you can base it on a promotion state. Whether the state is assigned to Current or to a specific view label, any view configured to a promotion state is read-only. This read-only status can create problems for a user who needs to, for example, both look at files as they existed earlier and create new change requests. Because CRs can only be added to a current configuration, the user may need to have two windows open for the view: one configured to a point in the past and one set to the current configuration.

Rolling Back a Current View

To roll back a current view, do the following:

  1. Choose View > Select Configuration.

    The Select A View Configuration dialog box opens.

  2. Select a view configuration option:

    Labeled Configuration

    All the items in the new view will have had the specified label in the parent view. In all cases, the revision of the item to which the label was attached is the tip revision in the new view. This option is disabled if the parent view has no view labels. Changes to the parent view do not affect the new view, including changes to the label upon which the view is based. Unless an item is set toBranch on change in the new view, it will be read-only and you cannot change it.

    Promotion State Configuration

    All the items in the new view will have been part of the specified promotion state in the parent view. In all cases, the revision of the item that was part of the promotion state is the tip revision in the new view. This option is disabled if the parent view has no promotion states defined for it. Changes to the parent view will not affect the new view, including changes to the promotion state or its assigned label. Unless a specific item is set to Branch on change in the new reference view, it will be read-only and you cannot change it.

    Configuration As Of

    The new view will contain only the items that existed at the date and time you specify. In all cases, the tip revision of each item in the new view is the revision closest to, but before, the specified time. Changes to the parent view will not affect the new view. Unless a specific item is set to Branch on change in the new view, it will be read-only and you cannot change it.
  3. Click OK.

Back to top

Returning to the Current Configuration

To return to the current configuration, do the following:

  1. Choose View > Select Configuration.

    The Select A View Configuration dialog box opens.

  2. Select Current Configuration

  3. Click OK.

Back to top

Basing a View Configuration on a Promotion State

To base a view configuration on a promotion state, do the following:

  1. Choose View > Select Configuration.

    The Select A View Configuration dialog box opens.

  2. Select Promotion State Configuration.

  3. Select a state from the list.

    Configuring a view to a promotion state maintains the dynamic nature of the promotion state. If the promotion state view label changes, the view is configured to the new view label on the next refresh. The promotion state name appears on the status bar. If you exit the view and return, you return to the current configuration.

  4. Click OK.

Back to top