История страницы

...

Действие отправляет запрос на поиск ресурсов, у которых параметры соответствуют тем, которые указаны в действии.
Поиск ресурса будет происходить по следующим правилам:
- Подходящими под условия ресурсами считаются те, которые удовлетворяют всем указанным параметрам поиска. Но при этом также учитывает и количество ресурсов, которое необходимо найти:
  - Если в "Правило количества" выбрано "Не больше чем", действие вернет результат сразу, как только найдет хотя бы один подходящий ресурс, т.е. до окончания времени тайм-аута. При этом, если в очереди сразу есть n или более ресурсов, действие вернет строго n ресурсов, где n - значение из параметра "Количество ресурсов". Если же в очереди меньше n ресурсов, действие сразу (до окончания тайм-аута) вернет все имеющиеся подходящие ресурсы.
  - Если в "Правило количества" выбрано "Строго указанное количество", действие вернет результат только тогда, когда в очереди появиться n или более ресурсов, подходящих под условия поиска. При этом, действие вернет строго n ресурсов, даже если их в очереди больше.
  - Если в "Правило количества" выбрано "Все", действие вернет результат сразу, если найдет хотя бы один подходящий ресурс, т.е. до окончания времени тайм-аута. При этом значение из параметра "Количество ресурсов" будет проигнорировано, т.е. действие вернет все подходящие ресурсы, которые найдет в очереди.
- Если параметр "Заблокировать на запись" = true, то при поиске игнорируются ресурсы, которые уже заблокированы на запись. Если = false, такие ресурсы в том числе будут добавлены в список подходящих ресурсов. При этом такое же правило не распространяется на блокировку на чтение, т.к. если ресурс имеет эту блокировку, его в любом случае "не видно" при поиске по условию.
- Если указана какая-то определенная сортировка, то сначала будет собран список всех подходящих ресурсов, затем ресурсы будут отсортированы по указанному параметру; в результирующую коллекцию ресурсы будут записаны в том же порядке, как в отсортированном списке.
- Если в очереди нет ни одного подходящего ресурса, действие встает в ожидание появления в очереди хотя бы одного подходящего ресурса.

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

Image RemovedImage Added

Параметры

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

Очередь ресурсов - Название очереди ресурсов, в которой нужно искать ресурсы.
Теги - Коллекция строк, в которой каждый элемент - это отдельный тег ресурса. Поиск будет среди тех ресурсов, у которых есть хотя бы один из перечисленных тегов.
Статус - Статусы, которые должны иметь ресурс.
Поле с выпадающим списком значений:
- Новый или В работе
- Новый
- В работе
Мин. приоритет - Наименьшее значение приоритета, который может быть у ресурса. Вместе со значением из поля «Макс. приоритет» составляет диапазон поиска по приоритету.
Макс. приоритет - Наибольшее значение приоритета, который может быть у ресурса. Вместе со значением из поля «Мин. приоритет» составляет диапазон поиска по приоритету.
Мин. дата создания - Наименьшее значение даты создания ресурса. Вместе со значением из поля «Макс. дата создания» составляет диапазон поиска по дате создания.
Макс. дата создания - Наибольшее значение даты создания ресурса. Вместе со значением из поля «Мин. дата создания» составляет диапазон поиска по дате создания.
Мин. дата обновления - Наименьшее значение даты последнего обновления ресурса. Вместе со значением из поля «Макс. дата создания» составляет диапазон поиска по дате обновления.
Макс. дата обновления - Наибольшее значение даты последнего обновления ресурса. Вместе со значением из поля «Мин. дата создания» составляет диапазон поиска по дате обновления.
Тип сортировки - Тип сортировки найденных ресурсов. Действие сортирует найденные ресурсы перед записью в результирующую коллекцию.
Это поле в виде выпадающего списка со значениями:
- Без сортировки
- По увеличению приоритета
- По уменьшению приоритета
- По увеличению даты создания
- По уменьшению даты создания
- По увеличению даты обновления
- По уменьшению даты обновления
Если выбрано значение "без сортировки", найденные ресурсы будут записаны в результирующую коллекцию в том же порядке, в каком они были найдены.
При выборе конкретного типа сортировки, сначала будут найдены все ресурса, соответствующие указанным условиям поиска. Затем эти ресурсы будут отсортированы с учетом выбранного типа сортировки, и в таком же порядке будут записаны в коллекцию, которая будет возвращена роботу.
Выбранный тип сортировки по приоритету, дате создания или дате обновления не учитывается, если во входных параметрах действия было указано конкретное значение приоритета, даты создания или даты обновления, соответственно.
Запретить чтение - Если значение "true", действие заблокирует найденные ресурсы на чтение и скроет их в очереди. Другие роботы не смогут найти скрытые ресурсы при поиске по условию.
Запретить запись- Если значение "true", действие заблокирует найденные ресурсы на запись для других роботов.

Если значение параметра = true, т.е. нужно будет блокировать ресурсы, действие будет искать только среди ресурсов, которые не имеют блокировки на запись, даже если они подходят под указанные условия поиска. Реализован такой вариант, чтобы не "зависать" на заблокированных ресурсах, когда в очереди могут быть другие "свободные" ресурсы.
Если блокировать на запись не надо, действие ищет в том числе и среди ресурсов, которые имеют блокировку на запись.
Завершить обработку - Если значение "true", действие получит значение и параметры ресурсов, а затем изменит их статус на "Обработан". С этим статусом ресурсы будут скрыты для роботов, даже при поиске по их идентификатору
Со стороны роботов такой статус у ресурсов будет словно удаление ресурсов, т.к. они больше не смогут найти эти ресурсы. Причем не найдет даже тот робот, который сам же и выполнил это действие. Однако ресурсы до сих пор будут в очереди, их сможет найти пользователь вручную через интерфейс Оркестратора.
Количество ресурсов - Количество ресурсов, которое должно вернуть действие. Учитывается вместе с параметром "Правило количества".
Правило количества - Правило, указывающее, как интерпретировать значение из поля "Количество ресурсов". Если выбрано "Все", действие игнорирует указанное количество ресурсов, и возвращает все подходящие ресурсы.
Тайм-аут, мс. - Время ожидания появления в очереди нужного количества ресурсов, подходящих под условия поиска. Если указано "-1", действие будет ждать бесконечно долго. Задается в миллисекундах.

Тайм-аут здесь - это время на поиск n-го кол-ва элементов, подходящих под условия.
Если в "Правило количества" выбрано "Все", действие не будет ожидать в течение всего тайм-аута, а вернет результат сразу, как только найдет хотя бы бы один подходящий ресурс. Но это не значит, что действие вернет только один ресурс - оно выберет все подходящие ресурсы и сразу их вернет, не дожидаясь возможного появления дополнительных ресурсов.

...

Cуществует процесс, где имеется очередь с ресурсами, необходимо получить не больше 5 ресурсов со статусом "Новый", а также узнать дату создания 2-ого по счета ресурса из коллекции.

Image RemovedImage Added

Решение

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

...

Перетащить на рабочую область действие "Получить коллекцию ресурсов" и заполнить его параметры:
1. Поле "Очередь ресурсов" - Указать название очереди ресурсов, в которой нужно искать ресурсы.
2. Поле "Статус" - Указать статус, который должны иметь все ресурсы. В данном случае статус "Новый".
3. Поле "Количество ресурсов" - Указать количество ресурсов, которое должно вернуть действие. В данном случае - 5.
4. Поле "Правило количества" - Указать нужное правило, указывающее, как правильно интерпретировать значение из поля "Количество ресурсов". В данном случае выбираем - "Не больше чем"
  Image Removed
  Image Added
Перетащить на рабочую область действие "Получить значение по индексу" и заполнить его параметры.
1. Поле "Коллекция" - Указать результат действия "Получить коллекцию ресурсов"
2. Поле "Индекс" - Указать порядковый номер позиции, с которой необходимо извлечь значения. В данном случае - 1 (По задаче нам необходимо вытащить 2-ой ресурс, но так как отсчет в коллекции начинается с 0, то соответственно указываем значение 1)
  Image AddedImage Removed
Перетащить на рабочую область действие "Получить значение" и заполнить его параметры.
1. Поле "Словарь" - Указать результат действия "Получить значение по индексу". Результатом данного действия в данном случае будет словарь с данными найденного ресурса.
2. Поле "Ключ" - Указать ключ, по которому выполняется поиск в словаре. В данном случае ключом будет значение "CreationDate", так как по задаче необходимо забрать дату создания ресурса.
  Image RemovedImage Added
Перетащить на рабочую область действие "Сообщение в лог" и заполнить его параметры.
1. Поле "Сообщение" - Указать текст, который будет выведен в лог файл сообщения. В данном случае указываем результат действия "Получить значение". Это будет дата создания ресурса.
  Image RemovedImage Added
Запустить робота по кнопке "Старт" в верхней панели.