Search

Search screen can be opened by clicking on th "Search" button in the left menu. Main purpose of this page is to find elements and start visualization with these elements or add them into currently opened visualization. All indexed data can be searched on this page with fulltext search or cypher queries can be run. User can search and view only data to which he has granted access. Only user with permission "Read all data" can search and view all data or run cypher queries.

All searches (queries) are organized in tabs. There are two types of tabs that can be created:

  • Node's table tab : this type of tab lets the user to choose properties that will be displayed as table columns and simple conditions can be constructed to filter nodes and combine it with fulltext search to find specific nodes

  • Cypher tab : this type of tab lets the user to enter any cypher query (based on user's permissions only read cypher queries can be executed or any cypher query if the user has Read all data permission)

Search screen elements

images/download/attachments/13271093/GLDOC_search_01_comments.png

1.Search panel

Search panel contains:

  • New visualization - start new visualization for selected elements. See Visualization.

  • Add to visualization button - add selected elements into current visualization. See Visualization.

  • Search field - fulltext search input

    • if search is configured to work automatically, search starts automatically (can be configured, see Search mode)

    • if search is configured to work manually press "Enter" to start search

    • which properties can be searched is configured in Node fulltext index

    • Both settings, Search mode and Node fulltext index can be also configured directly on search page with Search Settings widget (cogs icon next to search field)

  • CSV export - exports result in CSV format (can be opened in Microsoft Excel or other CSV editing tools). Only first 10000 record are exported. Exported columns and column names can be configured (see Export).

  • Import file - data (nodes or relationships) can be imported from CSV or XLS files. See Import file for more details.

  • Create node - create new nodes in database. It's available only for users with "Data management" permission.

2.Search query tabs

Tabs are used to organize and save search queries. For example if your domain is Configuration Management then you can create separate tabs for Services, Applications, Servers and Racks as in the picture above. If you enter string into search field then the fulltext search runs only within the data defined by currently selected (active) tab.

3.Add new query

New query (tab) can be created with this button. The new query is created as copy of active tab.

4.Query panel toggle

The query panel can be turn on or off with this button. Query panel is used to change the query in active tab.

5.Query panel for Node's table tab

When the type of active tab is set to "Node's table" the user can specify columns of results table (every column is one property of nodes), construct simple condition for filtering nodes and combine it with fulltext search of indexed properties. The condition that can be constructed with query consist of condition on labels and properties. Multiple properties can be added and for every property multiple values can be specified. In order to pass the condition the node has to have at least one of specified labels (OR between labels) and for every specified property (AND between properties) at least one of the values (OR between property values). For the setting in the picture above the condition can be read as follows: Return the properties (columns) of all nodes with the label "Ci" AND with the property Type set to value "Server".

6.Search result table for Node's table tab

Search result contains all data that meet the combined search criteria defined by fulltext search field and query panel.

Nodes in table can be selected:

  • select 1 element: click on record

  • select more elements: hold CTRL and clicking on records

  • select more elements area: click on the first record in area, then hold SHIFT and click on the last record in area

Selected nodes can be used to start new visualization, add to current visualization or export. Export options can be configured (see CSV export).

Table contains only some properties of node (selected in query panel). To view all properties press detail icon on the right side of record. Tabs of detail panel can be configured by (see Data schema).

If there are too many columns in the result table some of them are automatically hidden (page is responsive). Press "+" icon on the left side of record to show hidden properties.

Sorting of any column can be changed by pressing arrows next to the column title.

Tab with cypher query

images/download/attachments/13271093/GLDOC_search_02_comments.png

7.Query panel for Cypher tab

When the type of active tab is set to "Cypher" user can run Cypher queries and start vizualization with nodes and relationships in query result as starting points for visualization. Note that:

  • read Cypher queries are available for users with "Read all data" permission

  • write Cypher queries are available for users with "Read all data" and "Data management" permissions

  • fulltext search is not available in combination with cypher queries

8.Query result for Cypher tab

The result of the Cypher query is summarized in the Cypher result window. The counts of specific record types is displayed and also a simple result viewer (JSON viewer) is available for further inspection of results if needed. If there is at least one node, relationship or path in the result then the "New visualization" and "Add to visualization" buttons are enabled.