次の方法で共有


複数値パラメーター

複数値パラメーターを使用すると、ユーザーは 1 つ以上の任意のテキスト値を設定できます。 複数値パラメーターは多くの場合、フィルター処理に使用され、このような場合、ドロップダウン コントロールでは含まれる値が多すぎて役に立ちません。

静的な複数値パラメーターの作成

  1. 編集モードの空白のブックを使用して開始します。

  2. [パラメーターの追加]>[パラメーターの追加] を選びます。

  3. 表示される新しいパラメーター ペインで、次のように入力します。

    • パラメーター名: Filter
    • パラメーターの種類: Multi-value
    • 必須: unchecked
    • データの取得元: None
  4. [保存] を選び、パラメーターを作成します。

  5. Filter パラメーターは、最初は値のない複数値パラメーターになります。

    ブックでの複数値パラメーターの作成を示すスクリーンショット。

  6. 複数の値を追加できます。

    ブックへの 3 番目の値の追加を示すスクリーンショット。

複数値パラメーターは、複数選択ドロップダウン パラメーターと同様に動作し、"in" のようなシナリオでよく使用されます。

    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. パスワード: 任意のパスワード フィールドを追加または削除できます。 パスワード値は、入力するときに UI 上でのみ非表示になります。 この値は、参照時にパラメーター値として引き続き完全にアクセス可能です。 これらはブックの保存時に、暗号化されずに保存されます。

    ブックのパスワードの複数値フィールドを示すスクリーンショット。

初期値を使用した複数値パラメーターの作成

クエリを使用して、複数値パラメーターに初期値をシードできます。 その後、手動で値を削除または追加できます。 クエリを使用して複数値パラメーターを設定する場合は、最初にクエリされた値に戻すための [既定値に戻す] ボタンがパラメーターに表示されます。

  1. 編集モードの空白のブックを使用して開始します。

  2. [パラメーターの追加]>[パラメーターの追加] を選びます。

  3. 表示される新しいパラメーター ペインで、次のように入力します。

    • パラメーター名: Filter
    • パラメーターの種類: Multi-value
    • 必須: unchecked
    • データの取得元: JSON
  4. [JSON 入力] テキスト ブロックに、この JSON スニペットを挿入します。

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

    クエリの結果であるすべての項目は、複数値項目として表示されます。 JSON に限りません。 任意のクエリ プロバイダーを使用して初期値を指定できますが、結果は最初の 100 件に制限されます。

  5. [クエリの実行] を選択します。

  6. [保存] を選び、パラメーターを作成します。

  7. Filter パラメーターは、3 つの初期値を持つ複数値パラメーターになります。

    ブックでの動的ドロップダウンの作成を示すスクリーンショット。

次のステップ