Riferimento a funzioni di aggregazione (Generatore report 3.0 e SSRS)

Per includere valori aggregati nel report, è possibile utilizzare 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 delle funzioni predefinite che è possibile includere 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 ulteriori informazioni ed esempi, vedere Informazioni sull'ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore report 3.0 e SSRS).

Nota

È possibile creare e modificare definizioni del report (con estensione rdl) in Generatore report 3.0 e in Progettazione report di Business Intelligence Development Studio. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati. Per ulteriori informazioni, vedere Progettazione di report tramite Progettazione report e Generatore report 3.0 (SSRS) nel Web all'indirizzo microsoft.com.

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.
Count	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 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	Restituisce la varianza della popolazione di tutti i valori numerici non Null specificati dall'espressione, valutata nell'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	DataSource DataSet	Variabili	RenderFormat
Intestazione pagina Piè di pagina	Sì	Sì	Al massimo uno Nota 1	Sì	Sì	Sì	Sì
Corpo	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 della 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 utilizzato 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, utilizzare 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 utilizzata nelle espressioni di ordinamento dell'area dati.

• Nota 6. Solo nei filtri di membri. Non può essere utilizzata 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, pertanto i metodi non possono essere utilizzati per controllare i parametri durante l'inizializzazione.

• Nota 8. In tutte le aggregazioni eccetto 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	Previous	Sum e altre funzioni di ordinamento preliminare	Aggregazioni ReportItem	Funzioni di ricerca	Funzione Aggregate
Valore corrente	No	No	No	No	Sì	No	Sì	No
First Last	No	No	No	No	Sì	No	No	No
Previous	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 Aggregate	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

Le funzioni predefinite seguenti calcolano i valori correnti di un set di dati. RowNumber è simile a RunningValue, in quanto restituisce il 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. Utilizzare 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.
Last	Restituisce l'ultimo valore nell'ambito specificato dell'espressione specificata.
Previous	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, utilizzando un tipo di origine dati di Analysis Services, è possibile recuperare le aggregazioni calcolate sul server dell'origine dati da utilizzare in un'intestazione di gruppo.

Funzione	Descrizione
Aggregate	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. Utilizzare 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 ulteriori informazioni, vedere Creazione di gruppi di gerarchie ricorsive (Generatore report 3.0 e SSRS).

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

Torna all'inizio

Vedere anche

Riferimento

Esempi di espressioni (Generatore report 3.0 e SSRS)

Concetti

Utilizzo delle espressioni (Generatore report 3.0 e SSRS)

Informazioni sull'ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore report 3.0 e SSRS)