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

LocatorByKey

LocatorByKey

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
LocatorByKey
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.
key
Defines the XPath predicate representation of the key. For example, if you have defined
Hobbies/Hobby/@name
as a
Key
, select
Hobbies/Hobby[@name=$1]
. This property is required.
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.
params
Defines the values of the parameters in the XPath predicate. Each value has a dollar sign ($) and an integer that represents the position of the parameter in the list of parameters. This property is required.
remark
A user-defined comment that describes the purpose or action of the component.


Updated March 03, 2021