Mapping - serves to design the output XML in a visual environment;

Source - allows you to directly edit the XML mapping source code.

Include - defines the inclusion pattern, i.e. which fields should be included in the automatically generated list. This is defined by an expression whose syntax is $port.field. A good use of expressions explained above can be made here. Include can be left blank provided Exclude is set (and vice versa). If Include is blank, XMLWriter lets you use all ports that are connected to nodes up above the current element (i.e. all its parents) or to the element itself.

Exclude - lets you specify the fields that you explicitly do not want in the automatically generated list. Expressions can be used here the same way as when working with Include.

Element name - name of the element as it will appear in the output XML.

Value - element value. You can map a field to an element and it will populate its value. On the other hand, if you map a port to an element, you will create a Binding (see Creating the Mapping - Mapping Ports and Fields). If Value is not present, right-click the element and choose Add Child - Text node. The element then gets a new field representing its text value. The newly created Text node cannot be left blank.

Write null attribute - by default, attributes with values mapping to NULL will not be put to the output. However, here you can explicitly list names of attributes that will always appear in the output.

<date/>

<date time="" />

Omit null attribute - in contrast to Write null attribute, this one specifies which of the current element's attributes will NOT be written if their values are null. Obviously, such behavior is default. The true purpose of Omit null attribute lies in wildcard expressions in combination with Write null attribute.

Hide - in elements having a port connected, set Hide to true to force the following behavior: the selected element is not written to the output XML while all its children are. By default, the property is set to false. Hidden elements are displayed with a grayish font in the Mapping editor.

<address>
    <city>Atlanta</city>
    <state>Georgia</state>
</address>
<address>
    <city>Los Angeles</city>
    <state>California</state>
</address>

<city>Atlanta</city>
<state>Georgia</state>
<city>Los Angeles</city>
<state>California</state>

Write null element - decides, whether to write an element which has no value (but it may have some attributes).

true - writes null elements

<emptyElement/>

false - does not write null element; an element having an attribute with a value assigned is not considered as empty

<emptyEmement attr="value"/>

false - exclude if inner content is null - does not write a null element; only content of the element is taken into account. (Even if it has attributes with value assigned is considered as empty).

Write raw value - this property allows to insert pre-prepared XML string into a document

false - default, always escapes the value; for example, for a value <user id="1">John</user> and element elem the output would be

<elem>&lt;user id="1"&gt;John&lt;/user&gt;</elem>

true - the value is inserted unescaped, so the example above would look like

<elem><user id="1">John</user></elem>

Partition - by default, partitioning is done according to the first and topmost element that has a port connected to it. If you have more such elements, set Partition to true in one of them to distinguish which element governs the partitioning.

Please note that partitioning can be set only once. That is if you set an element's Partition to true, you should not set it in either of its subelements (otherwise the graph fails). For a closer look on partitioning, see Partitioning Output into Different Output Files.

<person clover:inPort="0">   		
    <firstname> </firstname>
    <surname> </surname>
</person>

<invoice clover:inPort="1" clover:partition="true""">   		
    <customer> </customer>
    <total> </total>
</invoice>

Write null element - use the $port.field syntax to determine which elements are written to the output despite having no content. By default, if an element has no value, it is not written. Write null element does not have to be entered on condition that the Omit null element is given. Same as in Include and Exclude, all ports connected to the element or up above are then available. See example below.

Omit null element - use the $port.field syntax to skip blank elements. Even though they are not written by default, you might want to use Omit null element to skip the blank elements you have previously forced to be written in Write null element. Alternatively, using Omit null element only is also possible. That means you exclude blank elements coming from all ports connected to the element or above.

<person>
    <firstname>William</firstname>
    <middlename>Makepeace</middlename>
    <surname>Thackeray</surname>
</person>

Write raw value - this property allows to insert pre-prepared XML string into a document

false - default, always escapes the value, e.g. for the value <user id="1">John</user> and the field name field1 the output would be

<field1>&lt;user id="1"&gt;John&lt;/user&gt;</field1>

true - the value is inserted unescaped, so the example above would look like

<field1><user id="1">John</user></field1>

Undo and Redo the last action performed.

Add Child Element under the selected element.

Add (child) Wildcard Element under the selected element.

Add Sibling Element After the selected element.

Add Child Attribute to the selected element.

Add Wildcard Attribute to the selected element.

Remove the selected node.

More actions - besides other actions described above, you can especially Add Sibling Before or Add Sibling After.

drag a port and drop it onto an element - you will create a Binding, see Creating the Mapping - Mapping Ports and Fields;

drag a field and drop it onto an element - you will add a child element of the same name as the field;

drag an available field (or even more fields) onto an element - you will create a subelement whose name is the field's name. Simultaneously, the element's content is set to $portNumber.fieldName;

drag one or more available ports and drop it onto an element with a Binding - you will create a Wildcard element whose Include will be set to $portNumber.*;

combination of the two above - drag a port and a field (even from another port) onto an element with a Binding - the port will be turned to Wildcard element (Include = $portNumber.*), while the field becomes a subelement whose content is $portNumber.fieldName;

drag an available port/field and drop it onto a Wildcard element/attribute - the port or field will be added to the Include directive of the Wildcard element/attribute. If it is a port, it will be added as $0.* (example for port 0). If it is a field, it will be added as $0.priceTotal (example for port 0, field priceTotal);

drag a port/field and drop it onto a property such as Include or Exclude (or any other excluding Input in Binding). That can be done either in the Content or Property panes - as a result, the property receives the value of the port/field. You can select and drag multiple fields, as well.

Moreover, if you hold down Ctrl while dragging, the port/field value will be added at the end of the property (not replacing it). For example, if the Include property currently contains $0.*, dragging field1 of port $1 and dropping it onto Include while holding Ctrl will produce this content: $0.*;$1.field1.

drag an (wildcard) element and drop it on another element - the (wildcard) element becomes a subelement

drag an (wildcard) attribute and drop it on an element - the element now has the (wildcard) attribute

drag a text node and drop it on an element - the element's value is now the text node

drag a namespace and drop it on an element - the element now has the namespace