dependency-track/docs
Hoobi 03bae1ed32
Add project filters to component identity search (#6085)
* Add project filters to component identity search

Adds onlyActive and onlyLatestVersion query parameters to
GET /v1/component/identity, allowing portfolio-wide component
searches to be scoped to active projects and/or projects flagged
as the latest version. Reduces noise from archived projects and
older project versions when triaging components across the
portfolio.

Closes #4570

Signed-off-by: hoobio <7289249+hoobio@users.noreply.github.com>

* Document component search project filters

Adds a short note to the Impact Analysis page describing the
"Only active projects" and "Only latest project versions" toggles
on the Components search page, and the matching onlyActive and
onlyLatestVersion query parameters on /api/v1/component/identity.

Refs #4570

Signed-off-by: hoobio <7289249+hoobio@users.noreply.github.com>

* Tighten javadoc and parameter descriptions

Trim wording in the new ComponentQueryManager overload, the new
@Parameter descriptions on /v1/component/identity, and the
Impact Analysis doc paragraph added in the previous commit.

Signed-off-by: hoobio <7289249+hoobio@users.noreply.github.com>

* Rename query params to disambiguate on /component endpoint

Per PR review: onlyActive and onlyLatestVersion read as if they
filter on component attributes when the endpoint is scoped to
components. Rename to:

- excludeInactiveProjects, mirroring the existing convention
  used by /v1/project, /v1/vulnerability, and others.
- onlyLatestProjectVersion, mirroring the existing field on
  Policy and its use in PolicyEngine.

Refs #4570

Signed-off-by: hoobio <7289249+hoobio@users.noreply.github.com>

* Update Impact Analysis doc to match toggle framing

Reflect the renamed query parameters and the toggle relabel
(Show inactive projects / Show all project versions, both on by
default) in the doc paragraph added by the previous commit.

Signed-off-by: hoobio <7289249+hoobio@users.noreply.github.com>

* Update Impact Analysis doc for renamed latest-version toggle

Track the frontend label change from "Show all project versions"
to "Show non-latest project versions".

Signed-off-by: hoobio <7289249+hoobio@users.noreply.github.com>

* Pluralize onlyLatestProjectVersions query parameter

Per PR review, the parameter takes effect across all matching
projects (one latest per name, multiple in aggregate), so the
plural form reads more accurately. Renames the corresponding
internal Java identifiers, test methods, test query strings, and
the Impact Analysis doc reference.

Signed-off-by: hoobio <7289249+hoobio@users.noreply.github.com>

---------

Signed-off-by: hoobio <7289249+hoobio@users.noreply.github.com>
2026-05-04 13:09:15 +02:00
..
_docs Add project filters to component identity search (#6085) 2026-05-04 13:09:15 +02:00
_includes Add visual anchors for headings in docs 2022-08-01 20:22:02 +02:00
_layouts Add Scarf to docs 2025-10-07 14:55:07 +02:00
_plugins Initial checkin 2018-02-08 23:16:43 -06:00
_posts Add changelog for v4.14.1 2026-04-03 19:47:06 +02:00
_sass Updating branding 2023-01-09 22:39:56 -06:00
css Updating branding 2023-01-09 22:39:56 -06:00
files Align retry configuration and behavior across analyzers 2024-02-24 22:16:46 +01:00
images docs: update screenshot to include internal component match mode selector 2025-06-19 02:00:10 +02:00
scripts Reverting some changes 2019-03-11 00:08:25 -05:00
404.md Initial checkin 2018-02-08 23:16:43 -06:00
_config.yml Fix version in docs 2026-04-03 18:44:41 +02:00
apple-touch-icon.png Updating doc icons 2020-03-23 14:59:32 -05:00
changelog.html Initial checkin 2018-02-08 23:16:43 -06:00
CNAME Create CNAME 2018-02-08 23:29:27 -06:00
favicon.ico Updating favicon.ico 2023-01-09 23:39:30 -06:00
Gemfile Downgrade jekyll to 3.9 2023-08-27 20:54:12 +02:00
index.md Fix incorrect URL for VulnDB analyzer 2026-01-27 18:31:17 +01:00
odt-odc-comparison.html Normalize capitalization of PyPI 2024-04-02 16:12:30 -04:00
robots.txt Initial checkin 2018-02-08 23:16:43 -06:00
search.html Added searching of change log entries 2019-01-10 10:35:56 -06:00
siteicon.png Initial checkin 2018-02-08 23:16:43 -06:00
touch-icon.png Updating doc icons 2020-03-23 14:59:32 -05:00