Archiving and restoring components in the QM application

Archive components that you no longer use or that are obsolete to simplify the list of components that you see. You can also archive components to 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

  • A Quality Management (QM) project area administrator must enable configuration management for the project.
  • You must have permission to delete and restore components.
Important: If a component contains classified or proprietary data that should not be shared with a wider audience, delete that data by scrubbing the component. See the related topic.

About this task

Remember:
  • In the QM application (except for the Trash view), you archive items by using the Delete task. You can restore them from the trash later if you need them again.
  • You cannot permanently delete components, streams, and baselines because artifacts reference these items. Removing the references would cause unexpected results.

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 archives all of the configurations of that component.

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

Procedure

  1. Open a project from the All Projects view: https://example.com:9443/qm/web
  2. Complete the steps for the action you want to take.
    • To archive components:
      1. On the toolbar, click Administration Administration menu > Manage Components and Configurations.

        The Components page shows the list of components for the project you are working in.

      2. From the Actions menu beside a component name, choose Delete Component.

      The component and its configurations are archived. The archived streams and baselines are still shown in the version tree so that you can see the full version history, but the configuration is annotated as archived.

    • To restore components:
      1. Click Administration Administration menu > View Trash
      2. From the View menu, select Component. The list of archived components is shown.
      3. From the Actions menu beside a component name, choose Restore Component.

      The system restores the component and all its configurations, and you can now see the component and its configurations in the application. To see the restored items, you might need to refresh the application page that you work on.

What to do next

To return to the list of components, click Administration Administration menu > Manage Components and Configurations.

To resume work in the current project, select a component and configuration from the Current Project Component and Current Configuration menus on the toolbar.

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


video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki