Parametri di testo della cartella di lavoro

  • Articolo

I parametri della casella di testo offrono un modo semplice per raccogliere l'input di testo dagli utenti della cartella di lavoro. Vengono usati quando non è pratico usare un elenco a discesa per raccogliere l'input, ad esempio con una soglia arbitraria o filtri generici. Usando una cartella di lavoro, è possibile ottenere il valore predefinito della casella di testo da una query. Questa funzionalità consente scenari interessanti, ad esempio l'impostazione della soglia predefinita in base alla p95 della metrica.

Un uso comune delle caselle di testo è rappresentato da variabili interne usate da altri controlli della cartella di lavoro. Si usa una query per i valori predefiniti e si rende invisibile il controllo di input in modalità di lettura. Ad esempio, potrebbe essere necessario che una soglia provengano da una formula, non da un utente e quindi si usi la soglia nelle query successive.

Creare un parametro di testo

  1. Iniziare con una cartella di lavoro vuota in modalità di modifica.

  2. Selezionare Aggiungi parametri>Aggiungi parametro.

  3. Nel nuovo riquadro dei parametri visualizzato immettere:

    1. Nome parametro: SlowRequestThreshold
    2. Tipo di parametro: Text
    3. Obbligatorio: checked
    4. Ottenere dati da: None

  4. Selezionare Salva per creare il parametro.

    Screenshot that shows the creation of a text parameter.

Questo screenshot mostra l'aspetto della cartella di lavoro in modalità di lettura:

Screenshot that shows a text parameter in read mode.

Stile campo parametro

Il parametro text supporta gli stili di campo seguenti:

  • Standard: campo di testo a riga singola.

    Screenshot that shows a standard text field.

  • Password: campo password a riga singola. Il valore della password è nascosto nell'interfaccia utente solo quando si digita. Il valore è completamente accessibile come valore di parametro quando viene fatto riferimento. Viene archiviato non crittografato quando la cartella di lavoro viene salvata.

    Screenshot that shows a password field.

  • Multilinea: un campo di testo su più righe con supporto di intelliSense avanzato e colorazione della sintassi per i linguaggi seguenti:

    • Testo
    • Markdown
    • JSON
    • SQL
    • TypeScript
    • KQL
    • TOML

    È anche possibile specificare l'altezza per l'editor su più righe.

    Screenshot that shows a multiline text field.

Fare riferimento a un parametro di testo

  1. Selezionare Aggiungi query per aggiungere un controllo query e quindi selezionare una risorsa di Application Insights.

  2. Nella casella KQL aggiungere questo frammento di codice:

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

  3. Usando il parametro text con un valore pari a 500 abbinato al controllo query, è possibile eseguire in modo efficace la query seguente:

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

  4. Eseguire la query per visualizzare i risultati.

    Screenshot that shows a text parameter referenced in KQL.

Nota

Nell'esempio precedente rappresenta {SlowRequestThreshold} un valore intero. Se si esegue una query per una stringa come {ComputerName}, è necessario modificare la query Kusto per aggiungere virgolette "{ComputerName}" per consentire al campo del parametro di accettare un input senza virgolette.

Impostare i valori predefiniti usando le query

  1. Iniziare con una cartella di lavoro vuota in modalità di modifica.

  2. Selezionare Aggiungi parametri>Aggiungi parametro.

  3. Nel nuovo riquadro dei parametri visualizzato immettere:

    1. Nome parametro: SlowRequestThreshold
    2. Tipo di parametro: Text
    3. Obbligatorio: checked
    4. Ottenere dati da: Query

  4. Nella casella KQL aggiungere questo frammento di codice:

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

    Questa query imposta il valore predefinito della casella di testo sulla durata del 95° percentile per tutte le richieste nell'app.

  5. Eseguire la query per visualizzare i risultati.

  6. Selezionare Salva per creare il parametro.

    Screenshot that shows a text parameter with a default value from KQL.

Nota

Anche se questo esempio esegue query sui dati di Application Insights, l'approccio può essere usato per qualsiasi origine dati basata su log, ad esempio Log Analytics e Azure Resource Graph.

Aggiungere convalide

Per i parametri di testo standard e password, è possibile aggiungere regole di convalida applicate al campo di testo. Aggiungere un'espressione regolare valida con un messaggio di errore. Se il messaggio è impostato, viene visualizzato come errore quando il campo non è valido.

Se la corrispondenza è selezionata, il campo è valido se il valore corrisponde all'espressione regolare. Se la corrispondenza non è selezionata, il campo è valido se non corrisponde all'espressione regolare.

Screenshot that shows text validation settings.

Formattare i dati JSON

Se JSON è selezionato come linguaggio per il campo di testo su più righe, il campo avrà un pulsante che formatta i dati JSON del campo. È anche possibile usare il tasto di scelta rapida CTRL+ \ per formattare i dati JSON.

Se i dati provengono da una query, è possibile selezionare l'opzione per pre-formattare i dati JSON restituiti dalla query.

Screenshot that shows the option Pre-format JSON data.

Passaggi successivi

Introduzione alle cartelle di lavoro di Azure