Skip to main content

Find Text

Description​

This activity locates the text within the designated Word document and provides its precise position and the corresponding page index.

note

You can only use this activity inside Word Context.

Design Time Configuration​

At design time, you can configure the following properties:

  • Find What - Specify the Text to search.

  • Result - Returns the Text positions and Text location in the form of page indexes.

  • Occurrence - Select the occurrences of the specified text or bookmark relative to which to add the image. The following options are available:

    OptionDescription
    AllInsert the image at every occurrence
    FirstInsert the picture only at the first occurrence
    LastInsert the picture only at the last occurrence

Advanced Options​

Users can use this dialogue to execute a text search with enhanced functionalities. For information on searching your text using advanced options, see the Advance Options dialog section.

  • Page(s) to search—Use the options below to search for specific text within one or more pages.

    OptionDescription
    AllChoose this option to search for text on all the page(s).
    SingleChoose this option to search the text on one page.
    RangeChoose this option to search the text on the range of page(s).

  • Read page by—This option becomes accessible exclusively when Single is chosen under Page(s) to search. It allows for the specification of the page index or number to facilitate the selection of subsequent options.

    OptionDescription
    Page IndexSelect this selection to access the page via its index.
    Page NumberChoose this option to access the page using its number.
note

The page index denotes the fixed physical page number, whereas the page number is user-defined and customizable. Users can define it on any page within the document's Header or Footer.

  • From page—When Page(s) to search is configured to Range, designate the initial page to initiate the text search.

  • To page—When Page(s) to search is set to Range, indicate the concluding page number within the range for text search.

  • Page number—If Page(s) to search is set to Single define the specific page number for text search.

  • Search In—Determine whether to search for text within the document's Body, Header, or Footer.

    OptionDescription
    Select AllEnable this option to search for text across all page sections (Body, Header, and Footer).
    BodyEnable this option to search for text within the page's Body.
    HeaderEnable this option to search for text within the page's header.
    FooterEnable this option to search for text within the page's footer.

  • Match case - Activating this option conducts a case-sensitive search; otherwise, it performs a case-insensitive search.

  • Match whole words only—Enabling this feature prevents partial matches. For instance, searching for "One" will not yield results for "Someone".

  • Use regular expression—Enabling this functionality permits the specification of a regular expression and retrieves any text that matches the expression.

Properties​

Misc​

  • DisplayName – Add a display name to your activity.
  • Private – By default, activity will log the values of your properties inside your workflow. If private is selected, then it stops logging.

Optional​

  • Continue On Error – It Specifies whether the automation should continue even when the activity throws an error. If True, the activity continues without throwing any exceptions. If False, the activity throws an exception. The default value is False.
note

It does not catch an error if this activity is present inside the Try-Catch block and this property's value is True.

Example​

Download Example

Sheet Exists