Parametry rozevíracího seznamu sešitu

  • Článek

Pomocí parametrů rozevíracího seznamu můžete shromažďovat jednu nebo více vstupních hodnot ze známé sady. Pomocí parametru rozevíracího seznamu můžete například vybrat jeden z požadavků vaší aplikace. Parametry rozevíracího seznamu také poskytují uživatelsky přívětivý způsob shromažďování libovolných vstupů od uživatelů. Parametry rozevíracího seznamu jsou užitečné zejména při povolování filtrování v interaktivních sestavách.

Nejjednodušší způsob, jak zadat parametr rozevíracího seznamu, je poskytnutí statického seznamu v nastavení parametru. Zajímavější způsob je dynamicky získat seznam prostřednictvím dotazu KQL. Pomocí nastavení parametrů můžete také určit, jestli se jedná o jeden nebo vícenásobný výběr. Pokud se jedná o vícenásobný výběr, můžete určit, jak se má sada výsledků formátovat, například jako oddělovač nebo uvozovky.

Vytvoření parametru statického rozevíracího seznamu

  1. Začněte prázdným sešitem v režimu úprav.

  2. Vyberte Přidat parametry>Přidat parametr.

  3. V novém podokně parametrů, které se otevře, zadejte:

    1. Název parametru: Environment
    2. Typ parametru: Drop down
    3. Povinné: checked
    4. Povolit více výběrů: unchecked
    5. Získání dat z: JSON

  4. Do bloku vstupního textu JSON vložte tento fragment kódu JSON:

    [
    { "value":"dev", "label":"Development" },
    { "value":"ppe", "label":"Pre-production" },
    { "value":"prod", "label":"Production", "selected":true }
]

  5. Vyberte Aktualizovat.

  6. Výběrem možnosti Uložit vytvořte parametr.

  7. Parametr Prostředí je rozevírací seznam se třemi hodnotami.

    Screenshot that shows the creation of a static dropdown parameter.

Vytvoření statického rozevíracího seznamu se skupinami položek

Pokud výsledek dotazu nebo JSON obsahuje group pole, zobrazí se v rozevíracím seznamu skupiny hodnot. Postupujte podle předchozí ukázky, ale použijte místo toho následující json:

[
    { "value":"dev", "label":"Development", "group":"Development" },
    { "value":"dev-cloud", "label":"Development (Cloud)", "group":"Development" },
    { "value":"ppe", "label":"Pre-production", "group":"Test" },
    { "value":"ppe-test", "label":"Pre-production (Test)", "group":"Test" },
    { "value":"prod1", "label":"Prod 1", "selected":true, "group":"Production" },
    { "value":"prod2", "label":"Prod 2", "group":"Production" }
]

Screenshot that shows an example of a grouped dropdown list.

Vytvoření dynamického parametru rozevíracího seznamu

  1. Začněte prázdným sešitem v režimu úprav.

  2. Vyberte Přidat parametry>Přidat parametr.

  3. V novém podokně parametrů, které se otevře, zadejte:

    1. Název parametru: RequestName
    2. Typ parametru: Drop down
    3. Povinné: checked
    4. Povolit více výběrů: unchecked
    5. Získání dat z: Query

  4. Do bloku vstupního textu JSON vložte tento fragment kódu JSON:

        requests
    | summarize by name
    | order by name asc

  5. Vyberte Spustit dotaz.

  6. Výběrem možnosti Uložit vytvořte parametr.

  7. Parametr RequestName je rozevírací seznam s názvy všech požadavků v aplikaci.

    Screenshot that shows the creation of a dynamic dropdown parameter.

Odkazování na parametr rozevíracího seznamu

Můžete odkazovat na parametry rozevíracího seznamu.

V KQL

  1. Vyberte Přidat dotaz, chcete-li přidat ovládací prvek dotazu, a pak vyberte prostředek Přehledy aplikace.

  2. V editoru KQL zadejte tento fragment kódu:

        requests
    | where name == '{RequestName}'
    | summarize Requests = count() by bin(timestamp, 1h)

  3. Fragment kódu rozšiřuje čas vyhodnocení dotazu na:

        requests
    | where name == 'GET Home/Index'
    | summarize Requests = count() by bin(timestamp, 1h)

  4. Spuštěním dotazu zobrazte výsledky. Volitelně ho můžete vykreslit jako graf.

    Screenshot that shows a dropdown parameter referenced in KQL.

Hodnota parametru, popisek, výběr a skupina

Dotaz použitý v předchozím dynamickém rozevíracím seznamu vrátí seznam hodnot, které jsou vykresleny věrně v rozevíracím seznamu. Ale co když chcete vybrat jiný zobrazovaný název nebo jeden z názvů? Parametry rozevíracího seznamu používají pro tuto funkci hodnotu, popisek, výběr a sloupce skupiny.

Následující ukázka ukazuje, jak získat seznam závislostí Přehledy aplikací, jejichž zobrazované názvy jsou stylovány pomocí emoji, má první vybranou a seskupuje podle názvů operací:

dependencies
| summarize by operation_Name, name
| where name !contains ('.')
| order by name asc
| serialize Rank = row_number()
| project value = name, label = strcat('🌐 ', name), selected = iff(Rank == 1, true, false), group = operation_Name

Screenshot that shows a dropdown parameter using value, label, selection, and group options.

Parametr Popis Příklad
{DependencyName} Vybraná hodnota GET fabrikamaccount
{DependencyName:label} Vybraný popisek 🌐 GET fabrikamaccount
{DependencyName:value} Vybraná hodnota GET fabrikamaccount

Vícenásobný výběr

Dosud uvedené příklady explicitně nastavily parametr tak, aby v rozevíracím seznamu vybrali pouze jednu hodnotu. Parametry rozevíracího seznamu také podporují více výběrů. Pokud chcete tuto možnost povolit, zaškrtněte políčko Povolit více výběrů .

Formát sady výsledků můžete zadat pomocí oddělovače a uvozovek s nastavením. Výchozí hodnota vrátí hodnoty jako kolekci ve formě a, b, c. Můžete také omezit počet výběrů.

KQL odkazující na parametr se musí změnit, aby fungoval s formátem výsledku. Nejběžnější způsob, jak ho povolit, je prostřednictvím operátoru in .

dependencies
| where name in ({DependencyName})
| summarize Requests = count() by bin(timestamp, 1h), name

Tento příklad ukazuje parametr rozevíracího seznamu s vícenásobným výběrem v práci:

Screenshot that shows a multi-select dropdown parameter.

Parametry rozevíracího seznamu také umožňují zadat speciální hodnoty, které se zobrazí také v rozevíracím seznamu:

  • Libovolný z nich
  • Jakékoli tři
  • ...
  • Libovolných 100
  • Libovolný vlastní limit
  • Všechny

Při výběru těchto speciálních položek se hodnota parametru automaticky nastaví na konkrétní počet položek nebo všechny hodnoty.

Speciální velikost pouzdra – vše

Když vyberete možnost Vše , zobrazí se další pole, které umožňuje určit, že se pro parametr použije speciální hodnota, pokud je vybrána možnost Vše . Tato speciální hodnota je užitečná v případech, kdy "Vše" může být velký počet položek a může vygenerovat velmi velký dotaz.

Screenshot of the New Parameter window in the Azure portal. The All option is selected and the All option and Select All value field are highlighted.

V tomto konkrétním případě se řetězec [] použije místo hodnoty. Tento řetězec lze použít k vygenerování prázdného pole v dotazu protokolů, například:

let selection = dynamic([{Selection}]);
SomeQuery 
| where array_length(selection) == 0 or SomeField in (selection)

Pokud jsou vybrány všechny položky, hodnota Selection je [], vytvoří prázdné pole pro proměnnou selection v dotazu. Pokud nejsou vybrány žádné hodnoty, hodnota Selection bude prázdný řetězec, což také vede k prázdnému poli. Pokud jsou vybrány nějaké hodnoty, jsou formátovány uvnitř dynamické části dotazu, což způsobí, že pole bude mít tyto hodnoty. Potom můžete otestovat array_length hodnotu 0, aby filtr nebyl použit, nebo pomocí operátoru in vyfiltrovat hodnoty v matici.

Další běžné příklady používají jako speciální hodnotu značky, pokud je parametr povinný, a pak otestujte následující:

| where "*" in ({Selection}) or SomeField in ({Selection})

Další kroky

Seznamte se s typy vizualizací, které můžete použít k vytváření bohatých vizuálních sestav pomocí Azure Workbooks.