Administrator HandbookTOC

Building hierarchical view

Goal of this case

The goal of this case is to create a hierarchy of Active Views. The father active View will be use to control the global status of child Active Views. We will have two dynamic graphic objects in the father Active View that should change if the status of one of the dynamic graphic object located in the associated child Active View change. In our example we decide to color in red the building representing the child global graphic object if one of the graphic object in the child become red.

As displayed in the following drawing the father Active View is used to monitor childs. If something happens in the child the father should reflect this change. The administrator is notified by the color change and can double click on the object of the child and diplay the child active view to find the defect object.

hierarchical view



The LoriotPro Active view are by design totally independant. We can compare them to WEB pages and html navigation.
To achieve our goal we need to use the event notification that are available with active view graphic object.

A dynamic object has a polling frequency, that is used to update the color of the backgroud of the graphic object.
It can also be used to send an event to the Event Manager.

Each time an event is generated a counter of this event is incremented.

We will read this counter in the building graphic object located in the father Active View to check if one of the child objet is in red state.

hierarchical active view concept

For each object of the child, we will have to add the send event 10000 action on the red state condition.

Steps summary

From our previous explanations the following steps should be performed.

  1. Create one new event number for each child.
  2. Create Father Active View and create one graphic object per child Active View.
  3. Create the child Active View(s).
  4. In the father Active View set the dynamic aspect of the graphic object and create rules based on the value of the event counter.
  5. For each child Active View and for each dynamic object in a child configure the rules for sending the associated child event.
  6. Add a reset counter button in the father to acknowledge the default.

Declare the new events

First of all we need to declare the new events that we will use in the object rules.

The event 10000 is used to notify a red status of any object in the Child 1 Active View.
The event 20000 is used to notify a red status of any object in the Child 2 A0c c bnnnnnnnnnnnnn tive View.

From the main menu, select the configure option and the Register new event number option

register new event menu

We enter 10000 as event number and Child 1

event creation

When done click on the Register or Modify button

We enter 20000 as event number and Child 2

event declaration

Creating the Father Active View

To create the father Active View we proceed as explain in the previous chapters. We have selected the LoriotPro host object, open the contextual menu and selected the Insert task option. Then we have selected the Active View option. We have name the Active View Father and add the two graphical objects.

father active view

When done we can set the dynamic option of each graphical object.

Let start by objet Child 1.

We configure first the mouse double click action. We open the object properties window, select Mouse action and in the ACtion type combo box we select the "Show Directory Active View or Plugin" option.

mouse double click action

We choose to use the Wizard and select the Child 1 Active View

Active View wizard selection

In the parameter field we get something like:

show_view 4864909984460177417

The number below is the unique number that identify our Child 1 Active View objet in the LoriotPro directory (the UID)

When done we can do the same operation on the Child 2 graphical object.

Back to the father ACtive View test the double click action on both child objet.

Next step consist of creating the rules that will change the color of our objects.

Open the graphic object property window and click in the Activate Dynamic Aspect

The select Get event reference status. This option reads the counter of events received with this event number.

graphic object dynamic aspect expression

The next pop up ask you to open the wizard.

call wizard

Answer no if the event is not yet defined in the event filter list, the next window is displayed.

Type the Get reference status expression followed by the event number to read, 10000 in our example.

Next step consist of loading a predefined set of rules. CLick on the Load filter button.

Load filter button

The Open file dialog bos is dispalyed, select the objectstatus.cte template

Select filter template

The pop up window asks you to confirm the deletion of any existing rules.

Delete Expression Filter

Answer Yes.

Next pop up asks you to select a host IP address, answer No

Host IP address

The set of rules are added

The Child 1 object is set, proceed with the same steps for the configuration of the Child 2 object.

Creating the child Active View

Create the Child 1 Active View and for each dynamic objects of this view, we modify the rules as explained here after.

We will use the Router 1 objet of the view.

Child 1 Active View

Open the properties windows of the routeur 1 object.

router 1 properties

The rules of the object in our example used the current status of the host in the directory. The status of an object depends of the result of the ping and snmp ping polling.

Select the rule with value 4 and click on the Set Event box

Choose the event 10000 in the list or enter 10000 in the event number field.

Next select the IP address destination where this event will be sent. This is the LoriotPro host IP address.

Set event IP address destination

Select the level of the event. The level defines the color of the event line in the log. We choose 4 (a red triangle) in our case.

The configuration is done for this object.

Each time that the rule 4 will be sastified the router 1 object will become red and an event 10000 will be fired.

Proceed for all object in the child 1 view that should generate event 10000

Do the same for the child 2 Active view but object wil generate event 20000.

How to check the configuration

To check the configuration we should proceed step by step.

First we check that the event is fired by the child object when the condition is sastified.

In our example, the router 1 in the Child 1 Active view is in default, in red color according to our rules.

The event 10000 is triggered at each polling interval set in the parameter of the Active View routeur 1 object.

We can now check what is the value seen by the Child 1 graphic object in the father Active View.

Open the father Active View, select the child 1 object and open the contextual menu.

select the Get information option.

The Last result give you the counter value of the event 10000. If this counter is equal to 0 according to our rule the object is green, if the value is higher than 0 the object is red.

counter is under 0 event counter 10000 is higher than 0

Remark that object will stay red even if the child object becomes green. We have to reset the event 10000 counter to comme back to the green state.

How to reset the Event counter from the Active View

When the problem is corrected the Router 1 object is green again but the child 1 father object stay red. This is normal because the counter is not longer increasing but it is different from 0.

The counter can be reset directly from the father view.

We could add two new objects in the view that display the counter value and a reset button.

In the father view, in edit mode, drag an outlined text object under the child 1 object.

Check the Fill text object option.

Back to the Active View you should see the current counter value.

We add a reset button under the counter value and we configure the double click action on this button

You should leave the Active View edit mode and switch to the process mode for testing the action of this button

A double click on this button display the folowing window :

acknowledge event

Click the Ack button to reset the counter.

The father and the child when everything is OK.

working mode

The router 1 is in default in the Child 1 Active View, the father child 1 in the father object is also red, the counter of event 10000 is higher than 0.

default mode