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

Текстовые параметры книги

  • Статья

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

Обычно текстовые поля используются так внутренние переменные, используемые другими элементами управления книги. Вы используете запрос для значений по умолчанию и делаете визуальный элемент ввода невидимым в режиме чтения. Например, вы можете сделать так, чтобы пороговое значение поступало из формулы (а не от пользователя), а затем использовать пороговое значение в последующих запросах.

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

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

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

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

    1. Имя параметра: SlowRequestThreshold
    2. Тип параметра: Text
    3. Требуется: checked
    4. Получать данные из: None

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

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

На этом снимке экрана показано, как книга выглядит в режиме чтения:

Снимок экрана: текстовый параметр в режиме чтения.

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

Текстовый параметр поддерживает следующие стили поля:

  • Стандартный: однострочное текстовое поле.

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

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

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

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

    • Текст
    • Markdown
    • JSON
    • SQL
    • TypeScript
    • KQL
    • TOML

    Вы также можете указать высоту для редактора многострочного текста.

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

Ссылка на текстовый параметр

  1. Выберите Добавить запрос, чтобы добавить элемент управления запросом, а затем выберите ресурс Application Insights.

  2. В поле KQL добавьте следующий фрагмент кода:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= {SlowRequestThreshold}) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  3. Используя текстовый параметр со значением 500 в сочетании с элементом управления запросом, вы фактически выполняете следующий запрос:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= 500) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  4. Выполните запрос, чтобы увидеть результаты.

    Снимок экрана: текстовый параметр, на который ссылается запрос KQL.

Примечание.

В приведенном выше примере {SlowRequestThreshold} представляет целочисленное значение. Если вы запрашиваете строку, например, {ComputerName}, вам потребуется изменить запрос Kusto и добавить кавычки вокруг "{ComputerName}", чтобы поле параметра принимало входные данные без кавычек.

Установка значений по умолчанию с помощью запросов

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

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

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

    1. Имя параметра: SlowRequestThreshold
    2. Тип параметра: Text
    3. Требуется: checked
    4. Получать данные из: Query

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

    requests
| summarize round(percentile(duration, 95), 2)

    Этот запрос задает для текстового поля значение по умолчанию 95-го процентиля продолжительности для всех запросов в приложении.

  5. Выполните запрос, чтобы увидеть результаты.

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

    Снимок экрана: текстовый параметр со значением по умолчанию из запроса KQL.

Примечание.

Хотя в этом примере запрашиваются данные Application Insights, такой подход можно использовать для любого источника данных на основе журналов — например, для Log Analytics и Azure Resource Graph.

Добавление проверок

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

Если выбрано соответствующее значение, поле является допустимым в том случае, когда значение соответствует регулярному выражению. Если соответствующее значение не выбрано, поле является допустимым в том случае, когда оно не соответствует регулярному выражению.

Снимок экрана: параметры проверки текста.

Форматирование данных JSON

Если для многострочного текстового поля выбран язык JSON, поле будет содержать кнопку, которая будет форматировать данные JSON поля. Для форматирования данных JSON также можно использовать сочетание клавиш CTRL+\.

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

Снимок экрана, на котором показан параметр

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

Начало работы с Azure Workbooks