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