Ресурсы
Ресурсы (Assets) – именованные значения, которые хранятся в Primo RPA Orchestrator и используются RPA-проектами. Роботы и Studio могут получать и изменять значения ресурсов в пределах предоставленных прав доступа и заданных ограничений.
Ресурсы позволяют централизованно управлять параметрами автоматизации: строками, числами, датами, учётными данными и структурированными данными JSON. Для каждого ресурса задаются тип, область доступности и при необходимости правила блокировки.
Область доступности ресурсов
Ресурсы могут быть глобальными или локальными.
| Вид ресурса | Доступность |
|---|---|
| Глобальный | Не привязан к определённому роботу. Доступен роботам с необходимыми правами, с учётом настроек чтения и записи. |
| Локальный | Привязан к одному или нескольким роботам, указанным в поле Робот-владелец. Доступен назначенным роботам с учётом настроек чтения и записи. |
Если поле Робот-владелец не заполнено, ресурс считается глобальным.
Создание и настройка ресурса
- В Оркестраторе откройте раздел Роботы → Ресурсы.
- Нажмите Добавить ресурс.
- Укажите наименование и тип ресурса, а также заполните остальные необходимые поля.
- При необходимости назначьте робота-владельца, ограничьте изменение значения или настройте блокировку.
- Сохраните ресурс.
Основные свойства
| Свойство | Описание |
|---|---|
| Наименование | Уникальное имя ресурса, по которому к нему обращаются роботы и Studio. |
| Описание | Необязательное пояснение о назначении ресурса и его содержимом. |
| Тип | Тип данных, хранящихся в ресурсе. |
| Робот-владелец | Один или несколько роботов, которым назначен ресурс. Если поле не заполнено, ресурс является глобальным. |
| Только для чтения | Запрещает роботам изменять значение ресурса. По умолчанию параметр выключен: чтение и запись доступны при наличии соответствующих прав. |
Типы ресурсов
| Тип | Назначение |
|---|---|
String | Строковое значение. |
Integer | Целое число. |
Floating | Число с плавающей точкой. |
Boolean | Логическое значение true или false. |
DateTime | Значение даты и времени. |
Credentials | Учётные данные - логин и пароль. Значения также могут храниться во внешнем хранилище. |
JObject | Структурированные данные в формате JSON. |
Блокировка ресурса
Блокировка применяется для управления конкурентным доступом к общему ресурсу, например когда несколько роботов одновременно выполняют процессы, использующие одно значение.
Чтобы использовать блокировку, выберите Тип блокировки в настройках ресурса. В проекте должна быть предусмотрена активность «Заблокировать ресурс».
| Тип блокировки | Поведение других роботов во время блокировки |
|---|---|
| Разрешено чтение | Разрешено читать ресурс, но запрещено изменять его значение. |
| Запрещено чтение | Запрещено читать и изменять ресурс до снятия блокировки. |
Свойство Таймаут определяет длительность блокировки в секундах. Если значение не указано, используется таймаут по умолчанию – 20 секунд. По истечении таймаута блокировка снимается автоматически.
Настройка блокировки применяется независимо от наличия робота-владельца. При этом она не отменяет ограничений доступа к локальному ресурсу и прав пользователя.
Ресурсы типа Credentials
Ресурс типа Credentials предназначен для хранения и получения пары «логин – пароль». Учётные данные можно хранить средствами Оркестратора либо использовать внешнее хранилище.
Использование внешнего хранилища
Для ресурсов типа Credentials предусмотрено свойство Тип внешнего хранилища. При настроенной интеграции можно выбрать:
- CyberArk – учётную запись из хранилища CyberArk;
- HashiCorp Vault – учётную запись из хранилища Vault.
В таком случае значение учётных данных хранится во внешней системе, а ресурс Оркестратора содержит сведения, необходимые для обращения к соответствующей записи.
При выборе CyberArk появляется поле Учётная запись CyberArk. Нажмите Поиск и выберите нужную учётную запись в открывшемся окне.
При выборе HashiCorp Vault выберите необходимую учётную запись из доступных записей Vault. Доступность записей зависит от настройки интеграции и прав доступа к хранилищу.
Поддержка HashiCorp Vault для ресурсов типа Credentials добавлена в Primo
RPA Orchestrator 1.26.8. Эта возможность отличается от хранения в Vault
секретов конфигурации служб Оркестратора.
Значения для пользователей
Для ресурса типа Credentials можно задать разные значения учётных данных в зависимости от учётной записи, под которой робот авторизуется в Оркестраторе (локальной или доменной).
- При создании или редактировании ресурса типа
Credentialsвключите переключатель Значения для пользователей. - Добавьте в таблицу как минимум одного пользователя.
- Укажите соответствующие ему учётные данные и сохраните ресурс.
При получении такого ресурса его значения будут свои, в зависимости от того, под какой УЗ робот авторизуется в Оркестраторе.
Ресурс Credentials со значениями для учётных записей роботов:
Когда параметр Значения для пользователей включён:
- при получении ресурса возвращается значение, соответствующее учётной записи робота;
- параметр Только для чтения включается автоматически;
- поля Логин, Пароль, Робот-владелец, Тип блокировки и Таймаут скрываются;
- поле Пользователь поддерживает автозаполнение по пользователям Оркестратора и проверку уникальности введённых значений;
- таблица пользователей должна содержать хотя бы одну запись.
Значения для пользователей – отдельный механизм настройки ресурса типа
Credentials. Не путайте его с назначением робота-владельца, которое
определяет область доступности локального ресурса.
Просмотр и фильтрация ресурсов
В таблице ресурсов доступны сведения об их использовании:
- Дата создания – когда ресурс был создан;
- Дата обновления – когда ресурс изменяли;
- Дата прочтения – когда значение ресурса считывалось.
Эти сведения обновляются при соответствующих операциях с ресурсами и хранятся в таблице Assets базы данных ltools.
Для поиска ресурсов можно использовать фильтры по описанию, типу данных, параметру Только для чтения, роботу и блокировке. Над таблицей отображается количество записей, соответствующих выбранным фильтрам.
Ресурсы для почтовых триггеров
При использовании триггера на получение письма Оркестратор может записывать сведения о письме, вызвавшем запуск проекта, в ресурс типа JObject.
В ресурс добавляются поля:
| Поле | Описание |
|---|---|
MessageId | Идентификатор письма. |
MessageDate | Дата и время получения письма. |
Эти сведения помогают определить письмо, инициировавшее выполнение, в том числе при обработке вложений с помощью активностей группы Оркестратор → Почта.
Если несколько писем одновременно ожидают обработки и соответствуют условиям
триггера, ресурс может содержать данные последнего письма, прочитанного
Оркестратором. Для более точной идентификации используйте дополнительные
признаки письма, например отправителя, тему и MessageDate.
Работа с ресурсами из Studio
Для работы с ресурсами Оркестратора используйте активности группы Оркестратор → Ресурсы в Primo RPA Studio.
| Активность | Назначение |
|---|---|
| Получить ресурс | Получить значение ресурса Оркестратора. |
| Установить ресурс | Записать или изменить значение ресурса при наличии разрешения на запись. |
| Заблокировать ресурс | Установить блокировку ресурса, для которого предусмотрена соответствующая настройка. |
| Получить учетные данные | Получить логин и пароль из ресурса типа Credentials. |
| Установить учетные данные | Установить значения учётных данных с учётом настроек ресурса и поддерживаемых операций. |
Подробнее об активностях:
Если значение ресурса типа Credentials хранится в HashiCorp Vault, робот может получать эти данные через Оркестратор. Источник хранения определяется настройками ресурса; передавать параметры подключения к Vault в активность «Получить учетные данные» не требуется.
Подтверждена возможность получения значений Credentials из Vault через Оркестратор. Возможность изменения записей непосредственно во внешнем хранилище с помощью активности «Установить учетные данные» следует проверять отдельно.
Права доступа к ресурсам
Доступ к ресурсам определяется правами, назначенными пользователю в конструкторе ролей Оркестратора.
| Операция | Необходимые права |
|---|---|
| Просмотр списка ресурсов | Просмотр |
| Получение значения ресурса | Просмотр и Управление |
| Изменение значения ресурса | Просмотр и Управление |
Для чтения и изменения значений ресурсов право Управление необходимо
назначать вместе с правом Просмотр. При недостаточных правах запрос из
Studio или через API может завершиться ошибкой 403 Forbidden.
Подробнее см. раздел «Роли пользователей Оркестратора».
Если ресурс недоступен
При ошибке получения или изменения ресурса проверьте:
- Существует ли ресурс и правильно ли указано его наименование.
- Соответствует ли выбранная активность типу ресурса.
- Имеет ли робот доступ к ресурсу с учётом поля Робот-владелец.
- Назначены ли необходимые права Просмотр и Управление.
- Не ограничены ли действия параметрами Только для чтения или Тип блокировки.
- Если используется CyberArk или HashiCorp Vault, доступно ли внешнее хранилище и корректно ли настроена интеграция.