Visual Items

What are Visual Items?

Visual Items are shape/data placeholders that you put on a visualization canvas.

Once you have created a view, you can link a Visual Item to that view and place the Visual Item on a visualization canvas, telling the Visual Item which shapes, sizes and colors it should use to draw the data from the view on the visualization.

The goal we are trying to achieve is to create a Visual Item that shows services from a view on a visualization using different shapes.

Inserting a Visual Item on a Visualization Canvas

Before using a Visual Item you need to have a model and view in place.

First we are going to insert a Visual Item on a canvas.

To insert a Visual Item on canvas:

  • Select a folder
  • Insert a visualization
  • Give a name to the visualization
  • Click OK
  • Select the visualization
  • Insert a Visual Item
  • Save the visualization

Editing the Visual Item on a canvas

Now we have to setup the Visual Item

To setup the Visual Item:

  • Select the Visual Item in the Explorer Treeview
  • Click Edit. The New/Edit Dialog is shown.
  • Enter the viewid in the reference field of the view you want to connect to this Visual Item (meaning: to stream the data from the view to the visual item). Do this on the first TAB of the dialog.
  • Check if the correct visualization is selected (at the bottom of the first (Identity) TAB).
  • Go to the information TAB and select the shape you want to have used when drawing data on the visualization. Select Service (Dragon1) in this case.
  • Go to the style TAB and enter a position (x,y) of 100, 100 and size (width, height) of 100, 100
  • Go to the Behavior TAB in the dialog and enter a rule
    • Enter onload in the rule event field
    • Enter Entityclass=* in the rule condition field
    • Enter show(name) in the rule action field
  • Click OK

Viewing the Visual Item on its own

To view the visual item:
  • Select the Visual Item in the Explorer Treeview
  • Switch to NORMAL model in the playerbar

Now you see the Visual Item being interpreted by Dragon1. It now act as a piece of the puzzle, as a mini visualization.

Viewing the Visual Item on the visualization canvas

  • Select the visualization in the Explorer Treeview
  • Switch to NORMAL model in the playerbar (if not already)

Now you see the visualization interpreting all the visual items attached to it.

The rules that you need to configure for the visual items are the same as for the views.

Giving every shape its own bitmap on the visualization

To give every shape its own bitmap on the visualization:

  • Select a model in your Explorer Treeview
  • Select a shape on your model canvas
  • Enter a source url in the Text Attributes panel in the Inspector on the right
  • Save your model
  • Select a Visual Item in your Explorer treeview
  • Click Edit
  • On the behavior TAB in the New Edit dialog, change the rule action field into show(image)
  • Click OK
  • Select the Visual Item or visualization in NORMAL mode
  • You will now see the visualization showing configured bitmaps for shapes.
  • If no bitmap is configured, the basic shape used in the model is shown.

Example Screenshots

Here are some example screenshots showing you step-by-step how to create and use a Visual Item.

Screenshot showing a model where the services shapes are configured as entityclass Services in the Entity Class field.



Screenshot showing a model where the services have a bitmap image linked in their Source URL field.



Screenshot showing a view that filters everything that is not an application. Because the playerbar is set to NORMAL mode the view shows a popup dialog on mouse over on shapes. Now it shows the configured image.



Screenshot showing an inserted Visual Item on a Visualization Canvas.



Screenshot showing the Identity TAB configuration of the Visual Item. It is linked to a view with viewid in the Reference Field.



Screenshot showing the Behavior TAB configuration of the view. It is setup to only show the services.



Screenshot showing the Visual Item. The rule configured in the Visual Item only shows the services (but with their default shapes).



Screenshot showing the Extra Identity configuration of a Visual Item.



Screenshot showing the Information TAB configuration of a Visual Item.



Screenshot showing the Style TAB configuration of a Visual Item.



Screenshot showing the Behavior TAB configuration of a Visual Item.



Screenshot showing the Extra TAB configuration of a Visual Item.



Screenshot showing different bitmaps per service shape.