Создать ресурс Версия 5 (Java)

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

Описание

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

1. Действие отправляет запрос на создание нового ресурса в очереди ресурсов, хранящейся в базе Оркестратора.
2. При создании ресурса сервер присваивает ему уникальный идентификатор. Идентификаторы ресурсов уникальны в базе Оркестратора в целом, вне зависимости от того, в какой тенант добавлена очередь ресурсов.
   
3. Поиск указанной очереди происходит по следующим правилам:
   
   • Если запуск проекта робота, поиск очереди будет осуществляться только в том тенанте, под которым пользователь вошел в Студию. Если очередь найдена, соответственно, есть доступ для работы с ней.  
   • Если запуск готового робота, поиск очереди будет осуществляться только в том тенанте, в который добавлен сам робот (добавлен или в сам тенант, или в его группу). Если очередь найдена, соответственно, есть доступ для работы с ней.  
4. Действие может сразу блокировать новый ресурс на чтение или запись, если заполнены соответствующие входные параметры. Причем дополнительно будет указана дата снятия блокировки с ресурса. Наличие даты снятия блокировки означает то, что ресурс будет заблокирован до указанной даты, даже если робот уже завершит свою работу. При наступлении указанной даты серверная часть Оркестратора сама снимет блокировку. Однако текущий экземпляр робота также может снять эту блокировку, если выполнит соответствующее действие.
5. При блокировке ресурса, данный экземпляр робота становится владельцем установленного вида блокировки. Быть владельцем блокировки означает то, что снять такую блокировку может только этот же экземпляр робота\проекта. Причем 2 разных запуска одного и того же робота (2 разных экземпляра) считаются разными владельцами.
6. Пользователь имеет больше полномочий, чем роботы, поэтому может снимать\устанавливать блокировку вне зависимости от того, кто ее владелец.

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

Параметры

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

Очередь ресурсов                     Название очереди ресурсов, в которой будет создан новый ресурс.

Значение                                    Значение, которое будет записано в новом ресурсе.

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

Приоритет                                  Приоритет нового ресурса среди других ресурсов очереди. Если поле пустое, ресурсу будет присвоен приоритет 0.

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

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

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

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

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

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

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

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

Настройки

Особые условия использования

Отсутствуют.

Пример использования 

Задача

Необходимо создать ресурс в очереди ресурсов с приоритетом "2", а также вывести его идентификатор в лог.

Решение

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

Реализация

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

3. Перетащить на рабочую область действие "Сообщение в лог" и настроить его параметры.

1. 1. Поле "Сообщение" - Указать результат (Идентификатор) действия "Создать ресурс"

4. Запустить робота по кнопке "Старт" в верхней панели. 

Результат

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

Был создан новый ресурс в соответствующей очереди ресурсов, с приоритетом "2". Также в лог был выведен идентификатор нового ресурса.