Sdílet prostřednictvím


Použití parametrů v řídicích panelech v reálném čase

Parametry se používají jako stavební bloky pro filtry v řídicích panelech v reálném čase. Spravují se v oboru řídicího panelu a dají se přidat do dotazů pro filtrování dat prezentovaných podkladovým vizuálem. Dotaz může použít jeden nebo více parametrů.

Tento dokument popisuje vytvoření a použití parametrů a propojených filtrů na řídicích panelech. Parametry lze použít k filtrování vizuálů řídicího panelu výběrem hodnot parametrů na panelu filtru nebo pomocí křížových filtrů.

Příklady dotazů použité v tomto článku jsou založené na tabulce StormEvents v ukázkových datech analýzy počasí dostupných v galerii ukázek.

Poznámka:

Správa parametrů je dostupná v režimu úprav pro editory řídicích panelů.

Požadavky

Zobrazení seznamu parametrů

Pokud chcete zobrazit seznam všech parametrů řídicího panelu, vyberte Spravovat>parametry.

Vytvoření parametru

Vytvoření parametru:

  1. V horní nabídce vyberte tlačítko Nové parametry. Otevře se podokno Parametry .
  2. Vyberte tlačítko + Přidat v horní části pravého podokna.
  3. Vyplňte příslušné vlastnosti parametru.
  4. Výběrem možnosti Hotovo vytvořte parametr.

Vlastnosti

V podokně Přidat parametr nakonfigurujte následující vlastnosti.

Pole Popis
Popisek Název parametru zobrazeného na řídicím panelu nebo na kartě pro úpravy
Typ parametru Jeden z následujících parametrů:
- Jeden výběr: Jako vstup pro parametr lze vybrat pouze jednu hodnotu ve filtru.
- Vícenásobný výběr: Jednu nebo více hodnot lze ve filtru vybrat jako vstupy pro parametr.
- Časový rozsah: Umožňuje vytvářet další parametry pro filtrování dotazů a řídicích panelů na základě času. Každý řídicí panel má ve výchozím nastavení výběr časového rozsahu.
- Volný text: Ve filtru nejsou vyplněné žádné hodnoty. Uživatel může zadat hodnotu nebo zkopírovat nebo vložit hodnotu do textového pole. Filtr uchovává použité poslední hodnoty.
Popis Volitelný popis parametru.
Název proměnné Název parametru, který se má použít v dotazu.
Datový typ Datový typ hodnot parametrů.
Zobrazit na stránkách Vyberte stránky, na kterých se tento parametr zobrazí. Možnost Vybrat vše zobrazuje parametr na všech stránkách.
Source Zdroj hodnot parametrů:
- Pevné hodnoty: Ručně zavedly statické hodnoty filtru.
- Dotaz: Dynamicky zavedené hodnoty pomocí dotazu KQL
Přidat hodnotu Vybrat vše Platí pouze pro jeden výběr a více typů parametrů výběru. Slouží k načtení dat pro všechny hodnoty parametrů. Tato hodnota by měla být součástí dotazu, aby poskytovala funkce. Další příklady při vytváření těchto dotazů najdete v tématu Použití parametru založeného na dotazu s vícenásobným výběrem.
Výchozí hodnota Výchozí hodnota filtru. Filtr vždy začíná výchozí hodnotou při počátečním vykreslení řídicího panelu.

Správa parametrů

Po výběru parametrů z horního panelu můžete zobrazit seznam existujících parametrů. Na každé kartě parametru můžete vybrat widget tužky pro úpravu parametru nebo vybrat nabídku Více [...] duplikovat, Odstranit nebo přesunout parametr.

Na kartě parametru se dají zobrazit následující indikátory:

  • Zobrazovaný název parametru
  • Názvy proměnných
  • Počet dotazů, ve kterých byl parametr použit
  • Stránky, ke které je parametr připnut

Karty parametrů můžete změnit přetažením nebo pomocí možnosti Přesunout do > .

Snímek obrazovky s ukázkovými kartami parametrů

Použití parametrů v dotazu

Parametr musí být použit v dotazu, aby byl filtr použitelný pro daný vizuál dotazu. Po definování můžete zobrazit parametry v horním panelu > a v intellisense dotazu.

Poznámka:

Pokud se parametr v dotazu nepoužívá, filtr zůstane neaktivní. Po přidání parametru do dotazu se filtr aktivuje.

Typy parametrů

Podporuje se několik typů parametrů řídicího panelu:

Následující příklady popisují použití parametrů v dotazu pro různé typy parametrů.

Výchozí parametr časového rozsahu

Ve výchozím nastavení má každý řídicí panel parametr časového rozsahu . Zobrazí se na řídicím panelu jako filtr, pouze pokud se používá v dotazu. Použijte klíčová slova _startTime parametru a _endTime použijte výchozí parametr časového rozsahu v dotazu, jak je vidět v následujícím příkladu:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Po uložení se na řídicím panelu zobrazí filtr časového rozsahu. Teď ho můžete použít k filtrování dat na kartě. Řídicí panel můžete filtrovat tak, že vyberete z rozevíracího seznamu: Časový rozsah (posledních x minut, hodiny/dny) nebo vlastní časový rozsah.

filtrování pomocí vlastního časového rozsahu.

Parametry s pevnými hodnotami s jedním výběrem

Parametry pevné hodnoty jsou založené na předdefinovaných hodnotách určených uživatelem. Následující příklad ukazuje, jak vytvořit parametr s pevnou hodnotou s jedním výběrem.

Vytvoření parametru s pevnými hodnotami s jedním výběrem

  1. Výběrem možnosti Parametry otevřete podokno Parametry a vyberte Nový parametr.

  2. Vyplňte podrobnosti následujícím způsobem:

    • Popisek: Typ události

    • Typ parametru: Jeden výběr

    • Název proměnné: _eventType

    • Datový typ: Řetězec

    • Připnout jako filtr řídicího panelu: zaškrtnuté

    • Zdroj: Pevné hodnoty

      V tomto příkladu použijte následující hodnoty:

      Hodnota Zobrazovaný název parametru
      Větrná bouře Bouře větru
      Krupobití Krupobití
      Velká voda Velká voda
      Sucho Sucho
      Počasí v zimě Zimní počasí
    • Přidání možnosti Vybrat všechny hodnoty: Nezaškrtnuto

    • Výchozí hodnota: Thunderstorm Wind

  3. Výběrem možnosti Hotovo vytvořte parametr.

Parametr se dá zobrazit v bočním podokně Parametry , ale aktuálně se nepoužívá v žádném vizuálu.

Použití parametru s pevnými hodnotami s jedním výběrem

  1. Spusťte ukázkový dotaz pomocí nového _eventType události pomocí názvu proměnné:

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType == _eventType
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

    Nový parametr se zobrazí v seznamu parametrů v horní části řídicího panelu.

  2. Výběrem různých hodnot aktualizujte vizuály.

    prvních pět výsledků událostí.

Parametry s pevnými hodnotami s vícenásobným výběrem

Parametry pevné hodnoty jsou založené na předdefinovaných hodnotách určených uživatelem. Následující příklad ukazuje, jak vytvořit a použít parametr s pevnou hodnotou s vícenásobným výběrem.

Vytvoření parametru s pevnými hodnotami s vícenásobným výběrem

  1. Výběrem možnosti Parametry otevřete podokno Parametry a vyberte Nový parametr.

  2. Vyplňte podrobnosti uvedené v části Použití parametru s pevnými hodnotami s jedním výběrem následujícími změnami:

    • Popisek: Typ události
    • Typ parametru: Vícenásobný výběr
    • Název proměnné: _eventType
  3. Výběrem možnosti Hotovo vytvořte parametr.

Nové parametry se dají zobrazit v bočním podokně Parametry , ale aktuálně se nepoužívají v žádném vizuálu.

Použití parametru s pevnými hodnotami s vícenásobným výběrem

  1. Spusťte ukázkový dotaz pomocí nového _eventType události pomocí proměnné.

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType in (_eventType) or isempty(_eventType)
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

    Nový parametr se zobrazí v seznamu parametrů v horní části řídicího panelu.

  2. Vyberte jednu nebo více různých hodnot, aby se vizuály aktualizovaly.

    vybrat společnosti.

Parametry založené na dotazu s jedním výběrem

Hodnoty parametrů založené na dotazu se načítají během načítání řídicího panelu spuštěním parametrového dotazu. Následující příklad ukazuje, jak vytvořit a použít parametr založený na dotazu s jedním výběrem.

Vytvoření parametru založeného na dotazu s jedním výběrem

  1. Výběrem možnosti Parametry otevřete podokno Parametry a vyberte Nový parametr.

  2. Vyplňte podrobnosti uvedené v části Použití parametru s pevnými hodnotami s jedním výběrem následujícími změnami:

    • Popisek: Stav

    • Název proměnné: _state

    • Zdroj: Dotaz

    • Zdroj dat: StormEventsSample

    • Vyberte Upravit dotaz a zadejte následující dotaz. Vyberte Hotovo.

      StormEvents
      | where StartTime between (_startTime.._endTime)
      | where EventType in (_eventType) or isempty(_eventType)
      | summarize TotalEvents = count() by State
      | top 5 by TotalEvents
      | project State
      
    • Hodnota: Stav

    • Zobrazovaný název: Stát

    • Výchozí hodnota: Zvolte výchozí hodnotu.

  3. Výběrem možnosti Hotovo vytvořte parametr.

Použití parametru založeného na dotazu s jedním výběrem

  1. Následující ukázkový dotaz s novým parametrem State používá proměnnou _state :

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType in (_eventType) or isempty(_eventType)
    | where State == _state
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

    Nový parametr se zobrazí v seznamu parametrů v horní části řídicího panelu.

  2. Výběrem různých hodnot aktualizujte vizuály.

Parametry založené na dotazu s vícenásobným výběrem

Hodnoty parametrů založené na dotazu se odvozují v době načtení řídicího panelu spuštěním dotazu zadaného uživatelem. Následující příklad ukazuje, jak vytvořit parametr založený na dotazu s vícenásobným výběrem:

Vytvoření parametru založeného na dotazu s vícenásobným výběrem

  1. Výběrem možnosti Parametry otevřete podokno Parametry a vyberte + Nový parametr.

  2. Vyplňte podrobnosti uvedené v části Použití parametru s pevnými hodnotami s jedním výběrem následujícími změnami:

    • Popisek: Stav
    • Typ parametru: Vícenásobný výběr
    • Název proměnné: _state
  3. Výběrem možnosti Hotovo vytvořte parametr.

Použití parametru založeného na dotazu s vícenásobným výběrem

  1. Následující ukázkový dotaz používá nový parametr State pomocí _state proměnné.

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType in (_eventType) or isempty(_eventType)
    | where State in (_state) or isempty(_state)
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

    Poznámka:

    Tato ukázka používá možnost Vybrat vše tak, že pomocí funkce vyhledá prázdné hodnoty isempty() .

    Nový parametr se zobrazí v seznamu parametrů v horní části řídicího panelu.

  2. Vyberte jednu nebo více různých hodnot, aby se vizuály aktualizovaly.

Parametry volného textu

Parametry volného textu neobsahují žádné hodnoty. Umožňují vám zavést vlastní hodnotu.

Vytvoření bezplatného textového parametru

  1. Výběrem možnosti Parametry otevřete podokno Parametry a vyberte + Nový parametr.
  2. Vyplňte podrobnosti následujícím způsobem:
    • Popisek: Stav
    • Typ parametru: Volný text
    • Název proměnné: _state
    • Datový typ: Řetězec
    • Výchozí hodnota: Žádná výchozí hodnota

Použití bezplatného textového parametru

  1. Spusťte ukázkový dotaz pomocí nového _state s použitím názvu proměnné:

    StormEvents
    | where StartTime between (_startTime.._endTime)
    | where EventType in (_eventType) or isempty(_eventType)
    | where State contains _state
    | summarize TotalEvents = count() by State
    | top 5 by TotalEvents
    

Parametry zdroje dat

Po přidání zdrojů dat do řídicího panelu můžete vytvořit parametr, který vybere jeden nebo více dostupných zdrojů dat. Tento parametr lze použít ve dlaždicích a dalších parametrech.

Vytvoření parametru zdroje dat

  1. Výběrem možnosti Parametry otevřete podokno Parametry a vyberte + Nový parametr.

  2. Vyplňte podrobnosti následujícím způsobem:

    • Popisek: Zdroj
    • Typ parametru: Zdroj dat
    • Zobrazit na stránkách: Vybrat vše
    • Hodnoty: Vybrat vše
    • Výchozí hodnota: StormEvents

    Snímek obrazovky s parametry zdroje dat

  3. Vyberte Hotovo.

Nový parametr je teď viditelný v seznamu parametrů v horní části řídicího panelu.

Použití parametru zdroje dat

  1. Přejděte na dotaz nové nebo existující dlaždice.

  2. Ve zdroji vyberte název nového parametru v části Parametry zdroje dat, například nový parametr Source .

    Snímek obrazovky s výběrem parametru zdroje dat v dotazu

  3. Vyberte Použít změny.

  4. Pomocí parametru Source změňte zdroj dat pro tento připojený dotaz.

Parametry křížových filtrů

Křížový filtr je funkce na řídicím panelu, která umožňuje vybrat hodnotu v jednom vizuálu a filtrovat data v jiných vizuálech na stejném řídicím panelu. Použití křížových filtrů dosáhne stejného výsledku jako výběr ekvivalentní hodnoty parametru v seznamu parametrů v horní části řídicího panelu.

Definování křížových filtrů

Pokud chcete vytvořit křížový filtr, musíte zapnout možnost ve vizuálu a pak zadat parametr, který se použije k filtrování dat.

  1. Přejděte na dotaz dlaždice, do které chcete přidat křížové filtry.

  2. Vyberte vizuál.

  3. V pravém podokně vyberte Interakce a zapněte křížové filtry.

  4. Volitelně můžete zadat typ interakce . Výchozí hodnota je Bod , kde můžete vybrat hodnotu ve vizuálu. Pokud chcete vybrat rozsah hodnot, například v časovém grafu, vyberte Možnost Přetáhnout.

  5. Zadejte sloupec, který se používá k zadání hodnoty, a parametr použitý k filtrování dotazu vizuálů.

    Důležité

    Sloupec a parametr musí být stejného datového typu.

Interakce s daty pomocí křížového filtru

Jakmile je křížový filtr definovaný, můžete ho použít k interakci s daty. Ve vizuálech, ve kterých jste definovali křížové filtry, můžete vybrat datové body a použít jejich hodnoty k filtrování aktuální stránky řídicího panelu. U vizuálů tabulky vyberte datové body tak, že kliknete pravým tlačítkem myši na příslušnou buňku a v místní nabídce vyberete Křížový filtr.

Křížový filtr můžete resetovat tak , že v horní části vizuálu, kde byl vybraný, vyberte Obnovit .

Snímek obrazovky s vizuálem tabulky s tlačítkem Obnovit

Použití podrobných analýz jako parametrů řídicího panelu

Podrobné analýzy umožňují vybrat hodnotu ve vizuálu a použít ji k filtrování vizuálů na cílové stránce na stejném řídicím panelu. Po otevření cílové stránky se hodnota předem vybere v příslušných filtrech. Vizuály na stránce, jako jsou spojnicové nebo bodové grafy, jsou filtrované tak, aby zobrazovaly jenom související data. Tato funkce je užitečná při vytváření řídicích panelů s podrobnými analýzami ze souhrnné stránky na stránku podrobností. Informace o vytváření stránek najdete v tématu Přidání stránky.

Definování podrobné analýzy

Pokud chcete vytvořit podrobnou analýzu, musíte zapnout možnost ve vizuálu a pak zadat jeden nebo více parametrů podrobné analýzy, které se používají k filtrování dat.

  1. Na primární stránce přejděte do režimu úprav .

  2. Upravte vizuál, do kterého chcete přidat podrobnou analýzu. Ujistěte se, že je vybraná karta Vizuál .

    Snímek obrazovky vizuálu řídicího panelu s možností upravit

  3. V pravém podokně vyberte Interakce a zapněte podrobnou analýzu.

    Snímek obrazovky se stránkou podrobné analýzy zobrazující možnost zapnutí

  4. V části Podrobná analýza vyberte Vytvořit nový a zadejte následující informace. Volitelně vyberte Přidat další dvojici a přidejte více parametrů pro cílovou stránku. Opakováním tohoto kroku přidáte podrobné analýzy na jiné stránky na aktuálním řídicím panelu pomocí různých parametrů.

    Pole Popis
    Cílová stránka Jednu nebo více cílových stránek pro přechod k podrobnostem pomocí definovaných parametrů.
    Column Sloupec výsledku dotazu, který se použije jako hodnota parametru na cílové stránce.
    Parametr Parametr použitý k filtrování vizuálů na cílové stránce pomocí hodnoty sloupce.
    Notes Volitelný krátký popis.

    Důležité

    Dvojice sloupců a parametrů musí být stejného datového typu.

    Snímek obrazovky s formulářem podrobné analýzy a zvýrazněním polí, která se mají vyplnit

Interakce s daty pomocí podrobných analýz

Jakmile jsou definovány podrobné analýzy, můžete je použít k interakci s daty. Uděláte to tak, že ve vizuálech nebo tabulkách, ve kterých jste definovali podrobnou analýzu, kliknete pravým tlačítkem myši na datový bod a pak vyberete Podrobnou analýzu k>cílové stránce. Hodnoty z datového bodu se používají jako parametry k filtrování vizuálů na cílové stránce.

Snímek obrazovky vizuálu řídicího panelu znázorňující interakci podrobné analýzy

Použití vyhledávání filtrů pro jeden a více filtrů výběru

Do jednoho a více filtrů výběru zadejte požadovanou hodnotu. Filtr se aktualizuje tak, aby zobrazoval jenom hodnoty odpovídající hledanému termínu.