Table of Contents

Search

  1. Preface
  2. Introduction to Data Transformation
  3. Data Processor Transformation
  4. Wizard Input and Output Formats
  5. Relational Input and Output
  6. XMap
  7. Libraries
  8. Schema Object
  9. Command Line Interface
  10. Scripts
  11. Parsers
  12. Script Ports
  13. Document Processors
  14. Formats
  15. Data Holders
  16. Anchors
  17. Transformers
  18. Actions
  19. Serializers
  20. Mappers
  21. Locators, Keys, and Indexing
  22. Streamers
  23. Validators, Notifications, and Failure Handling
  24. Validation Rules
  25. Custom Script Components

Data Transformation User Guide

Data Transformation User Guide

Option Statement Properties

Option Statement Properties

The Option statement contains properties that you can configure to customize the statement. You can configure the input, output, and a condition for mapping an input element to an output element.
The Option statement has the following properties:
Condition
Required if Input is not defined. An XPath expression that defines a condition for mapping the element. A condition is similar to a predicate expression in the Input column. The Data Processor transformation applies the Condition XPath to the result of the Input XPath.
Input
Required if Condition is not defined. An XPath expression that defines the input element. The expression can evaluate to a node or value.
Mode
Optional. 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
Optional. An XPath expression that defines the value of the element in the output hierarchical based on the results of the Input XPath expression.
Statement Type
Required. Identifies the statement as a Option statement.