Data formatting, Data formatting -10, 5 data formatting – Echelon i.LON 100 e2 Internet Server User Manual

Page 40

4.5 Data Formatting

In order to keep the

.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

.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

.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

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

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

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.

LON 100 Internet Server Program

4-10

mer’s Reference