kitControl-StatusStringToStatusNumeric
This component converts a StatusString value to an StatusNumeric value.
StatusStringToStatusNumeric is available in the Conversion folder of the kitControl palette.
The input string must contain only numeral characters, and optionally one period (.) for decimal notation. Valid input strings examples are 145678 or 34.81. Leading and/or trailing space characters are allowed and ignored. Any other input string characters (for example, alpha, punctuation) result in a fault status.
| Property | Value | Description |
|---|---|---|
| Facets | Config Facets window (defaults to null for units and one decimal place of precision) | Selects unit and configures how the value displays: units define the unit of measure from acceleration to volumetric flow. precision defines the number of decimal places. This configuration applies to the In property value. |
| Out | read-only number | Displays the converted target status numeric value. |
| In | number and null definition (defaults to 0) | Displays the source status text. When null is checked, the value displayed defaults to the incoming value from the device. If you remove the check mark you can configure the In value. |
| On Null In Value | drop-down list (defaults to Use In Value) | Configures how to handle null values. Use In Value outputs the Out 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. If this modified component links to another StatusString property, the framework ignores the null value. But, if connected to a StatusStringToStatusNumeric component, 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 Out value is null. |
| Out Value On Null | number | Defines an In value for the conversion object when its Out value has a null status. |