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

...

1. Действие отправляет запрос на поиск ресурсов, у которых параметры соответствуют тем, которые указаны в действии.

2. Поиск ресурса будет происходить по следующим правилам: 

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

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

Параметры

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

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

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

Статус                                      Статусы, которые должны иметь ресурс
                                                         Поле с выпадающим списком значений:

• • • • • • Новый или В работе
          • Новый
          • В работе

Мин. приоритет                      Наименьшее значение приоритета, который может быть у ресурса. Вместе со значением из поля «Макс. приоритет» составляет диапазон
                                                 поиска по приоритету

Макс. приоритет                     Наибольшее значение приоритета, который может быть у ресурса. Вместе со значением из поля «Мин. приоритет» составляет диапазон
                                                 поиска по приоритету

Мин. дата создания                Наименьшее значение даты создания ресурса. Вместе со значением из поля «Макс. дата создания» составляет диапазон поиска по дате
                                                 создания

Макс. дата создания               Наибольшее значение даты создания ресурса. Вместе со значением из поля «Мин. дата создания» составляет диапазон поиска по дате
                                                 создания

Мин. дата обновления          Наименьшее значение даты последнего обновления ресурса. Вместе со значением из поля «Макс. дата создания» составляет диапазон
                                                 поиска по дате обновления

Макс. дата обновления         Наибольшее значение даты последнего обновления ресурса. Вместе со значением из поля «Мин. дата создания» составляет диапазон
                                                 поиска по дате обновления

Тип сортировки                     Тип сортировки найденных ресурсов. Действие сортирует найденные ресурсы перед записью в результирующую коллекцию
                                                          Это поле в виде выпадающего списка со значениями:

• • • • • • Без сортировки

          • По увеличению приоритета

          • По уменьшению приоритета

          • По увеличению даты создания

          • По уменьшению даты создания

          • По увеличению даты обновления

          • По уменьшению даты обновления

...

Запретить чтение                  Если значение "true", действие заблокирует найденные ресурсы на чтение и скроет их в очереди. Другие роботы не смогут найти скрытые ресурсы при поиске
                                                по условию

Запретить запись                  Если значение "true", действие заблокирует найденные ресурсы на запись для других роботов

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

Завершить обработку          Если значение "true", действие получит значение и параметры ресурсов, а затем изменит их статус на "Обработан". С этим статусом ресурсы будут скрыты
                                                для роботов даже при поиске по их  идентификатору

...

Количество ресурсов           Количество ресурсов, которое должно вернуть действие. Учитывается вместе с параметром "Правило количества"

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

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

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

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

Результат                              Коллекция, в которой каждый элемент - это словарь с данными одного из найденных ресурсов: значение (ключ "Value"), идентификатор (ключ "Id"),
                                                теги (ключ "Tags"), статус (ключ "Status"), приоритет (ключ "Priority"), дата создания (ключ "CreationDate") и дата обновления (ключ "UpdateDate")

Настройки

...