Group Status

Any group may have an optional status that is dynamically calculated as a function of the state of its members. The status is indicated by the group's node color in the System Tree.

For example, a group of Devices is red if at least one device has an error, yellow if at least one device is offline, and green otherwise.

Group Status Calculation

The group status is calculated according to the following rules:

  • Every time a new member is added or an existing member's Member Status Variable is changed, the Member Status Expression is evaluated for the member, generating a member status string.

  • All member status strings are evaluated for against the Status Table, starting from the highest status then checking lower statuses until a match is found.

  • Once all member statuses are calculated, the group status is set according to the highest status of all the group members.

Let's assume that we have a group with five members. The Member Status Expression for each member is evaluated into a string value that is can be 100, 200, 300, 400 or 500 (string constants, not numbers). The example Status Table is made of these values:

This example illustrates how device group status is calculated by default. Default group status settings of a device group are as follows:

Member Status Variable: contextStatus

Member Status Expression: ({status} % 10 != 2 && ({status} - {status} % 10) == 40 ? 1: ({status} % 10 == 1 || {status} % 10 == 2 ? 3: 2))

Status Table:  

See Group Status configuration article for more information.

Was this page helpful?