Función InScope (Generador de informes y SSRS)

Artículo
09/10/2013

Indica si la instancia actual de un elemento se encuentra en el ámbito especificado.

[!NOTA]

Puede crear y modificar las definiciones de informe (.rdl) en el Generador de informes y en el Diseñador de informes en SQL Server Data Tools. Cada entorno de creación proporciona varias maneras de crear, abrir y guardar informes y elementos relacionados. Para obtener más información, vea la información sobre el diseño de informes en el Generador de informes y el Administrador de informes (SSRS) en el sitio web microsoft.com.

Sintaxis

InScope(scope)

Parámetros

scope
(String). Nombre de un conjunto de datos, una región de datos o un grupo que especifica un ámbito.

Tipo devuelto

Devuelve un Boolean.

Comentarios

La función InScope comprueba si el ámbito de la instancia actual de un elemento de informe pertenece al ámbito especificado por el parámetro scope.

Scope no puede ser una expresión.

La función InScope se usa habitualmente en regiones de datos que tienen un ámbito dinámico. Por ejemplo, se puede usar InScope en un vínculo de obtención de detalles de las celdas de una región de datos para ofrecer un nombre de informe distinto y diferentes conjuntos de parámetros en función de la celda en la que se haga clic. He aquí un ejemplo:

La expresión siguiente, usada como nombre de informe en un vínculo de obtención de detalles, abre el informe ProductDetail si la celda en la que se hace clic está en el grupo Month, o el informe ProductSummary si no lo está.
```
=Iif(InScope("Month"), "ProductDetail", "ProductSummary")
```
La expresión siguiente, usada en la propiedad Omit de un parámetro de informe detallado, pasa el parámetro al informe de destino solo si la celda en la que se hace clic está en el grupo Product.
```
=Not(InScope("Product"))
```

Para obtener más información, vea Referencia a las funciones de agregado (Generador de informes y SSRS) y Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS).

Ejemplo

El siguiente ejemplo de código indica si la instancia actual del elemento está en el ámbito del conjunto de datos, la región de datos o el grupo Product.