Funktionen im Berichts-Generator: InScope-Funktion in einem paginierten Bericht (Berichts-Generator)

Gilt für: Microsoft Report Builder (SSRS) Power BI Report Builder Berichts-Designer in SQL Server Data Tools

Gibt an, ob sich die aktuelle Instanz eines Elements in einem paginierten Bericht im angegebenen Geltungsbereich befindet.

Hinweis

Sie können paginierte Berichtsdefinitionsdateien (.rdl) im Berichts-Generator von Microsoft, im Power BI Report Builder und im Berichts-Designer in SQL Server-Datentools erstellen und ändern.

Syntax

InScope(scope)

Parameter

scope
(String) Der Name eines Datasets, eines Datenbereichs oder einer Gruppe, die einen Bereich angibt.

Rückgabetyp

Gibt einen Booleanzurück.

Bemerkungen

Die InScope-Funktion testet den Bereich der aktuellen Instanz eines Berichtselements in Bezug auf die Mitgliedschaft in dem durch den Parameter scope angegebenen Bereich.

Scope darf kein Ausdruck sein.

Die InScope -Funktion wird üblicherweise in Datenbereichen mit dynamischer Bereichsdefinierung eingesetzt. So kann InScope beispielsweise in einem Drillthroughlink in einer Datenbereichszelle verwendet werden, um unterschiedliche Berichtsnamen und unterschiedliche Parametersätze bereitzustellen, je nach Zelle, auf die Sie klicken. Dies wird im folgenden Beispiel verdeutlicht:

  • Der folgende Ausdruck, der als Berichtsname in einem Drillthrough-Link verwendet wird, öffnet den ProductDetail-Bericht, wenn sich die angeklickte Zelle in der Month-Gruppe befindet, andernfalls den ProductSummary-Bericht.

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

  • Der folgende Ausdruck, der in der Omit-Eigenschaft eines Drillthrough-Berichtsparameters verwendet wird, übergibt den Parameter nur dann an den Zielbericht, wenn sich die angeklickte Zelle in der Product-Gruppe befindet.

    =Not(InScope("Product"))

Weitere Informationen finden Sie in der Aggregatfunktionsreferenz (Berichts-Generator und SSRS) und unter Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS).

Beispiel

Im folgenden Codebeispiel wird angezeigt, ob sich die aktuelle Instanz des Elements innerhalb des Product -Datasets, -Datenbereichs oder -Gruppenbereichs befindet.

=InScope("Product")

Zugehöriger Inhalt

  • Last updated on