Обновить элемент Версия 7 (Java)

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


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


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

Свойство

Описание

Тип

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

Обязательность заполнения поля

Параметры

ID элемента

Уникальный идентификатор элемента очереди, который будет обновлен.

Robin.String


Да

Значение

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

Robin.Object


Нет

Теги

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

Robin.Collection


Нет

Приоритет

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

Robin.Numeric


Нет

Тайм-аут, мс

Время, в течение которого действие будет ожидать разблокировки элемента, если он уже заблокирован на обновление другим роботом или пользователем. Задается в миллисекундах. Если элемент не разблокировали или удалили, действие возвращает ошибку. Если указано «-1», действие будет ожидать разблокировки элемента, пока элемент не разблокируют или не удалят.

Robin.Numeric


Нет

Дата разблокировки на чтение

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


Если в поле указано "1-1-0001 00:00:00" (стандартное значение для дат, когда пользователь не вводил конкретную дату, но открывал окно редактирования), сервер должен воспринимать так, будто дата и время отложенного запуска не указаны.

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

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


Дата\Время
Нет
Дата разблокировки на запись

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


Если в поле указано "1-1-0001 00:00:00" (стандартное значение для дат, когда пользователь не вводил конкретную дату, но открывал окно редактирования), сервер должен воспринимать так, будто дата и время отложенного запуска не указаны.

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


Дата\Время
Нет
Результаты

Теги

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

Robin.Collection



Приоритет

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

Robin.Numeric



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

Дата и время, когда элемент был добавлен в очередь.

Robin.DateTime



Дата и время обновления

Дата и время, когда элемент был последний раз обновлен.

Robin.DateTime



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

Действие устаревшее

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

Задача
Существует процесс по обработке заявок на оплату, где в очереди Test1 существует элемент (заявка). 
Необходимо изменить тег элемента с значения "проверка" на "11111111" для обработки элемента в дальнейшем по новому тегу. 

Решение
Воспользоваться действием "Обновить элемент". 

Реализация

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

    Заполнить поле "ID элемента" значением из колонки идентификатор (панель по управлению очередями, где пользователь заранее сам узнает ID). Так же, ID элемента можно получить с помощью действий: Добавить элемент, Получить элемент по условию. 


  2. Заполнить поле "Теги" значением "11111111".


  3. Далее, в открывшемся окне в поле значение ввести требуемое.


  4. При необходимости записи результатов действия, заполнить поля соответствующими типами переменных. 

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

    • При необходимости поменять приоритет элемента (например, если требуется обрабатывать некоторые элементы (заявки) в первую очередь) необходимо заполнить поле "Приоритет" требуемым значением (например, 1). Элементы, у которых приоритет выше, будут обработаны в первую очередь. 
    • Если элемент заблокирован на чтение и/или обновление и требуется его разблокировка, то необходимо заполнить поля: "Дата разблокировки на чтение" и/или "Дата разблокировки на обновление".  Например, заявка заблокирована на чтение , но необходимо отключить ее блокировку (позволить роботу видеть заявку в дальнейшем) после определенной даты и времени. 

Таким образом можно по отдельности обновлять или устанавливать значение элемента или его приоритет. А также разблокировать элемент на чтение и запись с учетом определенной даты и времени. 

Результат

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

Тег элемента успешно обновлен. 

  • Нет меток