Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

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

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

  • Пользователь - через интерфейс Оркестратора
  • Программный робот при помощи действий, которые могут добавлять новые ресурсы в очередь, удалять старые, получать и изменять их значение и параметры. Это действия из группы "Оркестратор", подгруппы "Очереди ресурсов":
    • Создать ресурс
    • Изменить ресурс
    • Получить коллекцию ресурсов
    • Получить ресурс по ID
    • Получить ресурс по условию
    • Разблокировать ресурс
    • Удалить ресурс
    • Завершить обработку ресурса

...

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

Якорь
Очереди ресурсов
Очереди ресурсов
Очереди ресурсов

Image Added

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

...

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

Описание

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

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

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

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

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

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

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

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

Кнопка "Обновить"
image-2024-5-29_12-44-37.png

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

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

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

Для создания новой очереди ресурсов необходимо:

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

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

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

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

...

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

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

Условие запуска на основе очереди ресурсов

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

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

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

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

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

  1. Робот пытается получить значение ресурса, но из-за какой-то проблемы падает в ошибку.
  2. Пользователь перезапускает робота. 
  3. Робот снова пытается получить значение ресурса, и снова падает в ошибку. 

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

Ограничение попыток обработки ресурсов работает следующим образом:

  1. Робот не смог обработать ресурс (получить или изменить его) и упал в ошибку.
  2. Количество оставшихся попыток уменьшается на 1.
  3. Пользователь перезапускает робота, но он снова падает в ошибку при работе с тем же самым ресурсом.
  4. Количество оставшихся попыток снова уменьшается на 1.
  5. И так далее. В итоге, когда количество оставшихся попыток станет = 0, статус ресурса изменится на «Ошибка».
  6. Система скрывает от роботов ресурсы, которые в статусе "Ошибка" или "Обработан". Поэтому при повторном запуске робот уже не найдет этот ресурс в очереди, даже если будет искать по его ID.

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

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

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

Указать разное максимальное количество попыток для разных ресурсов нельзя. Это общий параметр для всех ресурсов очереди. Подсчет оставшихся попыток производится отдельно для каждого ресурса. Например, максимальное значение = 3, робот не смог обработать 1-й ресурс дважды, а 2-й ресурс - один раз. В итоге у 1-го ресурса будет указано количество оставшихся попыток "1 из 3", а у 2-го - "2 из 3".

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

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

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

...

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

...

Описание

...

У каждого ресурса может быть 1 из 4-х статусов:

  • Новый
  • В работе
  • Обработан
  • Ошибка

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

...

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

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

...

Слова или фразы, дополнительно описывающие ресурс (в основном нужны при поиске ресурса роботом)

Если тегов слишком много, отображается только часть из них. Все остальные видны только по нажатию на кнопку Image Removed

Image Removed

...

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

...

В столбце «Блокировка» можно просмотреть, какие текущие блокировки установлены у ресурса:

  • Если значение не указано, то ресурс не заблокирован
  • Если указано "На чтение", ресурс заблокирован только на чтение
  • Если указано "На запись", ресурс заблокирован только на запись
  • Если указано "На чтение" и "На запись" одновременно, то ресурс заблокирован и на чтение, и на запись. Ресурс обладает совокупностью особенностей этих блокировок

Если ресурс заблокирован с указанием даты снятия блокировки, рядом с названием соответствующей блокировки будет иконка Image Removed. При наведении на иконку можно посмотреть дату и время снятия блокировки
Image Removed

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

...

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

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

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

...

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

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

...

Кнопка "Обновить"
image-2024-5-29_12-44-37.pngImage Removed

...

Кнопка "Изменить параметры ресурса"
Image Removed

...

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

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

...

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

...

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

...

Image Added

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

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

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

Описание

Столбец "Идентификатор"Уникальный идентификатор, который система присваивает каждому ресурсу очереди при его создании
Столбец "Статус"

У каждого ресурса может быть 1 из 4-х статусов:

  • Новый
  • В работе
  • Обработан
  • Ошибка

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

Столбец "Попытки обработки"

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

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

Столбец "Теги"

Слова или фразы, дополнительно описывающие ресурс (в основном нужны при поиске ресурса роботом)

Если тегов слишком много, отображается только часть из них. Все остальные видны только по нажатию на кнопку Image Added

Image Added

Столбец "Приоритет"

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

Столбец "Блокировки"

В столбце «Блокировка» можно просмотреть, какие текущие блокировки установлены у ресурса:

  • Если значение не указано, то ресурс не заблокирован
  • Если указано "На чтение", ресурс заблокирован только на чтение
  • Если указано "На запись", ресурс заблокирован только на запись
  • Если указано "На чтение" и "На запись" одновременно, то ресурс заблокирован и на чтение, и на запись. Ресурс обладает совокупностью особенностей этих блокировок

Если ресурс заблокирован с указанием даты снятия блокировки, рядом с названием соответствующей блокировки будет иконка Image Added. При наведении на иконку можно посмотреть дату и время снятия блокировки
Image Added

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

Столбец "Автор"

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

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

  • название робота
  • название машины, на которой робот работал в момент создания ресурса
  • название учетной записи, под которой робот работал
Столбец "Дата создания"Дата и время создания ресурса. Отображается с учетом часового пояса пользователя, который работает с данным интерфейсом
Столбец "Редактор"

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

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

Кнопка "Обновить"
image-2024-5-29_12-44-37.pngImage Added

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

Кнопка "Изменить параметры ресурса"
Image Added

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

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

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

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

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

Якорь
Условие запуска на основе очереди ресурсов
Условие запуска на основе очереди ресурсов
Условие запуска на основе очереди ресурсов

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

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

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

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

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

  1. Робот пытается получить значение ресурса, но из-за какой-то проблемы падает в ошибку.
  2. Пользователь перезапускает робота. 
  3. Робот снова пытается получить значение ресурса, и снова падает в ошибку. 

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

Ограничение попыток обработки ресурсов работает следующим образом:

  1. Робот не смог обработать ресурс (получить или изменить его) и упал в ошибку.
  2. Количество оставшихся попыток уменьшается на 1.
  3. Пользователь перезапускает робота, но он снова падает в ошибку при работе с тем же самым ресурсом.
  4. Количество оставшихся попыток снова уменьшается на 1.
  5. И так далее. В итоге, когда количество оставшихся попыток станет = 0, статус ресурса изменится на «Ошибка».
  6. Система скрывает от роботов ресурсы, которые в статусе "Ошибка" или "Обработан". Поэтому при повторном запуске робот уже не найдет этот ресурс в очереди, даже если будет искать по его ID.

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

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

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

Указать разное максимальное количество попыток для разных ресурсов нельзя. Это общий параметр для всех ресурсов очереди. Подсчет оставшихся попыток производится отдельно для каждого ресурса. Например, максимальное значение = 3, робот не смог обработать 1-й ресурс дважды, а 2-й ресурс - один раз. В итоге у 1-го ресурса будет указано количество оставшихся попыток "1 из 3", а у 2-го - "2 из 3".

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

Принципы работы и изменения статусов

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

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

...

Принципы работы блокировок ресурса ресурса

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

...

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

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

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

...

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

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

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

...