Partilhar via


Funções do Construtor de Relatórios – função InScope 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

Indica se a instância atual de um item está no escopo especificado 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

InScope(scope)  

parâmetros

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

Tipo de retorno

Retorna um Booliano.

Comentários

A função InScope testa o escopo da instância atual de um item de relatório para a associação no escopo especificado pelo parâmetro scope.

OScope não pode ser uma expressão.

Um uso típico da função InScope é em regiões de dados que têm escopo dinâmico. Por exemplo, InScope pode ser usada em um link de drillthrough em células de uma região de dados para fornecer um nome de relatório diferente e conjuntos de parâmetros diferentes, dependendo da célula clicada. Um exemplo disso é o seguinte:

  • A expressão a seguir, usada como o nome do relatório em um link de drillthrough, abrirá 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 a seguir, usada na propriedade Omit de um parâmetro de relatório de drillthrough, passará o parâmetro para o relatório de destino somente se a célula clicada estiver no grupo Product .

    =Not(InScope("Product"))  
    

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).

Exemplo

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

=InScope("Product")