Funzioni Generatore report - Funzione RunningValue in un report impaginato (Generatore report)

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

Restituisce un'aggregazione parziale di tutti i valori numerici non Null specificati dall'espressione, valutata per l'ambito specificato in un report impaginato.

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.

Sintassi

  
RunningValue(expression, function, scope)  

Parametri

expression
Espressione su cui eseguire l'aggregazione, ad esempio [Quantity].

function
(Enum) Nome della funzione di aggregazione da applicare all'espressione, ad esempio Sum. Tale funzione non può essere RunningValue, RowNumbero Aggregate.

ambito
(String) Costante di tipo stringa ovvero il nome di un set di dati, area dati o gruppo oppure valore Null (Nothing in Visual Basic) tramite cui viene specificato il contesto in cui valutare l'aggregazione. TramiteNothing viene specificato il contesto più esterno, generalmente il set di dati del report.

Tipo restituito

Dipende dalla funzione di aggregazione specificata nel parametro function .

Osservazioni:

Il valore per RunningValue viene reimpostato su 0 per ogni nuova istanza dell'ambito. Se viene specificato un gruppo, il valore corrente viene reimpostato quando viene modificata l'espressione di raggruppamento. Se viene specificata un'area dati, il valore corrente viene reimpostato per ogni nuova istanza dell'area dati. Se viene specificato un set di dati, il valore corrente non viene reimpostato nell'intero set di dati.

RunningValue non può essere usato in un filtro o un'espressione di ordinamento.

Il set di dati per il quale il valore corrente è calcolato deve avere lo stesso tipo di dati. Per convertire dati con più tipi di dati numerici nello stesso tipo di dati, usare funzioni di conversione come CInt, CDbl o CDec. Per altre informazioni, vedere Funzioni di conversione del tipo.

Scope non può essere un'espressione.

Expression può contenere chiamate alle funzioni di aggregazione nidificate con le eccezioni e le condizioni seguenti:

  • Scope per le aggregazioni nidificate deve corrispondere o essere contenuto nell'ambito dell'aggregazione esterna. Per tutti gli ambiti distinti nell'espressione, un ambito deve essere in una relazione figlio con tutti gli altri ambiti.

  • Scope per le aggregazioni nidificate non può essere il nome di un set di dati.

  • Expression non deve contenere funzioni First, Last, Previouso RunningValue .

  • Expression non deve contenere aggregazioni nidificate che specificano recursive.

Per calcolare il valore corrente del numero di righe, usare RowNumber. Per altre informazioni, vedere Funzione RowNumber (Generatore report e SSRS).

Per altre informazioni, vedere Riferimento a funzioni di aggregazione (Generatore report e SSRS) e Ambito di espressioni per totali, aggregazioni e raccolte predefinite (Generatore report e SSRS).

Per altre informazioni sulle aggregazioni ricorsive, vedere Creazione di gruppi di gerarchie ricorsive (Generatore report e SSRS).

Esempi

L'esempio di codice seguente consente di ottenere una somma parziale del campo denominato Cost nell'ambito più esterno, che corrisponde al set di dati.

=RunningValue(Fields!Cost.Value, Sum, Nothing)  

L'esempio di codice seguente consente di ottenere una somma parziale del campo denominato Score nel set di dati denominato DataSet1.

=RunningValue(Fields!Score.Value,sum,"DataSet1")  

L'esempio di codice seguente consente di ottenere una somma parziale del campo denominato Traffic Charges nell'ambito più esterno.

=RunningValue(Fields!Traffic Charges.Value, Sum, Nothing)