Instruction Manual

4.5 Data Formatting
In order to keep the i.LON SOAP/XML interface neutral across regions, most of the rules for
formatting data, which would normally be changeable in LNS, are not changeable on the
i.LON 100. The one exception is the support of measurement system locale which is new in
version 1.1. The following list describes the various regional settings used by the i.LON 100
SOAP / XML interface:
Decimal Symbol – Always period "."
Precision – Single floats always use 7 digits of precision, including digits before and after
the decimal point. Double floats always use 14 digits of precision. For the rest of the base
types, precision is determined by the type definition
Digit Grouping Symbol – Always comma ","
Digit Grouping – Always in the form "123,456,789"
Negative Sign Symbol – Always the minus sign "-"
Negative Number Format – Always "-1.1"; negative symbol in front, and no space between
the symbol and the number
List Separators – If the format uses the localized list separator symbol verticle bar "|", the
i.LON 100 will replace it with comma ",". However, if you define a new type in the
NodeBuilder Resource Editor which is a structure, array or union, the default list separator
is space " ". The localized list separator must be explicitly specified in the format.
Measurement System – The i.LON 100 does not use localization settings for measurement
system. The measurement system used to display a formatted value is determined by the
UCPTformatDescription property of the data point. For example, if you have a data point
whose format is defined as SNVT_temp_f#US, then the UCPTvalue written to the
DataServerRead SOAP message will be in Farenheit. If that data point is an input to the
AlarmGenerator, then the format of a property which specifies a comparison value, a delta or
an offset like UCPThighLimit2Offset will also be in US units when you read it with the
AlarmGeneratorGet function. Furthermore, you must use US units when setting the
property with the AlarmGeneratorSet function. You should note that the value stored in the
XML file will always be in SI units so that XML files may be shared between i.LON 100s.
The rule used by the applications is that the format of the primary data point for the
application instance determines the format of measurement system dependent properties,
like offsets, comparison values and deltas.
i.LON 100 Internet Server Program4-10 mer’s Reference