История страницы
...
В случае отсутствия в очереди подходящих элементов, действие ожидает их появления в течение времени, указанного в поле «Тайм-аут, мс».
Иконка
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|
Параметры | ||||
Группа | Название существующей группы очередей, содержащей очередь, в которой будет производится поиск элемента. | Robin.String | Да | |
Очередь | Название существующей очереди, в которой будет производиться поиск элемента. | Robin.String | Да | |
Теги | Коллекция строк, в которой каждый элемент - это отдельный тег элемента очереди. Действие будет искать среди тех элементов, у которых есть хотя бы один из перечисленных тегов. | Robin.Collection | Нет | |
| Статус | Статус, который должен иметь искомый элемент. Поле с выпадающим списком значений:
| Robin.String | Да | |
Min. приоритет | Минимальное значение диапазона поиска элементов по приоритету. Если в поле «Max. приоритет» указано такое же значение, поиск будет производиться только среди элементов, имеющих указанное значение. | Robin.Numeric | Нет | |
Max. приоритет | Максимальное значение диапазона поиска элементов по приоритету. Если в поле «Min. приоритет» указано такое же значение, поиск будет производиться только среди элементов, имеющих указанное значение. | Robin.Numeric | Нет | |
Min. дата и время создания | Минимальное значение диапазона поиска элементов по дате и времени его создания. Если в поле «Max. дата и время создания» указано такое же значение, поиск будет производиться только среди элементов, имеющих указанное значение. | Robin.DateTime | Нет | |
Max. дата и время создания | Максимальное значение диапазона поиска элементов по дате и времени его создания. Если в поле «Min. дата и время создания» указано такое же значение, поиск будет производиться только среди элементов, имеющих указанное значение. | Robin.DateTime | Нет | |
Min. дата и время обновления | Минимальное значение диапазона поиска элементов по дате и времени его обновления. Если в поле «Max. дата и время обновления» указано такое же значение, поиск будет производиться только среди элементов, имеющих указанное значение. | Robin.DateTime | Нет | |
Max. дата и время обновления | Максимальное значение диапазона поиска элементов по дате и времени его обновления. Если в поле «Min. дата и время обновления» указано такое же значение, поиск будет производиться только среди элементов, имеющих указанное значение. | Robin.DateTime | Нет | |
Тип сортировки | Тип сортировки найденных элементов для выбора одного из них. Сначала будут найдены все подходящие элементы, а затем отсортированы; действие вернет первый элемент из отсортированного списка. | Robin.String | Нет | |
Заблокировать на чтение | Если значение равно «true», действие заблокирует найденный элемент на чтение для других роботов, а также скроет его в очереди. Скрытый элемент не будет найден другими роботами при поиске по условию. | Robin.Boolean | true | Нет |
Заблокировать на обновление | Если значение равно «true», действие заблокирует найденный элемент на обновление для других роботов. Если элемент уже заблокирован на обновление другим роботом и не был разблокирован за время тайм-аута, действие вернет ошибку. | Robin.Boolean | true | Нет |
Завершить обработку элемента | Если значение равно "true", действие получит содержимое элемента и изменит его статус на "Обработан". В новом статусе элемент станет недоступен для роботов даже по его ID. | Robin.Boolean | true | Нет |
Тайм-аут, мс | Время ожидания появления нужного элемента в очереди, а также снятия с элемента блокировки запись. Если указано "-1", действие будет ждать бесконечно долго. Действие вернет ошибку, если статус элемента изменят на "Обработан" или "Ошибка". Задается в миллисекундах. | Robin.Numeric | Нет | |
| Результаты | ||||
Теги | Коллекция строк, в которой каждый элемент - это отдельный тег элемента очереди. | Robin.Collection | ||
Приоритет | Приоритет элемента среди других элементов очереди. | Robin.Numeric | ||
Дата и время создания | Дата и время, когда элемент был добавлен в очередь. | Robin.DateTime | ||
Дата и время обновления | Дата и время, когда элемент был обновлен. | Robin.DateTime | ||
Значение | Значение найденного элемента очереди. | Robin.Object | ||
ID элемента | Уникальный идентификатор элемента очереди. | Robin.String | ||
Особые условия использования
Отсутствуют
Пример использования
Задача: существует процесс по обработке заявок на оплату и в очереди Test1 имеются элементы (заявки). 
.
Необходимо найти элемент (заявку) с приоритетом в интервале от 110 до 112, со статусом "Новый" ( вернуть первый элемент подходящий под данные условия). Так же применить параметры: тип сортировки- по уменьшению даты создания , заблокировать элемент на чтение и запись для того, чтобы данная заявка была не доступна для чтения и редактирования.
Решение: воспользоваться действием "Получить элемент по условию".
Реализация:
- Перетащить действие "Получить элемент по условию" и настроить его параметры:
- поле "Группа" заполнить значением "group1"
- поле "Очередь" заполнить значением "Test1"
поле "Статус" заполнить значением "Новый" - поле "Min. приоритет" заполнить значением "110"
- поле "Max приоритет" заполнить значением "112"
- поле "Тип сортировки" заполнить значением "По уменьшению даты создания"
- проставить чек-боксы = true в полях "Заблокировать на чтение", "Заблокировать на обновление"
2. При необходимости записи результатов действия в переменные заполнить соответствующие поля в разделе "Результат".
3. Запустить робота по кнопке "Старт" в верхней панели.
- Если необходимо получить элементы с определенными тегами, то необходимо заполнить поле "Теги", указав названия тегов элементов. (Например, получение заявки, содержащую определенные теги)
- Если необходимо получить элементы с определенным приоритетом (например, получение заявок с приоритетом от 1 до 3), то следует заполнить поля "Min. приоритет" и "Max. приоритет" указав значения 3 и 1 соответственно
- Если необходимо получить элементы с группировкой по дате создания (например, с 12.08.2022 4:00 по 14.08.2022 4:00) необходимо указать даты и время в соответствующих полях: "Min.дата и время создания", "Max. дата и время создания" (например, получение заявок, созданных в определенном интервале времени)
- Если необходимо получить коллекцию элементов с группировкой по дате обновления (например, 15.08.2022 5:00 по 17.08.2022 5:00) необходимо указать даты и время в соответствующих полях: "Min.дата и время обновления", "Max. дата и время обновления" (например, получение заявок, обновленных в определенном интервале времени)
- Если необходимо отсортированные элементы (например, по увеличению приоритета заявок), то необходимо заполнить параметр "Сортировка". Сначала будут найдены все подходящие элементы, а затем отсортированы; действие вернет первый элемент из отсортированного списка
- Если необходимо завершить обработку элемента (например, требуется перевести заявку в статус "Обработан" и сделать ее недоступной для роботов), то следует установить чек-бокс "Завершить обработку элемента" = true
- Если необходимо заблокировать элемент на обновление и/или чтение (например, есть заявка, которая должна быть заблокирована на обновление и/или чтение, т.е. робот в дальнейшем не сможет ее видеть или/и редактировать), то следует установить чек-бокс в полях: "Заблокировать на чтение"/"Заблокировать на обновление"
Элемент очереди может быть заблокирован роботом (на чтение и\или запись)
- только на чтение - когда элемент заблокирован на чтение, по умолчанию также происходит его скрытие в очереди (скрытие для поиска), т.е. его нельзя будет получить действиями с поиском по условию; действием получения по ID можно будет "увидеть элемент", но робот зависнет на элементе в ожидании снятия блокировки (в зависимости от выставленного тайм-аута)
- только на запись - когда элемент заблокирован на запись (роботом или пользователем), другой робот не может изменить его значения
- и на чтение, и на запись - соблюдаются одновременно два условия, описанных выше, то есть робот не сможет ни изменить элемент, ни прочитать его
Результат:
Программный робот отработал успешно.
Данный элемент заблокирован на чтение и запись.
Действие устаревшее.
Обзор
Инструменты контента