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

Se aplica a: Generador de informes de Microsoft (SSRS) Power BI Report Builder 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

expresión
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, uno de los ámbitos debe estar subordinado a todos los demás á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 .

  • La expresión no debe contener funciones de agregado anidadas que especifiquen 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 Referencia de funciones de agregado (Generador de informes y SSRS) y Ámbito de expresión para totales, funciones de agregado 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 siguiente ejemplo de código muestra la suma acumulada del campo llamado 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 siguiente ejemplo de código muestra la suma acumulada del campo denominado Traffic Charges en el ámbito más externo.

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

Contenido relacionado

  • Last updated on