Search tabs

Permission: Settings management

The Search tabs setting is used as a default setting of tabs in search page at user's first login. There are two types of search tabs that can be defined with this setting:

  • Node's table tab

    • this type of tab lets the user to choose properties that will be displayed as table columns and the user can define simple condition to filter nodes and combine it with fulltext search to find specific nodes to start the visualization with

    • tab is defined with "title", "columns" and "condition" (optional) - see Explanation of JSON properties below

  • 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)

    • tab is defined with "title" and "cypher" - see Explanation of JSON properties below

Configuration

  1. Left menu - settings

  2. In panel "Settings list" use icon "Update" for setting "SEARCH_TABS".

  3. Enter JSON configuration and confirm by pressing "Save" button.

Default configuration

Default configuration contains several default attributes to see how configuration should looks like. Probably this configuration doesn't match model of your data but can serve as example of short configuration.

  1. Left menu - settings

  2. In panel "Settings list" use icon "Update" for setting "SEARCH_TABS".

  3. Press button "Default" and store by pressing button "Save".

Automatic configuration

Automatic configuration is used to generate configuration which contains attributes of several random nodes. Random nodes are selected as first 1000 nodes. Generated JSON contains tab for every existing label (max. 20) and one tab for all nodes.

This automatically generated configuration can be used as good starting point to create own configuration.

  1. Left menu - settings

  2. In panel "Settings list" use icon "Update" for setting "SEARCH_TABS".

  3. Press button "Automatic", wait for generator to generate JSON and store by pressing button "Save".

Description of configuration

Configuration is entered as JSON. Example of JSON:

[
{
"title":"Nodes in a table",
"condition":{
"labels":[ "Person", "Company" ],
"properties":[
{
"property":"type",
"values":[ "person", "company" ]
},
{
"property":"subtype",
"values":[ "auditor", "manager", "limited" ]
}
]
},
"columns":[
{
"property":"title"
},
{
"property":"type"
}
]
},
{
"title":"Cypher query",
"cypher":"MATCH (n) RETURN n LIMIT 100"
}
]

Explanation of JSON properties:

Property

Values

Default

Description

Usage

title

MANDATORY

String

 

Title of tab with search results used on Search page.

Search Page

cypher

String

 

Cypher query that defines the output of this search tab

Search Page

condition

Object

 

Condition for filtering nodes or relationships listed in tab. Always use together with columns

Search Page

condition.properties

null, undefined, Array of SFO objects

 

Array of filter criteria. Defined criteria will be used in search and only elemets which match these criteria will be shown in results. If not defined, set to null or set to empty array then no filtering is applied for this tab. Each criteria is defined by SFO (Search Filter Object).

Logical "AND" is between each criteria in properties and logical "OR" is between items in values. Final condition based on properties can be for example: "type"="person" AND ("subtype"="auditor" OR "subtype"="manager").

Search Page

SFO.property

MANDATORY

String

 

Name of the DB property to filter on. This property has to be indexed, which means it has to be set in properties of Node Index configuration or Relationship Index configuration. See Node fulltext index.

Search Page

SFO.values

MANDATORY

Array of strings/numbers/booleans

 

List of values of the DB property which are matched in search filter. The exact string/number/boolean value is matched.

Search Page

condition.labels

Array of strings

 

Defines search criteria for node DB labels. Logical "OR" is between items. It's used only if group is set to "nodes".

Search Page

columns

MANDATORY

Array of CDO objects

 

Array of column definitions used in search results table. Each column is defined by CDO (Column Definition Object) which holds primarily the DB property name. Other metadata is used from Data schema (e.g. title).

Search Page

CDO.property

MANDATORY

String

 

Name of the DB property used in defined column. Values of this DB property will be listed as cell values in table column.

Search Page