Skip to Content
Primo RPA Studio CitizenЭлементы

Работа с элементами

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

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

alt

Под поисковой строкой можно увидеть иконки групп:

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

alt

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

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

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

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

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

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

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

alt

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

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

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

Если панель свойств или другие панели интерфейса случайно исчезли:

  1. Перейдите в верхнее меню ВидПанели
  2. Выберите Сброс панелей
  3. Интерфейс восстановится в стандартное состояние

Примечание: Это не влияет на ваш процесс или настройки, только на расположение элементов интерфейса.

Частные свойства описаны в статьях, посвященных конкретным элементам.

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

alt

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

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

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

В зависимости от типа элемента и назначения свойств, их значения бывают следующих видов:

  • Сценарий - открывает окно формирования сценария с помощью C#.
  • Вставить из буфера обмена - вносит в поле содержимое, предварительно скопированное в буфер обмена.
  • Текст
  • Текст - Пустое значение
  • True/False - истина или ложь, используется для указания значений, которые могут быть только в одном из этих двух состояний.
  • Choose Date/Time - выбор даты/времени.
  • Number - используется для указания числового значения.
  • Шаблон поиска — выражение, описывающее шаблон поиска элемента управления. Наличие шаблона поиска зависит от типа элемента.
  • Константа — обычный текст или чекбокс.
  • Переменная — выбирается из списка переменных, созданных для данного процесса, и выглядит как выпадающий список:
    alt
  • Очистить значение - удаляет содержимое поля.

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

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

alt

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

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

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

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

Соблюдайте следующие рекомендации при работе с функцией скриншотов: 1. Использовать только один монитор. 2. В RDP-сессиях, убедитесь, что: масштаб удаленного рабочего стола равен 100%; отключено интеллектуальное изменение размера.

Аннотации

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

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

alt

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

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

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

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

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

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

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

Редактор синтаксиса

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

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

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

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