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

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

Настройки большинства активити задаются автоматически во время записи процесса:

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

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

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

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

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

general-activity-settings-1

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

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

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

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

Для активити Клик, Двойной клик, Наведение, Drag&Drop, Прокрутка, Получение данных контрола, Чтение таблиц и Получение данных с помощью 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.

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

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

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

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

В активити Ввод текста в поле Значение и в активити Файл в поле Путь к файлу и Путь до нового файла переменные можно добавлять при помощи кнопки переменная.

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

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

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

general-activity-settings-4

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

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

Условия

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

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

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

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

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

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

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

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

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

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

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

general-activity-settings-5

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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