Ресурсы (интерфейс UI4)

Ресурсы – это именованные переменные в хранилище Оркестратора, которые при выполнении RPA-проектов могут читать/устанавливать роботы и Студия.

Ресурсы делятся на глобальные и локальные. Глобальные ресурсы – доступны всем роботам (в зависимости от настроек чтение/запись). Локальные ресурсы привязаны к конкретному роботу (роботу-владельцу), и только этот робот имеет к ним доступ (в зависимости от настроек чтение/запись).

Где найти: главное меню → раздел Роботы → вкладка Ресурсы.

Колонки таблицы

По умолчанию отображаются Имя, Описание, Тип, Значение, Дата создания, Дата обновления и Теги. Через параметры таблицы можно добавить остальные колонки: Логин, Пароль, Робот-владелец, Только для чтения, Блокировка, Тип блокировки, Таймаут (сек), Тип внешнего хранилища, Учетная запись CyberArk, Значения для пользователей, Пользователь, AD, Дата прочтения.

Начиная с версии 1.25.1 раздел Ресурсы содержит столбцы «Дата создания», «Дата обновления» и «Дата прочтения» для отображения активности ресурсов. Данные автоматически синхронизируются с базой ltools (таблица Assets) и обновляются при создании, изменении или использовании ресурса роботом.

Поиск и фильтры

Над таблицей расположено поле быстрого поиска — по названию или описанию. Кнопка Фильтры добавляет фильтры по Типу, признаку Только для чтения, Роботу-владельцу, Тегу и Блокировке; количество отфильтрованных элементов показывается счётчиком в левой части тулбара.

Создание ресурса

Для создания ресурса нажмите кнопку Добавить ресурс — откроется форма Добавить ресурс.

Обязательные поля — Имя и Тип; остальной состав формы зависит от выбранного типа. Например, для типа Credentials дополнительно появляются Тип внешнего хранилища, Значения для пользователей, Логин и Пароль:

• Имя – уникальное наименование ресурса, по которому робот будет к нему обращаться.

• Описание – произвольное текстовое описание ресурса. Обычно содержит описание назначения ресурса, его содержимого.

• Тип – тип данных:

  • String – произвольная строка
  • Integer – целое число
  • Floating – число с плавающей точкой
  • Boolean – логический, строка true/false
  • DateTime – дата-время
  • Credentials – логин-пароль или ссылка на внешнее хранилище Credentials
  • JObject – строка с валидным json

• Значение – значение ресурса; для типа JObject поле называется Значение (JSON).

• Блокировка* – если выставлен Тип блокировки, ресурс может быть взят роботом в монопольный доступ. Блокировка необходима при конкурентном доступе роботов к общему ресурсу. Например, при одновременной работе двух и более роботов с проектом, содержащим данный ресурс. При этом проект должен содержать элемент, устанавливающий блокировку. Если робот заблокировал элемент, то действия других роботов с данным ресурсом будут ограничены на установленное время. Настройка работает независимо от параметра Робот-владелец (владельцы могут быть установлены или отсутствовать). Возможные типы блокировки:

  • Разрешено чтение — другие роботы смогут только читать этот ресурс. Запись запрещена.
  • Запрещено чтение — другим роботам полностью запрещено использовать этот ресурс. Настройка помогает исключить «грязное» чтение: когда один робот меняет значение заблокированного ресурса, другой робот не может прочитать старое значение.

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

• Робот-владелец — позволяет назначить робота (-ов) для работы с ресурсом. В этом случае ресурс будет считаться локальным, привязанным к роботу. Если вы хотите, чтобы ресурс был доступен всем роботам, оставьте это поле пустым.

• Только для чтения — устанавливает допустимые действия с ресурсом для роботов. По умолчанию переключатель выключен — роботы могут читать и изменять (перезаписывать) значение ресурса. Если включить настройку, то ресурс будет доступен только для чтения.

• Таймаут (сек) — время блокировки ресурса за конкретным роботом. Если таймаут блокировки не указан, применится значение по умолчанию — 20 секунд, после чего блокировка будет автоматически снята.

• Тип внешнего хранилища – применим только к ресурсам типа Credentials при настроенной интеграции с CyberArk. В этом случае Credentials физически хранится в CyberArk, а в Оркестраторе хранится только идентификатор из внешнего хранилища.

• Учетная запись CyberArk — если в поле Тип внешнего хранилища был выбран CyberArk, отобразится обязательное поле Учетная запись CyberArk с кнопкой Поиск. Нажатие на кнопку Поиск открывает модальное окно для выбора учетной записи из CyberArk.

• Папка — папка, в которой размещается ресурс.

Значения для пользователей

Для ресурсов типа Credentials можно задать значения, которые будут привязаны к учетным записям робота (локальным или AD) — для этого переведите флажок Значения для пользователей в положение Включен.

При получении такого ресурса его значения будут свои, в зависимости от того, под какой УЗ робот авторизуется в Оркестраторе.

Если флажок Значения для пользователей включен, флажок Только для чтения будет включен автоматически, а поля Логин, Пароль, Робот-владелец, Тип блокировки, Таймаут будут скрыты.

Для поля Пользователь подключено автозаполнение (исходя из существующих пользователей Оркестратора) и осуществляется проверка уникальности введенных значений.

При включенном флажке Значения для пользователей таблица пользователей не может быть пустой (должен быть указан как минимум один пользователь).

Теги ресурсов

Ресурсу можно назначить теги — они отображаются в колонке Теги и доступны как фильтр. Управление тегами выполняется из меню действий строки (Добавить тег к ресурсу); там же доступно действие Переместить в папку.

Экспорт и импорт CSV

Кнопка Экспорт и импорт в тулбаре открывает два действия:

• Экспортировать в CSV — выгружает список ресурсов. Выгрузка не учитывает ресурсы с внешним типом хранилища.
• Импортировать из CSV — загружает ресурсы из файла. По завершении открывается окно Импорт CSV с итогом: сколько записей Создано и сколько Ошибок; для каждой ошибки указаны Имя ресурса и Причина ошибки.

Ресурсы почтовых триггеров (тип JObject)

Начиная с версии Оркестратора 1.25.7 / 1.26.7 при настройке триггера на получение письма в ресурс типа JObject автоматически сохраняются данные о письме, вызвавшем запуск проекта.

В ресурс добавляются следующие поля:

• MessageId — уникальный идентификатор письма
• MessageDate — дата и время получения письма

Это позволяет в RPA-проекте однозначно идентифицировать письмо, которое инициировало выполнение, и корректно обрабатывать его вложения через элементы группы Оркестратор > Почта.

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

Работа с ресурсами из Студии

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

Пример:

• Чтобы получить из Оркестратора ресурс с типом Сredentials, используйте в RPA-проекте элемент Получить учетные данные.
• Чтобы изменить в Оркестраторе значение ресурса с типом Сredentials, используйте в RPA-проекте элемент Установить учетные данные.

Права доступа к ресурсам

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

Важно! Право Управление в разделе Ресурсы отвечает за операции извлечения и установки значения ресурса. Оно должно назначаться совместно с правом Просмотр.

Без права Управление при попытке получить или установить ресурс через API или Студию будет возвращаться ошибка 403 Forbidden.

Подробнее о настройке прав на ресурсы см. в разделе Роли пользователей Оркестратора.