Создание/редактирование коллекции устройств

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

SQL-запроса;
набора правил.

Создание коллекции с помощью SQL-запроса

Для создания коллекции устройств:

На боковой панели главной страницы выберите Коллекции устройств.
Нажмите на кнопку Создать и в выпадающем списке выберите С помощью SQL-запроса:

В открывшейся форме заполните поля:

Имя — имя коллекции (должно быть уникальным);
Описание — краткое описание коллекции;
Обновление коллекции:
- Не обновлять — обновление коллекции возможно только в ручном режиме (статическая коллекция);
- Ежедневно — обновление коллекции происходит ежедневно в заданное время (динамическая коллекция);
- Еженедельно — обновление коллекции происходит еженедельно в заданный день недели (или несколько дней) и заданное время (динамическая коллекция);
- Ежемесячно — обновление коллекции происходит ежемесячно в заданное число месяца и время (динамическая коллекция);

SQL-запрос для формирования списка устройств в составе коллекции.

При использовании некорректного запроса коллекция не будет создана и сохранена. Правила составления SQL-запроса см. в разделе «Требования к SQL-запросу».

Нажмите на кнопку Выполнить.

Происходит валидация SQL-запроса:
- если SQL-запрос выполнился с ошибкой, то выводится предупреждение:
- если SQL-запрос выполнился без ошибки, то выводится список устройств, добавленных в коллекцию, и сообщение об успешной валидации запроса:
  
  Корректно созданный SQL-запрос можно сохранить в виде шаблона и переиспользовать его при создании/редактировании коллекций устройств.
  
  Для создания шаблона:
  1. Напишите SQL-запрос и нажмите на кнопку Выполнить.
  2. Если SQL-запрос выполнился без ошибки, то нажмите на Сохранить шаблон.
  3. Введите название шаблона (должно быть уникальным) и нажмите на кнопку Сохранить.
    
    Для использования сохраненного шаблона:
    
    Нажмите на Использовать шаблон.
    
    В строке поиска наберите название шаблона или выберите его из выпадающего списка.
    
    Подтвердите использование шаблона нажав на кнопку Использовать.
Нажмите на кнопку Создать.

Кнопка Создать активна только в случае выполнения SQL-запроса без ошибок.

Для редактирования коллекции устройств:

На боковой панели главной страницы выберите Коллекции устройств.
Выберите коллекцию устройств.
В окне быстрого просмотра нажмите на Редактировать.

Внесите изменения в коллекцию:

Если изменения затрагивают непосредственно SQL-запрос, то перед сохранением изменений необходимо провалидировать запрос, нажав на Выполнить.

Нажмите на кнопку Сохранить.

Требования к SQL-запросу

SQL-запрос должен иметь тип select и в списке извлекаемых колонок содержать столбец minion_id.

При создании SQL-запроса нельзя использовать следующие операторы:

drop;
alter;
create;
update;
delete;
insert;
truncate.

Шаблоны SQL-запросов

Запрос с использованием базовой информации по пользователям и устройствам:

select m.minion_id
from users u
join user_machine_mappings umm on umm.user_fdn = u.full_domain_name
join machines m on m.fqdn = umm.machine_fqdn
where <...>

Запрос с использованием подробной информации по устройствам:

select m.minion_id
from machines m
left join machine_disks md on md.minion_id = m.minion_id
left join machine_networks mn on mn.minion_id = m.minion_id
where <...>

Запрос с использованием информации, доступной в модуле «Инвентаризация»:

select m.minion_id
from users u
join user_machine_mappings umm on umm.user_fdn = u.full_domain_name
join machines m on m.fqdn = umm.machine_fqdn
left join machine_disks md on md.minion_id = m.minion_id
left join machine_networks mn on mn.minion_id = m.minion_id
where <...>

Создание коллекции с помощью набора правил

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

Для создания коллекции устройств:

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

В открывшейся форме заполните поля:

Имя — имя коллекции (должно быть уникальным);
Описание — краткое описание коллекции;
Обновление коллекции:
- Не обновлять — обновление коллекции возможно только в ручном режиме (статическая коллекция);
- Ежедневно — обновление коллекции происходит ежедневно в заданное время (динамическая коллекция);
- Еженедельно — обновление коллекции происходит еженедельно в заданный день недели (или несколько дней) и заданное время (динамическая коллекция);
- Ежемесячно — обновление коллекции происходит ежемесячно в заданное число месяца и время (динамическая коллекция);
набор правил вхождения устройств в коллекцию:
- Базовое множество (обязательно) — правило, в которое может быть добавлено получение набора устройств одним из способов:
  - из всего множества устройств (по умолчанию): чекбокс Включить в базовое множество все устройства:
  - из других коллекций.
    
    Для этого:
    
    Снимите чекбокс Включить в базовое множество все устройства.
    
    Нажмите на строку Найти и добавить коллекции и в выпадающем списке выберите коллекции:

Ограничение (опционально) — правила, в которых указываются ограничения на базовое множество.

Для добавления группы правил (при необходимости):

Нажмите на Добавить группу правил:
Нажмите на Добавить атрибут:

Из выпадающего списка выберите (или воспользуйтесь строкой поиска) атрибут.

При выборе атрибутов Пользовательский атрибут с типом "Дата" или Пользовательский атрибут с типом "Строка" на следующем шаге необходимо выбрать сам атрибут, который был ранее создан. Подробнее про создание атрибута см. раздел «Управление атрибутами».

Выберите значение атрибута.

В зависимости от выбранного атрибута в некоторых случаях требуется ввести значения атрибута. Например, для атрибута Дата выпуска BIOS необходимо ввести временной интервал:

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

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

Добавление группы правил выполняется так же, как и в разделе Ограничение.

Нажмите на кнопку Выполнить:

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

Например:

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

Для создания шаблона:
1. Создайте набор правил и нажмите на кнопку Выполнить.
2. Нажмите на Сохранить шаблон.
3. Введите название шаблона (должно быть уникальным) и нажмите на кнопку Сохранить.
  
  Для использования сохраненного шаблона:
  1. Нажмите на Использовать шаблон.
  2. В строке поиска наберите название шаблона или выберите его из выпадающего списка.
  3. Подтвердите использование шаблона, нажав на кнопку Использовать.
Нажмите на кнопку Создать.

Для редактирования коллекции устройств:

На боковой панели главной страницы выберите Коллекции устройств.
Выберите коллекцию устройств.
В окне быстрого просмотра нажмите на Редактировать.

Внесите изменения в коллекцию:

Если изменения затрагивают непосредственно набор правил, то перед сохранением изменений необходимо нажать на Выполнить.

Нажмите на кнопку Сохранить.