Обновить элемент Версия 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" для обработки элемента в дальнейшем по новому тегу.
Решение
Воспользоваться действием "Обновить элемент".
Реализация
- Перетащить на рабочую область действие "Обновить элемент" и заполнить его параметры.
Заполнить поле "ID элемента" значением из колонки идентификатор (панель по управлению очередями, где пользователь заранее сам узнает ID). Так же, ID элемента можно получить с помощью действий: Добавить элемент, Получить элемент по условию. - Заполнить поле "Теги" значением "11111111".
- Далее, в открывшемся окне в поле значение ввести требуемое.
- При необходимости записи результатов действия, заполнить поля соответствующими типами переменных.
5. Запустить робота по кнопке "Старт" в верхней панели.
- При необходимости поменять приоритет элемента (например, если требуется обрабатывать некоторые элементы (заявки) в первую очередь) необходимо заполнить поле "Приоритет" требуемым значением (например, 1). Элементы, у которых приоритет выше, будут обработаны в первую очередь.
- Если элемент заблокирован на чтение и/или обновление и требуется его разблокировка, то необходимо заполнить поля: "Дата разблокировки на чтение" и/или "Дата разблокировки на обновление". Например, заявка заблокирована на чтение , но необходимо отключить ее блокировку (позволить роботу видеть заявку в дальнейшем) после определенной даты и времени.
Таким образом можно по отдельности обновлять или устанавливать значение элемента или его приоритет. А также разблокировать элемент на чтение и запись с учетом определенной даты и времени.
Результат
Программный робот отработал успешно.
Тег элемента успешно обновлен.