Filtering artifacts for links to other applications

When you view artifacts, collections, and modules in the Artifacts, Collections, or Modules pages, you can filter artifacts that are linked to other applications integrated in the IBM® Engineering Lifecycle Management.

Before you begin

Your project must be configured for Engineering Lifecycle Management integration and you must have links to artifacts in other applications.

About this task

You can filter and display columns for the following link types:
  • Implemented By, Tracked By, or Affected By links to development artifacts in the Change and Configuration Management application.
  • Validated By links to test artifacts in the Quality Management application.
  • References and IBM Engineering Requirements Management DOORS® Next Referenced by links to requirement artifacts in any other application.

You can display columns, but you cannot filter by the link types for the Rhapsody Model Manager application. Filtering by CLM link types in a project with Configuration Management enabled is not supported.

Procedure

  1. Open the Artifacts, Collections, or Modules page.
  2. Click the Add filter icon Add filter icon.
    • To filter artifacts based on their links to other Engineering Lifecycle Management applications, in the New Filter window, select Link type from the Choose an attribute column.
      1. In the Choose values column, select the value that corresponds to the lifecycle application that you want to filter by and click Add. See Link Types for the list of all the link types associated to Engineering Lifecycle Management applications.
      2. To specify additional filters to the Link type attribute, click the Edit icon and add conditions.

        Edit filter and add conditions example

        In this example, the filter returns all artifacts that have an Affected by link to an artifact of type Heading .

    • To filter artifacts based on the status of the linked test and development items. In the New Filter window, select Limit by lifecycle status attribute.
      Important: The Limit by lifecycle status attribute can be used for Engineering Workflow Management enabled projects only. The Limit by lifecycle status attribute was introduced in DOORS Next version 6.0.2, which allows filtering capability for Engineering Workflow Management and Engineering Test Management relationships.
      From the Choose an attribute column, select:
      • None to display artifacts with no linked work items.
      • Open or Resolved to display linked work items with those statuses.
      • All Resolved to display requirement artifacts where all associated work items are resolved.
      • Passed, Failed, Unattempted to display all test items with those statuses.
      • All Passed to display requirement artifacts where all associated test items have passed.
      • All to display all development or test items.
  3. To display artifacts based on their links to Engineering Lifecycle Management applications, click the More Actions icon More Actions iconand select Configure Columns to Display. Select the link type that corresponds to the lifecycle application that you want to filter by and click Add.
    For example, select any one of the following link type options:
    • Implemented By, Tracked By, or Affected By to display associations with development artifacts.
    • Validated By to display associations with test artifacts.
    • References and Referenced by to display associations with requirement artifacts.
    • Derives Architecture From Element, Refined By Architecture Element, Satisfied By Architecture Element, and Traced By Architecture Element to display associations with design artifacts.
    1. To organize the column display, use the Move Up and Move Down options.
    2. Use the Format option to customize the column display. You can select attributes of the artifacts and wrap or trim the link text display.
      Note: Custom attribute values are not shown for cross-server links.
  4. To remove the filters applied, click the Clear all filters icon Clear all filters icon.
  5. To expand the filters applied, click Expand filters icon Expand filters icon.
  6. To collapse the filters applied, click Collapse filters icon Collapse filters icon.
    Note: To filter OSLC link types in a module or artifacts grid, the current project needs to be associated with a project that provides specific project area links and also which cannot be Configuration Management-enabled.
    • An association that provides Implemented By ("implemented-by") project area link types, enable filtering against Implemented By and Affected By links.
    • An association that provides Tracked By ("tracked-by-cm") project area link types, enable filtering against Tracked By and Affected By links.
    • An association that provides Validated By ("validated-by") project area link types, enable filtering against Validated By links.