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

Описание раздела

Image Removed

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

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

...

Обновление записей в таблице происходит только при обновлении страницы браузера или по нажатию на кнопку Image Removed в верхнем правом углу таблицы. Автообновление отсутствует.

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

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

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

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

Image Added

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

Таблица с ранее созданными очередями ресурсов. По умолчанию записи таблицы отсортированы по названию групп очередей. 

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

\

/кнопки	Описание
Столбец "Очередь ресурсов"	Название очереди ресурсов

.

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

.

Если

на очередь настроено

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

соответствующая иконка. Есть 2 варианта иконки - для включенного условия (в тултипе - "Условие запуска включено") и для выключенного (в тултипе - "Условие запуска выключено").

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

кол-во

количество ресурсов очереди

.

Якорь

Столбец

Кнопка "

Дата создания

Удалить"

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

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

Столбец "Автор"Автор создания очереди ресурсов.

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

 Image Removed

Image Added

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

"Вы уверены, что хотите удалить очередь ресурсов "Название очереди"?"

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

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

Вы уверены, что хотите удалить очередь ресурсов "Название очереди"?"

В окне подтверждения есть кнопки "Удалить" и "Отменить". По нажатию на "Удалить" из БД удаляется выбранная очередь и все, что с ней связано, в таблице пропадает строка с ней, а система выводит сообщение:

"Очередь ресурсов "Название очереди" удалена"

Image Added

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

Image Removed

Image Added

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

.

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

Просмотр описания API очередей ресурсов

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

Image Removed

Пользователю доступен функционал Swagger для просмотра описания API очередей.

Описание окна "API сервиса управления очередями ресурсов"

...

Название элемента окна

...

Описание

...

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

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

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

1. Нажать в разделе "Очереди ресурсов" на кнопку "Создать очередь ресурсов".  Откроется Откроется окно "Создание очереди ресурсов"
   Image AddedImage Removed
   
2. Ввести название новой очереди в поле "Название очереди ресурсов". Название должно быть уникальным.

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

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

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

...

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

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

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

Image Added

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

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

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

Чекбокс "Выбор ресурса"Находится в каждой строке таблицы. Используется для выбора сразу нескольких ресурсов и осуществления дальнейших массовых операций с ними (удаление).Чекбокс "Выбрать все ресурсы"Находится в заголовке столбца таблицы. Используется для выбора сразу всех ресурсов (на всех страницах) и осуществления дальнейших массовых операций с ними (удаление).

Столбец "Идентификатор"	Уникальный идентификатор,

который сервер присваивает

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

. Идентификаторы ресурсов уникальны в БД в целом.

Столбец "Статус"	Показывает статус ресурса Информация У каждого ресурса может быть 1 из

4х

4-х статусов: Новый В работе Обработан Ошибка Подробнее про статусы описано ниже
Столбец "Попытки обработки"	Число оставшихся попыток обработки ресурса

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

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

.

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

кнопку Image Removed.Image Removed

кнопку Image Added Image Added

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

Число, отображающее приоритет

Приоритет обработки ресурса

среди

относительно других ресурсов очереди

. 

Столбец "Блокировки"	В столбце «Блокировка» можно просмотреть, какие текущие блокировки установлены у ресурса Информация Могут быть следующие значения: Если значение не указано, то ресурс не заблокирован

.

Если указано "На чтение", ресурс заблокирован только на чтение

. Ресурс будет скрыт в очереди при поиске роботами по фильтрам; найти ресурс робот сможет только по его точному id, но даже в этом случае робот встанет в ожидание снятие блокировки. Найти и прочесть ресурс сможет только пользователь или экземпляр робота, который был инициатором этой блокировки.

Если указано "На запись", ресурс заблокирован только на запись

. Любой робот сможет найти его в очереди и прочитать, но при попытке изменения ресурса робот встанет в ожидание снятия блокировки с ресурса. Изменить ресурс сможет только пользователь или экземпляр робота, который был инициатором этой блокировки.

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

Если указано Image Removed,

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

.

Если ресурс заблокирован с указанием даты снятия блокировки, рядом с названием соответствующей блокировки будет иконка

Image Removed. В тултипе иконки текст: "Заблокировано до <дата и время снятия блокировки>".

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

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

Если инициатор - пользователь, то указано ФИО пользователя.

Если инициатор - робот, то указано его название,

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

он

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

, и

название

УЗ

учетной записи, под которой робот работал

.Значение в этом столбце никогда не меняется.

Столбец "Дата создания"	Дата

отображается

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

Системы.

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

пользователя.

Если инициатор - робот, то указано

его

: название

,

робота название

машины и УЗ

машины, на которой

он

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

\изменения

ресурса

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

название учетной записи, под которой робот работал
Столбец "Дата обновления"	Дата

отображается

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

Системы.

Кнопка "Открыть историю работы с ресурсом" Image Removed

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

Если ресурс уже удалили (он не найден в БД) пока была открыта карточка очереди, система не открывает окно и выдает предупреждение:

"Ошибка при работе с ресурсом

Ресурс не найден"

, который работает с данным интерфейсом

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

 Image RemovedОбновляет список ресурсов.

Image Added

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

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

 Image Removed

Image Added

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

.

Если ресурс уже удалили (он не найден в БД) пока была открыта карточка очереди, система не открывает окно и выдает предупреждение:

"Ошибка при работе с ресурсом

Ресурс не найден"

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

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

Создание условия запуска

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

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

2. Указать название условия в поле "Название условия". 
3. Выбрать очередь ресурсов, для которой создается условие запуска. 
4. Выбрать Робота в окне по кнопке "Выбрать" : 
   Image Removed
5. Выбрать машины для запуска, заполнить все обязательные параметры в окне создания.

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

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

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

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

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

   Image Removed

2. Нажать на кнопку "Редактировать". Поля станут редактируемыми:

   Image Removed
   

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

4. При нажатии на "Сохранить", окно будет закрыто.

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

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

...

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

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

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

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

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

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

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

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

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

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

Для настройки данного параметра

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

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

1. Нажать на кнопку "Изменить параметры

...

1. очереди ресурсов".

...

1.  Откроется окно "Параметры

...

1. очереди ресурсов":
   

...

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

...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Нажать на кнопку "Изменить параметры ресурса" в строке с нужным ресурсом (в таблице ресурсов). Откроется окно "Параметры ресурса":
   Image Added
2. Внести необходимые корректировки.
3. Нажать на кнопку «Сохранить» для подтверждения внесенных изменений. Или нажать на кнопку "Отменить", если решили не применять изменения. 

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

...

Окно "История работы с ресурсом"

Image Removed

Описание таблицы истории работы с ресурсом

Таблица с записями о событиях, происходивших с данным ресурсом. По умолчанию записи таблицы отсортированы по дате добавления записей.

...

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

...

Описание

...

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

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

Если инициатор - робот, то указано его название, название машины, на которой он работал в момент создания\изменения ресурса, и название УЗ, под которой робот работал.

...

Отображается одно из этих событий:

• Создание ресурса
• Изменение ресурса
• Блокировка ресурса
• Чтение ресурса
• Разблокировка ресурса
• Удаление ресурса

Некоторые действия пользователя или робота могут сопровождаться сразу несколькими записями в таблицу. Например, робот выполняет действие "Обновить ресурс", которое меняет значение и блокирует ресурс с датами разблокировки на чтение и на запись; в таблице будет 3 записи:

Блокировка ресурса (на чтение)

Блокировка ресурса (на запись)

Изменение ресурса

...

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

1. События, которые завершились успешно:
   подробнее в "Успешные события и варианты их параметров". Исключением является "Удаление ресурса" - может быть записано в таблицу истории только при возникновении ошибки выполнения этой операции.
2. События, которые завершились с ошибкой:
   у любого события, завершившегося неудачно, в столбце указано описание причины ошибки.

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

Успешные события и варианты их параметров