Inverted Values

Table of Contents

• Accessing Inverted Values

Inverted values are skill data points that invert the value of another skill data point by turning true into false, and false into true. The source data point is referred to as the raw value, and must be either a Boolean data point, or a numeric data point. For numeric data points, the value 0 is interpreted as false, and any other value as true. The inverted value is always a Boolean value.

The inverted value data point supports the same I/O directions as the raw value data point. If the raw value data point supports the input direction, then its value is automatically inverted to obtain the inverted value . If the raw data points supports the output direction, any value written to the inverted value data point is inverted and written to the raw value data point. Both conversions are done automatically and do not require a task to be scheduled.

Accessing Inverted Values

Inverted values have the following members:

Attributes

key	The inverted value’s primary key.
name	The inverted value’s name. The name is the last component of the primary key.
UUID	The unique UUID of the inverted value.
type	The inverted value’s element type. For inverted values, this is always “inverted value”.
category	The inverted value’s category. For inverted values, this is always “data point”.
value	The inverted value’s value. This attribute has the same readability and writability as the raw value’s value attribute, meaning that this attribute is readable if the raw value’s value attribute is readable, and writable if the raw value’s value attribute is writable.
updateTime	The last time the value was updated. This attribute is only available for inverted values whose raw value supports the input direction.
changeTime	The last time the value changed. This attribute is only available for inverted values whose raw value supports the input direction.
quality	The quality of the current value. This attribute is only available for inverted values whose raw value supports the input direction.
error	If the quality attribute is anything but “good”, this attribute contains the error that caused the quality to degrade. This attribute is only available for inverted values whose raw value supports the input direction.

Events

changed

This event is raised when the value, the quality, or the error changes. This event is only available for inverted values whose raw value supports the input direction.

Additionally, the inverted value will inherit all attributes and events related to the input and/or output data from its raw value, as applicable. At least the following attributes are inherited from the raw value data point, if is provides them:

• sourceTime
• writeTime
• writeError

Each individual type of skill data point can have additional attributes and events that are inherited by inverted values. Please refer to the documentation of the specific skill data point for details. Inverted values inherit the same attributes and events as data points.