On this page there is information about the representation the different types value. Basically these types are separate logically into two groups – simple value and complex object values. The simple values are:

• string,
• numeric, etc.
• reference values
• scripting expressions.

The group of the complex object values includes:

• map,
• collections,
• arrays, etc.

The value must be presented in only one way – by only one XML attribute (simple value) or by XML child elements (complex object value).

Simple Value

The simple values are presented by using XML attributes on the corresponding element. The possible XML attributes are:

• "value" – an optional XML attribute. It holds the simple value.
• "script" – an optional XML attribute. It holds the script expression, that should be evaluated. Refer to Scripting in Mapping for detailed information about the scripting in XML mapping.
• "ref" – an optional XML attribute. It holds the reference value. The possible values are:
  • "sourceValue" – the reference to the Source Device Item property.
  • "targetValue" – the reference to the Target Device Item property.
  • "targetOperation" – the reference to the Target Device Item operation.
  • "returnValue" – the reference to the returned value of the Source Device Item operation.
• "xsi:nil" – an optional XML attribute. It is used with value "true" to represent the null value. If this attribute is used with value "false", the represented value must not be null. Then the value must be represented as a complex object value, described below.

Complex Object Value

The complex object value is presented by using XML corresponding child elements – <map-value> or <array-value> (depends on the type of the value). If the value is of map type, the <map-value> should be used. If the value is of type collections, arrays, etc, then <array-value> should be used .

<map-value>

The <map-value> element has zero or many child elements <element>. The <element> tag has required attribute "key" that holds the key of the presented map. The value of the map is possible to be simple value or complex object value. If the value is a simple value, then it should be presented as XML attribute on XML element <element>. The possible XML attributes for simple value are presented in the section Simple Value above. If the value of the map is complex object value, then the child elements on the XML element <element> – <map-value> or <array-value> described bellow, should be used.

<array-value>

The <array-value> element has zero or many child elements <element>. The <element> holds the representation of the value. If the value is simple value, then should be presented as XML attribute on XML element <element>. The possible XML attributes for simple value are presented in the Simple Value section above. If the value is complex object value, then the child elements on XML element <element> – <map-value> or <array-value> should be used .