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

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

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

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

  1. На боковой панели главной страницы выберите Коллекции устройств.

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

    col cr

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

    col cr2

    • Имя — имя коллекции (должно быть уникальным);

    • Описание — краткое описание коллекции;

    • Обновление коллекции:

      • Не обновлять — обновление коллекции возможно только в ручном режиме (статическая коллекция);

      • Ежедневно — обновление коллекции происходит ежедневно, один или несколько раз в день. При настройке обновления коллекции несколько раз в день можно установить временной интервал (динамическая коллекция);

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

      • Ежемесячно — обновление коллекции происходит ежемесячно в заданное число месяца и время (динамическая коллекция);

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

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

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

    Происходит валидация SQL-запроса:

    • если SQL-запрос выполнился с ошибкой, то выводится предупреждение:

      col cr3

    • если SQL-запрос выполнился без ошибки, то выводится список устройств, добавленных в коллекцию, и сообщение об успешной валидации запроса:

      col cr4

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

      Для создания шаблона:

      1. Напишите SQL-запрос и нажмите на кнопку Выполнить.

      2. Если SQL-запрос выполнился без ошибки, то нажмите на Сохранить шаблон.

      3. Введите название шаблона (должно быть уникальным) и нажмите на кнопку Сохранить.

        Для использования сохраненного шаблона:

        1. Нажмите на Использовать шаблон.

        2. В строке поиска наберите название шаблона или выберите его из выпадающего списка.

        3. Подтвердите использование шаблона нажав на кнопку Использовать.

  5. Нажмите на кнопку Создать.

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

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

  1. На боковой панели главной страницы выберите Коллекции устройств.

  2. Выберите коллекцию устройств.

  3. В окне быстрого просмотра нажмите на Редактировать.

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

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

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

Если коллекция устройств в текущий момент редактируется другим администратором, то появится информационное окно:

col edit3

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

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

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

  • drop;

  • alter;

  • create;

  • update;

  • delete;

  • insert;

  • truncate.

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

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

    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 <...>

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

    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 <...>

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

    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 <...>

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

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

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

  1. На боковой панели главной страницы выберите Коллекции устройств.

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

    col cr11

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

    col cr12

    • Имя — имя коллекции (должно быть уникальным);

    • Описание — краткое описание коллекции;

    • Обновление коллекции:

      • Не обновлять — обновление коллекции возможно только в ручном режиме (статическая коллекция);

      • Ежедневно — обновление коллекции происходит ежедневно, один или несколько раз в день, с установленным интервалом (динамическая коллекция);

      • Еженедельно — обновление коллекции происходит ежедневно, один или несколько раз в день. При настройке обновления коллекции несколько раз в день можно установить временной интервал (динамическая коллекция);

      • Ежемесячно — обновление коллекции происходит ежемесячно в заданное число месяца и время (динамическая коллекция);

    • набор правил вхождения устройств в коллекцию:

      • Базовое множество (обязательно) — правило, в которое может быть добавлено получение набора устройств одним из способов:

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

          col cr14

        • из других коллекций.

          Для этого:

          1. Снимите чекбокс Включить в базовое множество все устройства.

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

            col cr13

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

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

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

        col cr13 1

      2. Нажмите на Добавить атрибут:

        col cr13 2

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

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

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

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

        col cr16

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

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

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

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

    col cr17

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

    Например:

    col cr18

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

    Для создания шаблона:

    1. Создайте набор правил и нажмите на кнопку Выполнить.

    2. Нажмите на Сохранить шаблон.

    3. Введите название шаблона (должно быть уникальным) и нажмите на кнопку Сохранить.

      Для использования сохраненного шаблона:

      1. Нажмите на Использовать шаблон.

      2. В строке поиска наберите название шаблона или выберите его из выпадающего списка.

      3. Подтвердите использование шаблона, нажав на кнопку Использовать.

  5. Нажмите на кнопку Создать.

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

  1. На боковой панели главной страницы выберите Коллекции устройств.

  2. Выберите коллекцию устройств.

  3. В окне быстрого просмотра нажмите на Редактировать.

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

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

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

Если коллекция устройств в текущий момент редактируется другим администратором, то появится информационное окно:

col edit3