A snapshot is initially associated with the workspace or
stream from which it was created. You can establish a relationship
between the snapshot and another stream by promoting the snapshot.
You can also delete a snapshot, which removes the association between
a snapshot and a stream but preserves the snapshot in the repository.
About this task
Promoting or deleting a snapshot creates or breaks an
association between the snapshot and another repository object such
as a stream or workspace. In a typical use case, a snapshot created
by a build is promoted to a distinguished stream, such as an integration
stream or one that will become the basis for a release.
- To promote a snapshot:
- In the Team Artifacts view, navigate
to the stream that includes the snapshot.
- Right-click the stream and click Show Snapshots.
- In the Search Results view, right
click the snapshot that you want to promote and click Promote.
- In the Select a Stream or Workspace window,
choose the stream or workspace to which you want to promote the snapshot. If the stream or workspace is not displayed, you can enter a
text string that will be used to search for a stream or workspace
whose name matches all or part of the text string. If you are not
sure of the name of the stream or workspace but know the name of its
owner, you can enter the owner's name to see a list of streams or
workspaces associated with that owner.
- Click OK to promote the snapshot
to the selected stream or workspace.
- To delete a snapshot:
- In the Team Artifacts view, navigate
to the stream that includes the snapshot.
- Right-click the stream and click Show Snapshots.
- In the Search Results view, right
click the snapshot that you want to delete and click Delete.
- Click OK to confirm the deletion. The association between the stream and the snapshot is broken,
but the snapshot remains in the repository. You can search for it
using Rational Team Concert™ source
control search.
For more information, see Searching for repository objects.
What to do next
Note: You can use the same procedures to promote or delete
a snapshot associated with a workspace. Search for snapshots associated
with workspaces in the Pending Changes view.