Дерево папок

Для удобства навигации и быстрого доступа в следующих разделах пользовательского интерфейса «Кабинет администратора» экземпляры сущностей распределяются по папкам, структурированным в виде иерархического дерева:

  • «Коллекции устройств»;

  • «Конфигурации».

Общие сведения

В продукте «Осмакс» папка служит средством сортировки и упорядочивания экземпляров сущностей для их отображения в пользовательском интерфейсе «Кабинет администратора».

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

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

Наименования папок должны быть уникальными в пределах одного типа сущности (раздела в пользовательском интерфейсе), независимо от уровня их размещения в иерархии.

Просмотр дерева папок

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

  • боковая панель для навигации по разделам сворачивается;

  • справа от свернутой боковой панели отображается отдельная панель с деревом папок.

folder tree general view
Рис. 1. Общий вид раздела с отображением дерева папок

При первом переходе в раздел в рабочей области отображается список экземпляров сущности, расположенных в корневой папке.

Для навигации по дереву используйте стандартные значки развертывания и свертывания узлов (expand icon/collapse icon).

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

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

Чтобы скрыть или отобразить боковую панель навигации и панель с деревом папок, используйте значки show icon/hide icon.

Поиск в дереве папок

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

  • в панели с деревом папок;

  • в формах для работы с папками, где требуется выбор расположения;

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

Для поиска папки по наименованию введите не менее трех символов в поле ввода.

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

folder tree search
Рис. 2. Поле поиска на панели с деревом папок

Чтобы выйти из режима поиска и отобразить полное дерево, нажмите Esc, очистите поле ввода или нажмите reset icon.

Поиск и фильтрация по атрибутам сущностей в папках

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

  • локальный поиск — поиск объектов только в текущей выбранной папке;

  • глобальный поиск — поиск объектов в текущей выбранной папке и ее дочерних папках.

Чтобы изменить режим поиска, выберите его в переключателе в строке поиска:

folder tree search menu

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

После выполнения глобального поиска:

  • в таблице со списком найденных объектов отображается дополнительный столбец Расположение с указанием пути к папкам, в которых они располагаются;

  • в панели быстрого просмотра свойств выбранного объекта отображается дополнительное поле Расположение с указанием пути к папке, в которой он располагается.

Выбранный режим также влияет на список объектов в таблице и область применения фильтров:

  • если в переключателе выбрано значение Только в этой папке (по умолчанию):

    • в списке отображают только объекты, располагающиеся в текущей выбранной папке;

    • фильтры применяются только к объектам, располагающимся в текущей выбранной папке;

  • если в переключателе выбрано значение В этой и вложенных папках:

    • в списке отображаются объекты, располагающиеся в текущей выбранной папке и ее дочерних папках;

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

Создание папки

Папка может быть создана в любой другой папке, кроме:

  • уровня глубже девятого (максимальный уровень вложенности — 10);

  • первого уровня, на котором располагается корневая папка.

Чтобы добавить новую папку в дерево:

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

  2. Откройте форму создания папки одним из двух способов:

    • на панели с деревом папок нажмите правой кнопкой мыши на ветви дерева, в которой следует разметить папку, и в меню действий выберите Создать папку;

      folder tree actions menu create
      Рис. 3. Меню действий для работы с папками в дереве
    • в меню Создать над списком экземпляров сущности в рабочей области выберите Папку.

      folder tree create menu
      Рис. 4. Меню создания в рабочей области
  3. В форме создания папки заполните поля:

    folder tree create folder dialog
    • Название (обязательное) — наименование папки длиной от 3 до 256 символов (должно быть уникальным в пределах раздела);

    • Описание — произвольное текстовое описание папки;

    • Расположение — при необходимости измените родительскую папку для размещения новой папки в дереве.

  4. Нажмите Создать.

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

Редактирование папки

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

Чтобы изменить атрибуты существующей папки в дереве:

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

  2. На панели с деревом папок нажмите правой кнопкой мыши на папке, атрибуты которой требуется изменить, и в меню действий выберите Редактировать.

    folder tree actions menu edit
    Рис. 5. Меню действий для работы с папками в дереве
  3. В форме редактирования папки измените значения в полях:

    folder tree edit folder dialog
    • Название — наименования папки длиной от 3 до 256 символов (должно быть уникальным в пределах раздела);

    • Описание — произвольное текстовое описание папки.

  4. Нажмите Сохранить.

В случае изменения наименования папки оно автоматически отображается в свойствах расположенных в ней объектов.

Перемещение папки

Допускается изменять расположение папки в дереве, за исключением следующих случаев:

  • перемещение корневой папки;

  • перемещение папки в дочернюю.

Чтобы изменить расположение папки в дереве:

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

  2. На панели с деревом папок нажмите правой кнопкой мыши на перемещаемой папке и в меню действий выберите Переместить.

    folder tree actions menu move
    Рис. 6. Меню действий для работы с папками в дереве
  3. В диалоговом окне перемещения папки укажите новое расположение.

    folder tree move folder dialog
    Рис. 7. Диалоговое окно выбора расположения
  4. Нажмите Переместить.

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

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

Удаление папки

Допускается удалять любые существующие папки в дереве, кроме корневой.

Чтобы удалить существующую папку из дерева:

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

  2. На панели с деревом папок нажмите правой кнопкой мыши на удаляемой папке и в меню действий выберите Удалить.

    folder tree actions menu delete
    Рис. 8. Меню действий для работы с папками в дереве
  3. Подтвердите удаление.

В результате операции:

  • папка удаляется из дерева вместе со всеми дочерними папками;

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

Управление расположением экземпляра сущности

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

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

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

Чтобы перенести один или несколько экземпляров сущности, поддерживающей распределение по папкам, из одной папки в другую:

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

  2. На панели с деревом папок выберите папку, содержащую перемещаемые экземпляры сущности.

  3. В таблице рабочей области выберите один или несколько экземпляров сущности для перемещения.

    folder tree select multiple instances to move
    Рис. 9. Выбор нескольких экземпляров сущности для перемещения
  4. На панели быстрого просмотра нажмите Переместить.

  5. В диалоговом окне перемещения укажите новое расположение.

    folder tree move folder dialog
    Рис. 10. Диалоговое окно выбора расположения
  6. Нажмите Переместить.

У выбранных экземпляров сущности изменяется значение атрибута Расположение. Дальнейшая работа с ними ведется в контексте новой папки.