The RunMapplet statement contains properties that you can configure to customize the statement. You can configure the input, output, and a condition for executing the RunMapplet statement. The RunMapplet statement can contain the MappletInput statement and the MappletOutput statement.
The RunMapplet statement has the following properties:
Condition
Optional. An XPath expression that defines a condition for executing the RunMapplet statement. A condition is similar to a predicate expression in the Input column. If you define an Input XPath expression and a Condition XPath expression for the same mapping statement, the Data Processor transformation applies the Condition XPath to the result of the Input XPath.
Input
Optional. An XPath expression that evaluates to a sequence of nodes or values. The mapping statement type determines how the Data Processor transformation uses the nodes or values in the mapping.
Mode
Required. Determines whether the Data Processor transformation adds an output element or matches an existing element with a value from a mapping statement. Choose one of the following options:
Add. Creates an element in the output hierarchical document. If the element in not multiple-occurring, and the same values exists in the output, the mapping statement fails.
Match. The statement expects to find a match for the element in the output elements. The statement fails if the element does not exist in the output hierarchical document.
Match or Add. If a matching element exists in the output hierarchical document, the Data Processor transformation does not add an output element. If the element does not exist in the output hierarchical document, the transformation creates an output element.
Name
Optional. A name for the statement. You can change the name at any time. The name identifies statements so you can find them in the mapping grid or in an event log. Statement names do not have to be unique.
On Fail
Optional. Determines the action taken if the statement fails. Choose one of the following options:
Skip. If the statement fails, skip the statement.
Propagate. If the statement fails, force the parent statement to also fail.
Output
Required. An XPath expression that defines the value of the node in the output hierarchy based on the results of the Input XPath expression.
Skip Missing Input
Optional. Determines whether to skip the statement if there is no match for the Input value. Choose one of the following options:
Enabled. If the element is not in the input hierarchical document, the Data Processor transformation skips the statement without error.
Disabled. The statement fails when the element is not in the input hierarchical document.
Statement Type
Required. Identifies the statement as a RunMapplet statement. The field identifies the name of the referenced mapplet.