Global Search¶

VDC provides powerful search capabilities to help you quickly locate ingredients and releases across all projects and feeds. Whether you're looking for a specific release by ID or discovering ingredients by name or type, VDC's search features support both interactive browsing and automated flows.

Quick Access: Use the global search bar (top navigation) for release IDs, or visit the "VDC Ingredients" section for ingredient discovery.

Search Types Overview¶

Search Type	What You Can Find	Where to Search	Best For
Release ID Search	Specific ingredient releases by exact ID	Global search bar	Direct navigation, CLI automation
Ingredient Search	Ingredients by name or type across projects	VDC Ingredients section	Discovery, browsing

Release ID Search¶

How It Works¶

Release ID search provides direct navigation to a specific ingredient release when you know its exact system-generated ID.

Search Location: Global search bar (available in top navigation on all VDC pages)

Search Rules¶

Format: Must use exact release ID (e.g., REL-123456, IFWI-789012)
Matching: Exact match only - no partial IDs supported
Case Sensitivity: Case-sensitive %%TODO: check if this is true%%
Results: Direct redirect to the Release View

Examples¶

✅ Valid searches:
REL-123456
IFWI-789012
BIOS-456789

❌ Invalid searches:
REL-123 (partial ID)
rel-123456 (wrong case)
"REL-123456" (quotes not needed)

What Happens Next¶

Valid ID: Automatically redirects to the Release View showing full release details
Invalid ID: Displays error message with suggestions for alternative search methods

Ingredient Search¶

How It Works¶

Ingredient search helps you discover and browse ingredients across all projects by name patterns or ingredient types.

Search Location: VDC Ingredients section (accessible from top navigation)

Search Rules¶

Name Search: Partial matching supported (case-insensitive) %%todo: check case insensitive%%
Type Search: Exact type matching from predefined list %%todo: check partial%%
Scope: Searches across all projects and feeds
Results: List view with navigation to ingredient details

Search Syntax¶

By Name¶

Search: "BIOS"
→ Finds: BIOS_NVL, BIOS_DMR, Custom_BIOS_Build

Search: "DMR"  
→ Finds: IFWI_DMR, BIOS_DMR, acode_DMR_A0

Search: "test"
→ Finds: test_build, IFWI_test, experimental_test_kit

By Type¶

Search: "ifwi"
→ Finds: All IFWI-type ingredients

Search: "unified-patch"
→ Finds: All unified patch ingredients  

Search: "acode"
→ Finds: All acode ingredients

Search Results¶

The results page displays a table with:

Column	Description
Name	Ingredient name (clickable → opens Ingredient View)
Type	Ingredient type classification
Project	Project containing the ingredient
Feed	Feed containing the ingredient
Launch Icon	Direct navigation button to Ingredient releases tab

Interactions¶

Click ingredient name: Opens the Ingredient View
Click launch icon: Alternative way to open Ingredient View with release tab active
Filter results: Use additional filters by type, project, silicon family & step

CLI Search¶

VDC CLI provides programmatic search capabilities for automation and scripting scenarios.

Installation & Setup¶

# Install VDC CLI (if not already installed)
# Follow your organization's CLI installation guide

# Authenticate
vdc-cli auth login

Release Commands¶

Ingredient Commands¶

Automation Examples¶

# Find latest release of an ingredient
latest_release=$(vdc-cli ingredient get-latest-release \
  --project validation-team --feed main --name IFWI_DMR)

# Batch download multiple releases
for release_id in REL-123456 REL-123457 REL-123458; do
  vdc-cli release download --id $release_id --output ./batch_downloads/
done

# Search and export ingredient list
vdc-cli ingredient search --type "unified-patch" --format csv > unified_patches.csv

Advanced Search Tips¶

Finding What You Need¶

Goal	Best Approach
Known release ID	Use global search bar for instant navigation
Browse ingredient types	Use ingredient search with type filter
Discover related ingredients	Search by common name patterns (e.g., "DMR", "NVL")
Automate flows	Use CLI commands in scripts
Cross-project discovery	Use ingredient search (searches all projects by default)

Search Strategy¶

Start broad, then narrow: Begin with general terms, refine based on results
Use type filters: When you know the ingredient type you need
Check multiple projects: The same ingredient name may exist in different contexts
Leverage partial matching: Ingredient name search supports partial terms

Troubleshooting¶

Common Issues¶

Problem	Symptoms	Solution
Release not found	"Invalid ID" error message	• Verify ID format and spelling • Check if you have access permissions • Confirm the release exists
No ingredient results	Empty search results	• Try broader search terms • Check spelling and remove special characters • Verify the ingredient exists in VDC
CLI authentication fails	Permission denied errors	%%TODO%%
Search too slow	Long loading times	• Use more specific search terms • Try searching within a specific project • Use type filters to narrow results

Error Messages Guide¶

"Release ID could not be found"

Double-check the ID format (e.g., REL-123456)
Ensure the release hasn't been deleted
Verify you have read access to the project

"No ingredients was found"

Try partial name matching (e.g., "BIOS" instead of "BIOS_specific_name")
Check if the ingredient type is spelled correctly
Consider that the ingredient might be in a different project than expected

"CLI ???"

Ensure VDC CLI is properly installed and in your PATH
Check if you're using the correct command syntax
Run vdc-??? --help for available commands

Current Limitations¶

Limitation	Impact	Workaround
No ingredient ID search	Cannot search ingredients by their system ID	Use name or type search, then browse to specific ingredient
No fuzzy matching for release IDs	Must know exact release ID	Use ingredient search to find releases, or check workflow logs

Future Enhancements: VDC is continuously improving search capabilities. Check the release notes for updates on new search features.