Find Text Action—Setting Properties

The Find Text action is used to search for a word or phrase within a larger piece of text. You can populate a variable with the index location of the text and/or with the number of instances found. You can also populate a variable with the found text. The variables must be created in earlier steps using the Create Variable action.

To set Find Text properties

  1. From the Task Builder Available Actions pane, open the Text folder and double-click the Find Text action or drag it into the Steps pane.

  2. In the Text box, enter the target to be searched. To enter a variable or dataset, click the Insert Expression/Variable button and use the Expression Builder to insert it.

  3. In the Find box, enter the text to look for within the target text.

  4. To make the search case sensitive, select Case Sensitive.

  5. If the text to look for is an expression, select Regular Expression.

  6. In the Populate variable with first index box, select the variable to be populated with the position of the first match found.

  7. Click the Advanced tab.

  8. If you want to populate a variable with the number of instances of the text found, select the variable in the Total find count into variable box. To begin the count from a point beyond the first instance, enter the number to begin in the Starting at the following instance box. For example if there are six instances and you enter 3 in this box, the total count returned will be 4.

  9. If you want to populate a variable with the text found, select the variable in the Populate variable with found text box.

  10. To set the Description tab properties, refer to Description Tab Options.

  11. To set the Error Causes and On Error tab properties, refer to Step Error Handling.

  12. When finished, click OK to save settings and close the properties dialog window.

See Also

About Actions

Adding Task Steps

Find Text Action