Active Dashboard palette

Overview Copied

The Active Dashboard Palette allows you to add contents to a dashboard and create your own tools. To open this in Active Console, you can either:

• Go to View > Active Dashboard > Show Tool Palette .

Beginning Active Console 5.5.x, the Managed Entity display name is used in the user readable path. This also reflects in the charts and widgets legends in the Active Dashboard. For dashboards that are configured in the Active Console 5.4.x and below, the user readable path of the charts and widgets legends retain its original value. However, you can manually update the display names.

Dashboard palette groups Copied

The dashboard palette consists of a set of groups which has a number of tools or objects to choose from. The palette consists of the following groups by category:

• 3D Shapes — the tools in the group are three dimensional basic shapes. These are used as building blocks for some of the more complex three dimensional shapes, such as the infrastructure tools. Many of the 3D shapes are created from groups of simpler objects.
• Backgrounds — all of the tools on this category are generic dashboard backgrounds.
• Basic Shape — these are the building blocks of dashboard diagrams. See Configure basic shape properties.
• Block Arrows
• Call Outs
• Frames — the tools in this group are all titled frames which can be used as part of a dashboard layout. In each case, you can link the object to the severity of a data item or create a hyperlink from the object to a data item. You can also link the frame title to the name of a data item.
• Hyperlinks
• Infrastructure
• ITRS Dark Theme Icons
• ITRS Dark Theme Shapes
• ITRS Light Theme Icons
• Lines — these are created with the line tool. Each line object has its standard appearance settings like the other shapes. See Configure lines properties.
• Widget — these are the key preconfigured tools that enable you to easily display data in the Active Dashboard.

By default, when one group is expanded, the palette collapses the other group. If you want more than one group to open at a time, then right-click in the palette and disabled the Auto Minimise Groups.

The table below lists the tools in the dashboard palette groups:

Hidden tools Copied

The Active Dashboard Palette contains a group of tools that are hidden by default. To displays the hidden tools, right-click the screen of the Active Dashboard Palette > Show Hidden Tools.

• 3D Shapes for Data Items
• Breach Predictor
• Data Item Tools
• Historical — the tools in this group are used to create a Line Chart or Spark Chart using historical data, or to add historical data to an existing chart.
• Indicators
• Time Series

The table below lists the hidden tools in the dashboard palette groups:

Tool properties Copied

To open the properties of the selected tool in the dashboard palette:

1. Right-click the selected tool.
2. Click Properties.

The Tool Configuration dialog appears on the screen:

The Tool Configuration dialog has the following options:

Configure basic shape properties Copied

To configure the properties of the basic shapes:

1. Select the shape you want to use in the Active Dashboard Palette.
2. Drag and drop the shape into the Active Dashboard canvas.
3. To access the object’s properties, perform any of the following:

• Right-click the shape and click Properties.
• Select the shape and press CTRL + Enter.
• Modify the properties using the Object Inspector.

This opens the Object Attributes dialog for basic shapes:

Object appearance properties Copied

These are the properties of a shape that you can change on the Appearance tab in the Object Attributes window:

Object text layout settings properties Copied

With the exception of lines, all basic objects can contain text. The text tool, rectangle tool, and ellipse tool create the same type of basic canvas object.

When an object is able to display a text, Text Layout Settings is available in the Object Attributes window.

The following properties are available on the Text Layout Settings tab:

Change the default font and display Unicode characters in label text Copied

Active Dashboard supports Unicode characters for dashboard labels and texts. To change the default font and display Unicode characters:

1. Install the font you need if it does not exist from the text layout font option. The font must be a valid and existing system font before it can be used.
2. Indicate the name of the font under the -dashboardDisplayFont flag in ActiveConsole.gci:

-dashboardDisplayFont
MingLiu

Note

If you are displaying Unicode characters, the font must have the specific Unicode characters you need (for example, MingLiu - Japanese and Chinese, Batang - Japanese and Korean).

For fonts with names that have Unicode characters (example, MS ゴシック, ＭＳ Ｐ明朝), it is required to convert the file encoding of ActiveConsole.gci from ANSI to UTF-8. You can do this by using the Save As option in Notepad.

These settings change the following:

• Chart headers, labels, and legends of dashboard objects that display texts, but these do not have a text font selector for Line Chart, Pie Chart, and Gauge.
• Default selected font of shapes and objects that have a text font selector do not change the fonts of existing shapes or objects in the dashboard.

Create complex and arbitrary shapes Copied

You are not restricted to the default shapes available in the Active Dashboard Palette. The dashboard allows you to define arbitrary polygons and other objects. There are two main ways to construct new shapes:

• Shape amalgamate, subtract, and intersect — allows you to modify existing shapes by adding and subtracting the areas of other shapes from the target.
• Edit properties directly option — shapes are made up of a number of segments, where each segment is a straight line or curve (a square is made up of four segments). It is possible to add, remove and modify segments directly.

Amalgamate selected shapes Copied

You can build up more complex shapes from basic shapes by using the Amalgamate selected shapes functionality.

To use the amalgamate selected shapes function:

1. Drag and drop a set of objects into the Active Dashboard canvas.
2. Select all the objects simultaneously.
3. Right-click the selected object.
4. Click Shape and click Amalgamate selected shapes.

In this example, four ellipse objects are combined manually:

• Selecting all ellipse objects display each object’s control points. It means that each object has still its own set of properties that you can configure.
• When you amalgamate the selected shapes, the dashboard combines the selected shapes, remove the overlapping lines, and making it a new object. This displays only one control point for the new selected object.

Subtract selected shapes Copied

The Subtract selected shapes function deletes the area of the other selected shapes from the selected item, which is the opposite of the Amalgamate selection shape function.

To use the subtract selected shapes function:

1. Drag and drop a set of objects into the Active Dashboardcanvas.
2. Select all the objects simultaneously.
3. Right-click the selected object.
4. Click Shape and click Subtract selected shapes.

In this example, four square objects are placed manually into the end points of the bigger object:

• Select all five objects so you can see their own control points.
• Right-click the bigger object to delete the area of the other selected shape (four square objects).
• When you subtract the selected shapes, the four square objects delete the area of the other selected shapes from the selected item, and making it a new object. This displays only one control point for the new selected object.

Edit object properties directly Copied

This functions allows you to modify the hidden segment points of the selected objects.

To edit objects directly:

1. Drag and drop the selected shape into the Active Dashboard canvas.
2. Right-click the selected shape and click Edit Properties Directly.
3. Alternatively, you can press ALT and click the shape.

New red and blue segment control points appear around the edge of the selected shape. Dragging these control points modify the shape of your object. You can add additional shape segments, and modifying these control points accordingly.

In this example, the square object has changed into a new object using the segment control points:

Configure shape segment Copied

The shape segment adds more segment control points so you can modify the existing shape.

To add a new segment control point:

1. Right-click the existing segment control point.
2. Select Shape Segment.
3. Click Insert New Segment.

Types of segment Copied

The dashboard is capable of adding curved segments to the selected shape.

There are three types of segment:

• Single-Point — creates a simple straight line between its adjoining segments.
• 2-Point Curve — creates two control points. One point determines the segment end, while the other can be used to change the curve on the segment. This curve bends in just one direction.
• 3-Point Curve — creates three control points. One point determines the segment end, while the other two determine the bend points. This is similar to a Bezier curve where it can bend in two separate directions.

Configure lines properties Copied

To configure the properties of the line:

1. Select the line you want to use in the Active Dashboard Palette.
2. Drag and drop the selected line into the Active Dashboard canvass.
3. Perform any of the following:

• Right-click the line shape, and click Properties > Line Format.
• Select the shape and press CTRL + Enter . Then, click Line Format.
• Modify the properties using the Object Inspector.

The properties of a line that you can change on the Line Format tab are:

Add line control points Copied

Lines can have multiple control points so these can be configured and repositioned in the dashboard. To add an additional control point to the line:

1. Right-click the selected line.
2. Click Add Control Point.

Alternatively, you can hold down ALT and then press and drag the mouse at the point in the line where you want the new control point to appear.

Auto anchor lines Copied

Auto anchor lines automatically connect lines over the top of the selected objects. If disabled, you can select and drag the control point in any part of the selected objects.

To enable this feature:

1. Right-click the selected line.
2. Click Auto Anchor Lines.

Alternatively, you can hold down ALT and then press and drag the mouse at the point in the line where you want the new control point to appear.

Auto lock line angles Copied

Auto lock line angles allow lines to auto-lock at 90 degree angles when you position it around the object in the dashboard. It retains the line while it is being moved around and repositioned. This makes it easier to create large complex diagrams that remain neat.

Configure grouped objects Copied

Selecting multiple objects is different from grouping the selected objects. To group the selected objects and configure the group:

1. Drag and drop two or more objects into the Active Dashboard Palette.
2. Select all the objects.
3. Right-click the selected objects.
4. Select Arrange.
5. Click Group.
6. Right-click the grouped objects and click Properties.

This opens the Group Properties dialog:

The Group Properties has almost identical options as when configuring an object property. The only field that is specific for grouped object is the Atomic Group option. If the Atomic Group is enabled, you cannot ungroup the object.

Note

You can still access the properties of each object within a group by pressing ALT and right-clicking the object.

If a set of dashboard objects that have no common settings, such as widgets and basic shapes, are selected, then the Active Dashboard displays the No Common Properties error message.

Copy and link object styles Copied

You can copy and link the styles of selected dashboard objects to make other dashboards look the same, or even update their styles based on changes in the source object.

To copy the style of an object:

1. Right-click the selected object.
2. Select Stye > Copy Style. This object is known as the source object.

To apply the style to another object, right click on the selected object and select one of the following functions on the Style menu:

• Apply Aesthetic Style — changes the visual properties of the target object to match the source object. This includes the appearance colour, transparency, border, and text properties settings. However, this does not change the shape and size of the target object.
• Apply Shape Style — changes the shape of the target object to match the source object.
• Apply Aesthetic and Shape Style — changes the shape and visual properties of the object to match the properties of the source object.

To link the style of the target object to that of the source object:

1. Copy the style of the source object.
2. Right-click the target object and click Style > Link Aesthetic Style.

Whenever you change the style of the source object, the target object automatically updates with the same style. This function only modifies the visual properties. It does not update the shape, or size of the target object.

Arrange dashboard objects Copied

There are number of functions supported by the dashboard for arranging dashboard objects with respect to each other. Right-click the selected object and navigate to Arrange. This shows he following list of options:

• Group — combine several objects into a group to treat them as a single object.
• Ungroup — disassociates the object from the group.
• Move to front — moves the selected objects in front of all other dashboard objects.
• Move to back — moves the selected objects behind all other dashboard objects.
• Align Left — aligns the selected objects, so that their left most points are equal to the left most object at the time the function is used.
• Align Right — aligns the selected objects, so that their right most points are equal to the right most object at the time the function is used.
• Align Center — aligns the centre of all the selected objects so that these are in straight line from top to bottom.
• Align Top — aligns the selected objects, so that their upper most points are equal to the upper most object at the time the function is used.
• Align Bottom — aligns the selected objects, so that their lowest most points are equal to the lowest most object at the time the function is used.
• Align Middle — aligns the middle of all the selected objects so that these are in straight line from left to right.
• Distribute Horizontally — distributes the selected objects so that are equally spaced, and not overlapping, from left to right.
• Distribute Vertically — distributes the selected objects so that are equally spaced, and not overlapping, from top to bottom.

Hide and unhide selected objects Copied

If there are many stacked objects in the Active Dashboard, you can temporarily hide the object. To do this, follow these steps:

1. Right-click the object.
2. Click Temporarily Hide Selected option to hide it.

To show the hidden objects, follow these steps:

1. Right-click anywhere in the Active Dashboard canvas.
2. Click Unhide All.

Configure grouped objects Copied

Selecting multiple objects is different from grouping the selected objects. To group the selected objects and configure the group:

1. Drag and drop two or more objects into the Active Dashboard Palette.
2. Select all the objects.
3. Right-click the selected objects.
4. Select Arrange.
5. Click Group.
6. Right-click the grouped objects and click Properties.

This opens the Group Properties dialog:

The Group Properties has almost identical options as when configuring an object property. The only field that is specific for grouped object is the Atomic Group option. If the Atomic Group is enabled, you cannot ungroup the object.

Note

You can still access the properties of each object within a group by pressing ALT and right-clicking the object.

If a set of dashboard objects that have no common settings, such as widgets and basic shapes, are selected, then the Active Dashboard displays the No Common Properties error message.

Copy and link object styles Copied

You can copy and link the styles of selected dashboard objects to make other dashboards look the same, or even update their styles based on changes in the source object.

To copy the style of an object:

1. Right-click the selected object.
2. Select Stye > Copy Style. This object is known as the source object.

To apply the style to another object, right click on the selected object and select one of the following functions on the Style menu:

• Apply Aesthetic Style — changes the visual properties of the target object to match the source object. This includes the appearance colour, transparency, border, and text properties settings. However, this does not change the shape and size of the target object.
• Apply Shape Style — changes the shape of the target object to match the source object.
• Apply Aesthetic and Shape Style — changes the shape and visual properties of the object to match the properties of the source object.

To link the style of the target object to that of the source object:

1. Copy the style of the source object.
2. Right-click the target object and click Style > Link Aesthetic Style.

Whenever you change the style of the source object, the target object automatically updates with the same style. This function only modifies the visual properties. It does not update the shape, or size of the target object.

Arrange dashboard objects Copied

There are number of functions supported by the dashboard for arranging dashboard objects with respect to each other. Right-click the selected object and navigate to Arrange. This shows he following list of options:

• Group — combine several objects into a group to treat them as a single object.
• Ungroup — disassociates the object from the group.
• Move to front — moves the selected objects in front of all other dashboard objects.
• Move to back — moves the selected objects behind all other dashboard objects.
• Align Left — aligns the selected objects, so that their left most points are equal to the left most object at the time the function is used.
• Align Right — aligns the selected objects, so that their right most points are equal to the right most object at the time the function is used.
• Align Center — aligns the centre of all the selected objects so that these are in straight line from top to bottom.
• Align Top — aligns the selected objects, so that their upper most points are equal to the upper most object at the time the function is used.
• Align Bottom — aligns the selected objects, so that their lowest most points are equal to the lowest most object at the time the function is used.
• Align Middle — aligns the middle of all the selected objects so that these are in straight line from left to right.
• Distribute Horizontally — distributes the selected objects so that are equally spaced, and not overlapping, from left to right.
• Distribute Vertically — distributes the selected objects so that are equally spaced, and not overlapping, from top to bottom.

Hide and unhide selected objects Copied

If there are many stacked objects in the Active Dashboard, you can temporarily hide the object. To do this, follow these steps:

1. Right-click the object.
2. Click Temporarily Hide Selected option to hide it.

To show the hidden objects, follow these steps:

1. Right-click anywhere in the Active Dashboard canvas.
2. Click Unhide All.