Vervolgkeuzelijstsparameters voor werkmappen

Met behulp van vervolgkeuzelijstparameters kunt u een of meer invoerwaarden uit een bekende set verzamelen. U kunt bijvoorbeeld een vervolgkeuzelijst gebruiken om een van de aanvragen van uw app te selecteren. Vervolgkeuzelijstparameters bieden ook een gebruiksvriendelijke manier om willekeurige invoer van gebruikers te verzamelen. Vervolgkeuzelijstparameters zijn vooral handig bij het inschakelen van filters in uw interactieve rapporten.

De eenvoudigste manier om een vervolgkeuzelijst op te geven, is door een statische lijst op te geven in de parameterinstelling. Een interessantere manier is om de lijst dynamisch op te halen via een KQL-query. U kunt ook opgeven of het één of meerdere selecties is met behulp van parameterinstellingen. Als het meerdere selecties is, kunt u opgeven hoe de resultatenset moet worden opgemaakt, bijvoorbeeld als scheidingsteken of aanhalingsteken.

Een statische vervolgkeuzelijst maken

1. Begin met een lege werkmap in de bewerkingsmodus.

2. Selecteer Parameters toevoegen parameter toevoegen>.

3. Voer in het nieuwe parametervenster dat wordt geopend het volgende in:

   1. Parameternaam: Environment
   2. Parametertype: Drop down
   3. Vereist: checked
   4. Meerdere selecties toestaan: unchecked
   5. Gegevens ophalen uit: JSON

4. Voeg in het tekstblok JSON-invoer dit JSON-fragment in:

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

5. Selecteer Bijwerken.

6. Selecteer Opslaan om de parameter te maken.

7. De parameter Omgeving is een vervolgkeuzelijst met de drie waarden.

   

Een statische vervolgkeuzelijst maken met groepen items

Als uw queryresultaat/JSON een group veld bevat, worden in de vervolgkeuzelijst groepen waarden weergegeven. Volg het voorgaande voorbeeld, maar gebruik in plaats daarvan de volgende 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" }
]

Een dynamische vervolgkeuzelijst maken

1. Begin met een lege werkmap in de bewerkingsmodus.

2. Selecteer Parameters toevoegen parameter toevoegen>.

3. Voer in het nieuwe parametervenster dat wordt geopend het volgende in:

   1. Parameternaam: RequestName
   2. Parametertype: Drop down
   3. Vereist: checked
   4. Meerdere selecties toestaan: unchecked
   5. Gegevens ophalen uit: Query

4. Voeg in het tekstblok JSON-invoer dit JSON-fragment in:

       requests
       | summarize by name
       | order by name asc
   

5. Selecteer Query uitvoeren.

6. Selecteer Opslaan om de parameter te maken.

7. De parameter RequestName is een vervolgkeuzelijst met de namen van alle aanvragen in de app.

   

Naar een vervolgkeuzelijst-parameter verwijzen

U kunt verwijzen naar vervolgkeuzelijstparameters.

In KQL

1. Selecteer Query toevoegen om een querybeheer toe te voegen en selecteer vervolgens een Application Insights-resource.

2. Voer in de KQL-editor dit fragment in:

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

3. Het fragment breidt de tijd voor queryevaluatie uit naar:

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

4. Voer de query uit om de resultaten te bekijken. U kunt deze desgewenst weergeven als een grafiek.

   

Parameterwaarde, label, selectie en groep

De query die in de voorgaande dynamische vervolgkeuzelijst wordt gebruikt, retourneert een lijst met waarden die getrouw worden weergegeven in de vervolgkeuzelijst. Maar wat moet u doen als u een andere weergavenaam of een van de namen wilt selecteren? Voor deze functionaliteit gebruiken vervolgkeuzelijstsparameters waarde, label, selectie en groepeerkolommen.

In het volgende voorbeeld ziet u hoe u een lijst met Application Insights-afhankelijkheden krijgt waarvan de weergavenamen zijn gestijld met een emoji, de eerste is geselecteerd en wordt gegroepeerd op bewerkingsnamen:

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

Opties voor vervolgkeuzelijstparameter

Parameter	Description	Voorbeeld
{DependencyName}	De geselecteerde waarde	GET fabrikamaccount
{DependencyName:label}	Het geselecteerde label	🌐 GET fabrikamaccount
{DependencyName:value}	De geselecteerde waarde	GET fabrikamaccount

Meerdere selecties

In de voorbeelden tot nu toe is de parameter expliciet ingesteld om slechts één waarde in de vervolgkeuzelijst te selecteren. Vervolgkeuzelijstparameters ondersteunen ook meerdere selecties. Als u deze optie wilt inschakelen, schakelt u het selectievakje Meerdere selecties toestaan in.

U kunt de indeling van de resultatenset opgeven via het scheidingsteken en offerte met instellingen. De standaardwaarde retourneert de waarden als een verzameling in de vorm van a, b, c. U kunt ook het aantal selecties beperken.

De KQL die naar de parameter verwijst, moet worden gewijzigd om te werken met de indeling van het resultaat. De meest voorkomende manier om deze in te schakelen is via de in operator.

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

In dit voorbeeld ziet u de vervolgkeuzelijst met meerdere selecties op het werk:

Speciale selecties voor vervolgkeuzelijsten

Met vervolgkeuzelijstparameters kunt u ook speciale waarden opgeven die ook worden weergegeven in de vervolgkeuzelijst:

• Een van de twee
• Elke drie
• ...
• Elke 100
• Elke aangepaste limiet
• Alle

Wanneer deze speciale items zijn geselecteerd, wordt de parameterwaarde automatisch ingesteld op het specifieke aantal items of alle waarden.

Speciale behuizing Alle

Wanneer u de optie Alles selecteert, wordt er een extra veld weergegeven, waarmee u kunt opgeven dat een speciale waarde wordt gebruikt voor de parameter als de optie Alle is geselecteerd. Deze speciale waarde is handig voor gevallen waarin 'Alle' een groot aantal items kan zijn en een zeer grote query kan genereren.

In dit specifieke geval wordt de tekenreeks [] gebruikt in plaats van een waarde. Deze tekenreeks kan worden gebruikt om een lege matrix te genereren in de logboekquery, zoals:

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

Als alle items zijn geselecteerd, is de waarde Selection , []die een lege matrix voor de selection variabele in de query produceert. Als er geen waarden zijn geselecteerd, is de waarde Selection een lege tekenreeks, wat ook resulteert in een lege matrix. Als er waarden zijn geselecteerd, worden deze opgemaakt in het dynamische deel van de query, waardoor de matrix deze waarden heeft. U kunt vervolgens testen op array_length 0 om het filter niet toe te passen of de in operator te gebruiken om te filteren op de waarden in de matrix.

Andere veelvoorkomende voorbeelden gebruiken '*' als de speciale markeringswaarde wanneer een parameter is vereist en test vervolgens met:

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

Volgende stappen

Meer informatie over de typen visualisaties die u kunt gebruiken om uitgebreide visuele rapporten te maken met Azure Workbooks.