How can I set Finders in DS?

Follow

You can set and change finders in the Finders tab of the Step View.

The content of the Finders tab differs depending on the type of the target page. For details, please refer to "What are finders for action steps in DS?".

 

Here, you are presented with the example of the Finders tab of Tag Finder.

 

Select your target location in the Window view, and to set it, click the 「+」 button in the Finders tab.

 

(Example) Using a Click step on a web page

1.png

2.png

3.png

 

 ・Frame Recursive

Originally, its was a function to switch to the needed frame but it has been now transformed into a "Set Current Window" step and cannot be used anymore.

 

 

・Find Where

You can define the area in which the designated tag will be searched for.

4.png

Option

Overview

Anywhere In Page

Default setting when no named tag. All elements inside the page are targeted.

In Named Tag

Element contained in the named tag.

Outside Named Tag

Used to manipulate a tag outside the named one.

After Named Tag

Used to manipulate a tag that follows the named one.

Before Named Tag

Used to manipulate a tag that precedes the named one.

Between Named Tags

Used to manipulate a tag that is positioned between two named ones.

In Tags Containing Named Tag

Used to manipulate a tag that contains the named one.

In Same Table Row as Named Tag

Used to manipulate a tag that is located in the same row as the named one.

In Same Table Column as Named Tag

Used to manipulate a tag that is located in the same column as the named one.

Advanced

To use more advanced settings.

 

 

・Tag Path

You can set the location of the tag to specify.

 

(Example) Specifying the tag path of the "Next" button of the web page.

5.png6.png

7.png

For details about tag path, please refer to "What about tag paths used in DS finders?".



・Attribute Name

You can designate the attribute of an element of the target to operate.

Knowledge about HTML is important for attributes, but just remember the most used ones are "class" and "title".

 

 

・Attribute Value

You can specify an attribute tag that with a specific value.

If you have defined an Attribute Name, the Attribute Value will be linked to this Attribute Name.

8.png

Option

Overview

Equals Text

Used to manipulate a tag that equals the text.

Contains Text

Used to manipulate a tag that contains the specified text.

Starts with Text

Used to manipulate a tag that starts with the specified string of characters.

Ends with Text

Used to manipulate a tag that ends with the specified string of characters.

Matched Pattern

To specify a tag with a pattern. Accurate description to secure stability is important but you can also build flexible robots.

Does not Equal Text

Used to manipulate a tag outside of a certain string of characters.

Does not Contain Text

Used to manipulate a tag that does not contain a certain text.

Does not Start with Text

Used to manipulate a tag that starts with a string of characters different from the specified one.

Does not End with Text

Used to manipulate a tag that ends with a string of characters different from the specified one.

Does not Match Pattern

Method to specify a tag with a pattern.

 

 

・Tag Pattern

You will define here an HTML or a specific text that must match with the tag.

"Symbol" is a function for inputting special characters.

By clicking the "Edit" button, the pattern editor opens up and you can check whether a pattern operates correctly.

 

(Example) Moving successively from page to page by clicking the "Next" button

However, because page 1 and page 2 are built differently, even if you specify the "Next" button in page 1 tag path, it will not be clicked from page 2 and on.

 

▼1st page

9.png

 

▼2nd page

10.png

 

For the above example, it is important to specify a string of characters; so please enter the one you want to target (here, "Next") in "Tag Pattern".



・Match Against

You can set the area where to search tags that match the value you have specified in "Tag Pattern".

You must be careful with tag patterns because to find one matching tag, the whole page is searched many times which can have effects on the robot performances. To avoid that, select "Text Only" from the drop-down menu.

 

Option

Overview

Text Only

Designates the tag that matches the text entered in "Tag Pattern"

HTML

Designates the HTML that matches the pattern entered in "Tag Pattern"

 

 

・Tag Depth

In case there are many matching tags, you can set the tag to use by designating the location of this tag.

 

Option

Overview

Any Depth

Default setting. Designates all matching tags.

Outermost Tag

Designates the outermost tag only.

Innermost Tag

Designates the innermost tag only.

 

 

・Tag Number

If many tag match your criteria (e.g. a tag path), you can specify the one to use by setting a number and make the computer count until tags until reaching this number, either from the first matching tag or reversely from the last one.

 



For details about each tab of the Step View, please refer to "What are the 4 Action Step tabs in DS?".

2 out of 3 found this helpful

Comments

0 comments

Article is closed for comments.