Funzioni di Generatore report - Riferimento alle funzioni di aggregazione nei report impaginati (Generatore report)

Si applica a:✅ Generatore di report Microsoft (SSRS) ✅ Power BI Report Builder ✅ Report Designer in SQL Server Data Tools

Per includere valori aggregati nel report impaginato, è possibile usare funzioni di aggregazione predefinite nelle espressioni. La funzione di aggregazione predefinita per i campi numerici è SUM. È possibile modificare l'espressione e utilizzare una funzione di aggregazione predefinita o specificare un ambito differente. L'ambito identifica il set di dati da utilizzare per il calcolo.

Quando l'elaboratore di report combina i dati e il layout del report, le espressioni per ogni elemento del report vengono valutate. Insieme a ogni pagina del report vengono visualizzati i risultati per ogni espressione negli elementi del report visualizzabile.

Nella tabella seguente sono elencate le categorie di funzioni predefinite supportate che possono essere incluse in un'espressione:

• Funzioni di aggregazione predefinite

• Restrizioni relative a campi, raccolte e funzioni di aggregazione predefiniti

• Restrizioni relative alle aggregazioni nidificate

• Calcolo dei valori correnti

• Recupero di conteggi delle righe

• Ricerca di valori da un altro set di dati

• Recupero di valori dipendenti dall'ordinamento

• Recupero di aggregazioni server

• Recupero del livello ricorsivo

• Verifica dell'ambito

Per determinare gli ambiti validi per una funzione, vedere l'argomento di riferimento delle singole funzioni. Per altre informazioni ed esempi, vedere Ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore report e SSRS).

Nota

È possibile creare e modificare file di definizioni di report impaginati (con estensione rdl) in Generatore report di Microsoft, Power BI Report Builder e Progettazione report di SQL Server Data Tools.

Funzioni di aggregazione predefinite

Le funzioni predefinite seguenti calcolano i valori di riepilogo relativi a un set di dati numerici non Null nell'ambito predefinito o nell'ambito denominato.

Funzione	Descrizione
Avg	Restituisce la media di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.
Conteggio	Restituisce il conteggio dei valori non Null specificati dall'espressione, valutato nel contesto dell'ambito specificato.
CountDistinct	Restituisce un conteggio di tutti i distinti valori non Null specificati dall'espressione, valutato nel contesto dell'ambito specificato.
Max	Restituisce il valore massimo di tutti i valori numerici non Null specificati dall'espressione, nel contesto dell'ambito specificato. È possibile utilizzare questa funzione per specificare il valore massimo di un asse del grafico per controllare la scala.
Min	Restituisce il valore minimo di tutti i valori numerici non Null specificati dall'espressione, nel contesto dell'ambito specificato. È possibile utilizzare questa funzione per specificare il valore minimo di un asse del grafico per controllare la scala.
StDev	Restituisce la deviazione standard di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.
StDevP	Restituisce la deviazione standard di popolazione di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.
Sum	Restituisce la somma di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.
Union	Restituisce l'unione di tutti i valori di dati spaziali non Null di tipo SqlGeometry o SqlGeography specificati dall'espressione, valutati nell'ambito specificato.
Var	Restituisce la varianza di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato.
VarP	Viene restituita la varianza della popolazione di tutti i valori numerici non Null specificati dall'espressione, valutata nel contesto dell'ambito specificato.

Torna all'inizio

Restrizioni relative a campi, raccolte e funzioni di aggregazione predefiniti

Nella tabella seguente sono riepilogate le restrizioni nei percorsi del report in cui è possibile aggiungere espressioni contenenti riferimenti alle raccolte predefinite globali.

Percorso nel report	Campi	Parametri	ReportItems	PageNumber TotalPages	Origine dati DataSet	Variabili	RenderFormat
Intestazione pagina Piè di pagina	Sì	Sì	Al massimo uno Nota 1	Sì	Sì	Sì	Sì
Body	Sì Nota 2	Sì	Solo elementi nell'ambito corrente o in un ambito contenitore Nota 3	No	Sì	Sì	Sì
Parametro del report	No	Solo i parametri precedenti dell'elenco Nota 4	No	No	No	No	No
Campo	Sì	Sì	No	No	No	No	No
Parametro query	No	Sì	No	No	No	No	No
Espressione di raggruppamento	Sì	Sì	No	No	Sì	No	No
Espressione di ordinamento	Sì	Sì	No	No	Sì	Sì Nota 5	No
Espressione filtro	Sì	Sì	No	No	Sì	Sì Nota 6	No
Codice	No	Sì Nota 7	No	No	No	No	No
Lingua del report	No	Sì	No	No	No	No	No
Variabili	Sì	Sì	No	No	Sì	Ambito corrente o contenitore	No
Aggregazioni	Sì	Sì	Solo nell'intestazione di pagina/piè di pagina	Solo nelle aggregazioni dell'elemento del report	Sì	No	No
Funzioni di ricerca	Sì	Sì	Sì	No	Sì	No	No

• Nota 1. ReportItems deve essere incluso nella pagina del report visualizzabile; in caso contrario, il relativo valore è Null. Se la visibilità di un elemento del report dipende da un'espressione che restituisce False, l'elemento del report non sarà presente nella pagina.

• Nota 2. Se un riferimento a un campo viene usato in un ambito del gruppo e non è incluso nell'espressione di raggruppamento, il valore per il campo non è definito, a meno che nell'ambito non sia presente un solo valore. Per specificare un valore, usare First o Last e l'ambito del gruppo.

• Nota 3. Le espressioni che includono un riferimento a ReportItems possono specificare valori per altri parametri ReportItems nello stesso ambito del gruppo o in un ambito del gruppo contenitore.

• Nota 4. I valori della proprietà per i parametri precedenti possono essere Null.

• Nota 5. Solo negli ordinamenti di membri. Non può essere usata nelle espressioni di ordinamento dell'area dati.

• Nota 6. Solo nei filtri di membri. Non può essere usata in espressioni dei filtri dell'area dati o del set di dati.

• Nota 7. La raccolta di parametri non viene inizializzata fino al termine dell'elaborazione del blocco di codice, di conseguenza non è possibile usare i metodi per controllare i parametri durante l'inizializzazione.

• Nota 8. In tutte le aggregazioni, ad eccezione di Count e CountDistinct, i tipi di dati devono essere analoghi per tutti i valori oppure essere Null.

Torna all'inizio

Restrizioni relative alle aggregazioni nidificate

Nella tabella seguente vengono riepilogate le restrizioni sulle funzioni di aggregazione che consentono la specifica di altre funzioni di aggregazione come aggregazioni nidificate.

Contesto	RunningValue	RowNumber	First Last	Indietro	Sum e altre funzioni di ordinamento preliminare	Aggregazioni ReportItem	Funzioni di ricerca	Funzione di aggregazione
Valore corrente	No	No	No	No	Sì	No	Sì	No
First Last	No	No	No	No	Sì	No	No	No
Indietro	Sì	Sì	Sì	No	Sì	No	Sì	No
Sum e altre funzioni di ordinamento preliminare	No	No	No	No	Sì	No	Sì	No
Aggregazioni ReportItem	No	No	No	No	No	No	No	No
Funzioni di ricerca	Sì	Sì Nota 1	Sì Nota 1	Sì Nota 1	Sì Nota 1	Sì Nota 1	No	No
Funzione di aggregazione	No	No	No	No	No	No	No	No

• Nota 1. Le funzioni di aggregazione sono consentite solo all'interno dell'espressione Source di una funzione di ricerca se tale funzione non è contenuta in un'aggregazione. Le funzioni di aggregazione non sono consentite all'interno di espressioni Destination o Result di una funzione di ricerca.

Torna all'inizio

Calcolo dei valori correnti

Nelle funzioni predefinite seguenti vengono calcolati i valori correnti per un set di dati. RowNumber è simile a RunningValue in quanto consente la restituzione del valore corrente di un conteggio che viene incrementato per ogni riga all'interno dell'ambito contenitore. Il parametro di ambito per queste funzioni deve specificare un ambito contenitore che controlla quando deve essere riavviato il conteggio.

Funzione	Descrizione
RowNumber	Restituisce il conteggio parziale del numero di righe per l'ambito specificato. La funzione RowNumber riavvia il conteggio da 1, non da 0.
RunningValue	Restituisce un'aggregazione parziale di tutti i valori numerici non Null specificati dall'espressione, valutata per l'ambito specificato.

Torna all'inizio

Recupero di conteggi delle righe

La funzione predefinita seguente calcola il numero di righe nell'ambito specificato. Utilizzare questa funzione per conteggiare tutte le righe, incluse quelle con valori Null.

Funzione	Descrizione
CountRows	Restituisce il numero di righe nell'ambito specificato, incluse le righe con valori Null.

Torna all'inizio

Ricerca di valori da un altro set di dati

Le funzioni di ricerca seguenti recuperano valori da un set di dati specificato.

Funzione	Descrizione
Funzione Lookup	Restituisce un valore da un set di dati per un'espressione specificata.
Funzione LookupSet	Restituisce un set di valori da un set di dati per un'espressione specificata.
Funzione Multilookup	Restituisce il set di valori di prima corrispondenza per un set di nomi da un set di dati che contiene coppie nome/valore.

Torna all'inizio

Recupero di valori dipendenti dall'ordinamento

Le funzioni predefinite seguenti restituiscono il primo, l'ultimo o il precedente valore all'interno di un ambito specificato. Queste funzioni dipendono dal tipo di ordinamento dei valori dei dati. Utilizzare queste funzioni, ad esempio, per trovare il primo e l'ultimo valore in una pagina o per creare un'intestazione di pagina in formato dizionario. Usare Previous per confrontare il valore di una riga con il valore della riga precedente in un ambito specificato, ad esempio per trovare i valori in percentuale anno dopo anno in una tabella.

Funzione	Descrizione
First	Restituisce il primo valore nell'ambito specificato dell'espressione specificata.
Ultimo	Restituisce l'ultimo valore nell'ambito specificato dell'espressione specificata.
Indietro	Restituisce il valore o il valore di aggregazione specificato per l'istanza precedente di un elemento all'interno dell'ambito specificato.

Torna all'inizio

Recupero di aggregazioni server

La funzione predefinita seguente recupera aggregazioni personalizzate dal provider di dati. Ad esempio, usando un tipo di origine dati di Analysis Services, è possibile recuperare le aggregazioni calcolate sul server dell'origine dati da usare in un'intestazione di gruppo.

Funzione	Descrizione
Aggregazione	Restituisce un'aggregazione personalizzata dell'espressione specificata, secondo quanto definito dal provider di dati.

Torna all'inizio

Verifica dell'ambito

La funzione predefinita seguente controlla il contesto corrente di un elemento del report per verificare se è un membro di un ambito specifico.

Funzione	Descrizione
InScope	Indica se l'istanza corrente di un elemento è inclusa nell'ambito specificato.

Torna all'inizio

Recupero del livello ricorsivo

La funzione predefinita seguente recupera il livello corrente quando viene elaborata una gerarchia ricorsiva. Usare il risultato di questa funzione con la proprietà Padding in una casella di testo per controllare il livello di rientro di una gerarchia visiva per un gruppo ricorsivo. Per altre informazioni, vedere Creazione di gruppi di gerarchie ricorsive (Generatore report e SSRS).

Funzione	Descrizione
Livello	Restituisce il livello di nidificazione corrente in una gerarchia ricorsiva.

Torna all'inizio

Vedi anche

Utilizzo delle espressioni nei report (Generatore di report e SSRS)
Esempi di espressioni (Generatore di report e SSRS)
Ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore di report e SSRS)