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. Using the IntelliScript Editor
  7. XMap
  8. Libraries
  9. Schema Object
  10. Command Line Interface
  11. Scripts
  12. Parsers
  13. Script Ports
  14. Document Processors
  15. Formats
  16. Data Holders
  17. Anchors
  18. Transformers
  19. Actions
  20. Serializers
  21. Mappers
  22. Locators, Keys, and Indexing
  23. Streamers
  24. Validators, Notifications, and Failure Handling
  25. Validation Rules
  26. Custom Script Components

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 June 14, 2019