From 974756c8e1043694dabd25aeb0aabc79386b2d4c Mon Sep 17 00:00:00 2001 From: Emma Van Der Heide Date: Thu, 1 Oct 2026 18:20:45 -0400 Subject: [PATCH 1/7] [SC-18631] Document segment scopes and Artifact Segments Adds a Manage artifact segments page (Settings > Artifacts > Artifact Segments: shared-field conditions, lifecycle, the Artifacts listing scope, the Segment filter rule and the Artifact Segments analytics datasets) and registers it in the sidebar and the Managing validation listing. Extends Manage inventory segments with the new inventory scope selector (Inventory Record Types / Segments), shared-field columns, saved views per segment and the limits of segment scope. Points the artifact filtering page at segments. Co-Authored-By: Claude Fable 5.1 --- site/guide/_sidebar.yaml | 1 + .../inventory/manage-inventory-segments.qmd | 17 +- .../validation/manage-artifact-segments.qmd | 183 ++++++++++++++++++ site/guide/validation/managing-validation.qmd | 1 + .../validation/view-filter-artifacts.qmd | 4 +- 5 files changed, 204 insertions(+), 2 deletions(-) create mode 100644 site/guide/validation/manage-artifact-segments.qmd diff --git a/site/guide/_sidebar.yaml b/site/guide/_sidebar.yaml index 28b811a4e0..821e1d0c45 100644 --- a/site/guide/_sidebar.yaml +++ b/site/guide/_sidebar.yaml @@ -153,6 +153,7 @@ website: - guide/validation/manage-artifact-types.qmd - guide/validation/manage-artifact-severities.qmd - guide/validation/manage-artifact-fields.qmd + - guide/validation/manage-artifact-segments.qmd - file: guide/validation/preparing-validation-reports.qmd contents: - guide/validation/review-documentation.qmd diff --git a/site/guide/inventory/manage-inventory-segments.qmd b/site/guide/inventory/manage-inventory-segments.qmd index fb03576f83..57002398d2 100644 --- a/site/guide/inventory/manage-inventory-segments.qmd +++ b/site/guide/inventory/manage-inventory-segments.qmd @@ -27,6 +27,7 @@ Save a set of inventory filters as a named, reusable segment that spans every in - A segment spans every inventory record type in your organization. Record types added later are automatically in scope, so a segment never needs to be updated when your inventory grows. - Matching records are evaluated live — a segment always reflects the current state of your inventory, and users only see the matching records they have permission to view. - A segment starts as a personal [Draft]{.bubble}. Publishing it makes it available to your entire organization. +- A published segment can be opened as the scope of the Inventory page, applied as a filter rule within a record type, and used as an analytics dataset. ::: {.callout title="Note that segments differ from saved views and grouping."} - **Segments** — Named filters managed by administrators in the organization settings, reusable by everyone once published. @@ -135,9 +136,23 @@ Archiving and deletion of segments are permanent. - **Archive Segment** — Permanently retires the segment. An archived segment cannot be edited, published, or restored. Click **Yes, Archive Segment** to confirm. - [**Delete Segment**]{.red} — Permanently deletes the segment. The inventory records it matched are not affected. Click **Yes, Delete Segment** to confirm. +## View a segment as the inventory scope + +Once a segment is published, anyone in your organization can open it as the scope of the Inventory page and work with every matching record across inventory record types: + +1. In the left sidebar, click **{{< fa cubes >}} Inventory**. + +2. Click the page title to open the scope selector. Options are grouped under **Inventory Record Types** and **Segments**. + +3. Select a segment. + + The listing shows every matching record you have permission to view, across all record types, with the fields shared by every record type as columns plus an **Inventory Record Type** column. Filter and Group By offer those shared fields and Inventory Record Type; search, sorting, and CSV export work as usual, and the export includes the Inventory Record Type column. + +In segment scope, Manage Columns, Register, and bulk editing are not available because columns, stages, and stakeholder roles differ by record type. You can still save views: a view saved while a segment is selected is scoped to that segment and listed separately from the views of each record type.[^3] The Inventory page remembers your last selected scope. + ## Apply segments as inventory filters -Once a segment is published, anyone in your organization can filter the inventory by it: +Within a single record type's listing, a published segment can also be used as a filter rule: 1. In the left sidebar, click **{{< fa cubes >}} Inventory**. diff --git a/site/guide/validation/manage-artifact-segments.qmd b/site/guide/validation/manage-artifact-segments.qmd new file mode 100644 index 0000000000..93012ce20f --- /dev/null +++ b/site/guide/validation/manage-artifact-segments.qmd @@ -0,0 +1,183 @@ +--- +# Copyright © 2023-2026 ValidMind Inc. All rights reserved. +# Refer to the LICENSE file in the root of this repository for details. +# SPDX-License-Identifier: AGPL-3.0 AND ValidMind Commercial +title: "Manage artifact segments" +date: last-modified +--- + +Save a set of artifact filters as a named, reusable segment that spans every artifact type, then publish the segment so everyone in your organization can view, filter, and analyze the matching artifacts together. + +::: {.attn} + +## Prerequisites + +- [x] {{< var link.login >}} +- [x] There are artifacts logged on records in your inventory.[^1] +- [x] You are a [{{< fa hand >}} Customer Admin]{.bubble} or assigned another role with sufficient permissions to perform the tasks in this guide.[^2] + +::: + +## Key concepts + +*Artifact segments* are named, reusable filters over your artifacts, built the same way as inventory segments:[^3] + +- A segment spans every artifact type in your organization, including validation issues. Artifact Type is available as a condition, so you can scope a segment to specific types. +- Segment conditions use the fields that every artifact type shares. Severity, Assignee, Risk Area, and Due Date count as shared fields only while every active artifact type has them switched on.[^4] If an artifact type is added or reconfigured later so that a saved segment no longer fits the shared fields, the segment is refused with a message wherever it is used until its conditions are updated. +- Matching artifacts are evaluated live. A segment always reflects the current state of your artifacts, and users only see the matching artifacts they have permission to view. +- A segment starts as a personal [Draft]{.bubble}. Publishing it makes it available to your entire organization. + +## Add segments + +::: {.callout} +By default, only the [{{< fa hand >}} Customer Admin]{.bubble} role can add artifact segments. To let other roles add segments, grant the Add Artifact Segment permission to those roles.[^2] +::: + +1. In the left sidebar, click **{{< fa gear >}} Settings**. + +2. Under {{< fa expand >}} Artifacts, select **Artifact Segments**. + +3. Click **{{< fa plus >}} Add Segment**. + +4. On the dialog that opens, enter the **Segment Name** and an optional **Description**. + +5. Click **Add Segment**. + + The detail page for your new segment opens, where you define the segment conditions. + +### Define segment conditions + +1. On your segment's detail page, click **{{< fa filter >}} Filter**. + +2. Enter the conditions that artifacts must match to belong to the segment: + + - Artifact Type is available as a condition, so you can scope a segment to specific artifact types. + - Only the fields shared by every artifact type are offered. A segment cannot reference another segment. + +::: {.callout-button .pl4 .nt2} +::: {.callout collapse="true" appearance="minimal"} +### How do I create effective filters? + +{{< include /guide/shared/_work-with-filters.qmd >}} +::: +::: + +3. Click **Apply Filters**. + + Your conditions appear as chips, and the list of matching artifacts updates live along with the matching artifact count. + +4. In the page header, click **Save Changes** to save the conditions to the segment, or **Cancel** to discard your edits. + +::: {.callout-important title="Saving conditions to a published segment changes its results for everyone."} +A published segment is evaluated live wherever it is used, including the Artifacts listing, artifact filters, and analytics datasets. When you save condition changes to a published segment, confirm the change when prompted. +::: + +## Publish segments + +Publishing makes a segment available to everyone in your organization. You can continue editing a segment after it is published. + +1. In the left sidebar, click **{{< fa gear >}} Settings**. + +2. Under {{< fa expand >}} Artifacts, select **Artifact Segments**. + +3. On the actions menu for your segment, click **Publish Segment**. + +4. Confirm the publication. + +Each segment shows one of the following statuses: + +| Status | Description | +|--------|-------------| +| [Draft]{.bubble} | Personal to you, visible only to you and not yet offered where segments are used. | +| [Published]{.bubble} | Available to everyone in your organization. | +| [Archived]{.bubble} | Permanently retired. An archived segment cannot be edited, published, or restored. | + +: Artifact segment statuses {.hover} + +::: {.callout title="Note that your organization starts with an example segment."} +Every organization includes an All Artifacts segment managed by {{< var vm.product >}}. +::: + +## Edit segments + +To rename a segment or update its description: + +1. In the left sidebar, click **{{< fa gear >}} Settings**. + +2. Under {{< fa expand >}} Artifacts, select **Artifact Segments**. + +3. On the actions menu for your segment, click **Edit Segment**. + +4. Update the **Segment Name** or **Description**, then click **Save Changes**. + +To edit the conditions of a segment, open the segment and update its filters.[^5] To see the artifacts a segment currently matches, select **View Matching Artifacts** on its actions menu. + +## Unpublish, archive, or delete segments + +::: {.callout-important} +Archiving and deletion of segments are permanent. +::: + +1. In the left sidebar, click **{{< fa gear >}} Settings**. + +2. Under {{< fa expand >}} Artifacts, select **Artifact Segments**. + +3. On the actions menu for your segment, click one of: + + - **Unpublish Segment** — Returns the segment to a personal draft. The segment is no longer offered where segments are used. + - **Archive Segment** — Permanently retires the segment. An archived segment cannot be edited, published, or restored. + - [**Delete Segment**]{.red} — Permanently deletes the segment. The artifacts it matched are not affected. + +## View a segment as the Artifacts scope + +Once a segment is published, anyone in your organization can open it as the scope of the Artifacts listing and work with every matching artifact across artifact types: + +1. In the left sidebar, click **{{< fa border-all >}} Artifacts**. + +2. Click the page title to open the scope selector. Options are grouped under **Artifact Type** and **Segments**. + +3. Select a segment. + + The listing shows every matching artifact you have permission to view, across all artifact types, with the shared fields as columns plus an **Artifact Type** column. Filter, Group By (including by Artifact Type), sorting, and CSV export are available on the shared fields. + +Switching between an artifact type and a segment resets the filters, sorting, and grouping, and the listing remembers your last selected scope. Saved views are not available in segment scope. If a segment you open is no longer available to you, for example because it was unpublished or deleted, the listing tells you so and returns to the artifact type view. + +## Apply segments as artifact filters + +Within a single artifact type's listing, a published segment can also be used as a filter rule: + +1. In the left sidebar, click **{{< fa triangle-exclamation >}} Validation Issues** or **{{< fa border-all >}} Artifacts**, and select the artifact type to filter. + +2. Click **{{< fa filter >}} Filter**. + +3. Click **{{< fa plus >}} Add Rule**, then select **Segment** from the field selector. + +4. Select one or more segments to filter by, and combine the rule with other conditions as needed.[^6] + +5. Click **Apply Filters**. + +## Use segments in analytics + +Published artifact segments are available as datasets for visualization widgets on your analytics pages, listed under Artifact Segments in the dataset selector.[^7] A widget built on a segment can be grouped by Artifact Type, and clicking a chart section opens the Artifacts listing in that segment's scope with the matching artifacts. + +## What's next + +- [Working with artifacts](working-with-artifacts.qmd) +- [View and filter artifacts](view-filter-artifacts.qmd) +- [Manage inventory segments](/guide/inventory/manage-inventory-segments.qmd) + + + +[^1]: [Working with artifacts](working-with-artifacts.qmd) + +[^2]: [Manage permissions](/guide/configuration/manage-permissions.qmd) + +[^3]: [Manage inventory segments](/guide/inventory/manage-inventory-segments.qmd) + +[^4]: [Manage artifact types](manage-artifact-types.qmd) + +[^5]: [Define segment conditions](#define-segment-conditions) + +[^6]: [View and filter artifacts](view-filter-artifacts.qmd#filter-and-sort-artifacts) + +[^7]: [Working with analytics](/guide/reporting/working-with-analytics.qmd) diff --git a/site/guide/validation/managing-validation.qmd b/site/guide/validation/managing-validation.qmd index 1c5e1c857f..d0a66a53cc 100644 --- a/site/guide/validation/managing-validation.qmd +++ b/site/guide/validation/managing-validation.qmd @@ -24,6 +24,7 @@ listing: - manage-artifact-types.qmd - manage-artifact-severities.qmd - manage-artifact-fields.qmd + - manage-artifact-segments.qmd aliases: - /guide/model-validation/managing-model-validation.html --- diff --git a/site/guide/validation/view-filter-artifacts.qmd b/site/guide/validation/view-filter-artifacts.qmd index 860d09d96e..0e5871f737 100644 --- a/site/guide/validation/view-filter-artifacts.qmd +++ b/site/guide/validation/view-filter-artifacts.qmd @@ -87,7 +87,7 @@ c. Click on any artifact for more information. - By default, artifacts for all records are listed by creation date in descending order. - To sort artifacts by a column in ascending ({{< fa angle-down >}}) or descending ({{< fa angle-up >}}) order, click on the column header. -To narrow down artifacts, you can apply some filters: +To narrow down artifacts, you can apply some filters. Published artifact segments, named reusable filters managed by your organization's administrators, can also be applied as a **Segment** filter rule within an artifact type, or opened as the scope of the Artifacts listing to view matching artifacts across all artifact types.[^artifact-segments] ::: {.panel-tabset} @@ -184,3 +184,5 @@ If the grouped field can no longer be grouped by — for example, because the fi [^9]: [Manage artifact types](/guide/validation/manage-artifact-types.qmd) [^10]: [Manage custom artifact views](customize-artifact-layouts.qmd#manage-custom-artifact-views) + +[^artifact-segments]: [Manage artifact segments](manage-artifact-segments.qmd) From 1f17262ed4c3052303f77c6c214249615bd38690 Mon Sep 17 00:00:00 2001 From: Emma Van Der Heide Date: Thu, 1 Oct 2026 18:21:35 -0400 Subject: [PATCH 2/7] [SC-18631] List the Artifact Segments analytics datasets Co-Authored-By: Claude Fable 5.1 --- site/guide/reporting/_create-a-visualization.qmd | 2 ++ 1 file changed, 2 insertions(+) diff --git a/site/guide/reporting/_create-a-visualization.qmd b/site/guide/reporting/_create-a-visualization.qmd index 9b67497316..f21095e9d1 100644 --- a/site/guide/reporting/_create-a-visualization.qmd +++ b/site/guide/reporting/_create-a-visualization.qmd @@ -29,6 +29,7 @@ a. Select a **Dataset**: - **Artifact Statuses Durations** — Days each artifact has spent in each status, across all artifact types, with `Artifact Type` as a column so you can compare or filter by type.^[[Manage artifact types](/guide/validation/manage-artifact-types.qmd)] - **Inventory Record - Dependencies** — One row per dependency between two inventory records, with the related record's ID and the dependency direction.^[[Configure record interdependencies](/guide/inventory/configure-record-interdependencies.qmd)] - **Inventory Segments - {Segment}** — Inventory records matching a published segment.^[[Manage inventory segments](/guide/inventory/manage-inventory-segments.qmd)] + - **Artifact Segments - {Segment}** — Artifacts across all artifact types matching a published segment.^[[Manage artifact segments](/guide/validation/manage-artifact-segments.qmd)] The two duration datasets return one row per record and stage, or per artifact and status, with a `Total Duration (Days)` measure you can average, sum, or take the minimum or maximum of. Time is counted in whole calendar days, the current stage or status is counted up to today, and repeat visits to the same stage or status are added together.^[Artifact status history is built from each artifact's activity log. Status changes made before per-field activity logging was introduced are counted toward the earliest status on record for that artifact.] @@ -57,6 +58,7 @@ a. Select a **Dataset**: - **Artifact Statuses Durations** — Days each artifact has spent in each status, across all [artifact types](/guide/validation/manage-artifact-types.qmd){target="_blank"}, with `Artifact Type` as a column so you can compare or filter by type. - **[Inventory Record - Dependencies](/guide/inventory/configure-record-interdependencies.qmd){target="_blank"}** — One row per dependency between two inventory records, with the related record's ID and the dependency direction. - **[Inventory Segments](/guide/inventory/manage-inventory-segments.qmd){target="_blank"} - {Segment}** — Inventory records matching a published segment. + - **[Artifact Segments](/guide/validation/manage-artifact-segments.qmd){target="_blank"} - {Segment}** — Artifacts across all artifact types matching a published segment. a. Select the [visualization configuration options](/guide/reporting/manage-custom-reports.qmd#visualization-configuration-options){target="_blank"} to apply to the dataset. From a3504e4cd5ca747bafcdd52bade73eb67c3b7b38 Mon Sep 17 00:00:00 2001 From: Emma Van Der Heide Date: Thu, 1 Oct 2026 18:27:27 -0400 Subject: [PATCH 3/7] [SC-18631] Match the artifact segments page to the inventory segments level of detail Names the Add New Segment and Edit Segment Conditions dialogs and every confirmation button, describes the All Artifacts example segment, and adds the segments vs saved views vs grouping callout. Co-Authored-By: Claude Fable 5.1 --- .../validation/manage-artifact-segments.qmd | 28 +++++++++++++------ 1 file changed, 19 insertions(+), 9 deletions(-) diff --git a/site/guide/validation/manage-artifact-segments.qmd b/site/guide/validation/manage-artifact-segments.qmd index 93012ce20f..9efb409934 100644 --- a/site/guide/validation/manage-artifact-segments.qmd +++ b/site/guide/validation/manage-artifact-segments.qmd @@ -27,6 +27,12 @@ Save a set of artifact filters as a named, reusable segment that spans every art - Matching artifacts are evaluated live. A segment always reflects the current state of your artifacts, and users only see the matching artifacts they have permission to view. - A segment starts as a personal [Draft]{.bubble}. Publishing it makes it available to your entire organization. +::: {.callout title="Note that segments differ from saved views and grouping."} +- **Segments** — Named filters managed by administrators in the organization settings, reusable by everyone once published. +- **Saved views** — Personal or shared table configurations that capture the columns, filters, sorting, and grouping applied to an artifact listing.[^8] +- **Grouping** — A listing layout option that organizes a table view into collapsible sections by field.[^9] +::: + ## Add segments ::: {.callout} @@ -39,7 +45,7 @@ By default, only the [{{< fa hand >}} Customer Admin]{.bubble} role can add arti 3. Click **{{< fa plus >}} Add Segment**. -4. On the dialog that opens, enter the **Segment Name** and an optional **Description**. +4. On the Add New Segment dialog that opens, enter the **Segment Name** and an optional **Description**. 5. Click **Add Segment**. @@ -49,7 +55,7 @@ By default, only the [{{< fa hand >}} Customer Admin]{.bubble} role can add arti 1. On your segment's detail page, click **{{< fa filter >}} Filter**. -2. Enter the conditions that artifacts must match to belong to the segment: +2. On the Edit Segment Conditions dialog that opens, enter the conditions that artifacts must match to belong to the segment: - Artifact Type is available as a condition, so you can scope a segment to specific artifact types. - Only the fields shared by every artifact type are offered. A segment cannot reference another segment. @@ -64,12 +70,12 @@ By default, only the [{{< fa hand >}} Customer Admin]{.bubble} role can add arti 3. Click **Apply Filters**. - Your conditions appear as chips, and the list of matching artifacts updates live along with the matching artifact count. + Your conditions appear as chips next to Filtered by, and the list of matching artifacts updates live along with the matching artifact count. 4. In the page header, click **Save Changes** to save the conditions to the segment, or **Cancel** to discard your edits. ::: {.callout-important title="Saving conditions to a published segment changes its results for everyone."} -A published segment is evaluated live wherever it is used, including the Artifacts listing, artifact filters, and analytics datasets. When you save condition changes to a published segment, confirm the change when prompted. +A published segment is evaluated live wherever it is used, including the Artifacts listing, artifact filters, and analytics datasets. When you save condition changes to a published segment, confirm the change by clicking **Yes, Save Changes**. ::: ## Publish segments @@ -82,7 +88,7 @@ Publishing makes a segment available to everyone in your organization. You can c 3. On the actions menu for your segment, click **Publish Segment**. -4. Confirm the publication. +4. Click **Publish Segment** to confirm. Each segment shows one of the following statuses: @@ -95,7 +101,7 @@ Each segment shows one of the following statuses: : Artifact segment statuses {.hover} ::: {.callout title="Note that your organization starts with an example segment."} -Every organization includes an All Artifacts segment managed by {{< var vm.product >}}. +Every organization includes an All Artifacts segment with no conditions, so it matches every artifact you can see across every artifact type. Edit it to narrow it down, or delete it if you do not need it. ::: ## Edit segments @@ -124,9 +130,9 @@ Archiving and deletion of segments are permanent. 3. On the actions menu for your segment, click one of: - - **Unpublish Segment** — Returns the segment to a personal draft. The segment is no longer offered where segments are used. - - **Archive Segment** — Permanently retires the segment. An archived segment cannot be edited, published, or restored. - - [**Delete Segment**]{.red} — Permanently deletes the segment. The artifacts it matched are not affected. + - **Unpublish Segment** — Returns the segment to a personal draft. The segment is no longer offered where segments are used. Click **Yes, Unpublish Segment** to confirm. + - **Archive Segment** — Permanently retires the segment. An archived segment cannot be edited, published, or restored. Click **Yes, Archive Segment** to confirm. + - [**Delete Segment**]{.red} — Permanently deletes the segment. The artifacts it matched are not affected. Click **Yes, Delete Segment** to confirm. ## View a segment as the Artifacts scope @@ -181,3 +187,7 @@ Published artifact segments are available as datasets for visualization widgets [^6]: [View and filter artifacts](view-filter-artifacts.qmd#filter-and-sort-artifacts) [^7]: [Working with analytics](/guide/reporting/working-with-analytics.qmd) + +[^8]: [Manage custom artifact views](customize-artifact-layouts.qmd#manage-custom-artifact-views) + +[^9]: [View and filter artifacts](view-filter-artifacts.qmd#group-artifacts) From ee37d09a5f8cebe43b66483ef4104784dde75cef Mon Sep 17 00:00:00 2001 From: Emma Van Der Heide Date: Thu, 1 Oct 2026 18:31:21 -0400 Subject: [PATCH 4/7] [SC-18631] Render the artifact field groups in the segments filter guidance Sets includes.artifacts on Manage artifact segments so the shared filters include lists artifact field groups, and adds the inventory record fields and artifact segment groups to that include's artifact block. Co-Authored-By: Claude Fable 5.1 --- site/guide/shared/_work-with-filters.qmd | 2 ++ site/guide/validation/manage-artifact-segments.qmd | 4 +++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/site/guide/shared/_work-with-filters.qmd b/site/guide/shared/_work-with-filters.qmd index 72d58cf76d..256cc53313 100644 --- a/site/guide/shared/_work-with-filters.qmd +++ b/site/guide/shared/_work-with-filters.qmd @@ -53,6 +53,8 @@ Value editor - **[artifact information]{.smallcaps}** — One of the artifact fields always created by {{< var vm.product >}}, such as the Business Unit. - **[assignees]{.smallcaps}** — User assigned to the Validation Issue type artifact. - **[artifact fields]{.smallcaps}** — One of the organization-specific artifact fields you added for your own use. +- **[inventory record fields]{.smallcaps}** — Fields of the parent inventory record that the artifact type is configured to display, such as the record's Stage. +- **[segment]{.smallcaps}** — A published [artifact segment](/guide/validation/manage-artifact-segments.qmd): a named, reusable filter managed by your organization's administrators. Available on artifact listings, and not offered inside a segment's own conditions. :::: diff --git a/site/guide/validation/manage-artifact-segments.qmd b/site/guide/validation/manage-artifact-segments.qmd index 9efb409934..01822f90dd 100644 --- a/site/guide/validation/manage-artifact-segments.qmd +++ b/site/guide/validation/manage-artifact-segments.qmd @@ -4,6 +4,8 @@ # SPDX-License-Identifier: AGPL-3.0 AND ValidMind Commercial title: "Manage artifact segments" date: last-modified +includes: + artifacts: true --- Save a set of artifact filters as a named, reusable segment that spans every artifact type, then publish the segment so everyone in your organization can view, filter, and analyze the matching artifacts together. @@ -58,7 +60,7 @@ By default, only the [{{< fa hand >}} Customer Admin]{.bubble} role can add arti 2. On the Edit Segment Conditions dialog that opens, enter the conditions that artifacts must match to belong to the segment: - Artifact Type is available as a condition, so you can scope a segment to specific artifact types. - - Only the fields shared by every artifact type are offered. A segment cannot reference another segment. + - Only the fields shared by every artifact type are offered. Fields of the parent inventory record and Segment are not available as conditions here. ::: {.callout-button .pl4 .nt2} ::: {.callout collapse="true" appearance="minimal"} From a18c77e6c884984b1e2a2f961ad2163506d8695d Mon Sep 17 00:00:00 2001 From: Emma Van Der Heide Date: Thu, 1 Oct 2026 19:19:45 -0400 Subject: [PATCH 5/7] [SC-18631] Note that segment conditions accept calculated fields Inventory and artifact segments can filter on Calculation and Aggregation fields using their stored values (frontend #2979, backend #3733). Co-Authored-By: Claude Fable 5.1 --- site/guide/inventory/manage-inventory-segments.qmd | 1 + site/guide/validation/manage-artifact-segments.qmd | 1 + 2 files changed, 2 insertions(+) diff --git a/site/guide/inventory/manage-inventory-segments.qmd b/site/guide/inventory/manage-inventory-segments.qmd index 57002398d2..492c7ff0af 100644 --- a/site/guide/inventory/manage-inventory-segments.qmd +++ b/site/guide/inventory/manage-inventory-segments.qmd @@ -61,6 +61,7 @@ By default, only the [{{< fa hand >}} Customer Admin]{.bubble} role can add segm - Inventory Record Type is available as a condition, so you can scope a segment to specific record types. - A segment cannot reference another segment, so Segment is not offered as a condition field here. + - Calculation and Aggregation fields can be used as conditions. They are evaluated against the stored values, which refresh in the background, and they offer the same operators as in the inventory filters, including **has error**.^[[Filter by calculated and aggregation fields](/guide/inventory/working-with-the-inventory.qmd#filter-by-calculated-and-aggregation-fields)] ::: {.callout-button .pl4 .nt2} ::: {.callout collapse="true" appearance="minimal"} diff --git a/site/guide/validation/manage-artifact-segments.qmd b/site/guide/validation/manage-artifact-segments.qmd index 01822f90dd..ad986bd4ae 100644 --- a/site/guide/validation/manage-artifact-segments.qmd +++ b/site/guide/validation/manage-artifact-segments.qmd @@ -61,6 +61,7 @@ By default, only the [{{< fa hand >}} Customer Admin]{.bubble} role can add arti - Artifact Type is available as a condition, so you can scope a segment to specific artifact types. - Only the fields shared by every artifact type are offered. Fields of the parent inventory record and Segment are not available as conditions here. + - Shared Calculation fields can be used as conditions. They are evaluated against the stored values, which refresh in the background, and they offer the same operators as in the artifact filters, including **has error**.^[[Filter by calculated and aggregation fields](/guide/validation/view-filter-artifacts.qmd#filter-by-calculated-and-aggregation-fields)] ::: {.callout-button .pl4 .nt2} ::: {.callout collapse="true" appearance="minimal"} From 86fa6a59eecbbcb0d92393ebed2296a0ee6a7f0c Mon Sep 17 00:00:00 2001 From: Emma Van Der Heide Date: Thu, 1 Oct 2026 21:40:56 -0400 Subject: [PATCH 6/7] Update manage-artifact-segments.qmd --- site/guide/validation/manage-artifact-segments.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/guide/validation/manage-artifact-segments.qmd b/site/guide/validation/manage-artifact-segments.qmd index ad986bd4ae..111e0ae463 100644 --- a/site/guide/validation/manage-artifact-segments.qmd +++ b/site/guide/validation/manage-artifact-segments.qmd @@ -104,7 +104,7 @@ Each segment shows one of the following statuses: : Artifact segment statuses {.hover} ::: {.callout title="Note that your organization starts with an example segment."} -Every organization includes an All Artifacts segment with no conditions, so it matches every artifact you can see across every artifact type. Edit it to narrow it down, or delete it if you do not need it. +Every organization includes an All Artifacts segment managed by ValidMind with no conditions, so it matches every artifact you can see across every artifact type. This example segment cannot be edited or unpublished, but it can be deleted. ::: ## Edit segments From 667265a5ea35ddf3697a1ce28851453387e42893 Mon Sep 17 00:00:00 2001 From: Emma Van Der Heide Date: Thu, 1 Oct 2026 21:43:36 -0400 Subject: [PATCH 7/7] [SC-18631] Remove the example segment callouts The All Artifacts and All Inventory Records example segments are seeded only inside the new-organization setup (Organization defaults in the backend); there is no backfill for organizations that already exist. Nearly every customer reading these pages has a long-standing organization that will never get the example, so a callout saying their organization starts with one is wrong for them. The example is also read-only, which the artifact callout misstated. Co-Authored-By: Claude Fable 5.1 --- site/guide/inventory/manage-inventory-segments.qmd | 4 ---- site/guide/validation/manage-artifact-segments.qmd | 4 ---- 2 files changed, 8 deletions(-) diff --git a/site/guide/inventory/manage-inventory-segments.qmd b/site/guide/inventory/manage-inventory-segments.qmd index 492c7ff0af..2ffed4932f 100644 --- a/site/guide/inventory/manage-inventory-segments.qmd +++ b/site/guide/inventory/manage-inventory-segments.qmd @@ -103,10 +103,6 @@ Each segment shows one of the following statuses: : Segment statuses {.hover} -::: {.callout title="Note that your organization starts with an example segment."} -Every organization includes an All Inventory Records segment managed by {{< var vm.product >}}. This example segment cannot be edited or unpublished, but it can be deleted. -::: - ## Edit segments To rename a segment or update its description: diff --git a/site/guide/validation/manage-artifact-segments.qmd b/site/guide/validation/manage-artifact-segments.qmd index 111e0ae463..bbe1230176 100644 --- a/site/guide/validation/manage-artifact-segments.qmd +++ b/site/guide/validation/manage-artifact-segments.qmd @@ -103,10 +103,6 @@ Each segment shows one of the following statuses: : Artifact segment statuses {.hover} -::: {.callout title="Note that your organization starts with an example segment."} -Every organization includes an All Artifacts segment managed by ValidMind with no conditions, so it matches every artifact you can see across every artifact type. This example segment cannot be edited or unpublished, but it can be deleted. -::: - ## Edit segments To rename a segment or update its description: