Расширение предназначено для получения селекторов (XPath и CSS) элементов веб-страниц и их передачи в Студию для автоматизации, а также для записи действий пользователя в браузере.

1. Установка

Автоматическая

Установите расширение из официального магазина дополнений (Chrome Web Store или Firefox Add-ons) по ссылке из Студии.

• Chrome: https://chromewebstore.google.com/detail/jckeblcmhhlchdopafpkeooehplnhneo
• Firefox: https://addons.mozilla.org/en-US/firefox/addon/robin-web-spy/

Ручная (режим разработчика)

Для Chrome:

1. Скачайте и распакуйте архив с расширением.

2. Перейдите на страницу chrome://extensions/.

3. Включите «Режим разработчика» (Developer mode).

4. Нажмите «Загрузить распакованное расширение».

5. Укажите папку с файлами расширения в проводнике.

Для Firefox:

1. Перейдите на страницу about:addons.

2. Нажмите на иконку шестеренки.

3. Нажмите «Установить дополнение из файла...» в открывшемся меню.

4. Укажите файл расширения в формате .xpi в проводнике.

2. Интерфейс виджета

По нажатии на иконку расширения открывается виджет.

• Вкладка «Web-шпион» – содержит параметры шпиона для захвата элементов страницы.
• Вкладка «Web-рекордер» – содержит параметры рекордера для записи действий в браузере.
• Кнопка смены режима закрепления – плавающий или в боковой панели.

Вкладка «Web-шпион»

• Опции «Полный XPath» / «Полный CSS-селектор» – переключают режим записи между коротким (относительным) и полным (абсолютным) путем.

• Кнопка «Указать элемент» – активирует режим выбора объекта на странице.

• Поля цXPath» и «CSS-селектор» – отображают полученные данные.

• Переключатель «Режим поиска» – выбор типа селектора для проверки.

• Кнопка «Найти элемент» – проверяет наличие элемента на странице по введенному селектору.

• Кнопка «Сохранить» – передает данные в Студию.

Вкладка «Web-рекордер»

• Опции «Полный XPath» / «Полный CSS-селектор» – переключают режим записи между коротким (относительным) и полным (абсолютным) путем.
• Опция «Делать скриншоты элементов» – переключает режим создания скриншота захватываемого элемента.
• Опция «Вставить после выбранного действия» – переключает режим вставки записанных действий на схему робота.
• Индикатор браузера, в котором открыто расширение.
• Кнопка «Начать» – активирует запись действий пользователя. Сменяется кнопками:
  • «Пауза» – приостанавливает запись, дальнейшие действия не записываются.
  • «Стоп» – останавливает запись, отправляет полученные данные в Студию.
  • «Отменить» – отменяет запись, имеющиеся данные удаляются.

3. Порядок работы

Шпион

1. 1. Выбор типа селектора

   • Короткий путь (по умолчанию): создает лаконичные селекторы (например, //button[@id="login"]). Рекомендуется для стабильной работы.

   • Полный путь: если активны чекбоксы «Полный...», генерируется абсолютный путь от корня страницы (/html/body/...). Используйте, если у элемента нет уникальных атрибутов.

2. Захват элемента

   1. Откройте нужную веб-страницу.

   2. Откройте виджет шпиона и нажмите «Указать элемент».

   3. Наведите курсор на нужный объект (он подсветится) и нажмите ЛКМ.

   4. Данные автоматически появятся в полях «XPath» и «CSS-селектор». Кнопка «Сохранить» станет активной.

      • Для отмены режима выбора до клика снова откройте виджет и нажмите «Отменить выбор элемента».

3. Проверка (валидация)

   1. Выберите режим поиска (XPath или CSS-селектор).

   2. Введите или измените значение в поле.

   3. Нажмите «Найти элемент»:

      • Если элемент один — он подсветится на 2 секунды.

      • Если элементов несколько — отобразится их количество (подсветки не будет).

      • Если элементов нет — отобразится «Найдено элементов: 0».

4. Сохранение
   • Нажмите «Сохранить». Данные будут мгновенно переданы в открытое окно создания/редактирования элемента в Студии.

Рекодер

1. Настройка параметров

   • Короткий путь (по умолчанию): создает лаконичные селекторы (например, //button[@id="login"]). Рекомендуется для стабильной работы.

   • Полный путь: если активны чекбоксы «Полный...», генерируется абсолютный путь от корня страницы (/html/body/...). Используйте, если у элемента нет уникальных атрибутов.

2. Запись действий
   1. Откройте нужную веб-страницу.
   2. Откройте виджет шпиона и нажмите «Начать».
      1. Если отсутствует открытый проект робота, начать запись не получится.
   3. Для приостановки записи откройте виджет, нажмите «Пауза».
   4. Для остановки записи нажмите «Стоп». Полученные данные будут переданы в Студию: будут созданы действия робота, повторяющие записанные действия пользователя, а также ресурсы робота, содержащие информацию об элементах, с которыми взаимодействовал пользователь.

4. Особенности работы

• Связь со Студией: Для корректной работы не закрывайте Студию до окнчания работы со шпионом/рекордером.

• Автономность: Расширение работает без доступа к интернету (в локальных сетях).