Visual Items

What is a Visual Item?

Icon/Data PlaceHolders

What are Visual Items? Visual Items are icons that can be configured as icon/data placeholders.

Visual Items can be used to generate data in a specific layout on the canvas, using icons.

Although there is a specific icon for a visual item, the sun shape, any icon can be used / treated as visual item. If you use any other icon than the specific visual item, Dragon1 will use the shape of the icon by default for generation data.

Depending on data and rules you can change colors, names and positions of icons with a visual item. Suppose you want to know which application has no service level contract, then you configure a visual items to color applications without service level contract data red and have it shown a call out.

Views and Folders

Once you have placed data in a folder, or created a model or a view (a filter on a model), you can link a Visual Item to that folder, model or 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 folder or 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 data in a folder, a model and/or 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.



Create a List of Item

You can create a list of items with and without shapes

You can present the list be in a row or column, circle, triangle, rectangle, square or block.

Attributes

The following reserved attributes are available for configuring a visual item:

  • Entityid
  • Entityclass
  • Entitytype
  • Layout
  • Spacing
  • Opacity
  • Icon
  • Width
  • Height
  • Rows
  • Cols

To add specific behavior of coloring, repositioning and changing size of a use the following attributes:

  • Rule Event
  • Rule Condition
  • Rule Action
  • Rule2 Event
  • Rule2 Condition
  • Rule2 Action
  • Rule3 Event
  • Rule3 Condition
  • Rule3 Action

You can add up to three rules in a visual item.

Filter Instances

Suppose you have 10 Processes with 2 types and want to filter one of the types, you only need to add Entitytype as attribute and add a value to filter on (include). If you want to exclude the value, preceed it with the unequal sign, like this: <>EXTRA