Назначение раздела

Очередь ресурсов - это инструмент для хранения и управления данными (ресурсами), которые обрабатываются программными роботами.

Основные цели использования очередей:

• Ускорение обработки данных. Несколько роботов могут одновременно брать и обрабатывать разные ресурсы из одной очереди.

• Обмен данными. Роботы могут обмениваться друг с другом значениями через очередь ресурсов. Особенно актуально, если роботы работают на разных машинах.

• Упорядочивание обработки данных. Ресурсам можно назначать приоритеты, чтобы роботы могли выбрать наиболее важные задачи (ресурсы для обработки).

• Контроль и мониторинг. Через интерфейс платформы пользователи видят статус обработки ресурсов и могут управлять ими, тем самым влияя на работу роботов (например, блокировать ресурсы, которые сейчас не стоит брать в работу).

Ресурс очереди  – это объект

В разделе доступно:

• зачем нужны очереди ресурсов
• просмотр списка очередей ресурсов
• создание новой очереди ресурсов
• удаление ранее созданной очереди ресурсов

...

Все данные в очереди представлены в виде ресурсов. Ресурс – это объект, который состоит из:

• Значения. Это данные
различного
• определенного типа (строка, число, коллекция, путь к папке и т.д.). 
• Параметров.  Параметры ресурса
– это
• –  это его дополнительные свойства, необходимые
при поиске и работе с ресурсами. Подробнее о параметрах: "Карточка очереди ресурсов"

...

С очередью ресурсов может работать:

...

• роботу для поиска и контроля обработки ресурса.

Пользователи работают с очередями ресурсов через интерфейс платформы - раздел "Очередь ресурсов". А роботы взаимодействуют с очередями при помощи действий,

...

которые могут добавлять новые ресурсы в очередь, удалять старые, получать и изменять их значение и параметры.

...

Эти действия расположены в группе действий "Оркестратор",

...

в подгруппе "Очереди ресурсов".

Раздел "Очереди ресурсов" предназначен для:

...

• просмотра списка очередей ресурсов
• создания новых очередей ресурсов
• удаления очередей ресурсов
• работы с карточкой очереди:
  • просмотра и изменения параметров очереди
  • просмотра ресурсов в очереди
  • просмотра и изменения параметров ресурсов

Также через карточку очереди ресурсов можно создать условие запуска на основе выбранной очереди.

Image Added

Таблица очередей ресурсов

В таблице отображаются все очереди ресурсов, которые были созданы в текущем тенанте.

С помощью выпадающего списка "Столбцы" можно выбрать, какие столбцы будут скрыты или отображены, при этом столбец "Очередь ресурсов" отображается всегда.

...

Image Removed

Описание таблицы очередей ресурсов

Таблица с ранее созданными очередями ресурсов. 

Название столбца/кнопки

Описание

Столбец "Очередь ресурсов"

Название очереди ресурсов

Является ссылкой (кнопкой), которая открывает карточку выбранной очереди ресурсов

Если создано условие запуска, в котором указана эта очередь,

рядом с ее названием отображается

то в столбце будет отображаться иконка: Image Modified - если условие запуска включено. Image Modified-

 если

если условие запуска выключено.
Столбец "Количество ресурсов"	Текущее количество ресурсов в очереди.

Якорь

Столбец "Дата создания"	Дата и время, когда была создана очередь ресурсов.
Столбец "Автор"	ФИО пользователя, который создал очередь ресурсов.

Кнопка "Удалить"Кнопка "Удалить"

Кнопка "Удалить" Image Modified	При нажатии

появляется окно с подтверждением удаления:

удаляется очередь ресурсов. Если

на очередь не было настроено условие запуска:
Image Removed

удаленная очередь ранее была указана в каком-то условии запуска робота, то это условие запуска будет автоматически выключено.
Кнопка Image Added	По нажатию

• Если на очередь было настроено условие запуска:
  Image Removed

Кнопка "Обновить"
Image Removed

По нажатию

происходит обновление записей в таблице

...

...

Создание очереди ресурсов

Для создания

...

очереди ресурсов

...

:

...

1. Нажмите на кнопку "Создать очередь ресурсов". Откроется окно

...

1. :
   Image Modified
   

...

1. 
   

2. В поле "Название очереди ресурсов"

...

Нажать на кнопку «Создать» для подтверждения сделанного выбора. Или нажать на кнопку "Отменить", если решили её не создавать.

...

При нажатии на "Создать", окно будет закрыто, а новая очередь ресурсов будет добавлена в таблицу.

1. введите название для новой очереди. Дубли в названиях очередей запрещены. 

2. Нажмите на кнопку «Создать». Окно закроется, новая очередь ресурсов будет создана.

Карточка очереди ресурсов

Чтобы открыть карточку очереди ресурсов нажмите в таблице раздела на название нужной очереди.

Image Added

Изменение параметров очереди ресурсов

Для изменения параметров очереди ресурсов нажмите на кнопку"Изменить параметры очереди ресурсов"и укажите нужные значения в открывшемся окне:

Image Added

На данный момент в окне можно настроить только один параметр - ограничение количества попыток обработки ресурсов:

• Этот параметр ограничивает число попыток обработки одних и тех же ресурсов, если роботы постоянно падают в ошибку при работе с ними.
  

  Информация
  title Пример
  Робот пытается получить/изменить ресурс, но появляется ошибка. Пользователь перезапускает робота.  Робот снова пытается получить/изменить ресурс, и снова появляется ошибка. Очевидно, проблему не исправить простым перезапуском робота. При следующих попытках работы с ресурсом робот все так же будет завершаться с ошибкой, и в итоге не сможет завершить свою работу. Чтобы робот не застревал на проблемном ресурсе, смог его пропустить и взять в работу следующий ресурс, можно ограничить число попыток обработки ресурса.

• Каждый раз, когда возникает у робота возникает ошибка при работе с ресурсом, происходит уменьшение оставшихся попыток обработки этого ресурса на 1. Как только количество попыток станет равно 0, статус ресурса меняется на "Ошибка". Роботы не смогут больше найти и взять в работу ресурс с таким статусом, даже если будут искать по точному идентификатору ресурса.
• Количество оставшихся попыток не уменьшается, когда робот успешно получил или изменил ресурс.
• Установленное максимальное количество попыток одинаково для всех ресурсов в очереди, но уменьшение оставшихся попыток происходит для каждого ресурса индивидуально.
• Уменьшение оставшихся попыток происходит вне зависимости от того, у какого робота возникла проблема с ресурсом - у разных или одного  и того же.

  Информация
  title Пример
  Робот1 пытается получить/изменить ресурс, но появляется ошибка. Система уменьшает у ресурса количество оставшихся попыток на 1. Робот2 пытается получить/изменить ресурс, но у него также появляется ошибка.  Система уменьшает у ресурса количество оставшихся попыток на 1.

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

Для ограничения количества попыток включите чекбокс "Ограничить количество попыток обработки ресурсов" и укажите в поле "Количество попыток" максимальное количество попыток для ресурсов этой очереди. Если у ресурсов должно быть неограниченное количество попыток, то отключите чекбокс.

Условие запуска робота

...

В карточке "Очередь ресурсов" доступны:

• просмотр списка ресурсов очереди
• изменения параметров ресурсов
• переход в карточку условия запуска на основе очереди ресурсов - для создания условия, его просмотра или изменения
• изменение количества попыток обработки ресурсов

Image Removed

Описание таблицы ресурсов очереди

Таблица содержит список ресурсов очереди с указанием их параметров.

...

Название столбца\кнопки

...

Описание

...

...

Число оставшихся попыток обработки ресурса

Подробнее про попытки обработки описано ниже

...

...

Приоритет обработки ресурса относительно других ресурсов очереди

...

...

Инициатор создания ресурса

Т.к. на данный момент создавать ресурсы могут только роботы, в столбце будет указано:

• название робота
• название машины, на которой робот работал в момент создания ресурса
• название учетной записи, под которой робот работал

...

Инициатор последнего изменения ресурса. Изменить ресурс может и робот, и пользователь, поэтому:

1. Если инициатор - пользователь, то указано его ФИО
2. Если инициатор - робот, то указано:
   
   • название робота
   • название машины, на которой робот работал в момент создания ресурса
   • название учетной записи, под которой робот работал

...

...

...

По нажатию открывается окно "Параметры ресурса"

Подробнее об окне описано ниже

...

...

С помощью выпадающего списка «Столбцы» можно выбрать, какие столбцы будут скрыты или отображены, при этом столбец «Идентификатор» отображается всегда.

...

на основе очереди ресурсов

Можно настроить запуск робота так, чтобы он активировался в зависимости от зависимости от наличия ресурсов в очередив очереди. Для этого необходимо создать условие запуска на основе очереди ресурсов. Создать

Создать такое условие запуска можно:

• В разделе "Условия запуска" на вкладке "Очереди ресурсов".
• Из карточки той очереди, на основе которой должно работать
условия
• условие запуска.
 Если
• 
  Если на
данную
• очередь еще не настроили условие запуска, то в ее карточке
будет кнопка
• отображается кнопка "Создать условие запуска" - по нажатию
на нее откроется
• открывается пустая карточка для создания условия запуска
в режиме создания
• .
 Если
• Если на очередь уже настроили условие, то
будет отображаться
• в ее карточке отображается кнопка "Открыть условие запуска" - по нажатию
на нее откроется
• открывается карточка уже существующего условия запуска в режиме
чтения
• просмотра параметров, которые при необходимости можно поменять.

Подробнее про создание, просмотр и изменение такого условия запуска можно узнать в карточку условия запуска и процесс ее создания, просмотра и изменения см. в разделе "Условия запуска" на вкладке "Очереди ресурсов".

...

На данный момент в качестве настроек очереди доступен только параметр "количество попыток обработки ресурсов". Этот параметр ограничивает число попыток обработки одних и тех же ресурсов, если роботы постоянно падают в ошибку при работе с ними. 

Очевидно, просто так проблему не исправить простым перезапуском робота. И при следующих попытках робот все так же будет завершаться с ошибкой, и в итоге не сможет завершить свою работу. Чтобы робот не застревал на проблемном ресурсе, смог его пропустить и взять в работу следующий ресурс, можно ограничить число попыток обработки ресурса.

Если робот успешно получил или изменил ресурс, то значение оставшихся попыток не меняется. 

Для настройки данного параметра необходимо выполнить шаги:

1. Нажать на кнопку "Изменить параметры очереди ресурсов". Откроется окно "Параметры очереди ресурсов":
   Image Removed
2. Если максимальное число попыток должно быть строго определенным, нужно активировать чекбокс "Ограничить количество попыток обработки ресурсов". В этом случае будет активно поле "Количество попыток" для указания максимального числа возможных попыток.
3. Если нет необходимости в ограничении числа попыток обработки ресурсов, нужно отключить чекбокс "Ограничить количество попыток обработки ресурсов".
4. Нажать на кнопку «Сохранить» для подтверждения внесенных изменений. Или нажать на кнопку "Отменить", если решили не применять изменения. 

...

Таблица ресурсов

В таблице отображаются все ресурсов, которые были созданы в данной очереди.

С помощью выпадающего списка "Столбцы" можно выбрать, какие столбцы будут скрыты или отображены, при этом столбец "Идентификатор" отображается всегда.

Якорь
Статусы Статусы

Статусы ресурсов

Статусы нужны для:

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

...

Особенности работы статусов:

1. При создании ресурса, ему автоматически

...

1. присваивается статус «Новый». Создавать ресурсы на данный момент могут только роботы.
   
2. Статус «В работе»:
   • устанавливается автоматически

...

1. • при чтении (получении) или изменении ресурса роботом.

...

1. • если при выполнения операции создания ресурс сразу заблокировали, то это не считается операцией изменения ресурса, поэтому статус будет "Новый", а не в "Работе".

...

1. • не будет установлен автоматически

...

1. • , если ресурс просматривает или изменяет пользователь.
   • не меняется автоматически на статус "Обработан"

...

1. • только потому, что завершился робот, который читал или изменял ресурс. Для такой смены статуса робот должен выполнить соответствующее действие.
   • если ресурс уже в статусе «В работе» (например, установился при чтении ресурса роботом), другой робот все равно может обратиться к ресурсу для его чтения

...

1. • или изменения.
2. Система скрывает от роботов ресурсы, которые в статусе "Обработан". Роботы не смогут найти

...

1. такие ресурсы в очереди, даже если будут искать по их точному идентификатору. Такой ресурс не сможет найти даже тот робот, который сам же и установил этот статус.
   Роботы могут установить у ресурса статус "Обработан", выполнив соответствующее действие.
2. Если оставшееся количество попыток обработки ресурса станет равным 0, статус ресурса

...

1. автоматически поменяется на «Ошибка».
   Система скрывает от роботов ресурсы, которые в этом статусе. Роботы не смогут найти такие ресурсы в очереди

...

1. , даже если будут искать по их точному идентификатору.
   
2. Пользователь может изменять текущий статус ресурса на любой другой статус в любом порядке через окно параметров ресурса.

...

Якорь

...

Блокировки Блокировки

Блокировка ресурсов

Если роботы должны обрабатывать ресурсы из одной и той же очереди, то без дополнительных ограничений они начнут брать в работу одни и те же ресурсы. Чтобы такое не происходило, можно использовать механизм блокировки ресурсов.

...

Таким образом, два робота последовательно обрабатывают могут параллельно обрабатывать ресурсы очереди, не пересекаясь друг с другом.

Тот, кто устанавливает блокировку, является ее инициатором. Есть несколько правил относительно инициаторов:

• Если блокировку устанавливает робот, то инициатором является не сам робот, а его экземпляр.
Например, дважды

• Информация
  title Пример
  Дважды запустили одного и того же робота, т.е. 2 его экземпляра. 1-й экземпляр блокирует ресурс, и становится инициатором этой блокировки. 2-й экземпляр уже не сможет управлять этим заблокированным ресурсом, т.к. его инициатором является 1-й экземпляр.

• Установленная блокировка не накладывает ограничений на инициатора этой блокировки. Инициатор может обрабатывать свой заблокированный ресурс, снимать установленную блокировку.
• Если инициатор блокировки - робот, на пользователя это не накладывает никакие ограничения
: он
• . Пользователь может читать
,
• и изменять ресурс, в том числе менять и установленные блокировки.
  Роботы такими правами не обладают: если инициатор блокировки кто угодно, но не данный экземпляр робота, то работа с ресурсом для него будет ограничена.

В платформе Robin предусмотрено несколько видов блокировок:

1. На чтение.
Если ресурс
2. Если ресурс заблокирован на чтение, то
он будет скрыт системой от
3. у всех
других
4. роботов
,
5. (кроме инициатора
этой блокировки. Роботы не смогут найти ресурс действиями с поиском по условию, т.к роботы не найдут ресурс, то
6. блокировки):
   • при поиске ресурса по заданным условиям, ресурс найден не будет. А значит, роботы не смогут ни прочитать, ни изменить
его. Однако есть небольшое исключение при попытке поиска
7. • такой ресурс.
   • при поиске ресурса по его
точному
8. • идентификатору (если он заранее известен роботу):
     
Если
9. • • если выполняется
поиск ресурса
10. • • действие для
его
11. • • получения (чтения) ресурса, то робот сможет найти ресурс,
но встанет
12. • • но встанет в ожидание снятия блокировки на чтение (максимальное время ожидания настраивается в
соответствующем
13. • • действии робота). Т.е. без снятия блокировки прочитать ресурс все равно нельзя.
Если
14. • • если выполняется
поиск ресурса
15. • • действие для
его
16. • • изменения ресурса, то робот сможет найти и изменить
ресурс, т.к. блокировка на чтение не блокирует изменение ресурса
17. • • ресурс, т.к. блокировка на чтение не блокирует изменение ресурса. Действие по изменению ресурса не возвращает значение ресурса, т.е. не "читает" ресурс, а значит его успешное выполнение не противоречит установленной блокировке.
18. На запись. Если ресурс заблокирован
только
19. на запись,
другие
20. то роботы
(кроме инициатора)
21. смогут найти этот ресурс и получить его значение и параметры (т.е. "прочитать"). Но всем роботам, кроме инициатора блокировки, изменение ресурса
им
22. будет недоступно. Если робот попытается изменить такой ресурс, то
робот
23. встанет в ожидание снятия блокировки на запись (максимальное время ожидания настраивается в
соответствующем
24. действии робота).
25. На чтение и на запись. Ресурсы, заблокированные и на запись, и на чтение, обладает совокупностью особенностей этих блокировок.
    При этом допустимо, что у этих
блокировок могут быть разные инициаторы
26. блокировок могут быть разные инициаторы. Например, блокировку на чтение установил Робот1, а блокировку на запись - Робот2.

Если робот заблокировал ресурсы, и не снял с них блокировку перед завершением своей работы, то система автоматически снимет эти блокировки. Не будут сняты только блокировки, для которых установлена конкретная дата их снятия .блокировки

Установка отложенной даты снятия блокировки

В некоторых ситуациях может потребоваться снятие блокировки с ресурсов не сразу после завершения работы робота, а намного позже.

Например, робот получает какие-то значения ежедневно. Но дальнейшая их обработка и применение возможны только к концу месяца из-за отсутствия в данный момент доступа к каким-то требуемым данным или приложениям. В этом случае можно добавить можно добавить все полученные значения в очередь в виде ресурсов и заблокировать их с установкой даты снятия этой блокировки. До указанной даты ресурс будет заблокирован и ни один робот не возьмёт его в работусможет прочитать и/или изменить ресурс в зависимости от установленной блокировки. Такая блокировка будет снята автоматически при наступлении указанной даты и времени, после чего роботы смогут начать их обработку. Установить .

Установить дату разблокировки ресурса можно и для блокировки на чтение, и для блокировки на запись.

Установить такую дату снятия блокировки может как робот, так и пользователь.

Якорь

...

Параметры ресурсов Параметры ресурсов

...

Изменение параметров ресурса

Для изменения параметров ресурса необходимо выполнить шаги:

...

ресурса нажмите на кнопку

...

 «Изменить параметры ресурса» в строке с

...

ресурсом

...

и укажите нужные значения в открывшемся окне:

Image Added 

 Параметры в окне "Параметры ресурса"

...

Описание окна "Параметры ресурса"