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

Ключ

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

Оглавление

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

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

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

Интерфейс страницы "Хранилище ресурсов" представлен ниже:

Image Removed

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

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

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

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

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

...

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

...

Примечание

...

Поле "Поиск" (1)

...

  • Поиск производится только по имени ресурса
  • Регистр не учитывается
  • Доступен поиск по части имени: введенный текст может быть в любой части имени ресурса

Image Removed

...

При нажатии открывается карточка ресурса в режиме создания.

Image Removed

Подробнее Создать ресурс

The Resource Storage section is intended for working with resources that are external to robots, robot projects, workflows, and screen forms. Such resources are stored in the system base, not somewhere locally or as part of another object (like variables in a robot).

Unlike resources from queues, resources from storage are static and intended for multiple use. Such resources are not supposed to be “processed” by being held in different statuses, or blocked for private use by only one subject. Storage resources are always available to all subjects (but within the boundaries of the role model), only the value of the resource can be changed.

For example, you can create a resource in the repository that contains the mail password (it is periodically changed, so you cannot specify it in the robot at once), and add resources to the resource queue that contain the numbers of requests to be checked by the robot. There are many requests, so they will be processed by several robots: due to statuses and locks, robots will not repeatedly process the same requests, and checked requests will be marked as processed.

The Resource Store section refers to the Orchestrator module. This module is displayed on the interface if the Orchestrator Administrator role is available to the user in the current tenant. If this role is not available, the entire Orchestrator module (along with the Resource Store section) will be hidden on the interface.

The interface of the Resource Store page is shown below:

Image Added

When any error occurs (on the back or front end) that is not specified separately in the specification (when navigating to a section, tab, opening windows, clicking buttons), a notification is displayed:

"Unknown error

Contact your administrator".

Description of the interface elements of the Resource Store page

The description of the interface elements of the Resource Store page is shown in the table below.

Element name

Note

Search

field (1)

  • Search is performed by resource name only
  • Case is not taken into account
  • Part of name search available: the entered text can be in any part of the resource name

Image Added

Create resource (2)

If you click on it, the resource card opens in the creation mode.

Image Added

Read more here: Create resource

Якорь
Столбцы
Столбцы
Columns (3)

  • Filter to customize the columns to be displayed in the resource table
  • The available values in the dropdown list are the names of all columns in the table
  • Column that cannot be disabled in the list is Resource

Image Added

The Columns table is displayed if there is a Resource table.

In the dropdown list there is a button Apply, which applies everything that is selected. If you click on the button, the selection is confirmed, the list is closed, and the columns appear/hide in the table. If you click sideways, the changes will not be applied.

The Cancel button does not apply the current changes. The table will be displayed in the previously applied variant.

Resource table (4)

Read more here: Resource table



Якорь
Таблица ресурсов
Таблица ресурсов
Description of the columns and buttons of the Resource Table of the Resource Store page

Element name

Template/example

Description

Resource (6)

Example:

Email address

Name of the resource.

This is a link to the resource card.

Read more here: Resource card.

The card will not open if:

  • Resource not found in the database. A warning appears:

    "Error while working with resource

    Resource not found, refresh the page"

  • The resource is not found or is not available to the user in the current tenant. A warning appears:
    "Working with the resource is prohibited
    Insufficient permissions to work with the resource Resource name
    "
  • Sorting by name is possible
Data type (7)

Example:

String

The data type of the resource. One of the following values is possible:

  • Boolean
  • Collection
  • Table
  • Date-time
  • Dictionary
  • Folder path
  • File path
  • Image
  • Number
  • Password
  • String

Sorting by resource data type name is possible

Value (8)

The value template depends on the data type of the resource. Details of all templates are listed below.

Resource value

Якорь
Удалить
Удалить
Delete (9)

-

When clicked, if

  • The resource is not found in the database, a warning appears:

    "Error while working with resource

    Resource not found, refresh the page"

  • The resource is not found or is not available to the user in the current tenant. A warning appears:
    "Working with the resource is prohibited
    Insufficient permissions to work with the resource Resource name"
  • If the checks are successful, a window appears:
    • The text in the window: “Are you sure you want to delete the resource Resource name?”

    • Buttons in the window: Delete and Cancel.

    • When you click on Cancel, the window closes, the resource is not deleted.

    • When you click on Delete, the window closes, the resource is deleted, and a notification appears:
      "The resource Resource name has been successfully deleted"

The table shows the resources that have been added to the current tenant (without grouping):

  • By default, the table entries are sorted by resource name
  • The table is not displayed:
    • if there are no resources available to the user in the current tenant, the phrase is displayed:
      "Here you can view the list of resources from the storage that are available to you in the current tenant".

    • For any errors with the license instead of the table the phrase is displayed:
      "Here you can view a list of resources from the vault that are available to you in the current tenant".

When you put the cursor on the resource name (5) and then click on it, you will go to the Resource Card. 

Create resource button

When you click the Create resource button, the Resource modal window opens.

Image Added

...

  • Фильтр для настройки столбцов, которые должны отображаться в таблице ресурсов
  • Доступные значения в выпадающем списке – названия всех столбцов таблицы
  • Столбец, который нельзя отключить в списке - "Ресурс"

Image Removed

Таблица "Столбцы" отображается, если есть таблица ресурсов.

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

Кнопка "Отменить" не применяет текущие изменения. Таблица будет отображена в предыдущем примененном варианте.

...

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

Подробнее  в eng 1.8Хранилище ресурсов

...

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

...

Шаблон\пример

...

Описание

...

Пример:

Адрес почты

...

Название ресурса.

Является ссылкой на карточку ресурса.

Подробнее в eng 1.8Хранилище ресурсов.

Карточка не открывается, если:

  • Ресурс не найден в базе. Появляется уведомление:

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

    Ресурс не найден, обновите страницу"

  • Ресурс не найден или недоступен пользователю в текущем тенанте. Появляется предупреждение:
    "Работа с ресурсом запрещена
    Недостаточно прав для работы с ресурсом "Название ресурса""
  • Возможна сортировка по названию

...

Пример:

Строка

...

Тип данных ресурса. Возможно одно из следующих значений:

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

Возможна сортировка по наименованию типа данных ресурсов

...

Шаблон значения зависит от типа данных ресурса. Подробнее о всех шаблонах указано ниже.

...

Значение ресурса

...

-

...

При нажатии, если

  • Ресурс не найден в базе, появляется предупреждение:

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

    Ресурс не найден, обновите страницу"

  • Ресурс не найден или недоступен пользователю в текущем тенанте, появляется предупреждение:
    "Работа с ресурсом запрещена
    Недостаточно прав для работы с ресурсом "Название ресурса""
  • Если проверки прошли успешно, появляется окно:
    • Текст в окне: "Вы уверены, что хотите удалить ресурс "Название ресурса"?"

    • Кнопки в окне: "Удалить" и "Отменить".

    • При нажатии на "Отменить", окно закрывается, ресурс не удаляется.

    • При нажатии на "Удалить", окно закрывается, ресурс удаляется, появляется уведомление:
      "Ресурс "Название ресурса" успешно удален"

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

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

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

При  подведении курсора на название ресурса (5) и  последующее на него нажатие осуществляется переход в Карточку ресурсов. 

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

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

Image Removed

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

...

Description of the interface elements of the Resource modal window 

The description of the interface elements of the Resource modal window is presented in the table below.

Interface element name

Available/default values

Description

Back-

Clicking closes the Resource Creation page and returns to the Resource Store page.  The resource will not be created

Resource name -

Resource name

Example:

Password for 1C

This field cannot be empty.

In create/edit/modify mode, a cross-shaped button appears in the field to clear text from the field. Image Added


Data type 

Available values:

  • String
  • Number
  • Date-time
  • Boolean
  • Password
  • File path
  • Folder path
  • Image
  • Collection
  • Dictionary
  • Table
     

Default value:

  • String

Data type of the resource to be created

Only one value is available in the list. The selected value affects the appearance of the Value field.

Image Added

The data type field of the resource to be created cannot be edited/modified by an existing resource in the resource card editing mode 

ValueThe presence of a default value depends on the selected data type

The appearance of the field and the option to customize its value depend on the selected data type. See Value options depending on data type for details

Since the String type is selected by default in the Data type field when opening the creation page, the Value field looks like an editable text field by default.

Create - in the resource creation mode-

When you click, the resource is not created and the page is not closed if:

  • The current tenant already has a resource with the same name, and a warning appears:

    "Error when creating a resource

    A resource with this name already exists"

  • Mandatory fields are not filled in. They are highlighted in red and the phrase “This field cannot be empty” appears below them, a warning appears:
    "Error when creating a resource
    Not all fields are filled in
    "
  • When filling the dictionary added keys with the same names, a warning appears:

    "Error when creating a resource

    There are keys with the same name in the dictionary"

    The key must be unique only within the dictionary in which it is specified, not among all dictionaries added to the resource. For example, the resource itself is a dictionary. One of the dictionary values is also specified with the type Dictionary. This results in a dictionary containing another dictionary. They are considered different dictionaries, i.e. one dictionary is not a continuation of the other. Therefore, the uniqueness of keys is checked in each dictionary separately.

  • If you specified columns with the same name when filling the table, a warning message appears:

    "Error when creating a resource

    A table has columns with the same name"

If all the checks are successful, a new resource is created, you are returned to the Resource Store section page, and a notification appears:

"The resource Resource name has been successfully created"

Cancel - in the resource creation mode-

When clicked, a window opens with the message: “Are you sure you want to cancel the resource creation?”.

If you click on the No button, the window closes, and the current page is left

If you click on the Yes button, the window closes, you are returned to the Resource Store page and the resource is not created.

...

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

Название элемента интерфейса

Доступные значения\по умолчанию

Описание

Вернуться-

При нажатии закрывается страница создания ресурса; происходит возврат на страницу "Хранилище ресурсов".  Ресурс создан не будет

Название ресурса -

Название ресурса

Пример:

Пароль для 1С

Данное поле не может быть пустым.

В режиме создания/редактирования/изменения в поле появляется  кнопка в виде крестика для очищения от текста. Image Removed

Тип данных 

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

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

Значение по умолчанию:

 Строка

Тип данных создаваемого ресурса

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

Image Removed

Поле типа данных создаваемого ресурса редактированию/изменению имеющегося ресурса в режиме редактирования карточки ресурсов изменению не подлежит 

Значение Наличие значения по умолчанию зависит от выбранного типа данных

Внешний вид поля и вариант настройки его значения зависят от выбранного типа данных. Подробнее в eng 1.8Хранилище ресурсов

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

Создать - в режиме создания ресурса-

При нажатии создание ресурса не происходит и страница не закрывается, если:

  • В текущем тенанте уже есть ресурс с таким же названием, при этом появляется предупреждение:

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

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

  • Обязательные поля не заполнены. Они подсвечиваются красным и под ними появляется фраза "Данное поле не может быть пустым", появляется предупреждение:
    "Ошибка при создании ресурса
    Заполнены не все поля"
  • При заполнении словаря добавили ключи с одинаковыми названиями, появляется предупреждение:

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

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

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

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

    В таблице есть столбцы с одинаковым названием"

Если все проверки пройдены успешно, создается новый ресурс, происходит возврат на страницу раздела "Хранилище ресурсов", появляется уведомление:

"Ресурс "Название ресурса" успешно создан"

Отменить - в режиме создания ресурса-

При нажатии открывается окно с сообщением: "Вы уверены, что хотите отменить создание ресурса?"

При нажатии на  кнопку "Нет", окно закрывается, остается текущая страница

При нажатии на кнопку "Да", окно закрывается, происходит возврат на страницу раздела "Хранилище ресурсов", ресурс не создается

 
Якорь
Просмотр раздела "Хранилище ресурсов"
Просмотр раздела "Хранилище ресурсов"

...

View Resource Store section

In order to view the Resource Store section:

  1. The user must log in to the system: Log in.

  2. The System can be accessed with the Orchestrator Administrator role. If the Orchestrator Administrator role is not available to the user, the Orchestrator module is not displayed. If this role is available, the next step is performed.
  3. The user goes to the Orchestrator module - Resource Store section.

  4. The following functionalities are available on the page that opens: 
    • View a sortable and searchable list of resources that are available to the user in the current tenant

    • Opening a resource card by clicking on the resource name (5)
    • Creating a new resource - eng Создание ресурса
    • Deleting resources - Delete resource
  5. The user in the Resource Store section can view a list of resources.

  6. By searching by resource name, you can narrow down the list of output table entries - Columns.

  7. You can use sorting operations to bring those records of interest to the top of the table.

  8. If the resource list does not fit on a single page, the system spreads the records over multiple pages based on the selected maximum number of output records - n: 1st page. - first n records, 2nd page. - second n records, etc. On each page, the system displays records that match the sorting conditions and the word(s) in the search bar

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

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

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

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

    • Открытие карточки ресурса по нажатию на название ресурса (5)
    • Создание нового ресурса -eng Создание ресурса
    • Удаление ресурсов -" eng 1.8Хранилище ресурсов"
  5. Пользователь в разделе "Хранилище ресурсов" может просмотреть список ресурсов.

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

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

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

Якорь
Удалить ресурс
Удалить ресурс

...

Deleting a resource

In order to delete a resource, the following actions are implemented:

  1. The Resource Store section is being previewed.
  2. The user selects a resource in the table and clicks the Delete button in its row.
  3. The system checks if the resource is in the database:
    • If the resource is not found, the system displays a warning message:
      "Error while working with resource
      Resource not found, refresh the page
      "

      The scenario ends at this step.
    • If the resource is found, the next step is performed.
  4. The system checks if the resource is available to the user in the current tenant:
    • If unavailable, the system displays a warning message:
      "Working with the resource is prohibited
      Insufficient rights to work with the resource "Resource name
      ""

      The scenario ends at this step.
    • If available, the next step is performed.
  5. The system opens a window to confirm the deletion:
    "Are you sure you want to delete the resource "Resource name"?"
  6. The user clicks the Delete button.

  7. The system performs similar checks as in steps 3-4.

  8. The system closes the confirmation window.

  9. The system deletes the resource.

  10. The system updates the list of resources on the partition page.

  11. The system displays a notification:
    "The resource "Resource Name" has been successfully deleted

...

Для того, чтобы удалить ресурс, реализуются следующие действия:

  1. Выполняется eng 1.8Хранилище ресурсов.
  2. Пользователь выбирает в таблице ресурс и в его строке нажимает на кнопку  eng 1.8Хранилище ресурсов .
  3. Система проверяет, есть ли ресурс в базе:
    • Если ресурс не найден, система выводит предупреждение:
      "Ошибка при работе с ресурсом
      Ресурс не найден, обновите страницу"

      Сценарий завершается на этом шаге.
    • Если ресурс найден, выполняется следующий шаг.
  4. Система проверяет, доступен ли ресурс пользователю в текущем тенанте:
    • Если недоступен, система выводит предупреждение:
      "Работа с ресурсом запрещена
      Недостаточно прав для работы с ресурсом "Название ресурса""

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

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

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

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

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