Partilhar via


Funções do Construtor de Relatórios - Função InScope num relatório paginado (Construtor de Relatórios)

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

Indica se a instância atual de um item está no âmbito especificado num 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, no Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Sintaxe

InScope(scope)  

Parâmetros

âmbito
(String) O nome de um conjunto de dados, região de dados ou grupo que especifica um escopo.

Tipo de Retorno

Devolve um valor booleano.

Observações

A função InScope testa o âmbito da instância atual de um item de relatório quanto à pertença ao âmbito especificado pelo parâmetro de escopo .

O âmbito não pode ser uma expressão.

Uma utilização típica da função InScope é em regiões de dados que têm âmbito dinâmico. Por exemplo, InScope pode ser usado num link de detalhamento nas células de uma região de dados para fornecer um nome de relatório diferente e conjuntos distintos de parâmetros, dependendo da célula em que se clica. Um exemplo disto é o seguinte:

  • A expressão seguinte, utilizada como nome do relatório num link de aprofundamento, abre o relatório ProductDetail se a célula clicada estiver no grupo Month e o relatório ProductSummary se não estiver.

    =Iif(InScope("Month"), "ProductDetail", "ProductSummary")  
    
  • A expressão seguinte, usada na propriedade Omit de um parâmetro de relatório de drillthrough, passará o parâmetro para o relatório alvo apenas se a célula clicada estiver no Product grupo.

    =Not(InScope("Product"))  
    

Para mais informações, consulte Aggregate Functions Reference (Report Builder e SSRS) e Expression Scope for Totais, Aggregates e Coleções Incorporadas (Report Builder e SSRS).

Example

O exemplo de código seguinte indica se a instância atual do item está no Product conjunto de dados, região de dados ou âmbito de grupo.

=InScope("Product")