kitControl-StatusBooleanToBoolean

This component converts a StatusBoolean In value to a simple Boolean Out value. This component is the reverse of the BooleanToStatusBoolean component.

StatusBooleanToBoolean is available in the Conversion folder of the kitControl palette.

This component converts an units output from a source component to the units of the target component. Such conversion is automatic. But, if needed, you can use this component to convert between:

Source Out of a point, kitControl, or Schedule object (status value), to a
Target non-status In value of a property in an extension or other component.

For example, to link the Out of a Schedule object to the Enabled property of a history extension of a point or object, you link a StatusBooleanToBoolean object between the two.

Figure 31. StatusBooleanToBoolean properties

Property	Value	Description
Facets	Config Facets window (defaults to true and false)	Defines the text to display for each Boolean value. `trueText` configures the text to describe the state when the component returns true. `falseText` configures the text to describe the state when the component returns false. This definition applies to the `In` property value. What text to define depends on how you are using the component.
In	`true` and `false` (default)	Displays the source status Boolean value.
Out	read-only StatusBoolean `true` and `false`	Displays the converted target simple Boolean value.
On Null In Value	drop-down list (defaults to Use In Value)	Configures how to handle null values. `Use In Value` outputs the `In` default value when the result of the conversion is null. Normally, the `Fallback` property for a given point defines the meaning of null as 0.0. If, during configuration, the null status check box is unchecked and another value entered and saved, the changed value becomes the new null value for the point. For example, a NumericWritable point (proxy point) positions a damper from 0 to 100% open. In the point’s configuration, its `Fallback` property defaults to a null value of 0.0. If this null status is unchecked and another value, such as 20, is entered and saved, the new value becomes the default when the value for the point is null. If this modified component links to another StatusNumeric property, the framework ignores the null value. But, if connected to a StatusBooleanToBoolean, the result of a null input value defaults to the changed value, which may not be what you intended. `Specify Out Value` adds the `Out Value On Null` property to this component. Configure it to return a reasonable value when the `In` value is null.
Out Value On Null	number	Defines an `Out` value for the conversion object when its `In` value has a null status.

kitControl-StatusBooleanToBoolean

Figure 31. StatusBooleanToBoolean properties

Related Links