Поделиться через

Многозначные параметры

  • Статья

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

Создание статического параметра с несколькими значениями

  1. Начните с пустой книги в режиме редактирования.

  2. Выберите Добавить параметры>Добавить параметр.

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

    • Имя параметра: Filter
    • Тип параметра: Multi-value
    • Требуется: unchecked
    • Получать данные из: None

  4. Нажмите кнопку Сохранить, чтобы создать параметр.

  5. Параметр Filter с несколькими значениями изначально не будет иметь ни одного значения.

    Снимок экрана: создание многозначного параметра в книге.

  6. Затем вы можете их добавить.

    Снимок экрана: добавление третьего значения в книгу.

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

    let computerFilter = dynamic([{Computer}]);
    Heartbeat
    | where array_length(computerFilter) == 0 or Computer in (computerFilter)
    | summarize Heartbeats = count() by Computer
    | order by Heartbeats desc

Стиль поля параметров

Многозначный параметр поддерживает следующие стили поля:

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

    Снимок экрана: стандартное многозначное поле книги.

  2. Пароль: можно добавлять и удалять произвольные поля пароля. Значения паролей скрыты только в пользовательском интерфейсе при вводе. Значения по-прежнему полностью доступны как значение параметра при ссылке. Они сохраняются незашифрованными при сохранении книги.

    Снимок экрана: многозначное поле пароля книги.

Создайте многозначный параметр с начальными значениями

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

  1. Начните с пустой книги в режиме редактирования.

  2. Выберите Добавить параметры>Добавить параметр.

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

    • Имя параметра: Filter
    • Тип параметра: Multi-value
    • Требуется: unchecked
    • Получать данные из: JSON

  4. Вставьте следующий фрагмент JSON в блок входных текстовых данных JSON:

    ["apple", "banana", "carrot" ]

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

  5. Снова выберите Выполнение запроса.

  6. Нажмите кнопку Сохранить, чтобы создать параметр.

  7. Параметр Filter с несколькими значениями будет иметь три начальных значения.

    Снимок экрана: создание динамического раскрывающегося списка в книге.

Следующие шаги