Condividi tramite


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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna 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

Al massimo uno

Nota 1

Corpo

Nota 2

Solo elementi nell'ambito corrente o in un ambito contenitore

Nota 3

No

Parametro del report

No

Solo i parametri precedenti dell'elenco

Nota 4

No

No

No

No

No

Campo

No

No

No

No

No

Parametro della query

No

No

No

No

No

No

Espressione di raggruppamento

No

No

No

No

Espressione di ordinamento

No

No

Nota 5

No

Espressione filtro

No

No

Nota 6

No

Codice

No

Nota 7

No

No

No

No

No

Lingua del report

No

No

No

No

No

No

Variabili

No

No

Ambito corrente o contenitore

No

Aggregazioni

Solo nell'intestazione di pagina/piè di pagina

Solo nelle aggregazioni dell'elemento del report

No

No

Funzioni di ricerca

No

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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna 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

No

No

First

Last

No

No

No

No

No

No

No

Previous

No

No

No

Sum e altre funzioni di ordinamento preliminare

No

No

No

No

No

No

Aggregazioni ReportItem

No

No

No

No

No

No

No

No

Funzioni di ricerca

Nota 1

Nota 1

Nota 1

Nota 1

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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna 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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna 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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna 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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna 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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna 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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna 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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna 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.

Icona freccia utilizzata con il collegamento Torna all'inizioTorna all'inizio