Client xml to object

No value ($null)

No value ($null)

No value ($null)

n/a

A string that does not define a well-formed XML

Empty character string ("")

abcXYZ

<missingSlashInClosingTag>XYZ<missingSlashInClosingTag>

n/a

ProcessException:Failed to parse

A well-formed XML that contains only text as content in an arbitrarily named root element.

<obj>123E4 </obj>

123E4(String)

n/a

A well-formed XML with a root element whose (simple) content can be converted to the class specified in the applicable class field (here: class).

<obj class="java.lang.Double">123E4</obj>

1230000.0
(Double value)

►NOTE ◄ The original string 123E4 is interpreted considering the rules for the Java Double class and gives the numerical value 123 x 10^4 (1230000.0) as an exponential number.

{
"textContent": "123E4",
	"class": "..."
}

(Client object in JSON notation)

►NOTE◄ If the input value 123E4 is interpreted without considering the Double/Long class, there is access to the original string via the automatically generated textContent property and to the name of the 'actual' class via the class property.

n/a

A well-formed XML with a root element whose (simple) content cannot be converted to the class specified in the applicable class field (here: class).

<obj class="java.lang.Long">123E4</obj>

No value ($null)

►NOTE ◄ The original string 123E4 is interpreted taking into account the rules for the Java Long class . The interpretation of the exponential notation (123 x 10^4) is not supported for Long in contrast to Double.  Therefore, 'no value' is returned.

n/a

A well-formed XML with a root element for which a class unknown in context is specified in the applicable class field (here: class).

<obj class="fancy.Number">123E4</obj>

{"textContent": "123E4",
	"class": "fancy.Number"}

(Client object in JSON notation)

n/a

A well-formed XML whose root element refers to a root element type defined for the server (here: "incident") and can be successfully validated against its schema.

<alert class="de.lobster.scm.scem.incident:Incident"><incidentState class="string">NEW</incidentState><incidentSource class="string">SCHEDULED</incidentSource><incidentSeverity class="string">HIGH</incidentSeverity><additionalInformation> ... </addtionalInformation></alert>

►IMPORTANT◄ The incidentState, incidentSource, and { incidentSeverity properties get their values from dynamic enumerations. The strings assigned in the example use the internal names of the corresponding values. For the automatic conversion from string to dynamic enumeration value to work, the relevant element must be explicitly assigned the class string (or java.lang.String) in the class attribute.

{
	"class": "de.lobster.scm.scem.incident.Incident",
	"affectedEntities": null,
	"created": null,
	"creatorId": "0",
	"id": "0",
	"incidentSeverity": HIGH,
	"incidentSource": SCHEDULED,
	"incidentState": "NEW",
	"incidentType": null,
	"lastModified": null,
	"lastModifierId": "0",
	"ownerId": "0",
	"partialLoaded": false
}

(New Incident entity – see SCEM Incident –in JSON-Notation)

►NOTE◄ Contents that are not provided for in the data model of the class (in the example: additionalInformation) are 'missing' in the created entity. Instead, default fields with default values for their data model appear here (e.g.: id=0).

{
"additionalInformation": ...	
"incidentState": {
		"textContent": "NEW",
		"class": "string"
	},
	"incidentSource": {
		"textContent": "SCHEDULED",
		"class": "string"
	},
	"incidentSeverity": {
		"textContent": "HIGH",
		"class": "string"
	},
	"textContent": "NEWSCHEDULEDHIGH",
	"class": "de.lobster.scm.scem.incident:Incident"
}

(Client object in JSON notation)

►NOTE◄ The client object reflects all the information from the XML, but maps it without any consideration of classes referenced in different layers.

n/a

Within an Execute with event action, the list of all weather reports (metar elements in the XML) from the file shall be considered as a different reference object. The following concatenation of value resolvers enables the XML file to be converted into a 'list object':

• The File reference value resolver reads the file from the directory ./upload/wx/metar.xml and returns.

• The chained Input object (type safe) 'reads' the content of the file (XML text).

• The chained Replace text value resolver is needed to add a class attribute to the first tag of the XML structure, which is required so that the root element (named avmet, see above) is parsed as a list object (java.util.List) in the next step. The replacement is controlled by a regular expression (see screenshot).

• The prepared XML is passed to the chained Client xml to object value resolver, which, taking into account the inserted class mapping for the root element, returns a list of objects whose fields reflect the contents of one metar element each.

►NOTE◄ In the Execute with event action block, this list could, for example, be searched by a Rule list resolver for a weather report for a specific airport identified by an Entity property rule for the icaoAdId property.