Дизайнер ELMA RPA > Моделирование процесса > Активити / Общие принципы настройки активити

Общие принципы настройки активити

Настройки многих активити задаются автоматически во время записи процесса:

При необходимости их можно изменить.

Настройки следующих активити задаются только вручную:

Чтобы открыть окно с настройками, нажмите на активити на графической модели процесса. Окно появится справа. Настройки каждого активити задаются на двух вкладках: Параметры и Обработчики.

Вкладка «Параметры»

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

basic-activity-settings-1

Основные параметры

Эти параметры определяются для всех активити, но могут отличаться в зависимости от выбранного активити.

Параметры указателя и элемента управления

Для RPA важно определение элементов интерфейса. Если мы не можем найти элемент, то и использовать его нельзя. Поиск элементов в интерфейсе осуществляется на основе набора признаков.

Для активити Кликнуть, Кликнуть по тексту, Навести, Переместить, Прокрутить, Считать текст, Считать текст OCR задаются параметры указателя и элемента управления.

Блок «Указатель»

В блоке Указатель отображается скриншот элемента интерфейса, над которым выполняется действие.

Здесь вы можете изменить место клика. Для этого нажмите на скриншот элемента интерфейса и задайте координаты.

general-activity-settings-2

  1. Укажите исходное положение курсора, относительно которого рассчитываются координаты смещения. Вы можете выбрать: Левый верхний угол, Правый верхний угол, Правый нижний угол, Левый нижний угол и Центр.
  2. Нажмите на кнопку Задать координаты и установите значок coordinates-icon в нужную область на скриншоте.
  3. После этого автоматически установятся координаты смещения по осям X и Y относительно исходного положения курсора (обозначается желтым кружком). Можно задать координаты вручную. Они указывается в пикселях. Если значения X и Y = 0, то смещения не будет.

Вы можете изменить масштаб скриншота элемента при помощи ползунка.

Чтобы отменить смещение курсора, нажмите на кнопку Сбросить. Чтобы сохранить заданные координаты для смещения курсора, нажмите на кнопку Сохранить.

Можно настроить параметры указателя:

  • Метод поиска — выбор метода поиска элемента: Native, По изображению или OCR.

Метод поиска

Описание

Native (нативный)

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

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

По изображению

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

Рекомендуется применять этот метод, когда не работает метод Native. По сравнению с методом Native поиск по изображению может выполняться дольше и быть менее точным.

OCR (Optical Character Recognition)

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

Два основных направления использования OCR:

  • получение текста, если есть фиксированная или рассчитанная область текста;
  • определение позиции элемента, если есть текст для поиска и найдено совпадение по этому тексту.

Выбор метода поиска зависит от активити. Методы можно комбинировать. Рекомендуется использовать Native, но если он не работает, применять поиск по изображению или OCR.

  • Кол-во попыток поиска и интервал (мс) — в этой настройке можно указать, сколько раз бот будет пытаться найти выбранный элемент интерфейса. По умолчанию — 10. Кроме того, вы можете задать паузу между попытками бота найти нужный элемент интерфейса. Указывается в миллисекундах, по умолчанию — 500. Чтобы изменить значения по умолчанию, нажмите на значок edit-icon, введите значение и сохраните его, нажав в любое место на экране или при помощи значка save-icon.
  • Путь XPath — путь к элементу веб-страницы, задаваемый с помощью XPath. Этот параметр используется для поиска элементов веб-страниц. Чтобы распознать элементы при помощи XPath, нужно установить расширение ELMA Web Recognizer. Ссылку на скачивание можно найти в настройках дизайнера ELMA RPA. Вы можете указывать значения контекстных переменных процесса. Нажмите на add-variable-icon  и укажите переменную. Ее можно выбрать из списка или добавить новую, нажав Создать параметр. Значение добавляется в формате {$наименование переменной}. Можно заполнить поле вручную, соблюдая указанный формат. Подробнее о контекстных переменных процесса читайте в этой статье.

Примеры использования XPath для указания элемента веб-страницы:

Блок «Элемент управления»

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

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

general-activity-settings-3

  • Корневой элемент — наименование корневого элемента (заголовка окна);
  • Имя наименование элемента управления;
  • Тип — тип элемента управления;
  • Текст — текст, который можно указать для поиска с помощью OCR;
  • Уровень — уровень вложенности элемента управления, начинается с рабочего стола;
  • Соотношение — соотношение сторон элемента управления.
  • Индекс — индекс элемента. Заполняется в том случае, если в интерфейсе расположено несколько одинаковых элементов.

Если для активити был задан дочерний элемент, информация о нем будет отображаться в этом блоке. Вы увидите скриншот дочернего элемента, над которым выполняется действие. Для него указываются такие же признаки, как и для родительского элемента. Чтобы удалить дочерний элемент, нажмите на значок delete-icon-3.

Чтобы указать информацию о дочернем элементе вручную, нажмите Добавить элемент +.

Использование регулярных выражений

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

Рассмотрим в качестве примера нажатие на кнопку для покупки товара. Значение корневого элемента может изменяться в зависимости от контекста, а в значении имени будет меняться стоимость.

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

Исходное значение:

 5 557₽ | 05.08 - 26.08, MOW ⇄ KVX - Google Chrome

Его можно преобразовать к виду:

/[\d\s]+₽ \| \d{2}\.\d{2} - \d{2}\.\d{2}, [A-Z]{3} ⇄ [A-Z]{3} - Google Chrome/

или к такому:

/.*₽ \| .* - .* ⇄ .* - Google Chrome/

Если предполагается, что другие значения не найдутся:

/.* - Google Chrome/

Для поля Имя можно использовать:

/Купить за [\d\s]+₽/

Или, например, так:

/Купить за .*/

Регулярные выражения можно использовать также в активити Считать из буфера обмена и Считать текст.

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

Использование контекстных переменных

При настройке активити можно использовать контекстные переменные. Вы можете указывать переменные при работе с такими активити, как Кликнуть по тексту, Ввести текст, Старт программы, Файл, Изменить параметр и Лог-сообщение.

Кроме того, переменные можно добавлять в блоке Элемент управления, когда вы заполняете поля Корневой элемент, Имя, Тип, Текст. Нажмите и укажите переменную. Ее можно выбрать из списка или добавить новую, нажав Создать параметр. Значение добавляется в формате {$наименование переменной}. Можно заполнить поле вручную, соблюдая указанный формат. Подробнее о контекстных переменных процесса читайте в этой статье.

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

Исходный текст:

5 557₽ | 05.08 - 26.08, MOW ⇄ KVX - Google Chrome

Вы можете подставить значения контекстных переменных. Создайте следующие переменные: «Стоимость», «Дата начала», «Дата окончания», «Шифр места отправления» и «Шифр места пребывания». Подставьте их в исходный текст:

 {$cost}₽ | {$date1} - {$date2}, {$from} ⇄ {$to} - Google Chrome

При работе с такими активити, как Ввести текст, Файл, Изменить параметр и Лог-сообщение переменные можно добавлять при помощи кнопки add-variable-icon.

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

Вкладка «Обработчики»

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

general-activity-settings-4

Задержка до и после активити

До и после выполнения активити происходит пауза, которая длится в течение времени, указанного в полях Задержка до, Задержка после. Время ожидания указывается в миллисекундах, по умолчанию — 250. Чтобы изменить время, нажмите на значок edit-icon.

Условия

Условия задаются в двух блоках:

  • Предусловие — проверяется до выполнения активити. Если условие верно, бот выполняет активити;
  • Постусловие — проверяется после выполнения активити. Если условие верно, бот переходит к следующему активити.

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

Можно использовать сразу несколько условий.

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

Чтобы удалить условие:

  • снова нажмите на иконку добавленного условия;
  • вызовите контекстное меню при помощи кнопки менюи нажмите Удалить.

Типы условий:

1. Интернет-соединение (интернет) — проверка доступности сайта. Чтобы добавить/изменить адрес, нажмите на значок edit-icon. В поле указывается IP-адрес сайта или адрес сайта без протокола, например, elma-bpm.ru. Это условие работает аналогично команде ping в командной строке Windows.

2. Ожидание изображения (изображение) — проверка доступности изображения. Это условие можно использовать, если элементы интерфейса появляются или исчезают с задержкой. Например, когда при нажатии кнопки запускается длительная операция. В этот момент отображается окно с предупреждением или индикатор выполнения. Когда операция закончится, может появиться новое окно, всплывающий элемент, элемент на панели статуса и т. д.

При добавлении этого условия появляются следующие настройки.

general-activity-settings-5

Вариант обработки:

На появление — ожидание появления указанного элемента;

На исчезновение — ожидание исчезновение указанного элемента;

Количество попыток проверки условия — указание, сколько раз будет проверяться, что элемент появился или исчез. По умолчанию — 1. Чтобы изменить количество, нажмите на значок edit-icon.

Интервал между проверками условия — время между проверками появления/исчезновения элемента, указывается в миллисекундах. По умолчанию — 10. Чтобы изменить интервал, нажмите на значок edit-icon.

Вы увидите также скриншот элемента, появление/исчезновение которого нужно ожидать.

Метод поиска — выбор метода поиска элемента, появление/исчезновение которого необходимо ожидать. Чтобы указать элемент интерфейса, нажмите на значок 139. Выбор элемента аналогичен выбору указателя при записи отдельного активити;

Кол-во попыток поиска и интервал (мс) — в этой настройке можно указать, сколько раз бот будет пытаться найти выбранный элемент интерфейса. По умолчанию — 10. Кроме того, вы можете задать паузу между попытками бота найти нужный элемент интерфейса. Указывается в миллисекундах, по умолчанию — 500. Чтобы изменить значения по умолчанию, нажмите на значок edit-icon.

Путь XPath — путь к элементу веб-страницы, задаваемый с помощью XPath. Настройка элемента выполняется так же, как и на вкладке Параметры.

О параметрах в блоке Элемент управления читайте в пункте Блок «Элемент управления».

3. Проверка программы (программа) — проверка наличия программы в системе.

Чтобы добавить/изменить название программы, нажмите на значок edit-icon.

начало внимание

Название программы необходимо задавать в таком виде, в каком оно указано в реестре Windows.

конец внимание

Сообщение в лог-файлы

Вы можете указать данные, которые будут записаны в лог-файлы до или после выполнения активити, чтобы отслеживать исполнение процесса. Подробнее о работе с лог-файлами читайте в статье «Отслеживание ошибок системы».

Для этого нажмите на кнопку log-icon и заполните поле Сообщение в логи. Вы можете указать текст и значения контекстных переменных процесса. Нажмите на add-variable-icon и укажите переменную. Ее можно выбрать из списка или добавить новую, нажав Создать параметр. Значение добавляется в формате {$наименование переменной}. Можно заполнить поле вручную, соблюдая указанный формат.