Domain to XML mappings are used to convert a domain entity to XML, so that it can be sent to other systems. They are used in two different scenarios:
An imported web service uses them to map domain entities to complex XML structures for the request.
An export XML activity needs a domain to XML mapping so that it knows how to map the objects to XML.
The screen is divided in two; on the left side are the domain entities that are mapped to the XML elements. On the right side are gray boxes corresponding to XML elements.
The top level domain entity is considered the parameter to the domain-to-XML mapping and needs to be specified wherever the mapping is called (such as a call web service microflow activity). Thus, the “Obtain the object(s) by” section is disabled for the top level element.
All other domain entities that are mapped to elements need their “Obtain the object(s) by” specified, except for those that are a direct child of a choice element. For those elements, the object is the same as that of the parent choice element.
See Map entity to element for details on mapping an entity to an XML element.
Behavior
Parameter
The entity that specifies the type of object or list that needs to be passed to the domain-to-XML mapping. This is the same entity that is placed opposite the root element of the domain-to-XML mapping.
Common
Name
The name of the mapping.
Folder
The folder in the module where this mapping is located.
Documentation
Extra information on what this mapping does.
Web Service Operation
(only filled in if the mapping is for a web service call and not for an XML Schema)
Web service
The name of the imported web service that this mapping is for.
Service name
The actual name of the service, as it is defined in the WSDL of the imported service.
Operation name
The name of the specific operation in the service that this mapping is meant for.
Parameter name
The name of the parameter that this mapping is for.
Is header parameter
Boolean that displays whether this is a parameter that occurs in the header of the SOAP request.
XML Schema
This is only necessary if the mapping is for an XML schema and not for a web service call.
XML Schema
Name of the XML Schema that this mapping is for.
Start at
Determines which part of the XML structure this mapping defines.