Раздел "Хранилище ресурсов" предназначен для работы с ресурсами, которые являются внешними по отношению к роботам, проектам роботов, процессам и экранным формам. Такие ресурсы хранятся в базе системы, а не где-то локально или как часть другого объекта (как переменные в роботе).

В отличии от ресурсов из очередей, ресурсы из хранилища статичны и предназначены для многократного использования. Такие ресурсы не предполагается "обрабатывать", проводя по разным статусам, или блокировать для частного использования только одним субъектом. Ресурсы хранилища всегда доступны всем субъектам (но в границах ролевой модели), можно менять только значение ресурса.
Например, в хранилище можно создать ресурс, содержащий пароль от почты (его периодически меняют, поэтому указать его сразу в роботе нельзя), а в очередь ресурсов добавить ресурсы, содержащие номера заявок, которые должен проверить робот. Заявок много, поэтому их будут обрабатывать несколько роботов: за счет статусов и блокировок роботы не будут повторно обрабатывать одни и те же заявки, а проверенные заявки отмечать как обработанные.

Раздел "Хранилище ресурсов" относится к модулю "Оркестратор". Этот модуль отображается на интерфейсе, если пользователю в текущем тенанте доступна роль "Администратор Оркестратора". Если эта роль недоступна, то весь модуль "Оркестратор" (вместе с разделом "Хранилище ресурсов") будет скрыт на интерфейсе.

При возникновении любой ошибки (со стороны бэка или фронта), которая не указана в спецификации отдельно (при переходе в раздел, открытии окон, нажатии кнопок), выводится уведомление:

"Неизвестная ошибка

Обратитесь к администратору" .

Описание элементов интерфейса страницы  "Хранилище ресурсов"

Описание элементов интерфейса страницы "Хранилище ресурсов" представлено в нижеприведенной таблице.

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

В таблице отображаются ресурсы, которые добавлены в текущий тенант (без группировки):

• По умолчанию записи таблицы отсортированы по названию ресурсов
• В выпадающем списке прокручиваются только строки таблицы, элементы над таблицей и шапка таблицы не перемещаются
• Таблица не отображается:

  • если нет ни одного ресурса, доступного пользователю в текущем тенанте, при этом на экран выводится фраза:
    Здесь можно просмотреть список ресурсов из хранилища, которые доступны вам в текущем тенанте"

  • При любых ошибках с лицензией вместо таблицы будет фраза "Здесь можно просмотреть список ресурсов из хранилища, которые доступны вам в текущем тенанте" .

Описание столбцов и кнопок таблицы  страницы "Хранилище ресурсов"

Кнопка "Создание ресурса"

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

При возникновении любой ошибки при переходе на вкладку, открытии окон, нажатии кнопок, выводится уведомление:

"Неизвестная ошибка

Обратитесь к администратору" 

Описание элементов интерфейса  модального окна "Ресурс" представлено в нижеприведенной таблице.

Описание элементов интерфейса  модального окна "Ресурс"

Варианты значения в зависимости от типа данных

В поля, где тип данных "Путь к файлу", "Путь к папке" или "Изображение" ввод значения в настоящее время будет только вручную. Т.к. из соображений безопасности, браузеры заменяют путь выбранного файла фейковым, тем самым защищая пользователя, то мы не сможем передать в поле захваченный реальный путь до файла/папки.

Например, настоящий путь "C:\users\user\фото_на_паспорт.jpg" будет заменен на "C:\fakepath\фото_на_паспорт.jpg". Робот, получивший такой фейковый путь ресурса, не сможет найти по нему нужный файл.

Описание вариантов поля "Значение"

Описание полей/кнопок для настройки значения типа "Коллекция"

Количество элементов коллекции

Это краткое отображение значения коллекции, которое указывает текущее количество ее элементов (1).

Шаблон:

Элементов: <количество элементов коллекции>

Пример:

Элементов: 3

Число в этой фразе меняется сразу, как только пользователь добавляет или удаляет элемент из коллекции (т.е. еще до сохранения ресурса). Если в коллекции нет элементов, то указано "Элементов: 0"

Если это дочерняя коллекция (коллекция внутри коллекции\словаря), то рядом есть шеврон (2), который:

• скрывает\отображает поле "Тип данных элемента" и список элементов этой коллекции
• не влияет на скрытие\отображение родительской коллекции и других элементов родительской коллекции

Если значение дочерней коллекции - "Элементов: 0", то шеврона нет, поле "Тип данных элемента" не скрыто.

Тип данных элемента

Тип данных добавляемого элемента коллекции.

Доступные значения:

• Строка
• Число
• Дата-время
• Логический
• Пароль
• Путь к файлу
• Путь к папке
• Изображение
• Коллекция
• Словарь
• Таблица

Значение по умолчанию: "Строка"

Каждая добавляемая строка с элементом содержит:

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

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

Если это поле для выбора типа элемента у основной коллекции (когда тип всего ресурса - коллекция), то при выпадающем списке вниз/вверх это поле не перемещается (как шапка у таблиц в разделах), прокручиваются только строки с элементами коллекции. 

По нажатию в список элементов коллекции добавляется еще одна строка с новым элементом. Тип данных этого элемента = тому, который на тот момент был выбран в поле "Тип данных элемента".

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

Но аналогичное поле у дочерней коллекции (коллекция внутри коллекции/cловаря), будет прокручиваться вместе с элементами.

Описание полей/кнопок для настройки значения типа "Словарь"

Значение - Количество записей словаря

Это краткое отображение значения словаря, которое указывает текущее количество его записей.

Шаблон:

Записей: <количество записей словаря>

Пример:

Записей: 3

Число в этой фразе (1) меняется сразу, как только пользователь добавляет или удаляет запись из словаря (т.е. еще до сохранения ресурса). Если в словаре нет записей, то указано "Записей: 0"

Если это дочерний словарь (словарь внутри коллекции\словаря), то рядом есть шеврон, который:

• скрывает\отображает кнопку "Добавить запись" и список записей этого словаря
• не влияет на скрытие\отображение родительского словаря и др. записей родительского словаря

Если значение дочернего словаря - "Записей: 0", то шеврона нет, кнопка "Добавить запись" не скрыта.

Добавить запись (Кнопка) (2)

По нажатию кнопки (2) в список записей словаря добавляется еще одна строка с новой записью. Каждая добавляемая строка содержит:

• поле "Ключ" (3)
• выпадающий список "Тип данных записи" (4)
• поля/кнопки "Значение" (5)
• кнопка "Удалить запись" (6)

Описание этих элементов приведено далее.

При выпадающем списке вниз прокручиваются только строки с записями словаря, эта кнопка не перемещается (как шапка у таблиц в разделах).

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

Ключ (Поле) (3)

Если добавлена строка с записью словаря

Строковое поле для указания ключа записи словаря. Указано в каждой строке с записью словаря.

Тип данных записи (Выпадающий список) (4)

Тип данных значения записи словаря. Поле указано в каждой строке с записью словаря.

Доступные значения:

• Строка
• Число
• Дата-время
• Логический
• Пароль
• Путь к файлу
• Путь к папке
• Изображение
• Коллекция
• Словарь
• Таблица

Значение по умолчанию: "Строка"

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

Значение (Поле) (5)

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

Внешний вид поля и вариант настройки его значения зависят от выбранного типа данных (см. соответствующее описание выше Варианты значения в зависимости от типа данных).

Если добавлена строка с записью словаря

Удалить запись (Кнопка) (6)

При нажатии удаляется выбранная запись.

Кнопка указана в каждой строке с записью словаря.

Если добавлена строка с записью словаря

Описание полей/кнопок для настройки значения типа "Таблица"

Количество столбцов и строк таблицы

Шаблон:

Столбцов: <количество столбцов>; строк: <количество строк>

Пример:

Столбцов: 5; строк: 2

Числа в этой фразе (1) меняются сразу, как только пользователь добавляет или удаляет столбцы\строки из таблицы (т.е. еще до сохранения ресурса) - по кнопкам на самой таблице или при помощи полей "Столбцов" и "Строк".

Если в таблице нет ни одного столбца (строк в этом случае тоже нет), то указано "Столбцов: 0; строк: 0"

Если это дочерняя таблица (т.е. таблица внутри коллекции/словаря), то рядом есть шеврон, который:

• Скрывает\отображает кнопку "Очистить таблицу"/"Заполнить таблицу" и сформированную таблицу.
• Не влияет на скрытие\отображение родительского словаря и др. его записей (аналогично и для родительской коллекции).

Если значение дочерней таблицы - "Столбцов: 0; строк: 0", то шеврона нет, кнопка "Заполнить таблицу"/"Очистить таблицу" не скрыта.

Заполнить таблицу/Очистить таблицу Кнопка

Видима, если в таблице 0 столбцов.

По нажатию:

• "Заполнить таблицу" заменяется на кнопку "Очистить таблицу"
• появляются поля "Столбцов" и "Строк", в которых уже указано значение "1". Соответственно, фраза "Столбцов: 0; строк: 0" сразу актуализируется до "Столбцов: 1, строк: 1"
• появляется таблица с 1 столбцом и 1 строкой (шапка не считается строкой и не учитывается в этом количестве)

Очистить таблицу Кнопка (2)

Видима, если в таблице столбцов > 0.

По нажатию:

• "Очистить таблицу" заменяется на кнопку "Заполнить таблицу"
• скрываются поля "Столбцов" и "Строк"
• удаляется вся таблица, даже если в ней уже были заполнены ячейки.
• Фраза "Столбцов: n; строк: k" сразу актуализируется до "Столбцов: 0; строк: 0"

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

"Столбцов" Поле (3)

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

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

• Значение по умолчанию: 1
• Доступные значения: цифры от 0-9
• Мин. значение, которое можно ввести = 0; макс. = 100
• Значение можно указать вручную или по кнопкам в виде стрелочек
• При увеличении кол-ва столбцов, они добавляются в конец таблицы
• По умолчанию название каждого нового столбца = значению счетчика столбцов. Значение счетчика не меняется, если удалили некоторые столбцы. Счетчик начинается с 0

  Например, по умолчанию в таблице 0 столбцов. Пользователь добавляет 4 столбца - они добавляются с названием "0", "1", "2" и "3". Текущее значение счетчика столбцов = 3. Пользователь переименовывает столбец "1" на "Тест", удаляет столбец "2" и "3", добавляет новый столбец. В итоге в таблице будет 3 столбца с названиями "0", "Тест" и "4". Текущее значение счетчика столбцов = 4

• При уменьшении кол-ва столбцов, они будут удалены с конца таблицы. Если при уменьшении столбцов в них содержатся данные, то их наличие игнорируется и столбец все равно удаляется
• Если в полях "Столбцов" и "Строк" указано "0", то при добавлении столбцов, в поле "Строк" значение все равно останется "0". В таблице будет только ее "шапка", которая не входит в число строк. Для табличных значений допустимо наличие n столбцов и 0 строк

"Строк" Поле (4)

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

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

• Значение по умолчанию: 1
• Доступные значения: цифры от 0-9
• Мин. значение, которое можно ввести = 0; макс. = 100
• Значение можно указать вручную или по кнопкам в виде стрелочек
• При увеличении кол-ва строк, они добавляются в конец таблицы
• При уменьшении кол-ва строк, они будут удалены с конца таблицы. Если при уменьшении строк в них содержатся данные, то их наличие игнорируется и строка все равно удаляется.
• Если в полях "Столбцов" и "Строк" указано "0", то при добавлении строк, в поле "Столбцов" установится значение 1, и вместе со строками добавится 1 столбец (у таблицы сразу будет "шапка"). Для табличных значений недопустимо наличие k строк и 0 столбцов

Подсказка о размере таблицы (5)

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

Текст подсказки:

"Максимальный размер таблицы — 100 строк и 100 столбцов" 

Таблица, сформированная при помощи полей "Столбцов" и "Строк" и/или кнопок на самой таблице:

• Можно сужать/расширять столбцы при помощи вертикальных границ таблицы
• Если все строки и/или столбцы не помещаются на странице, появляется вертикальный и\или горизонтальный выпадающий список (соответственно), который работает только в рамках области таблицы. При выпадающем списке прокручиваются только строки таблицы, шапка таблицы не скрывается
• Строки таблицы пронумерованы. Нумерация начинается с 0. Шапка таблицы не считается строкой, поэтому не учитывается в кол-ве строк и не пронумерована
• Если текст в ячейке не умещается в 1 строку, то остальная его часть не видна. Значение отображается полностью только при его редактировании. При этом для отображения всего текста столбец увеличится вниз и вправо по размеру текста
• По двойному клику на:
  • название столбца, его ячейка становится редактируемой и можно изменить название. Для сохранения изменений нужно убрать фокус с поля
  • ячейку в строке (строка с "шапкой" не считается) она становится редактируемой и можно добавить\изменить\очистить ее содержимое. Для сохранения изменений нужно убрать фокус с поля

значения в ячейках таблицы можно менять

Cформированная таблица (6)

Если кол-во столбцов > 0

Создать ресурс

Для того , чтобы  создать ресурс, необходимо войти в раздел " Хранилище ресурсов". Затем:

1. Пользователь должен нажать на кнопку "Создать ресурс".

2. Система при этом открывает страницу создания ресурса. 

3. Пользователь заполняет нужные поля.
4. Пользователь нажимает на кнопку "Создать". 
5. Система осуществляет проверку на заполнение обязательных полей и уникальность значений параметров:
   1. Система проверяет, заполнены ли обязательные поля:
      
      1. Если заполнены, выполняется следующий шаг.
      2. Если не заполнены, то осуществляется Проверка на обязательность.  
   2. Если на странице есть значение с типом "Словарь", система проверяет значения ключей словаря на уникальность:
      
      1. Если ключи уникальны в рамках словаря, выполняется следующий шаг.
      2. Если есть одинаковые ключи, выполняется Альтернатива  "Ключи словарей не уникальны"
         Если на странице несколько отдельных словарей (например, в разных элементах коллекции), то система проверяет уникальность ключей для каждого словаря отдельно.
   3. Если на странице есть значение с типом "Таблица", система проверяет названия столбцов на уникальность:
      
      1. Если столбцы уникальны в рамках таблицы, выполняется следующий шаг.
      2. Если есть одинаковые по названию столбцы, выполняется Альтернатива  "Столбцы не уникальны"
         Если на странице несколько отдельных таблиц (например, в разных элементах коллекции), то система проверяет уникальность столбцов для каждой таблицы отдельно.
   4. Система проверяет название ресурса на уникальность:
      
      1. Если в текущем тенанте нет ресурса с таким же названием, выполняется следующий шаг.
      2. Если в текущем тенанте есть ресурс с таким же названием, выполняется Альтернатива "Ресурс с таким названием уже существует".
6. Система добавляет новый ресурс в список ресурсов хранилища в текущем тенанте.
7. Система закрывает страницу создания ресурса, возвращая страницу раздела "Хранилище ресурсов"
8. Система выводит уведомление:
   "Ресурс "Название ресурса" успешно создан"
9. Если по каким-то причинам Пользователь хочет отменить создание ресурса выполняется Отмена создания ресурса.

Проверка на обязательность и уникальность

Альтернатива "Не заполнены обязательные поля"

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

2. Система выдает предупреждение:

   "Ошибка при создании ресурса

   Заполнены не все поля"

3. Пользователь заполняет все обязательные поля, которые пропустил.

4. Выполняется переход к шагу №4 Создать ресурс

Альтернатива  "Ключи словарей не уникальны"

1. Система не закрывает страницу и выдает предупреждение:

   "Ошибка при создании ресурса

   В словаре есть ключи с одинаковым названием"

   
   

2. Пользователь исправляет повторы в ключах словаря(ей).

3. Выполняется переход к шагу №4 Создать ресурс

Альтернатива  "Столбцы не уникальны"

Система не закрывает страницу и выдает предупреждение:

"Ошибка при создании ресурса

Альтернатива "Ресурс с таким названием уже существует"

1. Пользователь изменяет значение в поле "Название ресурса".
2. Выполняется переход к шагу №4 Создать ресурс

 При  необходимости отмены создания ресурса:

1. Пользователь нажимает кнопку "Отменить".
2. Система открывает окно с подтверждением отмены создания:
   "Вы уверены, что хотите отменить создание ресурса?"
3. Пользователь нажимает на кнопку "Да".
4. Система закрывает страницу создания ресурса, возвращая страницу раздела "Хранилище ресурсов". Нового ресурса нет в таблице раздела.

 Для того, чтобы просмотреть раздел "Хранилище":

1. Пользователь должен авторизоваться в системе Вход в систему.

2. Вход в Систему возможен с ролью "Администратор Оркестратора". Если пользователю не доступна роль "Администратор Оркестратора", то модуль "Оркестратор" не отображается. Если эта роль доступна, выполняется следующий шаг.

3. Пользователь переходит в модуль "Оркестратор" - раздел "Хранилище ресурсов".

4. На открывшейся странице доступны следующие функциональные возможности: 

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

   • Открытие карточки ресурса по нажатию на название ресурса Карточка ресурсов
   • Создание нового ресурса по кнопке "Создать ресурс"
   • Удаление ресурсов -" Удалить ресурс"

5. Пользователь в разделе "хранилище ресурсов" может просмотреть список ресурсов.

6. С помощью поиска по названию ресурса можно сузить список выводимых записей таблицы.

7. С помощью операций сортировки можно вывести в верхнюю часть таблицы те записи, которые представляют интерес.

8. Если список ресурсов не умещается на одной странице, система распределяет записи по нескольким страницам с учетом выбранного максимума выводимых записей - n: 1я стр. - первые n записей, 2я стр. - вторые n записей и т.д. На каждой странице система отображает записи, которые соответствуют условиям сортировки и слову(ам) в строке поиска.

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

1. Выполняются просмотр раздела  Хранилища".
2. Пользователь выбирает в таблице ресурс и в его строке нажимает на кнопку "Удалить".
3. Система проверяет, есть ли ресурс в базе:
   
   • Если ресурс не найден, система выводит предупреждение:
     "Ошибка при работе с ресурсом
     Ресурс не найден, обновите страницу"
     Сценарий завершается на этом шаге.
   • Если ресурс найден, выполняется следующий шаг.
4. Система проверяет, доступен ли ресурс пользователю в текущем тенанте:
   
   • Если недоступен, система выводит предупреждение:
     "Работа с ресурсом запрещена
     Недостаточно прав для работы с ресурсом "Название ресурса""
     Сценарий  завершается на этом шаге.
   • Если доступен, выполняется следующий шаг.
5. Система открывает окно с подтверждением удаления:
   "Вы уверены, что хотите удалить ресурс "Название ресурса"?"

6. Пользователь нажимает на кнопку "Удалить".

7. Система выполняет аналогичные проверки, как в шагах 3-4.

8. Система закрывает окно с подтверждением.

9. Система удаляет ресурс.

10. Система обновляет список ресурсов на странице раздела.

11. Система выводит уведомление:
    "Ресурс "Название ресурса" успешно удален"

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