dependency-track/docs/_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
..
administration Fix typo 2026-03-06 12:48:46 +01:00
analysis-types documentation 2023-12-02 18:56:13 +01:00
datasources Update OSS Index documentation 2026-02-03 12:30:54 +01:00
getting-started Fix runtime-only configuration documentation 2026-01-26 11:14:44 -05:00
integrations Bump FPF version to 1.3 2026-03-09 15:39:32 +01:00
triage Update changelog, update documentation 2022-02-05 22:13:51 +01:00
usage Add project filters to component identity search (#6085) 2026-05-04 13:09:15 +02:00
_defaults.md Initial checkin 2018-02-08 23:16:43 -06:00
best-practices.md Fix missing parenthesis in documentation 2024-09-26 14:12:39 +02:00
FAQ.md Fix borked docs navigation 2026-04-21 13:17:41 +02:00
terminology.md Update terminology.md 2024-01-02 08:56:35 -05:00