• Article

Fonction InScope (Générateur de rapports version 3.0 et SSRS)

Indique si l'instance actuelle d'un élément se trouve dans l'étendue spécifiée.

Notes

Vous pouvez créer et modifier des définitions de rapports (.rdl) dans le Générateur de rapports version 3.0 et dans le Concepteur de rapports, dans Business Intelligence Development Studio. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes. Pour plus d'informations, consultez Conception de rapports dans le Concepteur de rapports et le Générateur de rapports version 3.0 (SSRS) sur le site Web Microsoft.

Syntaxe

InScope(scope)

Paramètres

  • scope
    (String) Nom d'un dataset, d'une région de données ou d'un groupe qui spécifie une étendue.

Type de valeur retournée

Retourne Boolean.

Notes

La fonction InScope teste l'étendue de l'instance actuelle d'un élément de rapport pour l'appartenance à l'étendue spécifiée par le paramètre scope.

Scope ne peut pas être une expression.

En règle générale, la fonction InScope est utilisée dans les régions de données avec définition d'étendue dynamique. Ainsi, la fonction InScope peut être utilisée dans un lien d'extraction situé dans les cellules d'une région de données pour fournir un autre nom de rapport et des jeux de paramètres différents en fonction de la cellule sur laquelle l'utilisateur clique. En voici un exemple :

  • L'expression suivante, utilisée comme nom de rapport dans un lien d'extraction, ouvre le rapport ProductDetail si l'utilisateur clique sur une cellule située dans le groupe Month et le rapport ProductSummary s'il clique sur une autre cellule.

    =Iif(InScope("Month"), "ProductDetail", "ProductSummary")

  • L'expression suivante, utilisée dans la propriété Omit d'un paramètre de rapport d'extraction, passe le paramètre au rapport cible uniquement si la cellule sur laquelle l'utilisateur clique se trouve dans le groupe Product.

    =Not(InScope("Product"))

Pour plus d'informations, consultez Référence aux fonctions d'agrégation (Générateur de rapports version 3.0 et SSRS) et Présentation de l'étendue des expressions pour les totaux, les agrégats et les collections intégrées (Générateur de rapports version 3.0 et SSRS).

Exemple

L'exemple de code ci-dessous indique si l'instance actuelle de l'élément se trouve dans l'étendue du groupe, de la région de données ou du dataset Product.

=InScope("Product")