Элементы Студии

Все доступные компоненты процесса сгруппированы по тематике в панели Элементы. Например, группа Приложение Excel содержит специализированные элементы для работы с Excel.

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

• Избранные — для быстрого доступа к избранным элементам. В избранное элемент добавляется вручную. Для этого вызовите контекстное меню элемента и выберите пункт Добавить в Избранные:
• Часто используемые — для быстрого доступа к элементам, которые используются в проекте чаще всего.

Добавление элементов в процесс

Добавить элементы можно одним из следующих способов:

• Перетаскиванием drag-and-drop — выберите на панели элементов компонент и перетащите его в нужную часть процесса.
• Командой контекстного меню. Выберите элемент на панели элементов, вызовите его контекстное меню ПКМ, выберите Вставить после выделенного. Требование: в процессе должен существовать хотя бы один элемент для указания позиции вставки.

Свойства элемента

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

Панель Свойства состоит из нескольких информационных блоков:

• В верхней части отображается внутреннее наименование элемента и его уникальный идентификатор (ComponentId);
• В центральной — список свойств;
• В нижней части — краткое описание этих свойств (справка).

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

Все элементы обладают набором общих свойств:

1. Наименование — имя элемента, которое отображается в его заголовке и в журнале. Для удобства возможно изменить название элемента внутри процесса, например, когда используются несколько одинаковых компонентов.
2. Отключить логирование — позволяет отключить запись логов в консоли (только для данного элемента). Например, если он оперирует конфиденциальными данными. Существует возможность централизованно включить/отключить логирование для всех новых элементов, добавляемых в проект. Для этого перейдите в раздел Файл > Настройки > Общие > Элементы и установите нужное значение в чекбоксе Отключить логирование у новых элементов.
3. Продолжить при ошибке — сценарий будет выполняться даже в том случае, если при выполнении элемента возникла ошибка.
4. Скриншот завершения — позволяет сделать снимок экрана в момент завершения работы элемента. Эти скриншоты сохраняются в папку .Screenshots, которая создается автоматически внутри папки с процессом.
5. Скриншот ошибки — при возникновении ошибки будет сделан снимок экрана.
6. Пауза до (мс) — добавляет паузу перед выполнением элемента. Пауза может понадобиться, например, в случае, если сайт, с которым планируется выполнить определенное действие, долго загружается, и требуется подождать, прежде чем переходить к следующему элементу в процессе. Аналогичную роль выполняет элемент Ожидание
7. Пауза после (мс) — добавляет паузу после выполнения элемента.

Частные свойства описаны в статьях, посвященных конкретным элементам. Описание всех встроенных элементов в Primo RPA Studio (Windows) можно найти здесь.

Вносить изменения в свойства можно также в слотах самого элемента:

Значения свойств

Значения бывают следующих видов:

• Константа — обычный текст (например, как в свойстве Наименование) или чекбокс (например, Продолжить при ошибке). В случае текста рядом часто можно увидеть кнопку переключения межу режимами Код и Без кода — /> alt=“alt” data-size=“line” /> В состоянии Без кода введенные данные будут интерпретироваться как константы либо как имена переменных (то есть не будут считаться кодом).

• Переменная — выбирается из списка переменных, созданных для данного процесса, и выглядит как выпадающий список:

  

• Вычисляемое значение — выражение на том языке программирования, который был выбран при создании процесса (C#, Python либо JavaScript). Даже в случае, если необходимо указать обычную строку, ее текст необходимо заключить в кавычки, а спецсимволы внутри строки экранировать по правилам выбранного языка (описание языков не входит в тематику данного руководства). Вычисляемое свойство всегда содержит кнопку «…»:

  

  При нажатии кнопки «…» откроется форма редактирования выражения:

  

• Шаблон поиска — выражение, описывающее шаблон поиска элемента управления. Наличие шаблона поиска зависит от типа элемента.

Скриншоты элементов

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

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

Дополнительно скриншот сохранится в папку проекта .Resources. Название скриншота представляет собой ID элемента, к которому относится изображение.

Управление скриншотом осуществляется через контекстное меню скриншота. Доступны команды:

• Сделать скриншот — позволяет заменить текущий скриншот.
• Очистить — позволяет удалить скриншот.

Аннотации

К каждому элементу процесса можно добавить краткое описание (аннотацию). Описание будет отображаться сразу под названием элемента.

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

Управление элементами

Дополнительные действия с элементами можно осуществить при вызове контекстного меню. При нажатии ПКМ (правой клавиши мыши) доступны команды:

• Вырезать
• Копировать
• Вставить
• Удалить
• Закомментировать элементы — временное отключение выполнения. Элемент будет помещен в контейнер Закомментировать и проигнорируется при запуске/отладке процесса. При выборе сразу нескольких элементов, элементы будут закомментированы массово. Команда недоступна для корневой последовательности.
• Раскомментировать элементы — команда отображается только для контейнера Закомментировать, в котором находятся закомментированные элементы.
• Перенести элемент в try/catch — автоматически оборачивает элементы в блок обработки исключений Try-Catch.
• Перенести в новую последовательность — вызывает окно создания последовательности, после чего переносит выбранный элемент эту последовательность. Команда недоступна для корневой последовательности.
• Запуск с элемента — запускает процесс с выбранного элемента.
• Включить логирование — Функция доступна с версии 1.24.10
• Отключить логирование — Функция доступна с версии 1.24.10
• Помощь — открывает в браузере страницу документации по элементу.

Пакетное включение логирования элементов

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

1. Выберите необходимые элементы, зажав клавишу Shift и выделив первую и последнюю активности в списке.
2. Нажмите правой клавишей мыши на выделенные элементы и выберите опцию Отключить логирование или Включить логирование.

Отображение свойств элементов и редактор синтаксиса

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

Для активации данной функции:

1. Перейдите в раздел Файл → Настройки → Общие → Элементы.
2. Выберите версию v2.
3. Для процессов с типом “Диаграмма” установите галочку “Отображать дизайн элементов диаграммы”.

Кроме того, встроен редактор синтаксиса (IntelliSense), поддерживающий автозаполнение методов и программных выражений.

Для активации редактора синтаксиса:

1. Перейдите в раздел Файл → Настройки.
2. Установите галочку в параметре “Использовать строчный редактор”. Редактор включен по умолчанию.

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

Автоматическое определение параметров с версии 1.25.3

• Новые кнопки “Выбрать” для упрощения заполнения свойств:

  • Браузерные активности:
    • “Открыть браузер” → кнопка “Выбрать браузер” (автозаполнение типа браузера и URL)
    • “Присоединиться к браузеру” → автозаполнение заголовка вкладки и URL
    • “Активировать вкладку браузера” → автоматическое определение параметров вкладки
    • “Вход в систему” → кнопка “Выбрать вкладку”
  • Работа с процессами:
    • “Уничтожить процесс” → кнопка “Выбрать процесс” (автозаполнение имени процесса и заголовка)
    • “Присоединиться к приложению” → автоматическое определение параметров приложения

Элементы NuGet-пакетов

Элементы делятся на два типа:

1. Встроенные - базовые элементы, включенные в стандартную комплектацию Primo RPA Studio
2. Дополнительные NuGet - не входят в базовую комплектацию и требуют отдельной установки через NuGet-пакеты

После установки NuGet-пакета новые элементы автоматически появляются в панели элементов

Как работать с дополнительными элементами:

1. Установите нужный NuGet-пакет через:
   • Менеджер зависимостей в Primo RPA Studio
   • Ручную загрузку с NuGet.org
2. После установки проверьте появление новых элементов
3. Используйте их в процессах как обычные встроенные элементы