Web-шпион/рекордер

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

1. Установка

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

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

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

Для 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. Особенности работы

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

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

  • Нет меток