Creare o modificare una cartella di lavoro di Azure

  • Articolo

Questo articolo descrive come creare una nuova cartella di lavoro e come aggiungere elementi alla cartella di lavoro di Azure.

Questo video illustra la creazione di cartelle di lavoro.

Creare una nuova cartella di lavoro di Azure

Per creare una nuova cartella di lavoro di Azure:

  1. Nella pagina Cartelle di lavoro di Azure selezionare un modello vuoto o selezionare Nuovo nella barra degli strumenti superiore.
  2. Combinare uno di questi elementi da aggiungere alla cartella di lavoro:

Aggiungere testo

Le cartelle di lavoro consentono agli autori di includere blocchi di testo nelle cartelle di lavoro. Il testo può essere un'analisi umana dei dati, informazioni che consentono agli utenti di interpretare i dati, le intestazioni di sezione e così via.

Screenshot of adding text to a workbook.

Il testo viene aggiunto tramite un controllo markdown in cui un autore può aggiungere il contenuto. Un autore può usare le funzionalità di formattazione complete di markdown. Questi includono stili di intestazione e tipi di carattere diversi, collegamenti ipertestuali, tabelle e così via. Markdown consente agli autori di creare report avanzati o narrazioni analitiche simili a Word o portali. Il testo può contenere valori di parametro nel testo markdown e tali riferimenti ai parametri vengono aggiornati man mano che i parametri cambiano.

Modalità di modifica:

Screenshot showing adding text to a workbook in edit mode.

Modalità di anteprima:

Screenshot showing adding text to a workbook in preview mode.

Per aggiungere testo a una cartella di lavoro di Azure:

  1. Assicurarsi di essere in modalità di modifica selezionando Modifica sulla barra degli strumenti. Aggiungere una query eseguendo una di queste operazioni:

    • Selezionare Aggiungi e Aggiungi testo sotto un elemento esistente o nella parte inferiore della cartella di lavoro.
    • Selezionare i puntini di sospensione (...) a destra del pulsante Modifica accanto a uno degli elementi della cartella di lavoro, quindi selezionare Aggiungi e quindi Aggiungi testo.

  2. Immettere il testo markdown nel campo dell'editor.

  3. Usa l'opzione Stile testo per passare da markdown normale a markdown normale e markdown con lo stile standard di info/avviso/esito positivo/errore del portale di Azure.

    Suggerimento

    Utilizzare questo foglio informativo markdown per visualizzare le diverse opzioni di formattazione.

  4. Usare la scheda Anteprima per vedere l'aspetto del contenuto. L'anteprima mostra il contenuto all'interno di un'area scorrevole per limitarne le dimensioni, ma quando viene visualizzato in fase di esecuzione, il contenuto markdown si espande per riempire qualsiasi spazio necessario, senza una barra di scorrimento.

  5. Selezionare Modifica completata.

Stili di testo

Questi stili di testo sono disponibili:

Style Descrizione
plain Non viene applicata alcuna formattazione
info Stile "info" del portale, con un'icona ℹ o simile e sfondo blu
Errore Stile "errore" del portale, con un'icona ❌ o simile e sfondo rosso
esito positivo Stile di "successo" del portale, con un'icona ✔ o simile e sfondo verde
Upsell Stile "upsell" del portale, con un'icona 🚀 o simile e sfondo viola
warning Stile "avviso" del portale, con un'icona ⚠ o simile e sfondo blu

È anche possibile scegliere un parametro di testo come origine dello stile. Il valore del parametro deve essere uno dei valori di testo precedenti. L'assenza di un valore o qualsiasi valore non riconosciuto verrà considerato come plain stile.

Esempi di stile del testo

Esempio di stile info:

Screenshot of adding text to a workbook in preview mode showing info style.

Esempio di stile avviso:

Screenshot of a text visualization in warning style.

Aggiungere query

Cartelle di lavoro di Azure consente di eseguire query su una delle origini dati della cartella di lavoro supportate.

Ad esempio, è possibile eseguire query su Azure Integrità risorse per visualizzare eventuali problemi del servizio che interessano le risorse. È anche possibile eseguire query sulle metriche di Monitoraggio di Azure, ovvero i dati numerici raccolti a intervalli regolari. Le metriche di Monitoraggio di Azure forniscono informazioni su un aspetto di un sistema in un determinato momento.

Per aggiungere una query a una cartella di lavoro di Azure:

  1. Assicurarsi di essere in modalità di modifica selezionando Modifica sulla barra degli strumenti. Aggiungere una query eseguendo una di queste operazioni:
    • Selezionare Aggiungi e Aggiungi query sotto un elemento esistente o nella parte inferiore della cartella di lavoro.
    • Selezionare i puntini di sospensione (...) a destra del pulsante Modifica accanto a uno degli elementi della cartella di lavoro, quindi selezionare Aggiungi e quindi Aggiungi query.
  2. Selezionare l'origine dati per la query. Gli altri campi vengono determinati in base all'origine dati scelta.
  3. Selezionare tutti gli altri valori necessari in base all'origine dati selezionata.
  4. Selezionare la visualizzazione per la cartella di lavoro.
  5. Nella sezione query immettere la query oppure selezionare un elenco di query di esempio selezionando Esempi e quindi modificare la query in base alle proprie esigenze.
  6. Selezionare Esegui query.
  7. Quando si è certi di avere la query desiderata nella cartella di lavoro, selezionare Modifica completata.

Procedure consigliate per l'esecuzione di query sui log

  • Usare gli intervalli di tempo più piccoli possibili. Maggiore è l'intervallo di tempo, il rallentamento delle query e il maggior numero di dati restituiti. Per intervalli di tempo più lunghi, la query potrebbe dover passare all'archiviazione "a freddo" più lenta, rendendo la query ancora più lenta. L'impostazione predefinita è l'intervallo di tempo più breve, ma consentire all'utente di selezionare un intervallo di tempo più ampio che potrebbe essere più lento.

  • Usare il valore speciale "All" negli elenchi a discesa. È possibile aggiungere un elemento speciale All nelle impostazioni dei parametri a discesa. È possibile usare un valore speciale. L'uso di un elemento speciale consente di semplificare notevolmente le query.

  • Protezione dalle colonne mancanti. Se si usa una tabella personalizzata o colonne personalizzate, progettare il modello in modo che funzioni se la colonna non è presente in un'area di lavoro. Vedere la funzione column_ifexists .

  • Protezione da una tabella mancante. Se il modello viene installato come parte di una soluzione o in altri casi in cui le tabelle sono garantite, il controllo delle colonne mancanti non è necessario. Se si creano modelli generici che potrebbero essere visibili in qualsiasi risorsa o area di lavoro, è consigliabile proteggere per le tabelle che non esistono. Il linguaggio di query di Log Analytics non ha una funzione table_ifexists come la funzione per il test delle colonne. Esistono tuttavia alcuni modi per verificare se esiste una tabella. Ad esempio, è possibile usare un'unione fuzzy. Quando si esegue un'unione, è possibile usare l'impostazione isfuzzy=true per consentire all'unione di continuare se alcune tabelle non esistono. È possibile aggiungere una query sui parametri nella cartella di lavoro che verifica l'esistenza della tabella e nasconde il contenuto in caso contrario. Gli elementi che non sono visibili non vengono eseguiti, quindi è possibile progettare il modello in modo che altre query nella cartella di lavoro non riescano se la tabella non esiste, non vengono eseguite fino a quando il test verifica che la tabella esista.

    Ad esempio:

    let MissingTable = view () { print isMissing=1 };
union isfuzzy=true MissingTable, (AzureDiagnostics | getschema | summarize c=count() | project isMissing=iff(c > 0, 0, 1))
| top 1 by isMissing asc

    Questa query restituisce un valore 1 se la tabella AzureDiagnostics non esiste nell'area di lavoro. Se la tabella reale non esiste, verrà restituita la riga fittizia di MissingTable . Se sono presenti colonne nello schema per la tabella AzureDiagnostics , viene restituito un valore 0 . È possibile usarlo come valore del parametro e nascondere in modo condizionale i passaggi della query a meno che il valore del parametro non sia 0. È anche possibile usare la visibilità condizionale per visualizzare il testo che indica che l'area di lavoro corrente non contiene la tabella mancante e inviare l'utente alla documentazione su come eseguire l'onboarding.

    Invece di nascondere i passaggi, è possibile che non si vogliano avere righe come risultato. È possibile modificare MissingTable in modo che sia una tabella di dati vuota con lo schema di corrispondenza appropriato:

    let MissingTable = datatable(ResourceId: string) [];
union isfuzzy=true MissingTable, (AzureDiagnostics
| extend ResourceId = column_ifexists('ResourceId', '')

    In questo caso, la query non restituisce alcuna riga se la tabella AzureDiagnostics manca o se la colonna ResourceId non è presente nella tabella.

Esercitazione: query sui log incentrate sulle risorse nelle cartelle di lavoro

Questo video illustra come usare le query sui log a livello di risorsa in Cartelle di lavoro di Azure. Include anche suggerimenti e consigli su come abilitare scenari avanzati e migliorare le prestazioni.

Making resource centric log queries in workbooks

Parametro del tipo di risorsa dinamico

Usa ambiti dinamici per eseguire query più efficienti. Il frammento di codice seguente usa questa euristica:

  1. Singole risorse: se il conteggio della risorsa selezionata è minore o uguale a 5
  2. Gruppi di risorse: se il numero di risorse è superiore a 5, ma il numero di gruppi di risorse a cui appartiene le risorse è minore o uguale a 3
  3. Sottoscrizioni: in caso contrario,
Resources
| take 1
| project x = dynamic(["microsoft.compute/virtualmachines", "microsoft.compute/virtualmachinescalesets", "microsoft.resources/resourcegroups", "microsoft.resources/subscriptions"])
| mvexpand x to typeof(string)
| extend jkey = 1
| join kind = inner (Resources
| where id in~ ({VirtualMachines})
| summarize Subs = dcount(subscriptionId), resourceGroups = dcount(resourceGroup), resourceCount = count()
| extend jkey = 1) on jkey
| project x, label = 'x',
      selected = case(
        x in ('microsoft.compute/virtualmachinescalesets', 'microsoft.compute/virtualmachines') and resourceCount <= 5, true,
        x == 'microsoft.resources/resourcegroups' and resourceGroups <= 3 and resourceCount > 5, true,
        x == 'microsoft.resources/subscriptions' and resourceGroups > 3 and resourceCount > 5, true,
        false)

Ambito delle risorse statiche per l'esecuzione di query su più tipi di risorse

[
    { "value":"microsoft.compute/virtualmachines", "label":"Virtual machine", "selected":true },
    { "value":"microsoft.compute/virtualmachinescaleset", "label":"Virtual machine scale set", "selected":true }
]

Parametro di risorsa raggruppato per tipo di risorsa

Resources
| where type =~ 'microsoft.compute/virtualmachines' or type =~ 'microsoft.compute/virtualmachinescalesets'
| where resourceGroup in~({ResourceGroups})
| project value = id, label = id, selected = false,
      group = iff(type =~ 'microsoft.compute/virtualmachines', 'Virtual machines', 'Virtual machine scale sets')

Aggiungere parametri

È possibile raccogliere l'input dai consumer e farvi riferimento in altre parti della cartella di lavoro usando parametri. Usare i parametri per definire l'ambito del set di risultati o per impostare l'oggetto visivo corretto. I parametri consentono di creare report ed esperienze interattivi. Per altre informazioni sull'uso dei parametri, vedere Parametri della cartella di lavoro.

Le cartelle di lavoro consentono di controllare il modo in cui i controlli dei parametri vengono presentati ai consumer: casella di testo e elenco a discesa, a selezione singola e multipla, valori di testo, JSON, KQL o Azure Resource Graph e così via.

Guardare questo video per informazioni su come usare i parametri e i dati di log in Cartelle di lavoro di Azure.

Per aggiungere un parametro a una cartella di lavoro di Azure:

  1. Assicurarsi di essere in modalità di modifica selezionando Modifica sulla barra degli strumenti. Aggiungere un parametro eseguendo una di queste operazioni:

    • Selezionare Aggiungi e Aggiungi parametro sotto un elemento esistente o nella parte inferiore della cartella di lavoro.
    • Selezionare i puntini di sospensione (...) a destra del pulsante Modifica accanto a uno degli elementi della cartella di lavoro, quindi selezionare Aggiungi e quindi Aggiungi parametro.

  2. Nel nuovo riquadro dei parametri visualizzato immettere i valori per questi campi:

    • Nome parametro: i nomi dei parametri non possono includere spazi o caratteri speciali
    • Nome visualizzato: i nomi visualizzati possono includere spazi, caratteri speciali, emoji e così via.
    • Tipo di parametro:
    • Obbligatorio:

  3. Selezionare Modifica completata.

Screenshot showing the creation of a time range parameter.

Aggiungere grafici delle metriche

La maggior parte delle risorse di Azure genera dati sulle metriche sullo stato e sull'integrità, ad esempio l'utilizzo della CPU, la disponibilità dell'archiviazione, il numero di transazioni di database, le richieste di app non riuscite e così via. Usando le cartelle di lavoro, è possibile creare visualizzazioni dei dati delle metriche come grafici di serie temporali.

L'esempio seguente mostra il numero di transazioni in un account di archiviazione nell'ora precedente. In questo modo il proprietario dell'archiviazione può visualizzare la tendenza delle transazioni e cercare anomalie nel comportamento.

Screenshot showing a metric area chart for storage transactions in a workbook.

Per aggiungere un grafico delle metriche a una cartella di lavoro di Azure:

  1. Assicurarsi di essere in modalità di modifica selezionando Modifica sulla barra degli strumenti. Aggiungere un grafico delle metriche eseguendo una delle operazioni seguenti:
    • Selezionare Aggiungi e Aggiungi metrica sotto un elemento esistente o nella parte inferiore della cartella di lavoro.
    • Selezionare i puntini di sospensione (...) a destra del pulsante Modifica accanto a uno degli elementi della cartella di lavoro, quindi selezionare Aggiungi e quindi Aggiungi metrica.
  2. Selezionare un tipo di risorsa, le risorse di destinazione, lo spazio dei nomi e il nome della metrica e l'aggregazione da usare.
  3. Impostare altri parametri, se necessario, intervallo di tempo, split-by, visualizzazione, dimensioni e tavolozza dei colori.
  4. Selezionare Modifica completata.

Si tratta di un grafico delle metriche in modalità di modifica:

Screenshot showing a metric area chart for Storage transactions in edit mode.

Parametri del grafico delle metriche

Parametro Spiegazione Esempio
Tipo di risorsa Tipo di risorsa di destinazione Archiviazione o macchina virtuale.
Risorse Set di risorse da cui ottenere il valore delle metriche My Archiviazione 1
Spazio dei nomi Spazio dei nomi con la metrica > BLOB Archiviazione
Metric Metrica da visualizzare > transazioni BLOB > Archiviazione
Aggregazione Funzione di aggregazione da applicare alla metrica Somma, Conteggio, Media e così via.
Intervallo di ore Intervallo di tempo in cui visualizzare la metrica Ultima ora, Ultime 24 ore e così via.
Visualizzazione Visualizzazione da usare Area, Barra, Linea, Dispersione, Griglia
Divisione per Facoltativamente, suddividere la metrica in una dimensione Transazioni per tipo geografico
Dimensione Dimensioni verticali del controllo Piccolo, medio o grande
Tavolozza colori Tavolozza dei colori da utilizzare nel grafico. Ignorato se viene usato il Split by parametro Blu, verde, rosso e così via.

Esempi di grafici delle metriche

Transazioni suddivise per nome API come grafico a linee

Screenshot showing a metric line chart for Storage transactions split by API name.

Transazioni suddivise per tipo di risposta come grafico a barre di grandi dimensioni

Screenshot showing a large metric bar chart for Storage transactions split by response type.

Latenza media come grafico a dispersione

Screenshot showing a metric scatter chart for storage latency.

È possibile utilizzare i collegamenti per creare collegamenti ad altre visualizzazioni, cartelle di lavoro, altri elementi all'interno di una cartella di lavoro o per creare visualizzazioni a schede all'interno di una cartella di lavoro. I collegamenti possono essere stiliti come collegamenti ipertestuali, pulsanti e schede.

Screenshot of adding a link to a workbook.

Guardare questo video per informazioni su come usare schede, gruppi e collegamenti contestuali in Cartelle di lavoro di Azure:

È possibile applicare stili all'elemento di collegamento stesso e a singoli collegamenti.

Stili degli elementi di collegamento

Style Esempio Note
Elenco puntato Screenshot of bullet style workbook link. Il valore predefinito, i collegamenti, vengono visualizzati come un elenco puntato di collegamenti, uno su ogni riga. I campi Testo prima del collegamento e Testo dopo il collegamento possono essere usati per aggiungere altro testo prima o dopo gli elementi del collegamento.
List Screenshot of list style workbook link. I collegamenti vengono visualizzati come un elenco di collegamenti, senza punti elenco.
Paragrafo Screenshot of paragraph style workbook link. I collegamenti vengono visualizzati come paragrafo di collegamenti, racchiusi come un paragrafo di testo.
Navigazione Screenshot of navigation style workbook link. I collegamenti vengono visualizzati come collegamenti, con divisori verticali o pipe (|) tra ogni collegamento.
Schede Screenshot of tabs style workbook link. I collegamenti vengono visualizzati come schede. Ogni collegamento viene visualizzato come scheda, nessuna opzione di stile dei collegamenti si applica ai singoli collegamenti. Per informazioni su come configurare le schede, vedere la sezione schede di seguito.
Barra degli strumenti Screenshot of toolbar style workbook link. I collegamenti vengono visualizzati portale di Azure barra degli strumenti in stile, con icone e testo. Ogni collegamento viene visualizzato come pulsante della barra degli strumenti. Vedere la sezione della barra degli strumenti di seguito per informazioni su come configurare le barre degli strumenti.

Stili di collegamento

Style Descrizione
Collega Per impostazione predefinita, i collegamenti vengono visualizzati come collegamento ipertestuale. I collegamenti URL possono essere solo uno stile di collegamento.
Pulsante (primario) Il collegamento viene visualizzato come pulsante "primario" nel portale, in genere un colore blu
Pulsante (secondario) I collegamenti vengono visualizzati come pulsante "secondario" nel portale, in genere un colore "trasparente", un pulsante bianco nei temi chiari e un pulsante grigio scuro nei temi scuri.

Se i parametri obbligatori vengono usati nel testo del pulsante, nel testo della descrizione comando o nei campi valore e il parametro obbligatorio non viene impostato quando si usano pulsanti, il pulsante è disabilitato. È possibile usare questa funzionalità, ad esempio, per disabilitare i pulsanti quando non viene selezionato alcun valore in un altro parametro o controllo.

I collegamenti possono usare tutte le azioni di collegamento disponibili nelle azioni di collegamento e avere altre due azioni disponibili:

Azione Descrizione
Impostare un valore di parametro Un parametro può essere impostato su un valore quando si seleziona un collegamento, un pulsante o una scheda. Le schede vengono spesso configurate per impostare un parametro su un valore, che nasconde e mostra altre parti della cartella di lavoro in base a tale valore.
Scorrere fino a un passaggio Quando si seleziona un collegamento, la cartella di lavoro sposta lo stato attivo e scorre per rendere visibile un altro passaggio. Questa azione può essere usata per creare un "sommario" o un'esperienza di stile "tornare all'inizio".

Schede

Nella maggior parte dei casi, i collegamenti di tabulazione vengono combinati con l'azione Imposta un valore di parametro. Di seguito è riportato un esempio che mostra il passaggio dei collegamenti configurato per creare 2 schede, in cui la selezione di una scheda imposta un parametro selectedTab su un valore diverso(nell'esempio viene mostrata una terza scheda da modificare per visualizzare il nome del parametro e i segnaposto del valore del parametro):

Screenshot of creating tabs in workbooks.

È quindi possibile aggiungere altri elementi nella cartella di lavoro visibili in modo condizionale se il valore del parametro selectedTab è "1" usando le impostazioni avanzate:

Screenshot of conditionally visible tab in workbooks.

La prima scheda è selezionata per impostazione predefinita, impostando inizialmente selectedTab su 1 e rendendo visibile tale passaggio. Se si seleziona la seconda scheda, il valore del parametro viene modificato in "2" e viene visualizzato contenuto diverso:

Screenshot of workbooks with content displayed when selected tab is 2.

Una cartella di lavoro di esempio con le schede precedenti è disponibile in Cartelle di lavoro di Azure di esempio con collegamenti. g

Limitazioni delle schede

  • I collegamenti URL non sono supportati nelle schede. Un collegamento URL in una scheda viene visualizzato come scheda disabilitata.
  • Nelle schede non è supportato alcuno stile degli elementi. Gli elementi vengono visualizzati come schede e viene visualizzato solo il nome della scheda (testo del collegamento). I campi non utilizzati nello stile di tabulazioni sono nascosti in modalità di modifica.
  • La prima scheda è selezionata per impostazione predefinita, richiamando qualsiasi azione specificata da tale scheda. Se l'azione della prima scheda apre un'altra visualizzazione, non appena vengono create le schede, viene visualizzata una visualizzazione.
  • È possibile usare le schede per aprire un'altra visualizzazione, ma questa funzionalità deve essere usata con moderazione, perché la maggior parte degli utenti non si aspetta di spostarsi selezionando una scheda. Se altre schede impostano un parametro su un valore specifico, una scheda che apre una visualizzazione non modifica tale valore, quindi il resto del contenuto della cartella di lavoro continua a visualizzare la visualizzazione o i dati per la scheda precedente.

Barre degli strumenti

Usa lo stile barra degli strumenti per visualizzare gli stili dei collegamenti come barra degli strumenti. Nello stile della barra degli strumenti, l'autore deve compilare i campi per:

  • Testo del pulsante, testo da visualizzare sulla barra degli strumenti. I parametri possono essere usati in questo campo.
  • Icona, icona da visualizzare sulla barra degli strumenti.
  • Testo della descrizione comando, testo da visualizzare nel testo della descrizione comando del pulsante della barra degli strumenti. I parametri possono essere usati in questo campo.

Screenshot of creating links styled as a toolbar in workbooks.

Se vengono usati parametri obbligatori nei campi testo pulsante, testo della descrizione comando o valore e il parametro obbligatorio è unset, il pulsante della barra degli strumenti è disabilitato. Ad esempio, questa opzione può essere usata per disabilitare i pulsanti della barra degli strumenti quando non viene selezionato alcun valore in un altro parametro/controllo.

Una cartella di lavoro di esempio con barre degli strumenti, parametri globali e azioni arm è disponibile in cartelle di lavoro di Azure di esempio con collegamenti.

Aggiunta di gruppi

Un elemento di gruppo in una cartella di lavoro consente di raggruppare logicamente un set di passaggi in una cartella di lavoro.

I gruppi nelle cartelle di lavoro sono utili per diversi aspetti:

  • Layout: quando si desidera che gli elementi siano organizzati verticalmente, è possibile creare un gruppo di elementi in pila e impostare lo stile del gruppo in modo che sia una larghezza percentuale anziché impostare la larghezza percentuale su tutti i singoli elementi.
  • Visibilità: quando si vogliono nascondere o mostrare più elementi, è possibile impostare la visibilità dell'intero gruppo di elementi, anziché impostare le impostazioni di visibilità per ogni singolo elemento. Ciò può essere utile nei modelli che usano schede, perché è possibile usare un gruppo come contenuto della scheda e l'intero gruppo può essere nascosto/visualizzato in base a un parametro impostato dalla scheda selezionata.
  • Prestazioni: quando si dispone di un modello di grandi dimensioni con molte sezioni o schede, è possibile convertire ogni sezione in un proprio sottotemplate e usare i gruppi per caricare tutti i sottotemplate all'interno del modello di primo livello. Il contenuto dei sottotemplate non verrà caricato o eseguito fino a quando un utente non rende visibili tali gruppi. Altre informazioni su come suddividere un modello di grandi dimensioni in molti modelli.

Per aggiungere un gruppo alla cartella di lavoro:

  1. Assicurarsi di essere in modalità di modifica selezionando Modifica sulla barra degli strumenti. Aggiungere un parametro eseguendo una di queste operazioni:

    • Selezionare Aggiungi e Aggiungi gruppo sotto un elemento esistente o nella parte inferiore della cartella di lavoro.
    • Selezionare i puntini di sospensione (...) a destra del pulsante Modifica accanto a uno degli elementi della cartella di lavoro, quindi selezionare Aggiungi e quindi Aggiungi gruppo.

    Screenshot showing selecting adding a group to a workbook.

  2. Selezionare gli elementi per il gruppo.

  3. Selezionare Modifica completata.

    Si tratta di un gruppo in modalità di lettura con due elementi all'interno: un elemento di testo e un elemento di query.

    Screenshot showing a group in read mode in a workbook.

    In modalità di modifica, è possibile vedere che questi due elementi sono effettivamente all'interno di un elemento di gruppo. Nello screenshot seguente il gruppo è in modalità di modifica. Il gruppo contiene due elementi all'interno dell'area tratteggiata. Ogni elemento può essere in modalità di modifica o lettura, indipendentemente l'uno dall'altro. Ad esempio, il passaggio di testo è in modalità di modifica mentre il passaggio della query è in modalità di lettura.

    Screenshot of a group in edit mode in a workbook.

Definizione dell'ambito di un gruppo

Un gruppo viene considerato come un nuovo ambito nella cartella di lavoro. Tutti i parametri creati nel gruppo sono visibili solo all'interno del gruppo. Questo vale anche per l'unione: è possibile visualizzare solo i dati all'interno del gruppo o a livello padre.

Tipi di gruppi

È possibile specificare il tipo di gruppo da aggiungere alla cartella di lavoro. Esistono due tipi di gruppi:

  • Modificabile: il gruppo nella cartella di lavoro consente di aggiungere, rimuovere o modificare il contenuto degli elementi nel gruppo. Questa operazione viene usata più comunemente per scopi di layout e visibilità.
  • Da un modello: il gruppo nella cartella di lavoro viene caricato dal contenuto di un'altra cartella di lavoro in base al relativo ID. Il contenuto della cartella di lavoro viene caricato e unito nella cartella di lavoro in fase di esecuzione. In modalità di modifica non è possibile modificare alcun contenuto del gruppo, perché verranno semplicemente caricati nuovamente dal modello al successivo caricamento dell'elemento. Quando si carica un gruppo da un modello, usare l'ID risorsa di Azure completo di una cartella di lavoro esistente.

Tipi di carico

È possibile specificare come e quando vengono caricati i contenuti di un gruppo.

Caricamento lazy

Il caricamento differita è l'impostazione predefinita. Durante il caricamento differita, il gruppo viene caricato solo quando l'elemento è visibile. In questo modo un gruppo può essere utilizzato dagli elementi della scheda. Se la scheda non è mai selezionata, il gruppo non diventa mai visibile e pertanto il contenuto non viene caricato.

Per i gruppi creati da un modello, il contenuto del modello non viene recuperato e gli elementi nel gruppo non vengono creati finché il gruppo non diventa visibile. Gli utenti visualizzano gli spinner di stato per l'intero gruppo mentre il contenuto viene recuperato.

Caricamento esplicito

In questa modalità viene visualizzato un pulsante in cui si trova il gruppo e non viene recuperato o creato alcun contenuto finché l'utente non seleziona in modo esplicito il pulsante per caricare il contenuto. Ciò è utile negli scenari in cui il contenuto potrebbe essere costoso da calcolare o usare raramente. L'autore può specificare il testo da visualizzare sul pulsante.

Questo screenshot mostra le impostazioni di caricamento esplicite con un pulsante "Carica altro" configurato.

Screenshot of explicit load settings for a group in workbooks.

Questo è il gruppo prima di essere caricato nella cartella di lavoro:

Screenshot showing an explicit group before being loaded in the workbook.

Gruppo dopo il caricamento nella cartella di lavoro:

Screenshot showing an explicit group after being loaded in the workbook.

Modalità sempre

In modalità Sempre , il contenuto del gruppo viene sempre caricato e creato non appena viene caricata la cartella di lavoro. Questa operazione viene usata più di frequente quando si usa un gruppo solo a scopo di layout, in cui il contenuto sarà sempre visibile.

Uso di modelli all'interno di un gruppo

Quando un gruppo è configurato per il caricamento da un modello, per impostazione predefinita, tale contenuto viene caricato in modalità differita e verrà caricato solo quando il gruppo è visibile.

Quando un modello viene caricato in un gruppo, la cartella di lavoro tenta di unire tutti i parametri dichiarati nel modello con i parametri già esistenti nel gruppo. Tutti i parametri già esistenti nella cartella di lavoro con nomi identici verranno uniti all'esterno del modello da caricare. Se tutti i parametri in un passaggio del parametro vengono uniti, l'intero passaggio dei parametri scompare.

Esempio 1: Tutti i parametri hanno nomi identici

Si supponga di avere un modello con due parametri nella parte superiore, un parametro di intervallo di tempo e un parametro di testo denominato "Filter":

Screenshot showing top level parameters in a workbook.

Un elemento di gruppo carica quindi un secondo modello con due parametri e un passaggio di testo, in cui i parametri sono denominati allo stesso modo:

Screenshot of a workbook template with top level parameters.

Quando il secondo modello viene caricato nel gruppo, i parametri duplicati vengono uniti. Poiché tutti i parametri vengono uniti, viene unito anche il passaggio dei parametri interni, con conseguente unione del gruppo contenente solo il passaggio di testo.

Esempio 2: un parametro ha un nome identico

Si supponga di avere un modello con due parametri nella parte superiore, un parametro di intervallo di tempo e un parametro di testo denominato "FilterB" ():

Screenshot of a group item with the result of parameters merged away.

Quando viene caricato il modello dell'elemento del gruppo, il parametro TimeRange viene unito all'esterno del gruppo. La cartella di lavoro contiene il passaggio dei parametri iniziali con TimeRange e Filter e il parametro del gruppo include solo FilterB.

Screenshot of workbook group where parameters won't merge away.

Se il modello caricato conteneva TimeRange e Filter (anziché FilterB), la cartella di lavoro risultante avrà un passaggio di parametri e un gruppo con solo il passaggio di testo rimanente.

Suddivisione di un modello di grandi dimensioni in molti modelli

Per migliorare le prestazioni, è utile suddividere un modello di grandi dimensioni in più modelli più piccoli che caricano contenuto in modalità differita o su richiesta dall'utente. In questo modo il caricamento iniziale risulta più veloce perché il modello di primo livello può essere più piccolo.

Quando si divide un modello in parti, è necessario suddividere il modello in molti modelli (sottotemplate) che funzionano singolarmente. Se il modello di primo livello ha un parametro TimeRange usato da altri elementi, il sottotemplate dovrà avere anche un elemento di parametri che definisce un parametro con lo stesso nome esatto. I sottotemplate funzioneranno in modo indipendente e potranno essere caricati all'interno di modelli più grandi in gruppi.

Per trasformare un modello più grande in più sottotemplate:

  1. Creare un nuovo gruppo vuoto nella parte superiore della cartella di lavoro, dopo i parametri condivisi. Questo nuovo gruppo diventerà infine un sottotemplate.

  2. Creare una copia del passaggio dei parametri condivisi e quindi usare spostarsi in gruppo per spostare la copia nel gruppo creato nel passaggio 1. Questo parametro consente al sottotemplate di funzionare indipendentemente dal modello esterno e verrà unito quando viene caricato all'interno del modello esterno.

    Nota

    I sottotemplate non devono tecnicamente avere i parametri che vengono uniti se non si pianificano mai i modelli secondari visibili da soli. Tuttavia, se i modelli secondari non hanno i parametri, sarà molto difficile modificarli o eseguirne il debug se è necessario farlo in un secondo momento.

  3. Spostare ogni elemento nella cartella di lavoro da inserire nel sottotemplate nel gruppo creato nel passaggio 1.

  4. Se i singoli passaggi spostati nel passaggio 3 hanno visibilità condizionale, diventa la visibilità del gruppo esterno (come usato nelle schede). Rimuoverli dagli elementi all'interno del gruppo e aggiungere tale impostazione di visibilità al gruppo stesso. Salvare qui per evitare di perdere modifiche e/o esportare e salvare una copia del contenuto JSON.

  5. Se si desidera che tale gruppo venga caricato da un modello, è possibile usare il pulsante Modifica barra degli strumenti nel gruppo. Verrà aperto solo il contenuto del gruppo come cartella di lavoro in una nuova finestra. È quindi possibile salvarlo in base alle esigenze e chiudere questa visualizzazione della cartella di lavoro (non chiudere il browser, solo quella visualizzazione per tornare alla cartella di lavoro precedente che si stava modificando).

  6. È quindi possibile modificare il passaggio di gruppo per caricare dal modello e impostare il campo ID modello sulla cartella di lavoro/modello creata nel passaggio 5. Per usare gli ID delle cartelle di lavoro, l'origine deve essere l'ID risorsa di Azure completo di una cartella di lavoro condivisa. Premere Carica e il contenuto del gruppo verrà caricato da tale sottotemplate anziché salvato all'interno della cartella di lavoro esterna.