Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
iconfalse
titleThis page has been translated automatically

We want to provide you with the latest help content in your language as soon as possible. This page has been translated automatically and may contain grammatical errors or inaccuracies. We want this content to be useful to you. Please let us know at the bottom of this page if this information was helpful.

View the original article in Russian: Конструктор действий и Поиск по XPath

Описание

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

Note

Для использования этой функции вам необходимо располагать знанием основ языка разметки HTML.

Как вызвать?

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

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

Image Added

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

Image Added


Info

При добавлении элемента в Конструктор действий его доступные свойства и их автоматически попадают в окно Свойства элемента.

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

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

Image Added

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

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

2. № формы

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

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

Info

В настройках программы (Настройки → Запись) можно отметить два чекбокса - “Искать во всех формах на странице” и “Искать во всех документах на странице”  и тогда всегда при поиске элементов для номера документа и формы будет стоять -1.

3. Тэг

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

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

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

5. Значение

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

6. Тип поиска

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

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

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

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

Поиск по XPath

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

Image Added

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

1. XPath

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

2. Варианты

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

Info

Если ни один из предложенных вариантов Вас не устраивает, то Вы можете составить XPath выражение самостоятельно.

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

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

Image Added

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

  • Атрибут - атрибут элемента для которого надо установить новое значение

  • Значение - текст, который необходимо вставить. Можно использовать как простой текст так и переменные проекта{-Variable.someVar-}, {-Profile.Name-}.

Image Added

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

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

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

Image Added

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

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

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

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

Image Added

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

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

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

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

Комментарии
по умолчанию

Image Added

Те же экшены, только
с пользовательскими комментариями

Image Added

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

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

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