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

LocatorByOccurrence

LocatorByOccurrence

The
LocatorByOccurrence
component is used in the
source
property to identify an occurrence of a multiple-occurrence data holder.
For example:
  • An element that can occur multiple times in an XML document
  • A variable that can occur multiple times
The component identifies the occurrence by number. For example, if there are ten occurrences of a data holder, you can use
LocatorByOccurrence
to process the third occurrence.
LocatorByOccurrence
can be used to iterate over the occurrences in a repeating structure such as a
RepeatingGroup
anchor.
The
LocatorByKey
component identifies an occurrence of a multiple-occurrence data holder in the
source
and
target
properties.
Before you use
LocatorByKey
, you must define a
Key
at the global level of the Script. The
Key
specifies the data holders that uniquely identify the occurrence.
The following table describes the properties of the
LocatorByOccurrence
component:
Property
Description
disabled
Determines whether the Script ignores the component and all of the child components. Use this property to test, debug, and modify a Script. You can choose one of the following options:
  • Selected. The Script ignores the component.
  • Cleared. The Script applies the component.
The default is cleared.
occurrence_number
Defines the number of the occurrence.
optional
Determines whether a component failure causes the parent component to fail. You can choose one of the following options:
  • Selected. Component failure does not cause the parent component to fail.
  • Cleared. Component failure causes the parent component to fail.
Default is cleared. For more information about component failure, see Failure Handling.
recurring_element
Defines the data holder that the component identifies.
remark
A user-defined comment that describes the purpose or action of the component.


Updated September 26, 2018