Compartilhar via

  • Artigo

Função RunningValue (Construtor de Relatórios 3.0 e SSRS)

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

ObservaçãoObservação

É possível criar e modificar definições de relatórios (.rdl) no Report Builder 3.0 e no Designer de Relatórios no Business Intelligence Development Studio. Cada ambiente de criação fornece diferentes maneiras de criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Projetando e implementando relatórios usando o Designer de Relatórios (Reporting Services) na Web em microsoft.com.

Sintaxe

RunningValue(expression, function, scope)

Parâmetros

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

  • function
    (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, RowNumber ou Aggregate.

  • scope
    (String) Uma constante de cadeia de caracteres que é o nome de um conjunto de dados, região de dados ou grupo ou nulo (Nothing no 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.

O Scope 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, Previous ou 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, consulte Função RowNumber (Construtor de Relatórios 3.0 e SSRS).

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

Para obter mais informações sobre agregações recursivas, consulte Criando grupos de hierarquias recursivas (Construtor de Relatórios 3.0 e SSRS).

Descrição

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

Código

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