Dashboard

An Graphileon dashboard organises Functions into groups of manageable buttons and panels.

The default Graphileon dashboard contains a useful set of general purpose tools (Functions) for graph exploration. Some Functions are started when starting the dashboard, others can be started from the UserPanel by shortcut buttons. Below is an illustration of a part of the default dashboard setup (click the This dashboard shortcut from the UserPanel and explore from there).

Dashboard Setup

As you can see, the admin user connected to the Default Dashboard. The Dashboard has two types of outgoing Triggers: :START and :SHORTCUT. Functions connected to the dashboard by a :START Triggers are executed when the dashboard is loaded. The Function named Cypher is such a Function. This is a SearchView, so it will show a panel with a search field. This is why the default Graphileon dashboard shows this SearchView on startup as the Cypher box on the left panel. The default dashboard also contains other Views that are executed on startup, such as the 'Neighbours' view and the 'KeysView'.

The :SHORTCUT Triggers define buttons that should be shown on the UserPanel (default dashboard top-left). For example, the Me shortcut is defined by the :SHORTCUT Trigger to the Find node by id CypherQuery node, which sends its results to a NetworkView. This is how clicking the "Me" button results in a set of Function nodes showing up in a NetworkView.

:START Triggers

To start a Function when the Dashboard is loaded, you can connect it to the dashboard with a :START Trigger from the dashboard node to the Function node. As with inter-Function Triggers, parameters to the target Function can be set from the :START Trigger. In contrast to inter-Function triggers, however, they do not have a type property.

:SHORTCUT Triggers

If you need direct access to a Function from the dashboard, you can connect a :SHORTCUT Trigger from the dashboard node to the Function node. As with inter-Function Triggers and :START Triggers, parameters to the target Function can be set from the :SHORTCUT Trigger. Similar to the :START Trigger, they do not have a type property. They do, however, have some other properties that allow customization of the shortcut button in the UserView:

Key Value Description
index number/string Determines the order in which shortcuts are displayed. See Index Sorting.
name string The text to display on the button. If not set, the name of the target Function will be displayed instead.
icon string The name of an icon to display on the button. Can be any of the FontAwesome icons, without the prefix.
style string, css format CSS styling of the button.
hoverStyle string, css format CSS styling of the button when mouse is over it.
section string Name of the containing section - buttons can be grouped in sections.

Multiple Dashboards (not in Personal Edition)

In versions beyond the Personal Edition, each user can have multiple dashboards. Simply create an :IA_Dashboard node and connect a :DASHBOARD relation from your user node to the dashboard node. If a user has multiple dashboards, a Dashboard selection dropdown will appear in the UserView. The dashboards can be sorted by setting an index property on either the :IA_Dashboard node or the the :DASHBOARD relation.

Dashboard Selection

URL access to Dashboards and Functions (a.k.a. Bookmarks)

Dashboards and Functions can be configured to be accessible by browser URL.

Any Dashboard with a unique iaName property can be accessed through the url pattern: /#!/dashboard/{dashboard}, where {dashboard} is the iaName of the dashboard. For example, a Dashboard with iaName: "documents" can be accessed directly at http://example.com/#!/dashboard/documents.

Functions in the named Dashboard can then be made accessible at the url pattern: /#!/dashboard/{dashboard}/{bookmark}. This requires a :BOOKMARK relation from the Dashboard to any Function, with a name property on the relation (not iaName, because it does not have to be unique). This name property will be the {bookmark} placeholder in the url pattern above. For example, at http://example.com/#!/dashboard/documents/add would open the documents Dashboard and fire all its :BOOKMARK triggers with the name add.

Additional parameters for the bookmarks can be provided by a regular query string. These parameters can then be accessed from the :BOOKMARK triggers, using (%).url. For example, at http://example.com/#!/dashboard/documents/add?title=MyDocument, the value for (%).url.title in the :BOOKMARK triggers would be MyDocument.

Teams

In versions beyond the Personal Edition, dashboards, shortcuts and start Triggers can be shared with a team. An :IA_Team node can be connected to :IA_Function nodes by :START and :SHORTCUT relations, and to :IA_Dashboard nodes by :DASHBOARD relations. Any user connected to this :IA_Team node by a :MEMBER relation (from the user node to the team node) will have the dashboards, shortcuts and start Triggers of the team.

Example: In the following configuration, two users George and Suzanne have some functionalities of their own, some shared directly and some through a team.

Team Setup

Both George and Suzanne are using the Default dashboard. George, besides that, has his own dashboard with a single Start Trigger to a NetworkView. This Dashboard will not show up in Suzanne's UserView. She, on the other hand, has a shortcut to a query called Suzanne's Query that will not show up in George's UserView. Both are member of The Team, which has a shortcut to Team Query and a dashboard called Common Dashboard. This dashboard starts a SearchView called Neo4j and has a shortcut to Common Query.

If Suzanne were to load the Common Dashboard (which is available in her list through The Team), her dashboard would show the UserPanel with Suzanne's Query, Team Query and Common Query, grouped into personal shortcuts, team shortcuts and dashboard shortcuts, respectively. Moreover, her dashboard selection would show InterActor Dashboard and Common Dashboard, and the Neo4j SearchView is loaded. The result is shown below.

Team Setup

Hiding Personal/Team shortcuts

On specific dashboards, team and user shortcuts can be hidden by setting the following properties on the IA_Dashboard node:

  • personalShortcutsStatus: hidden
  • teamShortcutsStatus: hidden

They can also be visible but collapsed by default, by setting the above properties to collapsed.