Funciones del Generador de informes: función RunningValue en un informe paginado (Generador de informes)

Se aplica a: Generador de informes de Microsoft (SSRS) Generador de informes de Power BI Diseñador de informes en SQL Server Data Tools

Devuelve un agregado actualizado de todos los valores numéricos no NULL especificados por la expresión, que se evalúa en el contexto del ámbito especificado en un informe paginado.

Nota

Puede crear y modificar los archivos de definición de informes paginados (.rdl) en el Generador de informes de Microsoft, en Power BI Report Builder y en el Diseñador de informes de SQL Server Data Tools.

Sintaxis

  
RunningValue(expression, function, scope)  

Parámetros

expression
Expresión en la que se lleva a cabo la agregación; por ejemplo, [Quantity].

function
(Enum) Nombre de la función de agregado que se aplica a la expresión; por ejemplo, Sum. Esta función no puede ser RunningValue, RowNumberni Aggregate.

scope
(String) Constante de cadena que es el nombre de un conjunto de datos, grupo, región de datos o NULL (Nothing en Visual Basic), que especifica el contexto en el que evaluar la agregación. Nothing especifica el contexto más externo, normalmente el conjunto de datos de informe.

Tipo de valor devuelto

Viene determinado por la función de agregado especificada en el parámetro function .

Observaciones

El valor para RunningValue se restablece en 0 para cada nueva instancia del ámbito. Si se especifica un grupo, el valor actual se restablece cuando cambia la expresión de grupo. Si se especifica una región de datos, el valor actual se restablece en cada instancia nueva de la región de datos. Si se especifica un conjunto de datos, el valor actual no se restablece en todo el conjunto de datos.

RunningValue no se puede utilizar en un filtro o expresión de ordenación.

El conjunto de datos para los que se calcula el valor en ejecución debe tener el mismo tipo de datos. Si desea convertir datos de varios tipos de datos numéricos al mismo tipo de datos, use funciones de conversión como CInt, CDbl o CDec. Para obtener más información, vea Funciones de conversión de tipos.

Scope no puede ser una expresión.

Expression puede contener las llamadas a las funciones de agregados anidados con las siguientes excepciones y condiciones:

• El ámbito para los agregados anidados debe ser igual que el ámbito del agregado exterior, o ser contenido por él. Para todos los ámbitos distintos de la expresión, un ámbito debe estar en una relación secundaria con respecto a todos los otros ámbitos.

• El ámbito para los agregados anidados no puede ser el nombre de un conjunto de datos.

• Expression no debe contener las funciones First, Last, Previouso RunningValue .

• Expression no debe contener a los agregados anidados que especifican recursive.

Para calcular el valor actual del número de filas, use RowNumber. Para más información, consulte Función RowNumber (Generador de informes y SSRS).

Para más información, consulte Funciones del generador de informes - referencia de funciones de agregado (Generador de informes y SSRS) y Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS).

Para más información sobre los agregados recursivos, consulte Creación de un grupo de jerarquía recursiva (Generador de informes y SSRS).

Ejemplos

El ejemplo de código siguiente proporciona la suma actual del campo denominado Cost en el ámbito más externo, que es el conjunto de datos.

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

El ejemplo de código siguiente proporciona la suma actual del campo denominado Score en el conjunto de datos denominado DataSet1.

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

El ejemplo de código siguiente proporciona la suma actual del campo denominado Traffic Charges en el ámbito más externo.

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

Consulte también

Usar expresiones en informes (Generador de informes y SSRS)
Ejemplos de expresiones (Generador de informes y SSRS)
Tipos de datos en expresiones (Generador de informes y SSRS)
Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS)