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

Artigo
09/10/2013

Indica se a instância atual de um item está no escopo especificado.

Observação
Você pode criar e modificar definições de relatório (.rdl) no Construtor de Relatórios e no Designer de Relatórios no SQL Server Data Tools. Cada ambiente de criação fornece modos diferentes para criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Partes de Relatório (Construtor de Relatórios e SSRS) e Partes de Relatório no Designer de Relatórios (SSRS) na Web em microsoft.com.

Você pode criar e modificar definições de relatório (.rdl) no Construtor de Relatórios e no Designer de Relatórios no SQL Server Data Tools. Cada ambiente de criação fornece modos diferentes para criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Partes de Relatório (Construtor de Relatórios e SSRS) e Partes de Relatório no Designer de Relatórios (SSRS) na Web em microsoft.com.

Sintaxe

InScope(scope)

Parâmetros

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

Tipo de retorno

Retorna um Boolean.

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.

O Scope não pode ser uma expressão.

Um uso típico da função InScope é em regiões de dados que possuem escopo dinâmico. Por exemplo, InScope pode ser usada em um link de detalhamento 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 detalhamento, 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 detalhado, 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, consulte 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).