Funktionen von Report Builder – Referenz für Aggregatfunktionen in paginierten Berichten (Report Builder)

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

Um aggregierte Werte in ihren paginierten Bericht einzuschließen, können Sie integrierte Aggregatfunktionen in Ausdrücken verwenden. Die Standardaggregatfunktion für numerische Felder ist SUM. Sie können den Ausdruck bearbeiten und eine andere integrierte Aggregatfunktion verwenden oder einen anderen Bereich angeben. Mit dem Bereich wird angegeben, welcher Satz an Daten für die Berechnung verwendet werden soll.

Der Berichtsprozessor kombiniert Berichtsdaten und das Berichtslayout, und die Ausdrücke für jedes Berichtselement werden ausgewertet. Beim Anzeigen der einzelnen Seiten des Berichts sehen Sie die Ergebnisse für jeden Ausdruck in den gerenderten Berichtselementen.

In der folgenden Tabelle sind Kategorien von integrierten Funktionen aufgeführt, die Sie in einen Ausdruck einschließen können:

• Integrierte Aggregatfunktionen

• Einschränkungen bei integrierten Feldern, Auflistungen und Aggregatfunktionen

• Beschränkungen bei geschachtelten Aggregaten

• Berechnung fortlaufender Werte

• Abrufen von Zeilenanzahlen

• Werte in einem anderen Datensatz nachschlagen

• Abrufen von sortierungsabhängigen Werten

• Abrufen von Serveraggregaten

• Abrufen der rekursiven Ebene

• Testen des Bereichs

Um die gültigen Geltungsbereiche für eine Funktion zu ermitteln, finden Sie weitere Informationen im Referenzthema der jeweiligen Funktion. Weitere Informationen und Beispiele finden Sie unter Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Sammlungen (Berichts-Generator und SSRS).

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.

Integrierte Aggregatfunktionen

Die folgenden integrierten Funktionen berechnen aggregierte Werte für eine Menge numerischer Nicht-NULL-Daten im Standardbereich oder im benannten Bereich.

Function	Beschreibung
Avg	Gibt den Durchschnitt aller numerischen Werte zurück, die nicht null sind und durch den Ausdruck angegeben werden, der im angegebenen Gültigkeitsbereich ausgewertet wird.
Count	Gibt die Anzahl der nicht-NULL-Werte zurück, die durch den Ausdruck angegeben werden, der im Kontext des angegebenen Bereichs ausgewertet wird.
CountDistinct	Gibt die Anzahl aller verschiedenen Werte zurück, die nicht NULL sind, durch den Ausdruck angegeben werden und im Kontext des angegebenen Bereichs ausgewertet werden.
Max	Gibt den größten Wert aller numerischen Werte zurück, die nicht NULL sind und durch den Ausdruck angegeben werden, im Kontext des angegebenen Gültigkeitsbereichs. Sie können diese Funktion verwenden, um einen Diagrammachsen-Höchstwert zur Steuerung der Skala anzugeben.
Min	Gibt den Mindestwert aller nicht-NULL numerischen Werte zurück, die durch den Ausdruck angegeben werden, im Kontext des angegebenen Gültigkeitsbereichs. Sie können diese Funktion verwenden, um einen Diagrammachsen-Mindestwert zur Steuerung der Skala anzugeben.
StDev	Gibt die Standardabweichung aller Nicht-NULL-Zahlenwerte zurück, die durch den Ausdruck angegeben und im gegebenen Geltungsbereich ausgewertet werden.
StDevP	Gibt die Populationsstandardabweichung aller numerischen Werte ungleich NULL zurück, die durch den Ausdruck angegeben und im Kontext des angegebenen Bereichs ausgewertet werden.
Summe	Gibt die Summe aller numerischen Werte zurück, die nicht null sind und durch den Ausdruck angegeben werden, der im angegebenen Gültigkeitsbereich ausgewertet wird.
Union	Gibt die Vereinigung aller räumlichen Datenwerte vom Typ SqlGeometry oder SqlGeography zurück, die nicht NULL sind, durch den Ausdruck angegeben werden und im angegebenen Bereich ausgewertet werden.
Var	Gibt die Varianz aller numerischen Werte zurück, die nicht null sind, durch den Ausdruck angegeben werden und im angegebenen Gültigkeitsbereich ausgewertet werden.
VarP	Gibt die Populationsvarianz aller numerischen Werte zurück, die nicht NULL sind und anhand des Ausdrucks im Kontext des angegebenen Gültigkeitsbereichs ausgewertet werden.

Zurück zum Anfang

Einschränkungen bei integrierten Feldern, Auflistungen und Aggregatfunktionen

In der folgenden Tabelle werden Einschränkungen für Berichtspositionen zusammengefasst, auf deren Grundlage Sie Ausdrücke hinzufügen können, die Verweise auf globale integrierte Auflistungen enthalten.

Position im Bericht	Felder	Parameter	Berichtselemente	Seitennummer Gesamtseiten	Datenquelle Datensatz	Variablen	RenderFormat
Seitenheader Seitenfuß	Ja	Ja	Höchstens eins Hinweis 1	Ja	Ja	Ja	Ja
Body	Ja Hinweis 2	Ja	Nur Elemente im aktuellen Bereich oder in einem übergeordneten Bereich Hinweis 3	Nein	Ja	Ja	Ja
Berichtsparameter	Nein	Nur Parameter am Anfang der Liste Hinweis 4	Nein	Nein	Nein	Nein	Nein
Feld	Ja	Ja	Nein	Nein	Nein	Nein	Nein
Abfrageparameter	Nein	Ja	Nein	Nein	Nein	Nein	Nein
Gruppierungsausdruck	Ja	Ja	Nein	Nein	Ja	Nein	Nein
Sortierungsausdruck	Ja	Ja	Nein	Nein	Ja	Ja Hinweis 5	Nein
Filterausdruck	Ja	Ja	Nein	Nein	Ja	Ja Hinweis 6	Nein
Code	Nein	Ja Hinweis 7	Nein	Nein	Nein	Nein	Nein
Berichtssprache	Nein	Ja	Nein	Nein	Nein	Nein	Nein
Variablen	Ja	Ja	Nein	Nein	Ja	Aktueller oder enthaltener Bereich	Nein
Aggregate	Ja	Ja	Nur in Seitenkopf/Seitenfuß	Nur in Berichtselementaggregaten	Ja	Nein	Nein
Suchfunktionen	Ja	Ja	Ja	Nein	Ja	Nein	Nein

• Hinweis 1. Berichtselemente müssen in der gerenderten Berichtsseite vorhanden sein, oder der Wert ist NULL. Wenn die Sichtbarkeit eines Berichtselements von einem Ausdruck abhängt, der False ergibt, ist das Berichtselement auf der Seite nicht vorhanden.

• Hinweis 2. Wenn ein Feldverweis im Gültigkeitsbereich einer Gruppe verwendet wird und der Feldverweis nicht im Gruppenausdruck enthalten ist, ist der Wert für das Feld nicht definiert, es sei denn, es gibt im Gültigkeitsbereich nur einen Wert. Verwenden Sie Erste oder Letzte und den Gruppenbereich, um einen Wert anzugeben.

• Hinweis 3. Ausdrücke, die einen Verweis auf Berichtselemente einschließen, können Werte für andere Berichtselemente im gleichen Gruppenbereich oder einem enthaltenen Gruppenbereich angeben.

• Hinweis 4. Die Eigenschaftswerte für frühere Parameter sind u. U. NULL.

• Hinweis 5. Nur in Mitgliedssortierungen. Nicht zu verwenden in Ausdrücken für die Datenbereichssortierung.

• Hinweis 6. Nur in Mitgliederfiltern. Kann nicht in Datenregions- oder Dataset-Filterausdrücken verwendet werden.

• Hinweis 7. Die Parametersammlung wird erst initialisiert, nachdem der Codeblock verarbeitet wurde, daher können keine Methoden zum Steuern von Parametern während der Initialisierung verwendet werden.

• Hinweis 8. Der Datentyp für alle Aggregate außer Count und CountDistinct muss für alle Werte der gleiche Datentyp oder NULL sein.

Zurück zum Anfang

Beschränkungen bei geschachtelten Aggregaten

In der folgenden Tabelle finden Sie Einschränkungen, auf deren Grundlage Aggregatfunktionen andere Aggregatfunktionen als geschachtelte Aggregate angeben können.

Kontext	RunningValue	Zeilennummer	Erster Letzter	Zurück	Sum und andere Vorsortierungsfunktionen	ReportItem-Aggregationen	Suchfunktionen	Aggregatfunktion
Aktueller Wert	Nein	Nein	Nein	Nein	Ja	Nein	Ja	Nein
Erste Letzter	Nein	Nein	Nein	Nein	Ja	Nein	Nein	Nein
Zurück	Ja	Ja	Ja	Nein	Ja	Nein	Ja	Nein
Summe und andere Vorsortierfunktionen	Nein	Nein	Nein	Nein	Ja	Nein	Ja	Nein
ReportItem-Aggregate	Nein	Nein	Nein	Nein	Nein	Nein	Nein	Nein
Suchfunktionen	Ja	Ja Hinweis 1	Ja Hinweis 1	Ja Hinweis 1	Ja Hinweis 1	Ja Hinweis 1	Nein	Nein
Aggregatfunktion	Nein	Nein	Nein	Nein	Nein	Nein	Nein	Nein

• Hinweis 1. Aggregatfunktionen sind nur im Source -Ausdruck einer Suchfunktion zulässig, wenn die Suchfunktion nicht in einem Aggregat enthalten ist. Aggregatfunktionen sind im Destination -Ausdruck oder Result -Ausdruck einer Suchfunktion nicht zulässig.

Zurück zum Anfang

Berechnung fortlaufender Werte

Die folgenden integrierten Funktionen berechnen laufende Werte für einen Datensatz. RowNumber ist RunningValue ähnlich, da es den fortlaufenden Wert einer Zählung zurückgibt, der für jede Zeile innerhalb des enthaltenden Bereichs inkrementiert wird. Der Bereichsparameter für diese Funktionen muss einen enthaltenden Bereich angeben, der steuert, wann der Zähler neu gestartet wird.

Function	Beschreibung
RowNumber	Gibt eine laufende Zählung der Zeilenanzahl für den angegebenen Bereich zurück. Die RowNumber -Funktion startet den Zähler bei 1 neu und nicht bei 0.
RunningValue	Gibt einen fortlaufenden Aggregatwert aller numerischen Werte zurück, die nicht NULL sind und durch den Ausdruck angegeben werden, der für den angegebenen Gültigkeitsbereich ausgewertet wird.

Zurück zum Anfang

Abrufen von Zeilenanzahlen

Die folgende integrierte Funktion berechnet die Anzahl von Zeilen im angegebenen Bereich. Verwenden Sie diese Funktion, um alle Zeilen zu zählen, einschließlich Zeilen mit NULL-Werten.

Function	Beschreibung
CountRows	Gibt die Anzahl der Zeilen im angegebenen Bereich zurück, einschließlich der Zeilen mit NULL-Werten.

Zurück zum Anfang

Nachschlagen von Werten aus einem anderen Dataset

Die folgenden Suchfunktionen rufen Werte aus einem angegebenen Dataset ab.

Function	Beschreibung
Lookup-Funktion	Gibt für einen angegebenen Ausdruck einen Wert aus einem Dataset zurück.
LookupSet-Funktion	Gibt für einen angegebenen Ausdruck einen Satz von Werten aus einem Dataset zurück.
Multilookup-Funktion	Gibt den Satz der ersten übereinstimmenden Werte für einen Satz von Namen aus einem Dataset mit Name-Wert-Paaren zurück.

Zurück zum Anfang

Abrufen von von der Sortierung abhängigen Werten

Die folgenden integrierten Funktionen geben den ersten, letzten oder vorherigen Wert innerhalb eines gegebenen Bereichs zurück. Diese Funktionen hängen von der Sortierreihenfolge der Datenwerte ab. Verwenden Sie diese Funktionen, um beispielsweise den ersten und den letzten Wert auf einer Seite zu suchen, um Seitenkopfzeilen im Wörterbuchformat zu erstellen. Verwenden Sie Previous , um einen Wert in einer Zeile mit dem Wert der vorherigen Zeile innerhalb eines bestimmten Bereichs zu vergleichen, beispielsweise, um jährliche Prozentwerte in einer Tabelle zu finden.

Function	Beschreibung
First	Gibt den ersten Wert im festgelegten Bereich des angegebenen Ausdrucks zurück.
Zuletzt	Gibt den letzten Wert im festgelegten Bereich des angegebenen Ausdrucks zurück.
Zurück	Gibt den Wert oder den angegebenen Aggregatwert für die vorherige Instanz eines Elements innerhalb des angegebenen Bereichs zurück.

Zurück zum Anfang

Serveraggregate abrufen

Die folgende integrierte Funktion ruft benutzerdefinierte Aggregate vom Datenanbieter ab. Mithilfe eines Analysis Services-Datenquellentyps können Sie beispielsweise Aggregate, die auf dem Datenquellenserver berechnet wurden, für die Verwendung in einer Gruppenkopfzeile abrufen.

Function	Beschreibung
Aggregat	Gibt ein benutzerdefiniertes Aggregat des angegebenen Ausdrucks gemäß der Definition durch den Datenanbieter zurück.

Zurück zum Anfang

Testen für Bereich

Die folgende integrierte Funktion testet den aktuellen Kontext eines Berichtselements, um festzustellen, ob dieses Mitglied eines bestimmten Bereichs ist.

Funktion	BESCHREIBUNG
InScope	Gibt an, ob sich die aktuelle Instanz eines Elements innerhalb des angegebenen Bereichs befindet.

Zurück zum Anfang

Abrufen der rekursiven Ebene

Die folgende integrierte Funktion ruft die aktuelle Ebene ab, wenn eine rekursive Hierarchie verarbeitet wird. Verwenden Sie das Ergebnis dieser Funktion mit der Eigenschaft Padding in einem Textfeld, um für eine rekursive Gruppe die Einzugsebene in einer visuellen Hierarchie zu steuern. Weitere Informationen finden Sie unter Erstellen von rekursiven Hierarchiegruppen (Berichts-Generator und SSRS).

Funktion	BESCHREIBUNG
Level	Gibt die aktuelle Tiefe in einer rekursiven Hierarchie zurück.

Zurück zum Anfang

Zugehöriger Inhalt

• Ausdrucksverwendungen in paginierten Berichten (Berichts-Generator)
• Ausdrucksbeispiele in paginierten Berichten des Report Builder
• Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Sammlungen in einem paginierten Bericht (Berichts-Generator)