Widgets

Required Permission: Project Settings management (Read more about permissions in User Groups)

Table of Contents


Widgets setting is a collection of widget configuration objects. With these configuration objects, you can enable and configure widgets included in Visualization.

There are several internal widgets included in Graphlytic installation which you can use out of the box. See below for a full list of internal widgets and their configuration options.

Configuration

  1. In the "Application Menu" (top right) choose page "Project Settings"

  2. In the " Project Settings" panel click on the "Widgets" row.

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

Description of configuration

Configuration is entered in JSON format. Example:

[
{
"widget":"outagePropagation",
"config":{
"outageProp":"outageDependency",
"outageValue":"yes",
"thresholdProp":"outageThreshold"
}
},
{
"widget":"sumReport"
}
]


Explanation of JSON properties:


Property

Values

Default

Description

widget

MANDATORY

String


ID of widget you want to enable (include) in Visualization.

config

Object


Optional object which will be passed to widget with <widget>.configure(config) method immediately after widget is included. Structure of this object vary for each widget. Please see documentation of particular widget for more information about it's configuration options.

Internal Widgets

Widget ID

Configuration

Description

sumReport

Property

Description

valueProp

Name of node DB property with values to sum. If not defined then random numbers are used (for demo purposes).

Demo of a widget which acts on set of selected nodes, calculates sum of one property across these nodes and result is presented to user in the form of a table in modal window.

Example of configuration:

{
"widget":"sumReport",
"config":{
"valueProp":"costs"
}
}


outagePropagation

Property

Description

outageProp

MANDATORY

Name of relationship DB property with outage values.

outageValue

MANDATORY

Value of outageProp which will be considered as true. In case of this value the relationship is considered to be a outage propagator.

thresholdProp

Name of relationship DB property with threshold value. Threshold is a numeric value representing minimum number of nodes outgoing relationships with active outage in order to consider the node to be down (to be affected by this outage). In case multiple outgoing relationships of a node have different thresholdProp values then the minimal value is used. If not defined then the outage is calculated as if threshold value is 1 (always propagate to node).

This widget ads the "outage propagation button" to Tools panel in Visualization for simulationg outage propagation in graph.

Usage: select one or more nodes which are outage starting points and click the outage propagation button. Widget calculates based on starting points and configuration option the nodes and relationships which propagates outage in this step and selects them. You can press the outage propagation button multiple times and in every step the same calculation is made so you can observe the outage propagation effect in graph.

Example of configuration:

{
"widget":"outagePropagation",
"config":{
"outageProp":"outageDependency",
"outageValue":"yes",
"thresholdProp":"outageThreshold"
}
}