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 |
|---|---|
Restituisce la media di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato. |
|
Restituisce il conteggio dei valori non Null specificati dall'espressione, valutato nel contesto dell'ambito specificato. |
|
Restituisce un conteggio di tutti i distinti valori non Null specificati dall'espressione, valutato nel contesto dell'ambito specificato. |
|
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. |
|
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. |
|
Restituisce la deviazione standard di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato. |
|
Restituisce la deviazione standard di popolazione di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato. |
|
Restituisce la somma di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato. |
|
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. |
|
Restituisce la varianza di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato. |
|
Restituisce la varianza della popolazione di tutti i valori numerici non Null specificati dall'espressione, valutata nell'ambito specificato. |
.gif "Icona freccia utilizzata con il collegamento Torna all'inizio")
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 |
|---|---|
Restituisce il conteggio parziale del numero di righe per l'ambito specificato. La funzione RowNumber riavvia il conteggio da 1, non da 0. |
|
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 |
|---|---|
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 |
|---|---|
Restituisce un valore da un set di dati per un'espressione specificata. |
|
Restituisce un set di valori da un set di dati per un'espressione specificata. |
|
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 |
|---|---|
Restituisce il primo valore nell'ambito specificato dell'espressione specificata. |
|
Restituisce l'ultimo valore nell'ambito specificato dell'espressione specificata. |
|
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 |
|---|---|
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 |
|---|---|
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 |
|---|---|
Restituisce il livello di nidificazione corrente in una gerarchia ricorsiva. |
Torna all'inizio