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

Получить коллекцию ресурсов Версия 7 (Java)

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

...

Описание

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

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

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

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

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

Image Modified

Параметры

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

...

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

• • Если необходимо получить коллекцию ресурсов с определенными тегами, то необходимо заполнить поле "Теги", указав названия тегов ресурсов.
  • Если необходимо получить коллекцию ресурсов с определенными приоритетами, то следует заполнить поля "Мин. приоритет" и "Макс. приоритет". 
  • Если необходимо получить коллекцию ресурсов с группировкой по дате создания (например, с 12.08.2022 4:00 по 14.08.2022 4:00) необходимо указать даты и время в соответствующих полях: "Мин. дата создания", "Макс. дата создания". 
  • Если необходимо получить коллекцию ресурсов с группировкой по дате обновления (например, 15.08.2022 5:00 по 17.08.2022 5:00) необходимо указать даты и время в соответствующих полях: "Мин. дата обновления", "Макс. дата обновления".
  • Если необходимо необходимо отсортировать найденные ресурсы, то необходимо выбрать типа сортировки из выпадющего выпадающего списка параметра "Тип сортировки". 
  • Если необходимо завершить обработку ресуровресурсов, то следует установить чек-бокс "Завершить обработку ресурса" = true. 
  • Если необходимо заблокировать ресурсы на запись и/или чтение , то следует установить чек-бокс в полях: "Заблокировать на чтение"/"Заблокировать на запись". 
    

    Ресурсы очереди могут быть заблокированы роботом (на чтение и\или запись).

    • только на чтение - когда ресурсы заблокированы на чтение, по-умолчанию также происходит их скрытие в очереди (скрытие для поиска), т.е. его нельзя будет получить действиями с поиском по условию; действием получения по ID можно будет "увидеть ресурсы", но робот зависнет на ресурсе в ожидании снятия блокировки (в зависимости от выставленного тайм-аута).
    • только на запись - когда ресурсы заблокированы на запись (роботом или пользователем), другой робот не может изменить их значения.
    • и на чтение, и на запись - соблюдаются одновременно два условия, описанных выше, то есть робот не сможет ни изменить ресурсы, ни прочитать их.

...