Visualization settings

Permission: Settings management

Visualization setting is used to configure default visualization functionality and styling when user creates a new visualization.

Configuration

  1. Left menu - settings

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

  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 "VISUALIZATION".

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

Automatic configuration

Automatic configuration is used to generate configuration which contains automatically detected "nodeLabelAttr".

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 "VISUALIZATION".

  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:

{
"relationshipModel":"dirMergedEdges",
"timeline":{
"isOn":true,
"startDateProperty":"property",
"endDateProperty":"property",
"dateFormat":"YYYY-MM-DD",
"interval":604800000
},
"nodeTitleProp":"db_or_virtual_property_key",
"relTitleProp":"db_or_virtual_property_key",
"mergedRelTitleProp":"virtual_property_key",
"dirMergedRelTitleProp":"virtual_property_key",
"nodeTooltipProps":[
{
"property":"db_or_virtual_property_key_1"
},
{
"property":"db_or_virtual_property_key_2"
}
],
"relTooltipProps":[
{
"property":"db_or_virtual_property_key_3"
},
{
"property":"db_or_virtual_property_key_4"
}
],
"mergedRelTooltipProps":[
{
"property":"virtual_property_key_1"
}
],
"dirMergedRelTooltipProps":[
{
"property":"virtual_property_key_2"
}
],
"nodeSnippetProps":[
{
"property":"db_or_virtual_property_key"
},
{
"property":"db_or_virtual_property_key"
}
],
"nodeFilterProps":[
 
],
"mappers":{
"nodes":{
"background_color":{
"id":"1"
},
"background_image":{
"id":"2"
},
"border_width":{
"id":"21"
},
"border_color":{
"id":"22"
},
"size":{
"id":"3"
},
"shape":{
"id":"6"
}
},
"rels":{
"line_color":{
"id":"5"
},
"line_style":{
"id":"9"
},
"width":{
"id":"4"
},
"curve_style":{
"id":"42"
}
}
}
}

Explanation of JSON properties:

Property

Values

Default

Description

relationshipModel

"edges", "mergedEdges", "dirMergedEdges"

"edges"

Default Relationship Model set at new visualization initialization (when user creates a new visualization).

timeline

Object

 

Timeline configuration. If "timeline" configuration is not present then the Timeline widget is not activated in the visualization.

timeline.isOn

Boolean

false

If set to true then the Timeline widget is turned on when a new visualization is created and only data for preset date interval is visualized (see "timeline.interval" setting below).

timeline.startDateProperty

String

 

Name of a property where the element's start date of the time validity interval is stored.

If your data model has only one datetime point (e.g. events or workflows) then simply set "startDate" and "endDate" to the same datetime (same property name).

timeline.endDateProperty

String

 

Name of a property where the element's end date of the time validity interval is stored.

If your data model has only one datetime point (e.g. events or workflows) then simply set "startDate" and "endDate" to the same datetime (same property name).

timeline.dateFormat

"ms", "YYYY-MM-DD", "DD.MM.YYYY", "YYYY.MM.DD hh:mm:ss", "DD.MM.YY hh:mm:ss", "DD.MM.YYYY hh:mm:ss"

 

Configuration for datetime parser which reads the datetime data from timeline.startDateProperty and timeline.endDateProperty values.

Date format

Example of a valid value

Description

"ms"

4255414234

Integer value - number of miliseconds from 1.1.1970 (Unix epoch time)

"YYYY-MM-DD"

"2015-03-18"

Only date without time. Four digits year. Year first. Dash separator.

"YYYY-MM-DD hh:mm:ss"

"2015-03-18 20:23:59"

Date and time. Four digits year. Year first. Dash separator in date.

"YYYY.MM.DD hh:mm:ss"

"2015.03.18 20:23:59"

Date and time. Four digits year. Year first. Dot separator in date.

"DD.MM.YY hh:mm:ss"

"18.03.15 20:23:59"

Date and time. Two digits year. Day first. Dot separator in date.

"DD.MM.YYYY hh:mm:ss"

"18.03.2015 20:23:59"

Date and time. Four digits year. Day first. Dot separator in date.

timeline.interval

Integer

 

Interval defined in miliseconds. Typical values:

  • 1 hour = 3600000

  • 1 day = 86400000

  • 1 week = 604800000

  • 1 month (defined as 365days/12) = 2628000000

nodeTitleProp

String

First node DB property defined in Data schema.nodeProperties.database

Name of DB property used in several places in visualization (node title, tooltip title, tab Detail title, node snippet title) to identify node. For best results it should be DB property with unique identification or name for nodes. If set to null or not defined then the first Database Property Definition from "nodeProperties"."database" in Data schema is used.

relTitleProp

String

 

Name of DB property used as relationship title in visualization. If set to null or not defined then no relationship titles are shown in visualization.

mergedRelTitleProp

String

 

Name of virtual property used as merged relationship title in visualization. If set to null or not defined then no merged relationship titles are shown in visualization.

dirMergedRelTitleProp

String

 

Name of virtual property used as direction merged relationship title in visualization. If set to null or not defined then no direction merged relationship titles are shown in visualization.

nodeTooltipProps

Array of objects

 

Array of node DB properties which are listed in node tooltip. Each property is defined as simple object with only one property property. If set to null or not defined then no DB properties are printed in node tooltip. Ordering in GUI is the same as in this setting.

Example:

"nodeTooltipProps" : [
{ "property":"db_or_virtual_property_key" },
{ "property":"db_or_virtual_property_key" }
]

relTooltipProps

Array of objects

 

Array of relationship DB properties which are listed in relationship tooltip. Each property is defined as simple object with only one property property. If set to null or not defined then no data is printed in relationship tooltip. Ordering in GUI is the same as in this setting.

Example:

"relTooltipProps" : [
"property":"db_or_virtual_property_key" },
    { "property":"db_or_virtual_property_key" }
]

mergedRelTooltipProps

Array of objects

 

Array of merged relationship virtual properties which are listed in merged relationship tooltip. Each property is defined as simple object with only one property property. If set to null or not defined then no data is printed in merged relationship tooltip. Ordering in GUI is the same as in this setting.

Example:

"mergedRelTooltipProps" : [
{ "property":"virtual_property_key" }
]

dirMergedRelTooltipProps

Array of objects

 

Array of direction merged relationship virtual properties which are listed in direction merged relationship tooltip. Each property is defined as simple object with only one property property. If set to null or not defined then no data is printed in direction merged relationship tooltip. Ordering in GUI is the same as in this setting.

Example:

"dirMergedRelTooltipProps" : [
{ "property":"virtual_property_key" }
]

nodeSnippetProps

Array of objects

 

Array of node DB properties which are used as additional node identification in visualization tabs, e.g. in search or in node details. If set to null or not defined then no additional information is used in GUI and the only identification of node is nodeTitleProp.

Example:

"nodeSnippetProps" : [
{ "property":"db_or_virtual_property_key" },
{ "property":"db_or_virtual_property_key" }
]

nodeFilterProps

Array of objects

All node DB properties defined in Data schema with dataRole="dimension"

Array of node DB properties which are used in advanced filter in the search tab in visualization. If set to null or not defined then all DB properties from "nodeProperties" in Data schema which have dataRole set to "dimension" are used. Ordering in GUI is the same as in this setting.

Example:

"nodeFilterProps" : [
{ "property":"db_or_virtual_property_key" },
{ "property":"db_or_virtual_property_key" }
]

mappers

Object

 

Containst only two properties : "nodes" and "rels" with default style mappers definitions which are used when user creates a new visualization.

mappers.nodes

Object

Empty object

The "nodes" object contains references to specific style mappers that should be used to style nodes when user creates a new visualization (these mappers has to be already defined in the Style mappers setting and then referenced with the mapper's id property). There can be one and only one mapper defined for every style property (e.g. for line color, width, curve style, ...). When no mapper is defined for some style properties then the internal default values are used automatically.

mappers.nodes.background_color

Object

Default styles

Definition of node background color mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.

mappers.nodes.background_image

Object

Default styles

Definition of node background image mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.

mappers.nodes.border_width

Object

Default styles

Definition of node border width mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.

mappers.nodes.border_color

Object

Default styles

Definition of node border color mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.

mappers.nodes.shape

Object

Default styles

Definition of node shape mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.

mappers.nodes.size

Object

Default styles

Definition of node size mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.

mappers.rels

Object

 

The "rels" object contains references to specific style mappers that should be used to style relationships when user creates a new visualization (these mappers has to be already defined in the Style mappers setting and then referenced with the mapper's id property). There can be one and only one mapper defined for every style property (e.g. for line color, width, curve style, ...). When no mapper is defined for some style properties then the internal default values are used automatically.

mappers.rels.line_color

Object

Default styles

Definition of relationship line color mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.

mappers.rels.line_style

Object

Default styles

Definition of relationship line type mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.

mappers.rels.width

Object

Default styles

Definition of relationship width mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.

mappers.rels.curve_style

Object

Default styles

Definition of relationship curve style mapper. This object contains only property id which is the ID of style mapper which should be used when user creates a new visualization. When not defined or set to null then the default styles are applied.