Skip to main content
Version: Current

Find

Description​

Searches for a text or numeric value within a Google Sheet and returns the addresses of all matching cells.

The search can be limited to a specific range within the sheet.

Common Capabilities​

Process Data Support​

info

This activity supports dynamic configuration using variables from the Process Data drawer.

You can bind values from Model Data, Form Data, System Data, Enterprise Variables, and Activity Outputs.

Learn more → Using Process Data

Design-Time Configuration​

Display Text​

A user-defined name for the activity, displayed on the workflow canvas to help identify its purpose.

Connection Name​

The configured Google Sheets connection used to access Google Sheets resources.

Spreadsheet​

The spreadsheet where the search will be performed.

Sheet Name​

The name of the sheet where the operation will be performed.

If not specified, the currently active sheet is used.

Cell Range​

The range within which to search.

Find​

The text or numeric value to search for.

Match Case​

Determines whether the search is case-sensitive.

When enabled, values such as Apple and apple are treated as different values.

info

For details about selecting spreadsheets, sheets, and ranges, see Google Sheets Data Selection.

Wait All Incoming​

Execution Control

Controls how this activity behaves when multiple incoming execution paths converge.

Determines whether the activity executes when:

  • Any incoming path completes, or
  • All relevant incoming paths complete before execution

Learn more → Execution Control

On Error​

Error Handling Strategy

Defines how the workflow behaves if this activity encounters a runtime error.

Supported strategies include:

  • Fault
  • Continue
  • Suspend
  • Retry

Learn more → Error Handling

Output​

Cell Addresses​

A list of cell addresses where matching values were found.

Example:

[A1, B5, D10]

Remarks​

  • The authenticated Google account must have access to the spreadsheet.
  • The search is performed only within the specified range.
  • When Match Case is disabled, the search is performed without regard to letter casing.
  • Multiple matching cells may be returned.
  • If no matches are found, an empty list is returned.
  • The returned cell addresses use standard A1 notation and can be used by subsequent Google Sheets activities.