Holarch

Model

Search All Projects

Find items by number, name, description or attribute text in every project you can open, grouped by project, and open a result in its project.

How to use it →

On this page
  1. Overview
  2. Concepts
    1. What is searched
    2. How matching works
    3. Ranking
    4. Who sees what
  3. How to use it
    1. Find an item in any project
    2. Search all projects from the results page
    3. Worked example: a coolant pump across the CubeSat program
    4. Tips
  4. The results page
  5. Messages
  6. Limits
  7. Related pages

Overview

Search (⌘K / Ctrl+K) and the Database find items inside the open project. Search All Projects looks in every project you can open at once: system, subsystem and test projects, and libraries, LML and SysML v2 projects alike. Use it to answer questions such as "where else is this pump specified?", "which project holds requirement SYS.4?" or "who mentions the 5 bar limit?".

Results are grouped by project, best project first. A result opens its project at the item.

Search All Projects is part of the Individual and Team plans.

Concepts

What is searched

ItemSearched text
Item (requirement, action, asset, document and every other class)Number, name, description (as plain text) and every attribute value

In SysML v2 projects, elements are searched by short name (shown as the number), name and documentation, and the project's own Holarch items (risks, tasks) like the items of an LML project.

Relationships, diagrams, comments and project names are not searched. Search inside one project with filters and saved views stays in the Database.

How matching works

  • Matching ignores upper and lower case and finds text anywhere in a word: pump finds Pump, pumps and Coolant-pump.
  • Every word of the query must appear in the item, in any order and in any of its fields: coolant 5 bar finds an item named Coolant loop whose Rationale says below 5 bar.
  • Type at least two characters. A query made only of one- and two-letter words (for example sr) matches the start of numbers and names, not descriptions.

Ranking

Within a project, items are listed in this order:

RankMatch
1The number equals the query
2The number starts with the query
3The name equals the query
4The name starts with the query
5The name contains the query
6The number contains the query
7Every word is in the number or the name
8Some words are only in the description or an attribute value

Items of the same rank are listed by name. Projects are ordered by their best result, then by their number of matches.

Who sees what

Only projects you can open are searched: a project where you are a member with any role, that is not in the Trash, and whose organization's two-step sign-in rule you meet. A project you cannot open adds nothing to the results, the counts or the notes, so the page never shows whether such a project exists or what it holds.

How to use it

Find an item in any project

  1. Press ⌘K / Ctrl+K and type a number or a few words.
  2. The Other Projects group lists the best matches outside the open project, each with its project and class. The open project's own items are listed under Items.
  3. Choose a result to open its project at the item, or choose Search All Projects for “…” for the full results.

Search all projects from the results page

  1. Click Manage Projects, then Search All Projects.
  2. Type in the search box. The results update as you type.
  3. Read the results: one box per project with its number of matches. Each row shows the number, the name and the class or element kind. A row that matches in its description or an attribute shows the matching text, labelled Description: or with the attribute's name.
  4. Click a row to open its project at the item, or the project name to open the project's Home.
  5. Each project lists up to 20 items. When it has more, the box says Showing 20 of N. Add words to narrow the search.

Worked example: a coolant pump across the CubeSat program

  1. Create the CubeSat EO-1 demo, then a second project EO-1 Thermal with the requirement TH.1 Coolant pump flow and the description The coolant pump keeps the battery below 40 C.
  2. Press ⌘K / Ctrl+K in the CubeSat project and type pump. TH.1 Coolant pump flow appears under Other Projects, labelled EO-1 Thermal · Requirement.
  3. Choose Search All Projects for “pump”. The page lists EO-1 Thermal and every CubeSat item that mentions a pump.
  4. Type pump battery. Only items with both words remain: TH.1, matched in its description.
  5. Click TH.1. EO-1 Thermal opens with TH.1 selected.

Tips

  • Search for a requirement number to find which project holds it: an exact number is always listed first.
  • The page address keeps the query (#/search?q=pump). Bookmark it, or send it to people who can open the same projects: each of them sees only their own projects' results.
  • After a large import or a save of a whole project, a note says that some projects are still being read. Click Refresh a moment later.
  • To link a result to an item in your project, open your project and add a link to another project from the item's Trace section.

The results page

ControlWhat it does
Search boxThe query. Results update after a short pause in typing; Enter searches at once
RefreshSearches again
Status lineN matches in M projects (K searched)
Project boxThe project's name (opens its Home), SysML v2 for a SysML v2 project and its number of matches
Result rowNumber, name, class or element kind; the matching text for description and attribute matches

Messages

MessageMeaning
Type at least two characters. Every word must appear in the item: its number, name, description or an attribute.The query is shorter than two characters
No items match “…” in N projects. Check the spelling or use fewer words.Nothing matched in the projects you can open
N projects are still being read. Refresh in a moment for complete results.Some projects changed a lot (an import, a whole-project save) and their items are not searchable yet
Searching all your projects at once is part of the Individual and Team plans; …Your plan does not include Search All Projects
Too many searches. Try again in a minute.More than 600 searches in one minute

Limits

  • Up to 20 results per project are listed; the count covers every match.
  • Up to 4,000 characters of a description and 4,000 characters of attribute values per item are searched.
  • Up to six words per query; longer queries use the first six.
  • Search All Projects is not available through the API or MCP.