Fonctions du Générateur de rapports - Fonction InScope dans un rapport paginé (Générateur de rapports)

S’applique à : Générateur de rapports Microsoft (SSRS) Power BI Report Builder Concepteur de rapports dans SQL Server Data Tools

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

Notes

Il est possible de créer et de modifier des fichiers de définition de rapports (.rdl) paginés dans le Générateur de rapports Microsoft, dans Power BI Report Builder et dans le Concepteur de rapports de SQL Server Data Tools.

Syntaxe

InScope(scope)  

Paramètres

scope
(Chaîne) Nom d’un dataset, d’une région de données ou d’un groupe qui spécifie une étendue.

Type de retour

Retourne une valeur booléenne.

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 et SSRS) et Étendue des expressions pour les totaux, les agrégats et les collections intégrées (Générateur de rapports 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")  

Voir aussi

Utilisation d'expressions dans les rapports (Générateur de rapport et SSRS)
Exemples d'expressions (Générateur de rapports et SSRS)
Types de données dans les expressions (Générateur de rapports et SSRS)
Étendue des expressions pour les totaux, les agrégats et les collections intégrées (Générateur de rapports et SSRS)