Export With Mapping

Last update: Edit

1 Introduction

The Export with mapping activity allows you to export the data stored in domain model entities into an XML document, JSON document, or string variable.

2 Properties

An example of export with mapping properties is represented in the image below:

export with mapping properties

There are two sets of properties for this activity, those in the dialog box on the left, and those in the properties pane on the right.

The export with mapping properties pane consists of the following sections:

3 Action Section

The Action section of the properties pane shows the action associated with this activity.

You can open a dialog box to configure this action by clicking the ellipsis () next to the action.

You can also open the dialog box by double-clicking the activity in the microflow or right-clicking the activity and selecting Properties.

3.1 Export Mapping

The Export Mapping action defines in which way the data in the domain model corresponds with the XML schema or JSON structure.

3.2 Parameter Type

If the export mapping requires an input, this field shows the type of the input.

3.3 Parameter

If the export mapping requires an input, you can select a parameter of the correct type.

3.4 Content Type

If the export mapping is based on a message definition, it can export both XML and JSON. Choose which type of output you want.

3.5 Validate Against Schema

This determines whether the export action should validate the outgoing XML against the schema (XSD).

Setting this to yes can impact performance!

Default: No

3.6 Optional and Nillable

Elements in a schema can be optional (minOccurs=0) and/or nillable. When an empty value for an element is encountered, the server will check the schema to decide whether to exclude the element (optional) or send the element with a nil attribute (nillable). In case an empty value is encountered but the element is not optional or nillable, the server will throw an exception, which you need to handle yourself in the microflow. This will occur regardless of the XML validation settings. It is recommended to make sure the data that is being exported is valid according to the schema.

3.7 Store In

You can choose whether to store the result of an Export Mapping activity in an object which is a ‘System.FileDocument’ or a specialization of that entity or in a string variable.

3.8 Name

The name of the object or string which is the result of the activity.

4 Common Section

For more information on properties in this section, see Common Properties.