Archiving and restoring components

Archive components that you no longer use or that is obsolete. Archiving simplifies the list of components that you see and prevent team members from adding configurations of those components to global configurations. Archiving a component does not delete it. You can restore it when you need it again.

Before you begin

  • Configuration management must be enabled for the project.
  • You must be a configuration lead or have permission to archive and restore components.

About this task

You might archive components that are no longer in use that were created for temporary use only or by mistake, or whose artifacts were cloned to newer components.

When you archive a component, the system first archives all of the configurations (streams and baselines) of that component. Archived components and configurations are hidden from view in the application, though you see archived configurations when they are referenced by an active configuration. Archived configurations have a gray icon next to their name, as in this example of an archived stream: Gray icon that represents an archived stream.

You cannot edit archived components or configurations, and you cannot add archived configurations to global configurations. Archived items are not displayed in search and query results and Report Builder reports.

Procedure

  1. Open a project from the Home menu Home menu or the All Projects view: https://example.com:9443/rm/web
  2. On the toolbar, click Administration Administration menu > Manage Components and Configurations.
    The details of the component are shown.
  3. Optional: To work with a different component in the project, click the Browse Components breadcrumb link and click the component name.
  4. Complete the steps for the action that you want to take.
    • To archive components, click Archive this component so it is hidden from use Archive component icon.

      The component and its configurations are archived.

    • To restore components, complete the following steps:
      1. Click the Browse Components breadcrumb link.
      2. Click Show archived components Show archived components icon.
      3. Click the component name.
      4. Click Restore this component Restore component icon.

      The component and its configurations are now visible in the application.

What to do next

To return to the list of components, click the Browse Components breadcrumb link. To show or hide archived components, click Show archived components Show archived components icon or Hide archived components Hide archived components icon.

To resume work in the current project, click Artifacts on the toolbar. Check that the Current Project Component and Current Configuration menus on the toolbar are set to the component and configuration that you want to work in.

To resume work in another project, select it from the Home menu Home menu or the All Projects view.