Partilhar via


Funções do Construtor de Relatórios – função RunningValue em um relatório paginado (Construtor de Relatórios)

Aplica-se a: SSRS (Construtor de Relatórios da Microsoft) Power BI Report Builder Report Designer no SQL Server Data Tools

Retorna uma agregação contínua de todos os valores numéricos não nulos especificados pela expressão, avaliados para o escopo fornecido em um relatório paginado.

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Sintaxe

  
RunningValue(expression, function, scope)  

Parâmetros

expressão
A expressão na qual executar a agregação, por exemplo, [Quantity].

função
(Enum) O nome da função de agregação a ser aplicado à expressão, por exemplo, Sum. Essa função não pode ser RunningValue, RowNumberou Aggregate.

escopo
(String) Uma constante de cadeia de caracteres que é o nome de um conjunto de dados, região de dados, grupo ou nulo (Nothing em Visual Basic), que especifica o contexto no qual avaliar a agregação. Nothing especifica o contexto mais externo, geralmente o conjunto de dados do relatório.

Tipo de retorno

Determinado pela função de agregação especificada no parâmetro function .

Comentários

O valor de RunningValue é redefinido como 0 para cada nova instância do escopo. Se um grupo for especificado, o valor em uso será redefinido quando a expressão de grupo for alterada. Se uma região de dados for especificada, o valor em uso será redefinido para cada nova instância da região de dados. Se um conjunto de dados for especificado, o valor em uso não será redefinido em todo o conjunto de dados.

RunningValue não pode ser usado em um filtro ou expressão de classificação.

O conjunto de dados para o qual o valor em execução é calculado deve ter o mesmo tipo de dados. Para converter dados que têm vários tipos de dados numéricos no mesmo tipo de dados, use funções de conversão, como CInt, CDbl ou CDec. Para obter mais informações, consulte Funções de conversão de tipo.

OScope não pode ser uma expressão.

Expression pode conter chamadas para funções de agregação aninhadas com as seguintes exceções e condições:

  • O escopo para agregações aninhadas deve ser igual ao escopo da agregação externa ou deve estar contido nela. Para todos os escopos distintos na expressão, um escopo deve estar em uma relação filho com todos os outros escopos.

  • O escopo para agregações aninhadas não pode ser o nome de um conjunto de dados.

  • Expression não deve conter a função First, Last, Previousou RunningValue .

  • Expression não deve conter agregações aninhadas que especifiquem recursive.

Para calcular o valor em uso do número de linhas, use RowNumber. Para obter mais informações, confira Função RowNumber (Construtor de Relatórios e SSRS).

Para obter mais informações, confira Referência de funções de agregação (Construtor de Relatórios e SSRS) e Escopo das expressões para totais, agregações e coleções internas (Construtor de Relatórios e SSRS).

Para obter mais informações sobre agregações recursivas, confira Criação de Grupos de Hierarquias Recursivas (Construtor de Relatórios e SSRS).

Exemplos

O exemplo de código a seguir fornece uma soma parcial do campo denominado Cost no escopo mais externo que é o conjunto de dados.

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

O exemplo de código a seguir fornece uma soma parcial do campo denominado Score no conjunto de dados denominado DataSet1.

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

O exemplo de código a seguir fornece uma soma parcial do campo denominado Traffic Charges no escopo mais externo.

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