Delen via

Werkmaptekstparameters

  • Artikel

Tekstvakparameters bieden een eenvoudige manier om tekstinvoer van werkmapgebruikers te verzamelen. Ze worden gebruikt wanneer het niet praktisch is om een vervolgkeuzelijst te gebruiken om de invoer te verzamelen, bijvoorbeeld met een willekeurige drempelwaarde of algemene filters. Met behulp van een werkmap kunt u de standaardwaarde van het tekstvak ophalen uit een query. Deze functionaliteit maakt interessante scenario's mogelijk, zoals het instellen van de standaarddrempel op basis van de p95 van de metrische waarde.

Een veelvoorkomend gebruik van tekstvakken is als interne variabelen die worden gebruikt door andere besturingselementen voor werkmappen. U gebruikt een query voor standaardwaarden en maakt het invoerbeheer onzichtbaar in de leesmodus. U wilt bijvoorbeeld dat een drempelwaarde afkomstig is van een formule, niet van een gebruiker en vervolgens de drempelwaarde in volgende query's gebruikt.

Een tekstparameter 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: SlowRequestThreshold
    2. Parametertype: Text
    3. Vereist: checked
    4. Gegevens ophalen uit: None

  4. Selecteer Opslaan om de parameter te maken.

    Schermopname van het maken van een tekstparameter.

In deze schermopname ziet u hoe de werkmap eruitziet in de leesmodus:

Schermopname van een tekstparameter in de leesmodus.

Parameterveldstijl

De tekstparameter ondersteunt de volgende veldstijlen:

  • Standaard: Een tekstveld met één regel.

    Schermopname van een standaardtekstveld.

  • Wachtwoord: een veld met één regelwachtwoord. De wachtwoordwaarde wordt alleen verborgen in de gebruikersinterface wanneer u typt. De waarde is volledig toegankelijk als parameterwaarde wanneer hierna wordt verwezen. De werkmap wordt niet-versleuteld opgeslagen wanneer de werkmap wordt opgeslagen.

    Schermopname van een wachtwoordveld.

  • Multiline: Een tekstveld met meerdere regels met ondersteuning voor rich IntelliSense en syntaxiskleuring voor de volgende talen:

    • Sms verzenden
    • Markdown
    • JSON
    • SQL
    • TypeScript
    • KQL
    • TOML

    U kunt ook de hoogte voor de editor met meerdere regels opgeven.

    Schermopname van een tekstveld met meerdere regels.

Naar een tekstparameter verwijzen

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

  2. Voeg in het vak KQL dit fragment toe:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= {SlowRequestThreshold}) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  3. Door de tekstparameter te gebruiken met een waarde van 500 in combinatie met het querybeheer, voert u de volgende query effectief uit:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= 500) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  4. Voer de query uit om de resultaten te bekijken.

    Schermopname van een tekstparameter waarnaar wordt verwezen in KQL.

Notitie

In het voorgaande voorbeeld {SlowRequestThreshold} vertegenwoordigt u een geheel getal. Als u een query uitvoert op een tekenreeks zoals {ComputerName}, moet u de Kusto-query wijzigen om aanhalingstekens "{ComputerName}" toe te voegen om het parameterveld een invoer zonder aanhalingstekens te laten accepteren.

De standaardwaarden instellen met query's

  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: SlowRequestThreshold
    2. Parametertype: Text
    3. Vereist: checked
    4. Gegevens ophalen uit: Query

  4. Voeg in het vak KQL dit fragment toe:

    requests
| summarize round(percentile(duration, 95), 2)

    Met deze query wordt de standaardwaarde van het tekstvak ingesteld op de 95e percentielduur voor alle aanvragen in de app.

  5. Voer de query uit om de resultaten te bekijken.

  6. Selecteer Opslaan om de parameter te maken.

    Schermopname van een tekstparameter met een standaardwaarde van KQL.

Notitie

Hoewel in dit voorbeeld application Insights-gegevens worden opgevraagd, kan de benadering worden gebruikt voor elke gegevensbron op basis van logboeken, zoals Log Analytics en Azure Resource Graph.

Validaties toevoegen

Voor standaard- en wachtwoordtekstparameters kunt u validatieregels toevoegen die worden toegepast op het tekstveld. Voeg een geldige regex toe met een foutbericht. Als het bericht is ingesteld, wordt het weergegeven als een fout wanneer het veld ongeldig is.

Als de overeenkomst is geselecteerd, is het veld geldig als de waarde overeenkomt met de regex. Als de overeenkomst niet is geselecteerd, is het veld geldig als het niet overeenkomt met de regex.

Schermopname van de instellingen voor tekstvalidatie.

JSON-gegevens opmaken

Als JSON is geselecteerd als de taal voor het tekstveld met meerdere regels, heeft het veld een knop waarmee de JSON-gegevens van het veld worden opgemaakt. U kunt ook de sneltoets Ctrl + \ gebruiken om de JSON-gegevens op te maken.

Als gegevens afkomstig zijn van een query, kunt u de optie selecteren om de JSON-gegevens vooraf op te maken die door de query worden geretourneerd.

Schermopname van de optie JSON-gegevens vooraf opmaken.

Volgende stappen

Aan de slag met Azure Workbooks