Map entity to element

2 minutes to read Download PDF Edit

Object Mapping

The type of domain entity that is mapped to the XML element. Specified in the domain-to-XML mappings screen.

Obtain the object(s) by

Determines where the object comes from.

These properties are not applicable for:

  • The root element, because its objects are passed to the mapping as a parameter.
  • An element that is a child of a choice element, because its object is the same as the choice element’s.

Retrieving associated object(s)

Retrieve by association to an entity higher up in the hierarchy.

Calling a microflow

Retrieve an object via microflow. If the microflow requires parameters, only domain entities are supported. These can by any entity higher up in the hierarchy.. Primitive types (String, Integer etc) can’t be mapped at this time.

If no object(s) were found

What to do if no objects were found via Calling a Microflow or Retrieving associated object(s)

Error

Throw an error and abort the XML mapping. The microflow that called this mapping should handle the error.

Ignore (only if minimum occurrence is 0)

If the minimum required occurrence of the element is 0 (as specified by the XML Schema or WSDL) the element may be ignored. Mapping will continue for the rest of the elements.

Attribute to value element mapping

For each XML value element that the complex XML element encompasses, an attribute needs to be mapped from the entity.

These properties are not applicable for choice elements, because they do not contain value elements.

From attribute

The attribute in the domain entity that should be mapped to the element.

To value element

The XML element that will be filled.

Occurrence

Displays how often the element may occur. This can be “0..1” or “1”, depending on if it is required or not. If you want to never map a value to an optional (occurrence “0”) element, simply disable it in the “Select elements…” dialog in the Domain-to-XML mapping screen.

Convert using (optional)

A microflow to convert the value before insertion into the XML.