Find and Replace

<< Click to Display Table of Contents >>

 

Find and Replace

The Find Find tool searches for instances of a given text in a Domain, fully or partially. By the end of this search, users are presented to a list of results indicating the object or objects where this occurrence was found, its location inside that object or objects, such as whether it is a property or a Link, and the text containing this occurrence. To use this tool, select the Find Find option on the Default toolbar, select the Find item in Elipse E3 Studio's Tools menu, or use the shortcut key CTRL + SHIFT + F. In these cases, the search is always started for the whole current Domain. When right-clicking an object and selecting the Find option, which is equivalent to shortcut key CTRL + F, the search is always started from the selected object and its children, if available.

Find window

Find window

The available options on this window are described on the next table.

Available options on the Find window

Option

Description

Find what

Text to search for

Look in

Searches the whole Domain, on the Find Results 1 (one) or 2 (two) windows, or only in the selected object

Match case

Searches for the specified text exactly as written, matching its case

Whole word

Searches for the specified text as a whole word, without considering whether this text is contained inside another text

Use regular expressions

Searches for the specified text using a regular expression feature, described later

Everything

Searches for the specified text in object's properties, Links, scripts, and Picks

Include Formula Data

Includes in the search data from a Formula's database

Properties

Searches for the specified text only in the values of properties of objects

Only Names

Searches for the specified text only in properties representing an object's name, such as Name and ConnectionName

Links

Searches for the specified text only in Links of objects

Only Sources

Searches for the specified text only in sources of Links of objects

Scripts and Picks

Searches for the specified text only in scripts and Picks of objects

Find Results 1 and 2

Shows the search results on the Find Results 1 (one) or 2 (two) windows

Append Results

Allows executing a search without removing the results from previous searches

Find

Executes a search using the selected options

 

When selecting the Use regular expressions option, users can use patterns for character matching, known as Regular Expressions, to locate text. For example, using the expression "a*c" would allow finding texts "abc", "abbc", or "a123c". The next table contains some examples of the most common combinations on regular expressions.

Common combinations on regular expressions

Combination

Description

a

Finds only the "a" character

. (dot)

Finds any sequence of characters, except a new line

[a-c]

Finds only the characters "a", "b", or "c"

\n, \t

Finds the new line or tab characters, respectively

 

NOTES

Elipse E3 uses the ECMAScript syntax on regular expressions. For more information, please check topic Regular Expressions on Microsoft Docs.

Selecting the Use regular expressions option enables the Select regular expressions option near the Find what option, which allows selecting the most common regular expressions for searching.

 

The next figure shows a Find Results 1 (one) window for a search operation.

Find Results 1 window

Find Results 1 window

The available options on this window are described on the next table.

Available options on the Find Results 1 or 2 window

Option

Description

Select Previous Select Previous

Selects the previous result on the list of results (CTRL + SHIFT + F8)

Select Next Select Next

Selects the next result on the list of results (CTRL + F8)

Go to Result Go to Result

Selects the object that contains the result in Organizer

Delete Selected Groups Delete Selected Groups

Deletes the selected group of search results (DELETE)

Clean Results List Clean Results List

Removes all search results from the list of results

Filter

Allows filtering the results by using the Object, Location, and Result columns

Object

Full path of the object where the text was found

Location

Shows where the text was found, according to the options selected on the Advanced group of the Find window

Result

Shows the expression where the text was found

 

NOTE

Groups of results on Find Results 1 (one) and 2 (two) windows can be expanded Expand group of results or collapsed Collapse group of results for a better organization of the search results, specially when selecting the Append Results option.

 

The Replace Replace tool replaces occurrences found by another specified text. To use this tool, select the Replace Replace tool on the Default toolbar, select the Replace item in Elipse E3 Studio's Tools menu, or use the shortcut key CTRL + SHIFT + H. In these cases, the replacement is always performed for the whole current Domain. When right-clicking an object and selecting the Replace option, which is equivalent to shortcut key CTRL + H, the replacement is always performed from the selected object and its children, if available.

Replace window

Replace window

The available options on this window are described on the next table.

Available options on the Replace window

Option

Description

Find what

Text to search for and replace

Replace with

Text to use when replacing

Look in

Performs a replacement in the whole Domain, on Find Results 1 (one) or 2 (two) windows, or only in the selected object

Match case

Performs a replacement of the specified text exactly as written, matching its case

Whole word

Performs a replacement of the specified text as a whole word, without considering whether this text is contained inside another text

Use regular expressions

Performs a replacement of the specified text using the feature of regular expressions, described on the Find tool

Everything

Performs a replacement of the specified text in properties of objects, Links, scripts, and Picks

Include Formula Data

Includes in the replacement data from a Formula's database

Properties

Performs a replacement of the specified text only in the values of properties of objects

Only Names

Performs a replacement of the specified text only in properties representing an object's name, such as Name and ConnectionName

Links

Performs a replacement of the specified text only in Links of objects

Only Sources

Performs a replacement of the specified text only in sources of Links of objects

Scripts and Picks

Performs a replacement of the specified text only in scripts and Picks of objects

Find Results 1 and 2

Shows the replacement results on Find Results 1 (one) or 2 (two) windows

Append Results

Allows executing a replacement without removing the results from previous replacements

Find

Executes a search using the selected options without executing a replacement

Replace

Executes a replacement using the selected options for the first search result on Find Results 1 (one) or 2 (two) windows

Replace All

Executes a replacement using the selected options for all search results

Replace Selection

Executes a replacement only on the selected results on Find Results 1 (one) or 2 (two) windows

Replace Visible

Executes a replacement only on the results displayed after using the Filter option of Object, Location, or Result columns on Find Results 1 (one) or 2 (two) windows

 

NOTE

To select an object and show the exact location where a text was found or replaced, double-click the corresponding row on the list of results or press the space bar.

 

The next table contains the main search options, as well as the limitations for main data types.

Main search options

Data Type

Example

Notes

Date and Time

02/10/2010

00:00:10

Finds in Date and Time-type properties. If only a date is specified, finds all occurrences of that date, regardless of time. If only a time is specified, finds all occurrences of that time, regardless of date. Milliseconds are ignored during this search

Integer

0

100

Finds in all number properties. Searching for 10 finds 10 and 10.0, but does not find 10.1 or 100

Floating Point

10.0

40,5

Finds in all Floating Point-type number properties. Searching for 10.1 does not find 10 (integer). Windows regional settings are considered to validate a decimal symbol of a number

Color

255,255,0

0,0,234

Finds only in Color-type properties. Users must use commas to separate values, which must comply with the RGB system, that is, three groups of values ranging from 0 (zero) to 255

Boolean

True

False

Considers Windows language to process this search as a search for Boolean values

String

Test

Tag

Finds entire or partial Strings, according to the search type, by entire word or not. Any data type can be found on String-type properties

Was this page useful?