Новый редактор шаблона поиска

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

Улучшен интерфейс выбора элементов:

1. Подсказки для горячих клавиш.

   В окне Выбор элемента (Element selection) отображаются вспомогательные подсказки по клавишам, которые можно использовать при выборе элемента.

2. Всплывающие подсказки при работе со свойствами элемента управления.

   Добавлены всплывающие подсказки, помогающие скорректировать шаблон поиска. Значения свойств стали доступны для редактирования.

   

3. Вкладки Структура и Код.

   В редакторе шаблона появились вкладки Структура и Код (шаблон поиска в формате JSON).

   Дополнительно появилась возможность быстро поменять текущий селектор.

   

   

4. Корректное отображение результатов валидации.

   На этапе выбора свойств стало возможным проверить корректность шаблона (селектора). Для этого используйте кнопку Валидация настроек шаблона. Функция запускает проверку текущих настроек — результат отображается внизу редактора.

   

5. Отображение шаблона в виде дерева.

   Шаблон поиска можно отображать в виде дерева, что упрощает навигацию и управление элементами шаблона.

   

6. Путь до элемента.

   В окне редактора добавлена опция Путь до элемента, позволяющая управлять родительскими и дочерними селекторами. Путь до элемента помогает определить точное расположение элемента в иерархии пользовательского интерфейса.

   

   Дочерние и родительские селекторы добавляются/удаляются при помощи команд контекстного меню.

   

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

   

7. Копирование кода шаблона поиска.

   Стало возможным скопировать код шаблона для использования в других проектах.

   

8. Переименование и удаление параметров.

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

   

9. Поддержка Java Applet.

   Добавлена опция для включения или отключения поддержки Java Applet при работе с элементами интерфейса. Эта опция позволяет работать с элементами Java-апплетов, интегрированных в веб-страницы или приложения.

   

Добавлена поддержка выражений в поле Index шаблона (с версии 1.25.3)

В большом редакторе шаблонов теперь доступны расширенные возможности для поля Index:

• Переменные и выражения в фигурных скобках:

  {variable}, {variable[0]}, {variable.ToString()}, {DateTime.Now.Day}

• Автоматическая валидация при настройке шаблона.
• Кнопка «Валидация настроек шаблона» для тестирования выражений.

Пример использования:

Режим выбора элемента на экране

Кнопка “Режим выбора элемента на экране” (иконка Волшебная палочка) в Редакторе шаблона поиска используется для переключения между различными методами распознавания элемента. Если один элемент может быть обнаружен разными способами, система автоматически создает несколько вариантов шаблонов поиска.

Рекомендации:

• Если шаблон сформирован некорректно или элемент определился, например, как рабочий стол, это связано с приоритетом используемых методов. Нажмите кнопку несколько раз, чтобы переключить методы и выбрать подходящий вариант.
• При необходимости можно воспользоваться ручным режимом выбора элемента на экране.
• Некорректное распознавание элемента не является ошибкой, а отражает гибкость инструмента, который адаптируется для работы с различными интерфейсами.

Браузерный селектор

В редакторе шаблона браузерного селектора добавлен параметр Активировать вкладку. Этот параметр позволяет автоматизировать процесс переключения на нужную вкладку в браузере перед выполнением действия, если текущая активная вкладка не соответствует указанным параметрам (URL, Заголовок, Индекс).

• Если флажок установлен, робот проверяет, соответствует ли текущая активная вкладка параметрам, заданным в селекторе.
• Если вкладка не соответствует, робот автоматически активирует нужную вкладку и затем выполняет действие (например, клик).

При наличии нескольких вкладок с одинаковыми URL или Заголовком рекомендуется использовать параметр Индекс вкладки для однозначного указания нужной вкладки. Функция доступна с версии 1.24.8

С версии Студии 1.25.1 редактор шаблонов поддерживает работу с веб-элементами на страницах браузера Microsoft Edge, работающих в режиме эмуляции Internet Explorer (IE).

• Возможен выбор элементов с помощью инструмента Волшебная палочка как в режиме Браузер, так и в режиме Рабочий стол.
• Добавлена поддержка редактирования ранее выбранных элементов и валидации шаблонов в указанном режиме.

Работа с пикером в Internet Explorer / Edge (режим IE)

Для корректной работы пикера в Internet Explorer или Microsoft Edge в режиме IE необходимо выполнить следующие настройки:

• Включите чекбокс “Разрешение сторонних расширений обозревателя”.
• Установите уровень безопасности IE на “Средний-высокий”.

Регулярные выражения RegEx (с версии 1.25.1)

В режимах Рабочий стол (Desktop) и Браузер (Browser) появилась возможность использовать регулярные выражения для параметров селектора.

Искать во Фреймах

Свойство “Искать во Фреймах” предназначено для поиска элементов внутри HTML-фреймов <frame> и <iframe>, но при его использовании существуют следующие ограничения:

• 1. Защищённые фреймы: Если фрейм защищён настройками браузера, то поиск внутри него невозможен.
• 2. Разные домены: Поиск не выполняется, если содержимое фрейма загружается с другого домена или хоста. Например:
  • Работает: <iframe src="/local.html"> (тот же домен).
  • Не работает: <iframe src="https://externaldomain.com/page.html"> (другой домен).

Для корректной работы убедитесь, что фрейм загружает содержимое с того же домена и не имеет ограничений безопасности.

Строгий поиск (Strict Search) (с 1.25.1)

Область применения: Рабочий стол (Desktop)

В версии Студии 1.25.1 в основном редакторе добавлены новые инструменты для настройки поиска элементов:

1. Чекбокс Строгий поиск (Strict Search) Чекбокс «Строгий поиск» позволяет _ограничить поиск элементов только по указанному дереву контролов.

• Если включен – поиск осуществляется только среди прямых дочерних элементов, без пропуска уровней.
• Если отключен – поиск становится более гибким, может учитывать вложенные элементы.

2. Синхронизация значений атрибутов

Кнопка «Синхронизация» 🔗 позволяет включать или отключать распространение значений атрибута на все уровни элемента.

1. Синхронизация включена

• Атрибут имеет одинаковое значение на всех уровнях пути к элементу.

• Отображается значок целой ссылки 🔗.

• При изменении значения оно автоматически применяется ко всем уровням.

  

Пример: если задать AutomationID=“button1” на одном уровне, это же значение автоматически применяется ко всем вложенным уровням.

2. Синхронизация отключена После отключения значение перестает автоматически распространяться на все уровни, и его можно изменять отдельно для каждого уровня.

• Если значок разорванной ссылки исчезает, при наведении на пустую область всплывает подсказка: «Включить синхронизацию значения атрибута».

  

Строгий поиск в малом редакторе (с версии 1.25.3)

Добавлена кнопка Строгий поиск в малом редакторе шаблона. Функционал позволяет:

• Активировать режим строгого поиска при построении дерева через пикер
• Обеспечивает единое поведение с основным редактором шаблона
• Учитывается при:
  • Валидации шаблонов
  • Построении индексов элементов
• Доступен только в режиме Рабочий стол

Улучшенный алгоритм многоуровневого поиска в браузере (с версии 1.25.9)

В версии 1.25.9 представлен улучшенный алгоритм многоуровневого поиска элементов для работы со сложными интерфейсами с повторяющимися блоками (например, карточки товаров, таблицы, списки).

• До версии 1.25.9: При многоуровневом поиске алгоритм мог потерять часть элементов и всегда выбирал последний подходящий промежуточный узел в DOM-дереве, что часто приводило к выбору не того элемента.
• После версии 1.25.9: Алгоритм теперь корректно обрабатывает все подходящие элементы на каждом уровне и точно находит всё множество элементов, выбранных с помощью инструмента выбора элементов.

Как применить улучшение к существующим активностям:

Для обратной совместимости старые шаблоны продолжают работать по прежнему алгоритму. Чтобы воспользоваться улучшенным поиском для ранее созданных активностей:

1. Откройте свойство активности с поиском элемента
2. Очистите текущий шаблон поиска
3. С помощью пикера заново выберите целевой элемент на странице
4. Сохраните процесс.

⚠️ Важно: При редактировании “старого” шаблона через пикер система автоматически преобразует его в формат нового алгоритма поиска при сохранении.

Альтернативно, вы можете создать активность заново.

Для новых активностей, созданных в версии 1.25.9+, улучшенный алгоритм применяется автоматически.

Старый редактор шаблона поиска

Для использования старого редактора шаблона поиска перейдите в раздел Настройки ➝ Общие ➝ Элементы и установите галочку напротив опции Использовать старый редактор шаблона поиска по умолчанию.