Munkafüzet legördülő paraméterei

  • Cikk

A legördülő paraméterek használatával egy vagy több bemeneti értéket gyűjthet egy ismert készletből. Egy legördülő paraméterrel például kiválaszthatja az alkalmazás egyik kérését. A legördülő paraméterek felhasználóbarát módot biztosítanak a felhasználók tetszőleges bemeneteinek gyűjtésére is. A legördülő paraméterek különösen hasznosak az interaktív jelentések szűrésének engedélyezésében.

A legördülő paraméterek megadásának legegyszerűbb módja, ha statikus listát ad meg a paraméterbeállításban. Érdekesebb módszer a lista dinamikus lekérése egy KQL-lekérdezésen keresztül. Paraméterbeállítások használatával azt is megadhatja, hogy egyszeri vagy többszörös kiválasztásról van-e szó. Több kijelölése esetén megadhatja, hogyan kell formázni az eredményhalmazt, például elválasztóként vagy idézőjelként.

Statikus legördülő paraméter létrehozása

  1. Kezdje egy üres munkafüzettel szerkesztési módban.

  2. Válassza a Paraméterek>hozzáadása paraméter hozzáadása lehetőséget.

  3. A megnyíló új paraméterpanelen adja meg a következőt:

    1. Paraméter neve: Environment
    2. Paraméter típusa: Drop down
    3. Kötelező: checked
    4. Több kijelölés engedélyezése: unchecked
    5. Adatok lekérése a következő forrásból: JSON

  4. A JSON bemeneti szövegblokkjában szúrja be ezt a JSON-kódrészletet:

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

  5. Válassza a Frissítés lehetőséget.

  6. A paraméter létrehozásához válassza a Mentés lehetőséget.

  7. A Környezeti paraméter egy legördülő lista, amely a három értéket tartalmazza.

    Screenshot that shows the creation of a static dropdown parameter.

Statikus legördülő lista létrehozása elemek csoportjaival

Ha a lekérdezés eredménye/JSON tartalmaz egy group mezőt, a legördülő lista értékcsoportokat jelenít meg. Kövesse az előző mintát, de használja inkább a következő JSON-t:

[
    { "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.

Dinamikus legördülő paraméter létrehozása

  1. Kezdje egy üres munkafüzettel szerkesztési módban.

  2. Válassza a Paraméterek>hozzáadása paraméter hozzáadása lehetőséget.

  3. A megnyíló új paraméterpanelen adja meg a következőt:

    1. Paraméter neve: RequestName
    2. Paraméter típusa: Drop down
    3. Kötelező: checked
    4. Több kijelölés engedélyezése: unchecked
    5. Adatok lekérése a következő forrásból: Query

  4. A JSON bemeneti szövegblokkjában szúrja be ezt a JSON-kódrészletet:

        requests
    | summarize by name
    | order by name asc

  5. Válassza a Lekérdezés futtatása lehetőséget.

  6. A paraméter létrehozásához válassza a Mentés lehetőséget.

  7. A RequestName paraméter egy legördülő lista, amelyben az alkalmazás összes kérésének neve szerepel.

    Screenshot that shows the creation of a dynamic dropdown parameter.

Hivatkozás legördülő paraméterre

A legördülő paraméterekre hivatkozhat.

KQL-ben

  1. A lekérdezésvezérlő hozzáadásához válassza a Lekérdezés hozzáadása lehetőséget, majd válasszon egy alkalmazás Elemzések erőforrást.

  2. A KQL-szerkesztőben adja meg ezt a kódrészletet:

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

  3. A kódrészlet a lekérdezések kiértékelési ideje alatt a következőre bővül:

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

  4. Futtassa a lekérdezést az eredmények megtekintéséhez. Igény szerint diagramként is megjelenítheti.

    Screenshot that shows a dropdown parameter referenced in KQL.

Paraméterérték, címke, kijelölés és csoport

Az előző dinamikus legördülő paraméterben használt lekérdezés a legördülő listában hűen megjelenített értékek listáját adja vissza. De mi a teendő, ha egy másik megjelenítendő nevet vagy egy nevet szeretne kijelölni? A legördülő paraméterek értékeket, címkét, kijelölést és csoportosítási oszlopokat használnak ehhez a funkcióhoz.

Az alábbi minta bemutatja, hogyan szerezheti be az alkalmazás Elemzések olyan függőségek listáját, amelyek megjelenítendő neve emojival van stílusban, az első ki van jelölve, és műveletnevek szerint van csoportosítva:

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.

Paraméter Leírás Példa
{DependencyName} A kijelölt érték GET fabrikamaccount
{DependencyName:label} A kijelölt címke 🌐 GET fabrikamaccount
{DependencyName:value} A kijelölt érték GET fabrikamaccount

Több kijelölés

Az eddigi példák kifejezetten úgy állítják be a paramétert, hogy csak egy értéket válasszanak ki a legördülő listában. A legördülő paraméterek több kijelölést is támogatnak. A beállítás engedélyezéséhez jelölje be a Több kijelölés engedélyezése jelölőnégyzetet.

Az eredményhalmaz formátumát az Elválasztó és az Árajánlat beállításokkal adhatja meg. Az alapértelmezett értékeket gyűjteményként adja vissza a, b, c formátumban. A kijelölések számát is korlátozhatja.

A paraméterre hivatkozó KQL-nek módosítania kell az eredmény formátumának használatához. Az engedélyezés leggyakoribb módja az operátoron keresztül in történik.

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

Ez a példa a munkahelyi többszörös kiválasztású legördülő paramétert mutatja be:

Screenshot that shows a multi-select dropdown parameter.

A legördülő paraméterekkel speciális értékeket is megadhat, amelyek a legördülő menüben is megjelennek:

  • Bármelyik
  • Bármelyik három
  • ...
  • Bármely 100
  • Bármilyen egyéni korlát
  • Mind

Ha ezeket a speciális elemeket választja ki, a paraméter értéke automatikusan a megadott számú elemre vagy az összes értékre lesz beállítva.

Minden speciális burkolat

Az Összes lehetőség kiválasztásakor megjelenik egy további mező, amely lehetővé teszi annak megadását, hogy a paraméterhez egy speciális érték legyen használva, ha a Minden beállítás van kiválasztva. Ez a különleges érték olyan esetekben hasznos, amikor az "Összes" nagy számú elem lehet, és nagyon nagy lekérdezést hozhat létre.

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.

Ebben az esetben a sztring [] érték helyett használatos. Ez a sztring egy üres tömb létrehozására használható a naplók lekérdezésében, például:

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

Ha az összes elem ki van jelölve, az érték Selection az [], amely egy üres tömböt hoz létre a selection változóhoz a lekérdezésben. Ha nincs kijelölve érték, akkor az érték Selection egy üres sztring lesz, amely szintén üres tömböt eredményez. Ha valamelyik érték ki van jelölve, azok a lekérdezés dinamikus részén belül vannak formázva, így a tömbben ezek az értékek szerepelnek. Ezután tesztelheti array_length a 0 értéket, hogy a szűrő ne legyen alkalmazva, vagy használja az in operátort a tömb értékeinek szűrésére.

Más gyakori példák a "*" értéket használják speciális jelölőértékként, amikor paraméterre van szükség, majd tesztelje a következőkkel:

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

További lépések

Ismerje meg, hogy milyen vizualizációk használatával hozhat létre gazdag vizualizációs jelentéseket az Azure-munkafüzetekkel.