Searching for Projects That Include Inventory Based on a Specific Component or Component Version

You can use the Project Inventory filter to search for those projects that include one or more inventory items based on a specific component or component version. The search returns a filtered list of projects; and, when a project in the list is opened, its inventory is also filtered by the search criterion.

This search method saves you time in locating specific inventory items that require attention across all projects. For example, you might also use this search method to pinpoint those projects containing inventory items affected by a recent component upgrade.

You can also use this search method to easily locate projects that contain inventory items impacted by a security vulnerability whose exact ID you do not know; you can search instead for projects with inventory based on a component and version known to be affected by the vulnerability. (This search method is an alternative to using the Security Vulnerability filter, which requires the exact vulnerability ID as the search criterion. See Searching for Projects That Include Inventory Impacted by a Specific Security Vulnerability.)

Rules When Performing this Search

When you search for projects that include inventory based on a specific component or component version, the following rules apply.

•

A full or partial string value is supported as search criterion.

•

All characters in the search string must be consecutive.

•

The string value is case-insensitive and can contain letters, numbers, hyphens, and special characters. Spaces are also allowed.

•

Only inventory items on the Project Inventory tab are supported in the search.

How to Perform this Search

Use this procedure to locate those projects that include inventory based on a specific component or component version.

To search for projects that include inventory based on a specific component or component version, do the following:

1.

Navigate to the Projects view. (See Opening the Projects View if additional instructions are needed.)

2.

At the top of the Projects pane, select Project Inventory from search dropdown list on the left.

3.

In the Enter Search Criteria field, specify the complete name or a partial string for one of the following:

•

The name of the component as it appears on the Component Details tab (for example, struts2-core) for an inventory item

•

The name of the component and version as it appears in the Inventory Name value (for example, Apache Struts 2.3.14.3)

The list of projects changes to reflect the search results, and a filtered count (for example, “(19 of 123)”) is also provided in the Projects pane header to show the number of projects returned by the search.

4.

Open one of the projects to see a filtered list of inventory items that contain the component or component and version. (See Opening a Project for details.)