Components

Back Next

Statement properties

A hierarchical mapper automatically configures statement properties when it generates a statement, but you can edit the statement properties or manually configure a statement.

To add or remove rows, use the

Settings

button. You can also search for a statement using a string. When you select the row for a statement, the corresponding mapping is highlighted in the

Hierarchical Mapper

area. Similarly, when you select an element in the hierarchical mapper, the corresponding statement is highlighted in the

Statements

area.

The following table describes the statement properties:

Property	Description
Row	Row number to identify the statement. The row number is generated automatically.
Name	Name to identify the statement. You can change the name at any time, and the statement name doesn't need to be unique. You can use the statement name to help you find the statement in the session log.
Statement Type	Type that defines how the statement runs when a source element appears in the source schema.
Input	XPath or expression consisting of XPaths that defines the input element in the source schema. The expression can evaluate to an element or to a value.
Condition	XPath or expression consisting of XPaths that defines a condition to map the source element to the target element. For example, normalize-space(string(.)) = 'A'
Skip Missing Input	Determines whether to skip the mapping statement if the input expression doesn't match an element in the source schema. Choose one of the following options: Enabled. If the source element doesn't exist, the hierarchical mapper skips the statement without error. Disabled. If the source element doesn't exist, the statement fails.
Default	Default value to set the value of the target element if the hierarchical mapper can't find the source element.
On Fail	Determines what to do if the statement fails. Choose one of the following options: Skip Statement. If the statement fails, skip the statement. Skip Iteration. If the statement fails and it's part of a group, skip every iteration of the statement. Propagate. If the statement fails, the parent statement also fails.
Output	XPath or expression consisting of XPaths that defines the output element in the target schema.
Mode	Determines whether the hierarchical mapper adds an output element to the target schema or matches the value of the output expression to an existing element in the target schema. Choose one of the following options: Add. Creates an element in the target schema. If the element is not a multiple-occurring element and the element already exists in the target schema, the statement fails. Match. Matches the value of the output expression to an existing element in the target schema. If the element doesn't exist, the statement fails. Match or Add. If the value of the output expression exists in the target schema, the hierarchical mapper matches the output to the target element. If the element doesn't exist in the target schema, the hierarchical mapper creates an element in the target schema.
Comments	Comments that you want to make about the statement.