Docs

SysModeler — User Manual

15. Advanced Model Query Engine

The Model Query Engine is a database-like search interface for interrogating your system model with fields, operators, logical groups, scoping, and sorting.

15.1 Opening the Query panel

Open a project and select Query from the left sidebar. The panel lists all of your saved queries.

Note: View-only collaborators can run queries but do not see the + (Create Query) button.

15.2 Query fields (Properties to Select)

Under Properties to Select, choose which fields to return per match. Leaving it empty returns every available property.

FieldDescriptionTypical usage
@idUnique string identifier of the nodeKeep this selected to enable click-to-canvas jumping
@typeSysML metamodel classification typeFilter for e.g. PartDefinition or Requirement
nameHuman-readable element nameFind a specific block like "Alpha Drone" or "Engine"
ownerParent element/package containing the nodeScope to specific sub-assemblies/subsystems
shortNameElement short nameCompact identifiers
documentationAttached documentation textSearch descriptive metadata
isAbstractBoolean flag for abstract definitionsIsolate concrete instantiations from base abstractions
directionFeature directionFilter directional features

Tip: If @id is not selected, "go to node" may not work reliably for that query's results.

15.3 Creating a query (step by step)

  1. Click + to open the Create Query dialog and give the query a name.
  2. Under Properties to Select, choose the fields to return (15.2).
  3. Under Where (Filters), click Add filter. Each filter is a property, an operator, and a value. Example: to find the node named "Alpha Drone", set property name, operator =, value Alpha Drone.
  4. Check Inverse on a filter to match the opposite (every node not meeting the condition).
  5. Click Add filter again for more conditions, and use the ALL (AND) / ANY (OR) switch to control whether every condition must match or just one.
  6. Click Add group to nest a subset of conditions in their own AND/OR block — for logic like "this AND (that OR that)".
  7. (Optional) Add Scope by pasting specific element IDs to search only within those elements instead of the whole project.
  8. (Optional) Add Order By to sort results by a property, ASC or DESC; add multiple ordering properties to break ties.
  9. Click Create to save. The query appears in the list.

15.4 Editing & deleting queries

  • Reopen a saved query with the pencil (Edit) icon to modify it. Editing resaves the entire query, not just the changed part.
  • Delete Query permanently removes a saved query.

15.5 Executing a query

  1. Click a query's Execute (▶) icon.
  2. It returns every node currently satisfying the conditions, as a results table — one column per selected property, one row per matching node.
  3. Results always reflect the live model at the head of the project's active branch; a saved query is not a frozen snapshot.

15.6 Navigating from results to the canvas

  • Click a result row to jump to that node on the canvas. The node's diagram opens in a side-by-side pane and the view focuses on it.
  • If the node has never been placed on a diagram, the correct file still opens, but there won't be a meaningful position to jump to yet. Not all elements generate nodes.
  • Use the search box above the results table to filter the currently displayed results only — it does not re-search the entire model.