Получить ресурс по ID Версия 7 (Java)
Группа действий: Оркестратор Подгруппа Очереди ресурсов
Описание
- Действие ищет ресурс по указанному идентификатору и возвращает его значение и параметры. Действие отправляет запрос на получение значения и параметров ресурса, созданного в очереди ресурсов в базе Оркестратора. При этом поиск ресурса производится по указанному идентификатору ресурса.
- Поиск указанного ресурса будет происходить по следующим правилам:
- Если запуск проекта робота, поиск ресурса с указанным идентификатором будет осуществляться только том тенанте, под которым пользователь вошел в Студию. Если ресурс найден, соответственно, есть доступ для работы с ним.
- Если запуск готового робота, поиск ресурса с указанным идентификатором будет осуществляться только том тенанте, в который добавлен сам робот (добавлен или в сам тенант, или в его группу).
- Действие может блокировать ресурс на чтение или запись, если активированы соответствующие входные параметры. При блокировке ресурса, данный экземпляр робота становится владельцем установленного вида блокировки. Быть владельцем блокировки означает то, что снять такую блокировку может только этот же экземпляр робота\проекта. Причем 2 разных запуска одного и того же робота (2 разных экземпляра) считаются разными владельцами.
- Пользователь имеет больше полномочий, чем роботы, поэтому может снимать\устанавливать блокировку вне зависимости от того, кто ее владелец.
- Если ресурс уже заблокирован на чтение и при этом инициатор - не данный экземпляр робота, действие встает в ожидание снятия этой блокировки.
- Если действие должно заблокировать ресурс на запись, но он уже заблокирован на запись пользователем или другим экземпляром робота, действие встает в ожидание снятия этой блокировки. Если ресурс заблокирован на запись, но действие не должно устанавливать этот вид блокировки, ожидание снятия блокировки на запись не происходит, она просто игнорируется.
Иконка действия
Параметры и их настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Идентификатор | Уникальный идентификатор ресурса | Robin.String | Да | |
Запретить чтение | Если значение "true", действие заблокирует ресурс на запись для других роботов. Но если ресурс уже заблокирован на запись другим инициатором, действие будет ожидать снятия блокировки. При значении "false", действие игнорирует блокировку на запись | Robin.Boolean | False | Нет |
Запретить запись | Если значение "true", действие заблокирует ресурс на запись для других роботов. Но если ресурс уже заблокирован на запись другим инициатором, действие будет ожидать снятия блокировки. При значении "false", действие игнорирует блокировку на запись | Robin.Boolean | False | Нет |
Тайм-аут, мс | Время ожидания снятия блокировки с ресурса. Задается в миллисекундах. Если указано "-1", действие будет ждать бесконечно долго | Robin.Numeric | 0 | Нет |
Результаты | ||||
Теги | Коллекция строк, в которой каждый элемент - это отдельный тег полученного элемента | Robin.Collection | ||
Приоритет | Приоритет полученного элемента среди других элементов очереди | Robin.Numeric | ||
Дата создания | Дата и время, когда элемент был добавлен в очередь | Robin.DateTime | ||
Дата обновления | Дата и время, когда элемент был последний раз обновлен | Robin.DateTime | ||
Значение | Значение ресурса | Robin.Object |
Особые условия использования
Отсутствуют
Пример использования
Задача
Существует ресурс, необходимо закрыть его на чтение и запись, а также узнать приоритет данного ресурса.
Решение
Воспользоваться действиями "Получить ресурс по ID", "Сообщение в лог".
Реализация
- Перетащить на рабочую область действие "Получить ресурс по ID" и настроить его параметры
- Поле "Идентификатор" - Указать идентификатор ресурса.
- Чекбокс "Запретить чтение" - Указать true, чтобы действие заблокировало ресурс на чтение.
- Чекбокс "Запретить запись " - Указать true, чтобы действие заблокировало ресурс на запись
- Перетащить на рабочую область действие "Сообщение в лог" и настроить его параметры.
- Поле "Сообщение" - Указать результат (Приоритет) действия "Получить ресурс по ID"
- Поле "Сообщение" - Указать результат (Приоритет) действия "Получить ресурс по ID"
- Запустить робота по кнопке "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Ресурс заблокирован на чтение и на запись, а приоритет ресурса был выведен в лог.