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.
On this page
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
| Item | Searched 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:
| Rank | Match |
|---|---|
| 1 | The number equals the query |
| 2 | The number starts with the query |
| 3 | The name equals the query |
| 4 | The name starts with the query |
| 5 | The name contains the query |
| 6 | The number contains the query |
| 7 | Every word is in the number or the name |
| 8 | Some 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
- Press ⌘K / Ctrl+K and type a number or a few words.
- 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.
- 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
- Click Manage Projects, then Search All Projects.
- Type in the search box. The results update as you type.
- 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.
- Click a row to open its project at the item, or the project name to open the project's Home.
- 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
- 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.
- 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.
- Choose Search All Projects for “pump”. The page lists EO-1 Thermal and every CubeSat item that mentions a pump.
- Type pump battery. Only items with both words remain: TH.1, matched in its description.
- 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
| Control | What it does |
|---|---|
| Search box | The query. Results update after a short pause in typing; Enter searches at once |
| Refresh | Searches again |
| Status line | N matches in M projects (K searched) |
| Project box | The project's name (opens its Home), SysML v2 for a SysML v2 project and its number of matches |
| Result row | Number, name, class or element kind; the matching text for description and attribute matches |
Messages
| Message | Meaning |
|---|---|
| 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.
Related pages
- Database: search, filter and edit inside one project
- Links to other projects
- Program Map