# Fragment Search Searching for fragments in a Word document. The block works only when the "Use COM" property is enabled in the "Create Document" or "Open Document" blocks.
Document Link

[Link] Link to the open

Word document where the Work is currently taking place.

The variable name in this property must match the variable name in the "Document Link" property of the "Create Document" or "Open Document" blocks from the Word group that were previously used to create or open this document.

Text[Text] The string to be found.
Starting Page Index[Number] The starting page index for the search. Numbering starts at 1.
Ending Page Index[Number] The ending page index for the search. Numbering starts at 1.
Starting Character Index

[Number] The starting character index for the search. Numbering starts at 0.

If the "Starting Page Index" property is set and is greater than zero, this property is ignored.

Ending Character Index

[Number] The ending character index for the search. Numbering starts at 0.

If the "Ending Page Index" property is set and is greater than zero, this property is ignored.

List of Fragments

[List] A list of links to the Range object.

Examples of available properties applicable to the first element of the array (with index 0):

  • $ListRanges[0].Start - starting character index;
  • $ListRanges[0].End - ending character index;
  • $ListRanges[0].Text - text of the fragment.

To replace text in the document for this fragment, assign a new value to the Text property, for example, $ListRanges[0].Text = "New text".

Error Handling Level

Select the error handling level. Possible values:

  • "Default" - by default;
  • "Ignore" - errors are ignored;
  • "Handle" - errors are handled.

If "Default" is selected, the value from the "Start" block of this diagram will be used.

Message Level

Select the message level that blocks will output during operation. Possible values:

  • "Default" - by default;
  • "Release" - output is disabled;
  • "Debug" - main information output;
  • "Detailed" - detailed information output.

If "Default" is selected, the value from the "Start" block of this diagram will be used.

Error Text[Text] Returns detailed information about the error in case of incorrect execution of the block's work.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sherparpa.ru/en/sherpa-rpa/sherpa-designer/spravochnik-blokov/word-word-automation/poisk-fragmentov-searchrangesworddocument.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.