Перейти к основному содержимому
Версия: 0.3.0

Коллекции

Коллекция управляемых устройств — это логическое объединение управляемых устройств, сформированное по определённым критериям и используемое для организации совместного управления, мониторинга и администрирования входящих в него устройств.

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

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

подсказка

Практические сценарии использования коллекций рассмотрены в разделе Создание коллекций клиентов.


Интерфейс страницы «Коллекции»

Для перехода на страницу настройки коллекций в главном меню выберите пункт Настройки Рис. 1 [1].
На появившейся выдвижной панели в разделе Core выберите пункт Коллекции Рис. 1 [2].

Переход на страницу настройки коллекций
Рисунок 1. Переход на страницу настройки коллекций


Откроется страница Коллекции Рис. 2.

Интерфейс страницы "Коллекции"
Рисунок 2. Интерфейс страницы "Коллекции"


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

  1. Навигационная панель

    Навигационная панель содержит следующие элементы:

    • Поле поиска Рис. 2 [1]: интерактивная строка фильтрации, позволяющая находить коллекции по названию;
    • Область Иерархия коллекций Рис. 2 [2]: вложенные элементы отображаются в виде дерева с возможностью раскрытия и свёртывания его узлов;
    • Поле Корневой элемент Рис. 2 [3]: отображает Root collection как верхний уровень иерархии;
    • Кнопка ✚ (Создать подколлекцию) Рис. 2 [4]: появляется при наведении на элемент и позволяет быстро добавить дочернюю коллекцию в выбранный узел;
    • Кнопка Обновить Рис. 2 [5]: перезагружает дерево коллекций и актуализирует данные без перезагрузки страницы;
    • Кнопка Редактировать структуру Рис. 2 [6]: переключает интерфейс в режим управления иерархией.
  2. Рабочая область (панель настройки коллекции)

    Панель настройки коллекции
    Рисунок 3. Панель настройки коллекции


    При выборе конкретной коллекции в дереве навигации отображается выдвижная панель настройки коллекции Рис. 3, содержащая:

    • Кнопку Скопировать в буфер обмена Рис. 3 [1]: рядом с названием Root collection находится иконка для быстрого копирования идентификатора коллекции в буфер обмена;
    • Кнопку Перейти на страницу коллекции Рис. 3 [2]: в правом верхнем углу интерфейса доступна кнопка для перехода на страницу с полными настройками данной коллекции;
    • Кнопку ✚ (Создать подколлекцию)`Рис. 3 [3]: открывает форму добавления вложенной коллекции;
    • Поле Название коллекции Рис. 3 [4]: отображается в верхней части и служит основным идентификатором текущего контекста;
    • Поле Описание Рис. 3 [5]: описание для коллекции.
  3. Элемент взаимодействия (модальное окно Создание коллекции) появляется после нажатия кнопки ✚ (Создать подколлекцию) Рис. 3 [3])

    Окно создания новой коллекции
    Рисунок 4. Окно создания новой коллекции

Создание коллекции

Окно создания новой коллекции содержит Рис. 4:

  • Поля ввода:

    • Название Рис. 4 [1]: поле для ввода уникального имени коллекции;
    • Описание Рис. 4 [2]: поле для внесения пояснительной информации о назначении коллекции;
    • Фильтр коллекции Рис. 4 [3]: текстовое поле с поддержкой JSON (фигурные скобки {} устанавливаются по умолчанию для обозначения объекта фильтра коллекции);

    к сведению

    Подробнее о поле Фильтр коллекции:

    • Поле представляет собой встроенный редактор кода с нумерацией строк, предназначенный для формирования правил автоматической фильтрации и включения клиентов в коллекцию.
    • Логика отбора клиентов в коллекцию строится на основе сопоставления системных параметров, например, элементов grains, которые собираются с клиентских устройств (например, через префикс grains.os можно отбирать клиентов по операционной системе, как показано в примере со значением WindowsРис. 4 [3]).
  • Кнопки управления:

    • Отмена Рис. 4 [4]: закрывает модальное окно без сохранения введенных данных;
    • Создать Рис. 4 [5]: подтверждает сохранение новой коллекции с заданными параметрами.

При создании или сохранении коллекции после редактирования выводятся информационные сообщения (например, «Коллекция успешно создана» Рис. 5 или «Коллекция была изменена»).

Уведомление "Коллекция успешно создана"
Рисунок 5. Уведомление "Коллекция успешно создана"

Редактирование коллекции

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

  1. Выберите ее в навигационной панели Рис. 6 [1].

  2. В открывшейся панели настройки коллекции Рис. 6 [2] нажмите кнопку Редактировать Рис. 6 [3].

    Переход в режим редактирования коллекции
    Рисунок 6. Переход в режим редактирования коллекции

  3. В появившихся полях выполните необходимые изменения и нажмите кнопку Сохранить Рис. 7 [1].

    Окно редактирования коллекции
    Рисунок 7. Окно редактирования коллекции

Редактирование иерархии коллекций

В режиме редактирования структуры доступна операция переноса коллекции в другую родительскую коллекцию, исключая её дочерние коллекции.

Перенос является каскадным: коллекция перемещается вместе со всеми своими дочерними элементами (вложенным поддеревом).


ВНИМАНИЕ

Система автоматически блокирует логически некорректные операции:

  • перенос коллекции внутрь самой себя;
  • перенос коллекции внутрь любой из её дочерних коллекций;
  • изменение положения корневой коллекции (Root collection);
  • размещение в рамках одной коллекции двух дочерних коллекций с одинаковыми именами (при возникновении конфликта появляется соответствующее уведомление).

Для редактирования иерархии коллекций выполните следующие действия:

  1. На странице Коллекции активируйте кнопку Редактировать структуру Рис. 8 [1].

    Переход в режим редактирования иерархии коллекций
    Рисунок 8. Переход в режим редактирования иерархии коллекций
  2. Отредактируйте иерархию коллекций.

    Например, сделайте коллекции с названиями Windows и Alt linux Рис. 8 [2] вложенными в коллекцию Операционные системы Рис. 8 [3].

    к сведению

    В интерфейсе управления коллекциями реализована поддержка механизма Drag-and-Drop (перетаскивание мышью), предназначенная для изменения структуры и вложенности элементов.
    Над деревом коллекций отображается подсказка-инструкция: «Перетаскивайте коллекции, чтобы изменить их родителя» Рис. 8 [4].

    С помощью захвата мышью и перемещения конкретной коллекции (например, дочернего элемента Alt linux или Windows Рис. 8 [2]) можно изменять её уровень вложенности, привязывая к другому родительскому узлу дерева.

  3. По завершении редактирования Рис. 9 [1] деактивируйте кнопку Редактировать структуру Рис. 9 [2] и выйдите из режима редактирования.
    Изменения автоматически зафиксируются и сохранятся в системе.

    Редактирование иерархии коллекций
    Рисунок 9. Редактирование иерархии коллекций