Dela via


Flervärdesparametrar

Med en flervärdesparameter kan användaren ange ett eller flera godtyckliga textvärden. Flervärdesparametrar används ofta för filtrering, ofta när en listrutekontroll kan innehålla för många värden för att vara användbar.

Skapa en statisk flervärdesparameter

  1. Börja med en tom arbetsbok i redigeringsläge.

  2. Välj Lägg till parametrar>Lägg till parameter.

  3. I det nya parameterfönstret som öppnas anger du:

    • Parameternamn: Filter
    • Parametertyp: Multi-value
    • Krävs: unchecked
    • Hämta data från: None
  4. Välj Spara för att skapa parametern .

  5. Filterparametern är en flervärdesparameter, inledningsvis utan värden.

    Skärmbild som visar hur du skapar en flervärdesparameter i en arbetsbok.

  6. Du kan sedan lägga till flera värden.

    Skärmbild som visar hur du lägger till ett tredje värde i en arbetsbok.

En flervärdesparameter fungerar på samma sätt som en listruteparameter med flera val och används ofta i ett "in"-liknande scenario.

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

Parameterfältformat

En flervärdesparameter stöder följande fältformat:

  1. Standard: Gör att du kan lägga till eller ta bort godtyckliga textobjekt.

    Skärmbild som visar arbetsbokens standardfält med flera värden.

  2. Lösenord: Gör att du kan lägga till eller ta bort fält för godtyckliga lösenord. Lösenordsvärdena döljs bara i användargränssnittet när du skriver. Värdena är fortfarande helt tillgängliga som ett parametervärde när de refereras. De lagras okrypterade när arbetsboken sparas.

    Skärmbild som visar ett flervärdesfält för arbetsbokslösenord.

Skapa en flervärdesparameter med inledande värden

Du kan använda en fråga för att ange flervärdesparametern med inledande värden. Du kan sedan ta bort värden manuellt eller lägga till fler värden. Om en fråga används för att fylla i flervärdesparametern visas en återställningsstandardknapp på parametern för att återställa tillbaka till de ursprungligen efterfrågade värdena.

  1. Börja med en tom arbetsbok i redigeringsläge.

  2. Välj Lägg till parametrar>Lägg till parameter.

  3. I det nya parameterfönstret som öppnas anger du:

    • Parameternamn: Filter
    • Parametertyp: Multi-value
    • Krävs: unchecked
    • Hämta data från: JSON
  4. Infoga det här JSON-kodfragmentet i textblocket JSON-indata :

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

    Alla objekt som är resultatet av frågan visas som flervärdesobjekt. Du är inte begränsad till JSON. Du kan använda valfri frågeprovider för att ange inledande värden, men du begränsas till de första 100 resultaten.

  5. Välj Kör fråga.

  6. Välj Spara för att skapa parametern .

  7. Parametern Filter är en flervärdesparameter med tre inledande värden.

    Skärmbild som visar skapandet av en dynamisk listruta i en arbetsbok.

Nästa steg