CustomData

<< Click to Display Table of Contents >>

 

CustomData

Text Configures or returns optional properties of devices, in XML format. The default value of this property is empty. The next code contains an example of the content of a file in XML format for use with this property.

<CustomData>
  <Property name="Property1" type="String">Value1</Property>
  <Property name="Property2" type="Integer">123</Property>
  <Property name="Property3" type="Boolean">true</Property>
</CustomData>

 

NOTES

Notice that the names of nodes (CustomData and Property) and attributes (name and type) is case-sensitive, that is, CustomData is different from customdata and name is different from Name.

On the other hand, the content of the Property node and the content of the name and type attributes is not case-sensitive.

The type attribute is optional and, if omitted, indicates that the content of the Property node is a String.

Possible values for the type attribute are Boolean, Byte, Date, Double, Empty, Integer, Long, Null, Single, and String.

 

In the case of the Date data type, possible values may have the following formats:

YYYY-MM-DD (year, month, and day)

HH:mm:ss[.000] (mandatory hours, minutes, and seconds and optional milliseconds)

YYYY-MM-DD HH:mm:ss[.000] (mandatory date and time and optional milliseconds)

 

NOTES

The format of the Date data type does not depend on Windows Regional Settings.

Using a date with the value "0000-00-00" results in a time value, even if time was not informed, that is, the result is equal to "00:00:00".

Formatting a date with the value "YYYY-MM-DD 00:00:00" results in a value with year, month, and day, discarding time.

Milliseconds are only added to time if its value is different from 0 (zero).

Times cannot be represented in AM-PM format, the 24-hour format is always used.

 

For more information about the behavior of this property, please check topic Configuration of CustomData Property on Elipse Water User's Manual.

Was this page useful?