Коллекции

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

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

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

подсказка

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

---

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

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

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

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

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

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

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

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

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

2. Рабочая область (панель настройки коллекции) Рис. 3

   Рисунок 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]: для выбора вышестоящей ветки в иерархии дерева коллекций;

• Блок Фильтр коллекции Рис. 4 [4]: встроенный конструктор динамических запросов (с поддержкой логических операторов, например, AND, и групп фильтров) для автоматического отбора клиентов, попадающих в коллекцию.
  Ниже отображается предварительный список клиентов, соответствующих заданным условиям фильтрации.

  примечание

  Блок Фильтр коллекции функционирует аналогично фильтру коллекции, описанному в разделе Фильтр коллекции.

  При активации кнопки Свободный ввод Рис. 4 [7] открывается текстовое поле с поддержкой JSON (фигурные скобки {} устанавливаются по умолчанию для обозначения объекта фильтра коллекции);

  к сведению

  Подробнее о кнопке Свободный ввод Рис. 4 [7]:

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

  
  Рисунок 5. Режим свободного ввода фильтрации в окне создания новой коллекции

• Кнопки управления:

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

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

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

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

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

1. Выберите ее из списка в навигационной панели Рис. 7 и нажмите ее строку.

   Рисунок 7. Список коллекции в навигационной панели
   

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

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

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

к сведению

В дереве коллекций поддерживается изменение структуры и порядка элементов с помощью перетаскивания (Drag&Drop):

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

ВНИМАНИЕ

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

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

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

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

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

2. Отредактируйте иерархию коллекций.

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

   к сведению

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

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

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

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