Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Изменить ресурс Версия 8 (Java)

Группа действий: Оркестратор Подгруппа Очереди ресурсов

...

Описание

Действие изменяет текущее значение и параметры ресурса в очереди ресурсов.

  1. Действие отправляет запрос на получение значения и\или параметров ресурса, созданного в очереди ресурсов в базе Оркестратора. При этом поиск ресурса производится по указанному идентификатору ресурса.
  2. Действие может блокировать ресурс на чтение или запись, если заполнены соответствующие входные параметры. Причем дополнительно будет указана дата снятия блокировки с ресурса. Наличие даты снятия блокировки означает то, что ресурс будет заблокирован до указанной даты, даже если робот уже завершит свою работу. При наступлении указанной даты серверная часть Оркестратора сама снимет блокировку. Однако текущий экземпляр робота также может снять эту блокировку, если выполнит соответствующее действие.

  3. При блокировке ресурса, данный экземпляр робота становится владельцем установленного вида блокировки. Быть владельцем блокировки означает то, что снять такую блокировку может только этот же экземпляр робота\проекта. Причем 2 разных запуска одного и того же робота (2 разных экземпляра) считаются разными владельцами.
  4. Пользователь имеет больше полномочий, чем роботы, поэтому может снимать\устанавливать блокировку вне зависимости от того, кто ее владелец.
  5. Если ресурс уже заблокирован на запись и при этом инициатор - не данный экземпляр робота, действие встает в ожидание снятия этой блокировки.
  6. Если действие должно заблокировать ресурс на чтение, но он уже заблокирован на чтение пользователем или другим экземпляром робота, действие встает в ожидание снятия этой блокировки. Если ресурс заблокирован на чтение, но действие не должно устанавливать этот вид блокировки, ожидание снятия блокировки на чтение не происходит, она просто игнорируется

Иконка действия

Image Removed

Параметры

Входные параметры

Идентификатор                         Уникальный идентификатор ресурса

Значение                                    Новое значение ресурса

Теги                                             Коллекция строк, в которой каждый элемент - это отдельный новый тег для ресурса. Если поле пустое, текущие теги ресурса не изменятся. Если указана коллекция, в которой 0 элементов, текущие теги будут удалены

Приоритет                                  Приоритет элемента среди других элементов очереди. Если поле пустое, текущий приоритет ресурса не поменяется

Временно запретить чтение    Дата автоматического снятия блокировки на чтение. Должна быть больше текущей даты. Если поле заполнено, ресурс будет сразу заблокирован

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

Тайм-аут, мс                              Время ожидания снятия блокировки с ресурса. Задается в миллисекундах. Если указано "-1", действие будет ждать бесконечно долго

Выходные параметры

Тэги                                             Коллекция строк, в которой каждый элемент - это отдельный тег ресурса

Приоритет                                 Приоритет ресурса среди других ресурсов очереди

Значение                                    Значение ресурса

Дата создания                          Дата и время создания ресурса

Дата обновления                     Дата и время последнего обновления ресурса

...

Image Added

Параметры и их настройки

Название

Описание

Тип данных

Обязательное

Примечание

Входные параметры


Идентификатор

Уникальный идентификатор ресурса

.

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", а также узнать дату создания данного ресурса.

Image Modified

Решение

Воспользоваться действиями "Изменить ресурс", "Сообщение в лог". 

...

  1. Перетащить на рабочую область действие "Изменить ресурс" и настроить его параметры
    1. Поле "Идентификатор" - Указать идентификатор ресурса.
    2. Поле "Приоритет" - Указать новый приоритет для ресурса.
      Image Modified
  2. Перетащить на рабочую область действие "Сообщение в лог" и настроить его параметры.
    1. Поле "Сообщение" - Указать результат (Дата создания) действия "Изменить ресурс"
      Image Modified
  3. Запустить робота по кнопке "Старт" в верхней панели. 

...

Программный робот отработал успешно.

Image Modified

Был изменен приоритет данного ресурса на "1", а также в лог была выведена дата создания данного ресурса


Image Modified