Control Module Class

Control Module objects are hierarchical elements of the business structure in the KPI Model Panel.

In the KPI Model Control Modules are elements of an Equipment Module.

There are no child objects for Control Module objects in the KPI Model.

Quick Configuration

  1. In the KPI Model panel, right-click on a Equipment Module object and select Admin  New  Control Module from the context menu.

  2. In the Create Object Wizard, give a name to the object and click Create to create the object in the KPI Model.

Object Properties

Common

Object Name

The user-modifiable object name. This name overrides the name which has been supplied by the external system. It must be unique within the collection of objects of the parent object.

Object Description

This is the user-modifiable object description. This text overrides the description which has been supplied by the external system.

VisualKPI Object

The corresponding Visual KPI object class.

Group ID

The Group ID which gets assigned by VisualKPI.

Translations

Table for translations of property values to various languages.

Attachments

File attachments stored in MongoDB file store.

Options

Compound holding the group options for the KPI visualization.

Show

Show this group in the VisualKPI dashboard.

Display Order

Numeric value that overrides the default alphanumeric order of KPIs. KPIs without explicit display order will be sorted alphanumerically and displayed below KPIs with display order values explicitly set.

Contact

Primary contact for this group. Can be individuals, separated by semicolons, or AD distribution lists.

Group Info Settings

Group info settings.

Info

Additional relevant information (can be hyperlinked).

Info Description

If the Info field is a hyperlinked value, then this will be the tooltip or mouseover text for the link. If only a URL is used, then this will be the text displayed in Info.

Info Display Format

Info display format.

  • Number only: For actual value visualization, only the number part will be used.

  • Number, followed by Engineering Unit: For actual value visualization, the number will be displayed followed by the engineering unit.

  • Engineering Unit, followed by Number: For actual value visualization, the number will be displayed following the engineering unit.

Info Numeric Format

The numeric formatting code (.NET) used to modify how numbers are displayed.

Info Eng. Unit

Unit of measure for the info value (applicable if value is numeric).

Info URL

URL link for the Info field (creates a hyperlink in the Info field).

Sparkline Options

Compound holding the sparkline options for the KPI visualization.

Show Sparklines

Controls whether or not sparklines are shown for KPIs and charts in this group (Sparklines feature must be enabled).

Sparkline Start

Start time of the sparkline (absolute or relative).

Sparkline End

End time of the sparkline (absolute or relative).

Geo Map Options

Compound holding the geographical map options for the KPI visualization.

Zoom Level

Specific to groups (0-21) default Google zooming level.

Geo Label Format

Overrides what is displayed for an object on a geo map.

  • Default:

  • Name:

  • Name: Info:

Column Display Options

Compound holding the column display options for the KPI visualization.

KPI Actual Display Name

Overrides the default actual column name (header) for KPIs in this group.

KPI Target Display Name

Overwrite the name of the KPI target display.

Group Info Display Name

Overwrite the name of the group info.

Show Group Info

Hide/show group info column.

KPI Info Display Name

Overwrite the name of the info display.

Show KPI Info

Hide/show KPI Info.

Chart Info Display Name

Overrides the default info column name (header) for charts in this group.

Show Chart Info

Hide/Show the chart information.

Table Info Display Name

Overwrite the name of the table information.

Show Table Info

Hide/show table information.

Default Group Settings

Default group settings.

Default Tab

Overrides the default tab selection (Groups, KPIs, Charts, etc.) when the Group is selected.

  • Default:

  • System:

  • Groups:

  • KPIs:

  • Charts:

  • Tables:

Group Map Settings

Group Map settings.

Group Map KPI Cell Count

Group Map KPI cell count.

Group Map Header Priority

Group Map header priority.

  • Default: Default.

  • Overall: Overall.

  • Recently Changed: Recently Changed.

Links

List of associated links or URLs (semicolon separated, limit 10) for the object.

Link Descriptions

List of associated Link or URL descriptions (semicolon separated, limit 10) for the object. These are used to both shorten and give better meaning to links (e.g., instead of www.xyz.com?x=5&type=2, the user could see SOPs or Shift Report).

Location

The location of the object.

Strategy

Definition of the location strategy.

  • No location: This object is not interpreted in a location context.

  • Static (or manually changed) location: You may set the location data manually, by Engineering Script or by selecting the location visually using the Location Finder feature.

  • Inherited location: The object inherits the location from the owning object in the system hierarchy.

  • Dynamic location: The object location is supplied by other I/O Items. You may drop other I/O items into the location fields of this object.

  • Location properties: The endpoint server has distinct properties for I/O item location data. Please note, that this option works only for I/O items .

Name

The optional name of a location.

Latitude

The north-south position of a point on the Earth’s surface.

Longitude

The east-west position of a point on the Earth’s surface.

Altitude

The height above sea level of the location.

Track Location

Enables historization of Location data.

Custom Options

Compound to hold various structures to customize the object and to be read and written to by Lua-Script code or external interfaces.

Custom String

A generic string buffer to be used programmatically for custom purposes.

Custom Properties

This is an extensible set of named strings which can be used programmatically for custom purposes.

Property Name

A custom property name which can be used programmatically.

Property Value

The value of the custom property which can be read and written programmatically.

Custom Tables

This is an extensible set of named tables which can be used programmatically for custom purposes.

Table Name

A custom table name which can be used programmatically.

Table Data

Handles an entire table organized in columns and rows. The data can easily (cut, copy and paste) be exchanged with table-oriented data of other software products, e.g. MS Excel.