Parametri della cartella di lavoro

Usando i parametri, è possibile raccogliere l'input dai consumer e farvi riferimento in altre parti di una cartella di lavoro. In genere viene usato per definire l'ambito del set di risultati o impostare l'oggetto visivo corretto. È possibile creare report e esperienze interattive usando questa funzionalità chiave.

Quando si usano cartelle di lavoro, è possibile controllare il modo in cui i controlli dei parametri vengono presentati ai consumer. Possono essere casella di testo rispetto all'elenco a discesa, single-vss multi-select e valori da testo, JSON, KQL o Azure Resource Graph.

I tipi di parametri supportati includono:

• Ora: consente di selezionare da intervalli di tempo precompilato o selezionare un intervallo personalizzato
• Elenco a discesa: consente di selezionare da un valore o da un set di valori
• Gruppo opzioni: consente di selezionare un valore da un set noto
• Testo: consente di immettere testo arbitrario
• Criteri: consente di definire un set di criteri in base ai parametri specificati in precedenza, che verranno valutati per fornire un valore dinamico
• Risorsa: consente di selezionare una o più risorse di Azure
• Sottoscrizione: consente di selezionare una o più risorse di sottoscrizione di Azure
• Multivalore: consente di impostare uno o più valori di testo arbitrari
• Tipo di risorsa: consente di selezionare uno o più valori del tipo di risorsa di Azure
• Percorso: consente di selezionare uno o più valori di posizione di Azure

Fare riferimento a un parametro

È possibile fare riferimento ai valori dei parametri da altre parti delle cartelle di lavoro usando associazioni o espansioni di valori.

Fare riferimento a un parametro con associazioni

In questo esempio viene illustrato come fare riferimento a un parametro intervallo di tempo con associazioni:

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

2. Aprire l'elenco a discesa Intervallo di tempo e selezionare l'opzione Intervallo di tempo nella sezione Parametri nella parte inferiore:

   • Questa opzione associa il parametro intervallo di tempo all'intervallo di tempo del grafico.
   • L'ambito di tempo della query di esempio è ora di 24 ore.

3. Eseguire la query per visualizzare i risultati.

   

Fare riferimento a un parametro con KQL

In questo esempio viene illustrato come fare riferimento a un parametro di intervallo di tempo con KQL:

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

2. In KQL immettere un filtro dell'ambito temporale usando il parametro | where timestamp {TimeRange}:

   • Questo parametro si espande sul tempo di valutazione delle query su | where timestamp > ago(1d).
   • Questa opzione è il valore dell'intervallo di tempo del parametro.

3. Eseguire la query per visualizzare i risultati.

   

Fare riferimento a un parametro con testo

In questo esempio viene illustrato come fare riferimento a un parametro intervallo di tempo con testo:

1. Aggiungere un controllo di testo alla cartella di lavoro.
2. Nella classe Markdown immettere The chosen time range is {TimeRange:label}.
3. Selezionare Modifica completata.
4. Il controllo testo mostra il testo L'intervallo di tempo scelto è Ultima 24 ore.

Opzioni di formattazione dei parametri

Ogni tipo di parametro ha le proprie opzioni di formattazione. Usare la sezione Anteprime del riquadro Modifica parametro per visualizzare le opzioni di espansione di formattazione per il parametro.

È possibile usare queste opzioni per formattare tutti i tipi di parametri, ad eccezione del selettore Intervallo di tempo. Per esempi di formattazione dei tempi, vedere Opzioni dei parametri di tempo.

Altri tipi di parametri includono:

• Selezione risorse: gli ID risorsa vengono formattati.
• Selezione sottoscrizione: i valori della sottoscrizione vengono formattati.

Convertire toml in json

Sintassi: {param:tomltojson}

Valore originale:

name = "Sam Green"

[address]
state = "New York"
country = "USA"

Valore formattato:

{
  "name": "Sam Green",
  "address": {
    "state": "New York",
    "country": "USA"
  }
}

Escape JSON

Sintassi: {param:escapejson}

Valore originale:

{
	"name": "Sam Green",
	"address": {
		"state": "New York",
		"country": "USA"
  }
}

Valore formattato:

{\r\n\t\"name\": \"Sam Green\",\r\n\t\"address\": {\r\n\t\t\"state\": \"New York\",\r\n\t\t\"country\": \"USA\"\r\n  }\r\n}

Codificare il testo in base64

Sintassi: {param:base64}

Valore originale:

Sample text to test base64 encoding

Valore formattato:

U2FtcGxlIHRleHQgdG8gdGVzdCBiYXNlNjQgZW5jb2Rpbmc=

Formattare i parametri usando JSONPath

Per i parametri stringa che sono contenuto JSON, è possibile usare JSONPath nella stringa di formato dei parametri.

Ad esempio, potrebbe essere presente un parametro stringa denominato selection che è stato il risultato di una query o di una selezione in una visualizzazione con il valore seguente:

{ "series":"Failures", "x": 5, "y": 10 }

Usando JSONPath, è possibile ottenere singoli valori da tale oggetto:

Formato	Risultato
{selection:$.series}	Failures
{selection:$.x}	5
{selection:$.y}	10

Nota

Se il valore del parametro non è valido JSON, il risultato del formato sarà un valore vuoto.

Stile dei parametri

Gli stili seguenti sono disponibili per i parametri.

Pillole

Lo stile delle pillole è lo stile predefinito. I parametri sono simili al testo e richiedono all'utente di selezionarli una volta per passare alla modalità di modifica.

Standard

Nello stile standard, i controlli sono sempre visibili, con un'etichetta sopra il controllo.

Modulo orizzontale

Nello stile orizzontale del modulo, i controlli sono sempre visibili, con l'etichetta sul lato sinistro del controllo.

Modulo verticale

Nello stile verticale del modulo, i controlli sono sempre visibili, con l'etichetta sopra il controllo. A differenza dello stile standard, c'è solo un'etichetta o un controllo in una riga.

Nota

In layout verticali standard, form e form, non esiste alcun concetto di modifica inline. I controlli sono sempre in modalità di modifica.

Parametri globali

Dopo aver appreso come funzionano i parametri e le limitazioni relative solo alla possibilità di usare un parametro "downstream" di dove è impostato, è ora di apprendere i parametri globali, che modificano tali regole.

Con un parametro globale, il parametro deve comunque essere dichiarato prima di poterlo usare. Tuttavia, qualsiasi passaggio che imposta un valore su tale parametro influisce su tutte le istanze di tale parametro nella cartella di lavoro.

Nota

Poiché la modifica di un parametro globale ha questo comportamento "aggiorna tutto", l'impostazione globale deve essere attivata solo per i parametri che richiedono questo comportamento. Una combinazione di parametri globali che dipendono l'uno dall'altro può creare un ciclo o un'oscillazione in cui le globali concorrenti cambiano tra loro e sopra. Per evitare cicli, non è possibile "redeclare" un parametro dichiarato come globale. Tutte le dichiarazioni successive di un parametro con lo stesso nome creeranno un parametro di sola lettura che non può essere modificato in tale posizione.

Usi comuni dei parametri globali:

1. Sincronizzare gli intervalli di tempo tra molti grafici:

   • Senza un parametro globale, qualsiasi pennello intervallo di tempo in un grafico verrà esportato solo dopo tale grafico. Quindi, selezionando un intervallo di tempo nel terzo grafico verrà aggiornato solo il quarto grafico.
   • Con un parametro globale, è possibile creare un parametro timeRange globale, assegnargli un valore predefinito e usare tutti gli altri grafici come intervallo di tempo associato e output del pennello temporale. Inoltre, impostare l'impostazione Esporta solo il parametro quando viene pennellato un intervallo . Qualsiasi modifica dell'intervallo di tempo in qualsiasi grafico aggiorna il parametro timeRange globale nella parte superiore della cartella di lavoro. Questa funzionalità può essere usata per fare in modo che una cartella di lavoro funzioni come un dashboard.

2. Consente di modificare la scheda selezionata in un passaggio di collegamento tramite collegamenti o pulsanti:

   • Senza un parametro globale, il passaggio collegamenti restituisce solo un parametro per la scheda selezionata.
   • Con un parametro globale, è possibile creare un parametro selectedTab globale. È quindi possibile usare il nome del parametro nelle selezioni delle schede nel passaggio dei collegamenti. È possibile passare il valore del parametro nella cartella di lavoro da un collegamento o usando un altro pulsante o un collegamento per modificare la scheda selezionata. L'uso di pulsanti da un passaggio di collegamento in questo modo può rendere un'esperienza simile alla procedura guidata, in cui i pulsanti nella parte inferiore di un passaggio possono influire sulle sezioni visibili sopra di esso.

Creare un parametro globale

Quando si crea il parametro in un passaggio dei parametri, usare l'opzione Considera questo parametro come globale in Impostazioni avanzate. L'unico modo per creare un parametro globale consiste nel dichiararlo con un passaggio di parametri. Gli altri metodi di creazione di parametri, tramite selezioni, pennello, collegamenti, pulsanti e schede, possono aggiornare solo un parametro globale. Non possono dichiarare se stessi.

Il parametro sarà disponibile e funzionerà come parametri normali.

Aggiornare il valore di un parametro globale esistente

Per l'esempio di grafico, il modo più comune per aggiornare un parametro globale consiste nell'usare il pennello temporale.

In questo esempio il parametro timerange viene dichiarato come globale. In un passaggio di query riportato di seguito, creare ed eseguire una query che usa tale parametro di intervallo di tempo nella query e restituisce un risultato del grafico temporale. In Impostazioni avanzate per il passaggio della query abilitare l'impostazione del pennello dell'intervallo di tempo. Usare lo stesso nome di parametro dell'output per il parametro time brush. Selezionare anche l'opzione Esporta solo il parametro quando viene pennellato un intervallo .

Ogni volta che un intervallo di tempo viene pennellato in questo grafico, aggiorna anche il parametro di intervallo di tempo sopra la query e il passaggio della query stesso, perché dipende anche da un intervallo di tempo.

1. Prima del pennello:

   • L'intervallo di tempo viene visualizzato come Ultima ora.
   • Il grafico mostra l'ultima ora di dati.

   

2. Durante il pennello:

   • L'intervallo di tempo è ancora l'ultima ora e vengono tracciati i contorni del pennello.
   • Nessun parametro modificato. Dopo aver lasciato andare al pennello, l'intervallo di tempo viene aggiornato.

   

3. Dopo il pennello:

   • L'intervallo di tempo specificato dal pennello temporale viene impostato da questo passaggio. Esegue l'override del valore globale. L'elenco a discesa intervallo di tempo visualizza ora l'intervallo di tempo personalizzato.
   • Poiché il valore globale nella parte superiore è cambiato e poiché questo grafico dipende da un intervallo di tempo come input, viene aggiornato anche l'intervallo di tempo della query usata nel grafico. Di conseguenza, la query e il grafico verranno aggiornati.
   • Verranno inoltre aggiornati tutti gli altri passaggi della cartella di lavoro che dipendono da un intervallo di tempo .

   

   Nota

   Se non si usa un parametro globale, il valore del parametro timerange verrà modificato solo sotto questo passaggio della query. Gli elementi sopra questo passaggio o questo elemento stesso non verranno aggiornati.