Skip to content

Latest commit

 

History

History
104 lines (58 loc) · 11.9 KB

apps-categories.md

File metadata and controls

104 lines (58 loc) · 11.9 KB
Raw

Категории приложений

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

При добавлении в шаблон нескольких компонентов, каждую строку с компонентом можно детализировать в таблице ниже:

В шаблонах возможно использовать имена переменных в формате {переменная}. Если вы прописываете переменную, то робот во время работы будет менять переменную на нужное значение. Вызов переменной может быть прописан прямо в JSON.

Также в значениях полей допустимо использовать символ *.

ВНИМАНИЕ! В окне редактора для всех режимов, кроме SAP, доступен инструмент Инспектор UI, который позволяет детально исследовать интерфейсы приложений. Работа с инструментом подробнее описана в разделе Инспектор UI.

Браузер

Шаблон поиска для категории приложений Браузер выглядит следующим образом:

В поле Заголовок укажите название сайта, в котором нужно найти компонент. В поле URL задайте адрес сайта.
Не забудьте выбрать тип браузера в параметре рядом с полем Заголовок. На рисунке выше выбран браузер Chrome.

Для добавления компонента вручную:

  1. Нажмите кнопку , после чего выделите новую строку и введите данные в поля Тэг, Текст, Индекс (начинается с единицы) и Искать во фреймах (поиск внутри элементов iframe).
  2. Для уточнения поиска можно ввести имена и значения атрибутов тега в таблицу (ключ, значение). Если указать несколько строк, поиск элемента в браузере будет вестись вглубь от самого верхнего шаблона.

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

Рабочий стол

Шаблон поиска для приложений Рабочего стола выглядит следующим образом:

Чтобы присоединиться к нужному приложению, достаточно заполнить одно из полей:

  • Заголовок — имя главного окна десктоп-приложения.
    ‼️ Важно. Если заголовок содержит спецсимвол \, его потребуется заэкранировать. Примеры:
    ◽С:\\Users\\User1\\AppData\\Local\\Primo.Exchange\\ext.chrome - Notepad++;
    ◽ *\\cmd.exe.
  • Процесс — название процесса запущенного приложения Windows.

Если заполнены оба поля, будут одновременно учитываться оба значения.

В верхнем правом углу находится параметр с типами автоматизации пользовательского интерфейса:

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

  • UIAUTOMATION — значение по умолчанию. Подходит для приложений рабочего стола, работающих по правилам Win32.
  • UIAUTOMATION_UIA — рекомендуется использовать в случае, если в режиме UIAUTOMATION не удается получить доступ к нужному элементу управления. Более старая технология.
    🔹 Примечание. Если сначала был выбран режим UIAUTOMATION_UIA, а потом — UIAUTOMATION, то для корректной работы шаблона поиска потребуется перезагрузить Студию.
  • MSAA — библиотека Microsoft Active Accessibility. Имеет больше ограничений, чем UIAUTOMATION, т.к. является устаревшей технологией. Обращение к MSAA будет полезным в ограниченном количество случаев: например, когда при поиске текстовых элементов необходимо использовать свойство идентификации Role.
  • JAVA и JAVA_EXT — предназначены для Java-приложений. Тип Java использует расширение Primo, тип Java_Ext — расширения сторонних вендоров.
    ‼️ При работе с Java, разрядность Студии и Робота должны совпадать с разрядностью Java. ‼️
  • RDP — используется для работы с приложениями удаленного рабочего стола по протоколу RDP.

Для добавления компонента вручную:

  1. Нажмите кнопку , выделите новую строку и введите данные в поля AutomationID, Name, ClassName, ControlType, LocalizedControlType и Индекс (начинается с единицы). Поля заполняются выборочно. При этом свойство AutomationID является одним из самых важных при поиске: оно не изменяется при каждом запуске и однозначно идентифицирует компонент.
  2. Для уточнения поиска можно ввести имена и значения атрибутов искомого компонента в таблицу (ключ, значение). Если указать несколько строк, поиск элемента в роботизируемом приложении будет вестись вглубь от самого верхнего шаблона.

Функция Быстрый поиск включена по умолчанию и активирует укороченный маршрут поиска компонента в приложении. Рекомендуется использовать этот параметр при работе с 1С.
Быстрый поиск не поддерживает поиск по свойствам идентификации BoundingRectangle, AcceleratorKey, ProcessId, NativeWindowHandle, Orientation. Если в режиме быстрого поиска компонент не находится, отключите параметр и произведите поиск еще раз.

Для автоматического добавления компонента используйте опцию Выбрать компонент и кликните искомый элемент в окне нужного приложения. Откроется окно для выбора свойств компонента (дерево контроллов). В случае, если необходим обход всего дерева свойств, воспользуйтесь кнопкой Автоматически с установленным чекбоксом Полное дерево контроллов:

SAP

При работе с SAP рекомендуется использовать специализированные компоненты.

Шаблон поиска для категории SAP выглядит следующим образом:

Если происходит работа с WebView SAP, шаблон поиска будет иметь следующий вид:

Область Browser представляет собой шаблон поиска для браузера.

В шаблонах поиска SAP допускается использование символа *.

Контейнеры

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

Если элемент помещен в контейнер, то окно редактора шаблона также будет открываться в режиме Контейнер:

При этом параметры поиска будут соответствовать типу приложения — десктоп или веб. По аналогии с параметрами для категории Браузер или Рабочий стол.