UQL Shortcuts
The panel of common UQL commands will show or hide upon clicking Shortcut module in the sidebar:
- Insert: node or edge, as introduced in the GraphSet Management chapter
- Query: node, edge, path, etc.
Click the widgets under 'Query' section will copy a sample of the respective UQL into the Web-CLI at the top of main page; users can easily modify the UQL and query against the current graphset based on their needs.
For instance click 'Find Nodes' widget to query for 10 nodes, and the query results are displayed in the main page:

Web-CLI Operations
Inputing UQL in the Web-CLI will trigger pop-up lists of available commands and parameters, different components of a UQL statement will show in different color; linefeed is allowed in the UQL.
Ultipa Web-CLI executes UQL one at a time upon clicking the 'Play' button to the right end; historical UQLs can be listed by clicking the 'History' icon. The records are listed in time descending order, clicking any record will copy the UQL into the CLI:

Result Tab Operations
The result of each execution of UQL will be recoreded in the current result tab. Open more tabs by clicking the 'Split' icon for better comparision between results of different UQLs:

The UQL history of each tab is folded on the top of the tab, users can retrieve any UQL command and its query result by clicking the UQL record and its return values. Clicking the 'Edit' icon will copy the UQL into the CLI:

The query results are displayed below the uQL in both List View and Graph View.
List View
The list view shows the query result in a traditional table-like view. It can display nodes, edges and paths. Query result of nodes and edges are by default displayed in list view.
Node List
Observe the list view of 'Find Nodes' result. The nodes in the list can be edited or deleted:

Edge list
Observe the list view of 'Find Edges' result. The edges in the list can be edited or deleted; use the Node Selector, an advanced tool for editing the From Node and the To Node of an edge:

For example, click the icon to the right of To Node and popup the Node Selector, input the filtering condition of node in the curly brackets and hit 'Enter', in the search results click any record to select that node as the To Node:

Note: the Node Selector searches for nodes by executing find().nodes(<filter>) as nodes return nodes limit <m>
, where the value of limit
could be edited in the Setting module from the sidebar.
Path List
Observe the list view of 'A-B Path Finding' result. The nodes and edges that line up alternatively in each path can be edited or deleted in the similar way as instroduced above. Click a node or edge in a path to evoke the operation menu:

In this example, the nodes in the paths are labeled using their values of property 'name', while the edges are labeled using their values of property '_uuid'. The edge label can be adjusted for better intuitiveness. Go to Setting to reset edge label:

Shown in the above screenshot, the edge label is using property 'name', and because the edges have no such property hence Ultipa Manager uses '_uuid' as edge label in the list view.
Modify the setting and use 'schema' as edge label, and check the list view again:

Using schema as label property name means to use schema name as label.
Other Result
Other types of query result such as values, tables, etc., will be displayed in non-editable table format.
Graph View
The graph view visualizes the query result using a 2D or 3D sub-graph which is more intuitive than list or table. Besides editing, deleting and setting labels of nodes and edges, the graph view of query result facilitates users with a lot more operations against meta-data, such as adjusting layout style, creating meta-data in drag-drop manner and appending search result to the current result.
Graph view can display nodes and paths. Query result of paths is by default displayed in 2D view.
2D Graph
The toolbar in a 2D view result tab contains:
Icon | Description |
---|---|
![]() |
Locate nodes in current result tab |
![]() |
Switch to 3D view |
![]() |
Open meta-data style panel |
Locate Nodes
Switch the result of 'Find Nodes' to 2D graphic view:

Ultipa Manager supports secondary search for nodes in 2D view, highlight the found nodes and center them in the tab:
- search for one node by node property '_uuid'
- fulltext search for multiple nodes by node property 'name'
Note: the method of fulltext search by node 'name' does NOT require a fulltext index of node property 'name' to be created; it only requires the graphset to have a node property called 'name' with data type 'string'.
Meta-data Style
Observe the 2D view of 'A-B Path Finding' result:

The edges are using _uuid as label; change the edge label to edge schema following below steps:
- click icon
in the toolbar;
- edit style 'default', which is currently in use;
- in the popup panel switch to substyle 'edge--default', and check the box in front of 'Display Schema' at the lower right corner:

Default substyles 'node-default' and 'edge-schema' cannot be renamed or added with new filtering rules, only the style such as color, shape and display can be edited.
Confirm the changes and check the edge label on the graph view:

Add multiple substyles under a style to better describe the query result. Each substyle can have its own color, shape, size/width, and label display, filtering rules are also included as many as needed to cover all the nodes or edges to which the substyle is applicable.
Choose the correct meta-data type when creating substyle:

Add filtering rules under the substyle:

A properly adjusted meta-data style helps highlight the imformation that users want to emphasize of a sub-graph. Below style empahsizes the relationship 'follow' and the start/end node of paths:

Node Operations
Operations on nodes in the 2D view includes:
Operation | Description |
---|---|
hover | Show the info bar on the bottom of the result tab, containing property values of current node |
drag | Move current node and lock it to the new position |
left-click | Lock current node, lock info bar, popup menu |
right-click | Popup menu |
Note:
- if a node is not locked, it moves when other nodes in the sub-graph move, and it will NOT move with other nodes if it is 'locked';
- the info bar, if not locked, will hide when the hover ends;
- see below descriptions for left/right-click menus.
A screenshot of left-click menu of node in 2D view:

Options in the left-click menu:
Option | Description |
---|---|
Spread | Append the result of n-hop spread from the current node into the current tab, namely executing spread().src(<>).depth(1) limit m (limit m could be edited in the Setting module in the side bar) |
Edit | Edit current node's property value; this will update the current graphset |
Delete | Delete current node from the current graphset |
Note: editing and deleting node in the 2D view are similar to that in the list view.
See an example of 'Spread' operation:
Find a node and run its 2D view, spread the node via left-click menu:

Three paths are drawn as the maximum number of return is 3. Go to Setting and edit the value of 'Limit' to 5:

Spread the node again and two more paths are drawn:

A screenshot of right-click menu of node in 2D view:

Options in the right-click menu:
Option | Description |
---|---|
Hide | Hide current node and all of its edges from the sub-graph |
Lock | Lock node to its current position |
Unlock | Unlock node from its current position |
New Edge | Create an edge between current node and a designated node in the sub-graph; this will update the current graphset |
Note: a hidden node and its edges will not be drawn again in the same result tab, but this will not affect the function 'Spread' in the left-click menu.
See an example of 'New Edge' operation:

Edge Operations
Operations on edges in the 2D view includes:
Operation | Description |
---|---|
hover | Show the info bar on the bottom of the result tab, containing property values of current edge |
left-click | Lock info bar, popup menu |
A screenshot of left-click menu of edge in 2D view:

Options in the left-click menu:
Option | Description |
---|---|
Edit | Edit current edge's property value; this will update the current graphset |
Delete | Delete current edge from the current graphset |
Note: editing and deleting edge in the 2D view are similar to that in the list view.
Blank Area Operations
Operations on the blank area of the 2D view includes:
Operation | Description |
---|---|
drag | Move sub-graph |
wheel up/down | Zoom sub-graph in/out |
left-click | Clear any node selection, unlcok info bar |
right-click | Popup menu |
A screenshot of right-click menu of blank area in 2D view:

Options in the right-click menu:
Option | Description |
---|---|
New Node | Create a node in the sub-graph; this will update the current graphset |
Lock All | Lock all nodes in the sub-graph to their current positions |
Unlock All | Unlock all nodes in the sub-graph from their current positions |
Tree Layout | Re-organize all nodes in the sub-graph in tree layout |
Chain Layout | Re-organize all nodes in the sub-graph in chain layout |
Collapse Edges / Expand Edges |
Collapse multiple edges in the same direction between any two nodes into one representative edge / Expand all representative edges |
See an example of 'Collapse/Expand Edges' operation:

3D Graph
Ultipa Manager automatically display complex query results in 3D space. Users can also switch a 2D view to 3D mode as per needs.
The toolbar in a 3D view result tab contains:
Icon | Description |
---|---|
![]() |
Switch to 2D view |
![]() |
Open meta-data style panel |
Meta-data Style
Style settings in the 3D view only support node color and meta-data display label. Nodes are drawn into dot with size 20, and edges are drawn into gray line with width 1.
Node Operations
Operations on nodes in the 3D view includes:
Operation | Description |
---|---|
hover | Show the node label |
drag | Move current node |
left-click | Popup menu |
A screenshot of left-click menu of node in 3D view:

Options in the above menu are same with those in a 2D view.
Edge Operations
Operations on edges in the 3D view includes:
Operation | Description |
---|---|
hover | Show the edge label |
Blank Area Operations
Operations on the blank area of the 3D view includes:
Operation | Description |
---|---|
left-drag | Rotate sub-graph |
right-drag | Rotate user view |
wheel up/down | Zoom sub-graph in/out |
left-click | Clear any node selection, if these is any |