Page Comparison

Описание

Конструктор действий - универсальный инструмент для работы с элементами страницы, который позволяет подобрать оптимальные признаки для его поиска.

Как вызвать?

Существует два способа для вызова конструктора:

1. необходимо кликнуть правой клавишей мыши по интересующему Вас элементу на странице и выбрать В конструктор действий из контекстного меню.

Image Removed

2. Второй способ - из окна Дерево элементов. Кликаем ПКМ по нужном элементу и выбираем В конструктор действий.

Image Removed

Параметры поиска

Классический поиск

Image Removed

1. № документа

Рекомендуется ставить значение -1 (поиск во всех документах на странице). 

2. № формы

Тоже лучше ставить -1 (поиск по всем формам на странице). При выборе такого значения шаблон будет более универсальным.

Пример: на странице 3 формы - поиск, регистрация, заказ товара. Нам надо кликнуть в форме заказа по кнопке и мы выбрали в качестве значения поля “Форма” - 2 (нумерация с нуля). Спустя какое-то время на сайте появляется новая форма, для входа, и вставлена она перед формой заказа. Под номером 2 теперь будет форма входа и наш шаблон либо выдаст ошибку о том, что кнопка не найдена, либо (что гораздо хуже) будет кликать в другой форме по другой кнопке.

3. Тэг

HTML тэг, который надо найти.

4. Имя атрибута

Атрибут HTML тэга по которому производится поиск.

5. Значение

Значение атрибута, выбранного HTML тега

6. Тип поиска

1. text - поиск по полному либо частичному вхождению текста;

2. notext - поиск элементов в которых не будет указанного текста;

3. regexp - поиск с помощью регулярных выражений;

На скриншоте видно, что после клика по кнопке Поиск нашлось три элемента, что не очень хорошо - всегда старайтесь подбирать такие параметры поиска, чтоб в итоге находился только один элемент.

Поиск по XPath

С помощью XPath выражений Вы можете реализовать более универсальный и устойчивый к изменениям вёрстки сайта алгоритм поиска элементов, в сравнении с классическим поиском или регулярными выражениями.

Image Removed

№ документа и № формы отвечают за то же, что и при классическом поиске.

1. XPath

Поле ввода XPath выражения.

2. Варианты

Здесь можно выбрать одно из предложенных Конструктором выражений.

Выбор действия

Можно выбрать одно из трёх возможных действий

Image Removed

Set - Установка значения

Table of contents

Description

The action designer is a universal tool for working with page elements, which allows you to select the optimal signs for its search.

How to call?

There are two ways to call a designer:

1. you need to right-click on the element of interest on the page and select to the action designer from the context menu.

Image Added

2. The second method is from the Element Tree window. Right-click on the desired element and select to the action designer.

Image Added

Search options

Classic search

Image Added

1. Document №.

It is recommended to set the value -1 (search in all documents on the page). 

2. Form №.

It is also better to set -1 (search in all forms on the page). Choosing this value will make the template more versatile.

Example: on page 3 of the form - search, registration, ordering goods. We need to click on the button in the order form and we have chosen as the value of the “Form” field - 2 (numbering from zero). After some time, a new login form appears on the site, and it is inserted in front of the order form. Number 2 will now be the login form, and our template will either give an error that the button was not found, or (much worse) will click on another button in another form.

3. Tag

HTML tag to find.

Example:

<div class="visible" id="username"></div>

div - this is a tag.

4. Attribute name

The HTML tag attribute for the search.

<div class="visible" id="username"></div>

class and id - attributes.

5. Value

The value of the attribute of the selected HTML tag

<div class="visible" id="username"></div>

visible and username - attribute values.

6. Search type

1. text - search by full or partial text occurrence;

2. notext - search for elements that do not contain the specified text;

3. regexp - search using regular expressions
   By default RegeXp search is case insensitive. To change it you can prepend (?-i) to your expression (this mean “disable case insensitive mode”).

The screenshot shows that after clicking on the Search button, three elements were found, which is not very good - always try to select such search parameters so that in the end there is only one element.

XPath search

With the help of XPath expressions, you can implement a more universal and resistant to changes in site layout algorithm for finding elements, in comparison with classic search or regular expressions.

Image Added

Document number and form number are responsible for the same as in the classic search.

1. XPath

XPath expression input field.

2. Options

Here you can select one of the suggested expression designer.

Action selection

You can choose one of three possible actions

Image Added

Set - Setting a value

• Attribute - an attribute of an element for which a new value must be set

• Value is the text to be inserted. You can use both plain text and project variables {-Variable.someVar-} , {-Profile.Name-} .

Image Removed

Image Added

3. Добавление в проект

И уже в самом конце когда параметры подобраны, элемент найден, выбрано и протестировано необходимое действие можно нажимать Добавить в проект.

Полезные ссылки

Get - Получение значения

• Атрибут - атрибут, значение которого надо получить.

• Значение - здесь отобразится значение найденного атрибута.
  

Image Removed

Rise - Выполнить действие

• здесь можно выбрать необходимое действие, которое нужно сделать с найденным элементом.

Image Removed

• Для действий drag и drop доступны два дополнительных поля, для координат

Завершающие действия

Image Removed

1. Тестирование

После того как подобрали необходимые параметры поиска и определились с нужным действием не помешает протестировать подобранные параметры нажав соответствующую кнопку.

2. Комментарий

Не плохой идеей будет оставить комментарий для экшена т.к. автоматические комментарии несут мало информации

Getting a value

• Attribute - the attribute whose value you want to get.

• Value - the value of the found attribute will be displayed here.
  

Image Added

Rise - Rise event

• here you can select the required action to be done with the found element.

Image Added

• Two additional fields are available for drag and drop actions, for coordinates

Final actions

Image Added

1. Test

After you have selected the necessary search parameters and decided on the desired action, it does not hurt to test the selected parameters by clicking the appropriate button.

2. Comment

It's not a bad idea to leave a comment for the action as automatic comments carry little information

3. Adding to the project

And already at the very end, when the parameters are selected, the element is found, the required action is selected and tested, you can click Add to project.

Useful links

• XPath

• Regular Expression Tester

• Setting the value

• Rise event

• Getting value

• Element Properties Window

• ZennoPoster + xPath using Yandex.Market as an example (contest article from the forum)