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

Data Transformation User Guide

Data Transformation User Guide

Replace

Replace

The
Replace
transformer finds and replaces strings in the input text. Leaving the
replace_with
property empty deletes the found text.
The following table describes the properties of the
Replace
transformer:
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.
find_what
Defines the text to find. The value is one of the following searcher components:
  • NewlineSearch. Finds a newline character.
  • PatternSearch. Finds text that matches a regular expression.
  • SegmentSearch. Finds a segment from a specified opening marker to a closing marker.
  • TextSearch. Finds a specified string.
Default is TextSearch. For more information, see the Searcher Component Reference.
name
A descriptive label for the component. This label appears in the log file and the
Events
view. Use the
name
property to identify the component that caused the event.
occurrence
Specifies which occurrences to replace:
all
,
first
, or
last
.
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.
remark
A user-defined comment that describes the purpose or action of the component.
replace_with
Defines the replacement string.