Skip to content

Products and Projects Organization

The Products view is the central hub for organizing and managing your Software Bills of Materials (SBOMs) in CAST SBOM Manager. Products provide a hierarchical structure to group related SBOMs together.

Understanding the Hierarchy

CAST SBOM Manager uses a three-level organizational structure:

Product
  └── Project
      └── Version (SBOM)

Product

The top-level container representing a major application or product line.

Example: "MyApplication", "E-Commerce Platform"

Project

A mid-level organizational unit within a product. Projects typically represent components, modules, or subsystems.

Example: "Backend API", "Frontend UI", "Mobile App"

Version

Individual SBOM snapshots created at specific points in time. Each version represents a complete scan of your codebase.

Example: "v1.0.0", "v2.1.0", "2024-01-15-release"

Creating Products and Projects

Products and projects are created automatically when you create a new SBOM. There is no separate interface for creating them independently.

Creating a Product or Project

  1. Click + New SBOM from any view
  2. In the Details step of the wizard:
    • Product field: Type a new product name or select an existing one
    • Project field: Type a new project name or select an existing one
    • Version field: Enter a unique version identifier

Creating New vs. Using Existing

The Product and Project fields show autocomplete suggestions of existing items. You can:

  • Select an existing item from the dropdown
  • Type a new name (minimum 3 characters) to create a new product or project

Editing Products and Projects

No Renaming Capability

Products and projects cannot be renamed after creation. Names are permanent once set.

If you need to change a product or project name:

  1. Create new SBOMs with the desired product/project names
  2. Delete the old SBOMs (if no longer needed)
  3. The old product/project will be automatically removed when empty

Deleting Products and Projects

Products and projects cannot be deleted directly. They are automatically removed when they become empty:

  • Deleting a project: Delete all SBOM versions within the project → Project is automatically removed
  • Deleting a product: Delete all projects within the product → Product is automatically removed

Automatic Cleanup

This automatic cleanup ensures your product hierarchy stays clean without manual maintenance.

Accessing the Products View

  1. From the main navigation menu, click on Products
  2. The Products view displays all your products and projects in an expandable tree structure

Products Table

The Products table shows your organizational hierarchy:

Table Structure

  • Expandable rows - Click the arrow icon to expand a product and view its projects
  • Product rows - Display as "Product: {name}"
  • Project rows - Show the project name nested under their parent product

Columns

  • Name - Product or project name
  • Actions - View icon to navigate to project versions

Viewing Project Versions

To view all SBOMs (versions) for a specific project:

  1. Click the view icon (arrow) next to the project name
  2. The Versions view opens showing all SBOMs for that project

Versions View Components

Header

  • Breadcrumb navigation showing Product > Project
  • Quick access to create new SBOMs

Versions Table Displays all SBOM versions with customizable columns:

ColumnDescription
VersionVersion name/identifier
ComponentsNumber of third-party components detected
FilesTotal files scanned
LicensesCount of distinct licenses found
VulnerabilitiesNumber of vulnerabilities detected
CreatedSBOM creation timestamp
UpdatedLast modification timestamp

KPI Cards Summary metrics across all versions in the project.

Delta Charts (shown when 2+ versions exist) Visual comparison showing changes between versions:

  • Component count trends
  • License changes
  • Vulnerability trends

Managing SBOMs

Viewing a SBOM

Click on any version row or the "show" action to open the detailed Bill of Materials view.

Deleting a SBOM

To delete a SBOM version:

  1. Click the delete icon in the actions column
  2. Confirm the deletion in the modal dialog

WARNING

Deleting a SBOM is permanent and cannot be undone. All associated component information specific to that SBOM will be removed.

Exporting SBOMs

You can export SBOM data in multiple formats:

  1. Click the Export button
  2. Select the export format:
    • Excel (XLSX) - Spreadsheet format
    • Word (DOCX) - Document format
    • CycloneDX XML - Industry standard SBOM format
    • CycloneDX JSON - Industry standard SBOM format
  3. Choose export options:
    • Standard export (default settings)
    • Custom export (select specific component categories)
  4. Click Export to download

Table Preferences

Customize which columns appear in the Versions table:

  1. Click the column settings icon
  2. Check/uncheck columns to show/hide
  3. Click Save to apply changes

Your column preferences are saved automatically.