Udostępnij przez

Funkcje programu Report Builder — odniesienie do funkcji agregujących w raportach stronicowanych (Report Builder)

Dotyczy: Microsoft Report Builder (SSRS) Power BI Report Builder Projektant raportów w narzędziu SQL Server Data Tools

Aby uwzględnić zagregowane wartości w raporcie podzielonym na strony, możesz użyć wbudowanych funkcji agregujących w wyrażeniach. Domyślna funkcja agregacji dla pól liczbowych to SUM. Możesz edytować wyrażenie i użyć innej wbudowanej funkcji agregującej lub określić inny zakres. Zakres określa zestaw danych do użycia na potrzeby obliczeń.

Ponieważ procesor raportów łączy dane raportu i układ raportu, wyrażenia dla każdego elementu raportu są oceniane. Podczas wyświetlania każdej strony raportu zostaną wyświetlone wyniki dla każdego wyrażenia w renderowanych elementach raportu.

W poniższej tabeli wymieniono kategorie wbudowanych funkcji, które można uwzględnić w wyrażeniu:

Aby określić prawidłowe zakresy funkcji, zobacz temat referencyjny dla poszczególnych funkcji. Aby uzyskać więcej informacji i przykładów, zobacz Zakres wyrażeń dla sum, agregatów i wbudowanych kolekcji (Report Builder i SSRS).

Uwaga / Notatka

Pliki definicji raportu podzielonego na strony (rdl) można tworzyć i modyfikować w programie Microsoft Report Builder, programie Power BI Report Builder i w projektancie raportów w narzędziach SQL Server Data Tools.

Wbudowane funkcje agregujące

Następujące wbudowane funkcje obliczają wartości podsumowania dla zestawu danych liczbowych innych niż null w zakresie domyślnym lub nazwanym zakresie.

Function Opis
Avg Zwraca średnią wszystkich wartości liczbowych innych niż null określonych przez wyrażenie obliczone w danym zakresie.
Liczba Zwraca liczbę wartości innych niż null określonych przez wyrażenie obliczone w kontekście danego zakresu.
CountDistinct Zwraca liczbę wszystkich unikatowych wartości innych niż null określonych przez wyrażenie obliczone w kontekście danego zakresu.
Maksimum Zwraca maksymalną wartość wszystkich wartości liczbowych innych niż null określonych przez wyrażenie w kontekście danego zakresu. Można go użyć do określania maksymalnej wartości osi wykresu w celu kontrolowania skali.
Min Zwraca minimalną wartość wszystkich wartości liczbowych innych niż null określonych przez wyrażenie w kontekście danego zakresu. Można go użyć do określania wartości minimalnej osi wykresu w celu kontrolowania skali.
StDev Zwraca odchylenie standardowe wszystkich wartości liczbowych innych niż null określonych przez wyrażenie obliczone w danym zakresie.
StDevP Zwraca odchylenie standardowe populacji wszystkich wartości liczbowych innych niż null określonych przez wyrażenie obliczone w kontekście danego zakresu.
Sum Zwraca sumę wszystkich wartości liczbowych innych niż null określonych przez wyrażenie obliczone w danym zakresie.
Unia Zwraca unię wszystkich wartości danych przestrzennych innych niż null typu SqlGeometry lub SqlGeography określonych przez wyrażenie obliczone w danym zakresie.
Var Zwraca wariancję wszystkich wartości liczbowych innych niż null określonych przez wyrażenie obliczone w danym zakresie.
VarP Zwraca wariancję populacji wszystkich wartości liczbowych innych niż null określonych przez wyrażenie obliczone w kontekście danego zakresu.

Ikona strzałki używana z linkiem Powrót do góry Powrót do góry

Ograniczenia dotyczące wbudowanych pól, kolekcji i funkcji agregujących

W poniższej tabeli przedstawiono podsumowanie ograniczeń w lokalizacjach raportów, w których można dodawać wyrażenia zawierające odwołania do globalnych kolekcji wbudowanych.

Lokalizacja w raporcie Pola formularza Parametry ReportItems Numer strony

TotalPages		 Źródło danych

Dataset		 Variables RenderFormat
Nagłówek strony

Stopka strony		 Tak Tak Co najwyżej jeden

Notatka 1		 Tak Tak Tak Tak
Body Tak

Uwaga 2		 Tak Tylko elementy w bieżącym zakresie lub zawierającym zakres

Uwaga 3		 Nie. Tak Tak Tak
Parametr raportu Nie. Tylko wcześniejsze parametry na liście

Uwaga 4		 Nie. Nie. Nie. Nie. Nie.
(No changes needed) Tak Tak Nie. Nie. Nie. Nie. Nie.
Parametr zapytania Nie. Tak Nie. Nie. Nie. Nie. Nie.
Wyrażenie grupy Tak Tak Nie. Nie. Tak Nie. Nie.
Wyrażenie sortowania Tak Tak Nie. Nie. Tak Tak

Uwaga 5		 Nie.
Wyrażenie filtru Tak Tak Nie. Nie. Tak Tak

Uwaga 6		 Nie.
Code Nie. Tak

Uwaga 7		 Nie. Nie. Nie. Nie. Nie.
Report.Language Nie. Tak Nie. Nie. Nie. Nie. Nie.
Variables Tak Tak Nie. Nie. Tak Obecny zakres lub zakres, który zawiera Nie.
Aggregates Tak Tak Tylko w nagłówku/stopce strony Tylko w agregacjach elementów raportu Tak Nie. Nie.
Funkcje wyszukiwania Tak Tak Tak Nie. Tak Nie. Nie.

  • Uwaga 1. Element ReportItems musi istnieć na renderowanej stronie raportu lub ich wartość ma wartość Null. Jeśli widoczność elementu raportu zależy od wyrażenia, które daje wartość False, element raportu nie istnieje na stronie.

  • Uwaga 2. Jeśli odwołanie do pola jest używane w zakresie grupy, a odwołanie do pola nie jest uwzględnione w wyrażeniu grupy, wartość pola jest niezdefiniowana, chyba że istnieje tylko jedna wartość w zakresie. Aby określić wartość, użyj opcji Pierwszy lub Ostatni i zakres grupy.

  • Uwaga 3. Wyrażenia zawierające odwołanie do elementu ReportItems mogą określać wartości dla innych elementów ReportItems w tym samym zakresie grupy lub w zakresie zawierającym grupę.

  • Uwaga 4. Wartości właściwości dla wcześniejszych parametrów mogą mieć wartość null.

  • Uwaga 5. Tylko w sortowaniu członków. Nie można używać w wyrażeniach sortowania regionów danych.

  • Uwaga 6. Tylko w filtrach członków. Nie można używać w regionie danych ani w wyrażeniach filtrów zestawu danych.

  • Uwaga 7. Kolekcja Parameters nie jest inicjowana do momentu przetworzenia bloku kodu, dlatego metody nie mogą służyć do kontrolowania parametrów podczas inicjowania.

  • Uwaga 8. Typ danych dla wszystkich agregacji z wyjątkiem Count i CountDistinct musi być tym samym typem danych lub wartością null dla wszystkich wartości.

Ikona strzałki używana z linkiem Powrót do góry Powrót do góry

Ograniczenia dotyczące zagnieżdżonych agregacji

W poniższej tabeli podsumowano ograniczenia dotyczące tego, które funkcje agregujące mogą określać inne funkcje jako zagnieżdżone agregaty.

Context RunningValue Numer wiersza First

Ostatni		 Wstecz Funkcje Suma i Inne Przedsortowanie Agregaty elementów raportu Funkcje wyszukiwania Funkcja agregacji
Wartość bieżąca Nie. Nie. Nie. Nie. Tak Nie. Tak Nie.
First

Ostatni		 Nie. Nie. Nie. Nie. Tak Nie. Nie. Nie.
Wstecz Tak Tak Tak Nie. Tak Nie. Tak Nie.
Sum i inne funkcje wstępnego sortowania Nie. Nie. Nie. Nie. Tak Nie. Tak Nie.
Agregacje elementu raporu Nie. Nie. Nie. Nie. Nie. Nie. Nie. Nie.
Funkcje wyszukiwania Tak Tak

Notatka 1		 Tak

Notatka 1		 Tak

Notatka 1		 Tak

Notatka 1		 Tak

Notatka 1		 Nie. Nie.
Funkcja agregacji Nie. Nie. Nie. Nie. Nie. Nie. Nie. Nie.
  • Uwaga 1. Funkcje agregujące są dozwolone tylko wewnątrz wyrażenia źródłowego funkcji Lookup, jeśli funkcja Lookup nie jest zawarta w agregacji. Funkcje agregujące nie są dozwolone w wyrażeniach Destination lub Result funkcji Lookup.

Ikona strzałki używana z linkiem Powrót do góry Powrót do góry

Obliczanie bieżących wartości

Następujące wbudowane funkcje obliczają bieżące wartości dla zestawu danych. RowNumber jest podobny do RunningValue, ponieważ zwraca bieżącą wartość liczenia, która zwiększa się dla każdego wiersza w kontenerowym zakresie. Parametr zakresu dla tych funkcji musi określać zawierający kontekst, który kontroluje moment rozpoczęcia ponownego zliczania.

Function Opis
Nr wiersza Zwraca bieżącą liczbę wierszy dla określonego zakresu. Funkcja RowNumber uruchamia ponownie zliczanie z wartością 1, a nie 0.
RunningValue Zwraca bieżącą agregację wszystkich wartości liczbowych innych niż null określonych przez wyrażenie, obliczonej w podanym zakresie.

Ikona strzałki używana z linkiem Powrót do góry

Uzyskiwanie liczby wierszy

Następująca wbudowana funkcja oblicza liczbę wierszy w danym zakresie. Ta funkcja służy do zliczania wszystkich wierszy, w tym wierszy z wartościami null.

Function Opis
CountRows Zwraca liczbę wierszy w określonym zakresie, w tym wiersze z wartościami null.

Ikona strzałki używana z linkiem Powrót do góry Powrót do góry

Szukanie wartości z innego zestawu danych

Następujące funkcje wyszukiwania pobierają wartości z określonego zestawu danych.

Function Opis
Funkcja Lookup Zwraca wartość z zestawu danych dla określonego wyrażenia.
Funkcja LookupSet Zwraca zestaw wartości z zestawu danych dla określonego wyrażenia.
Funkcja Multilookup Zwraca zestaw wartości pierwszego dopasowania dla zestawu nazw z zestawu danych zawierającego pary nazwa/wartość.

Ikona strzałki używana z linkiem Powrót do góry Powrót do góry

Pobieranie wartości zależnych od sortowania

Następujące wbudowane funkcje zwracają pierwszą, ostatnią lub poprzednią wartość w danym zakresie. Te funkcje zależą od kolejności sortowania wartości danych. Użyj tych funkcji, na przykład, aby znaleźć pierwsze i ostatnie wartości na stronie w celu utworzenia nagłówka strony w stylu słownika. Użyj funkcji Previous, aby porównać wartość w jednym wierszu z wartością poprzedniego wiersza w określonym zakresie, na przykład aby znaleźć wartości procentowe rok do roku w tabeli.

Function Opis
First Zwraca pierwszą wartość w danym zakresie określonego wyrażenia.
ostatnia Zwraca ostatnią wartość w danym zakresie określonego wyrażenia.
Previous Zwraca wartość lub określoną wartość zagregowaną dla poprzedniego wystąpienia elementu w określonym zakresie.

Ikona strzałki używana z linkiem Powrót na górę Powrót na górę

Pobieranie agregacji serwera

Poniższa wbudowana funkcja pobiera niestandardowe agregacje od dostawcy danych. Na przykład przy użyciu typu źródła danych usług Analysis Services można pobrać agregacje obliczane na serwerze źródła danych do użycia w nagłówku grupy.

Function Opis
Kruszywo Zwraca niestandardową agregację określonego wyrażenia zgodnie z definicją dostawcy danych.

Ikona strzałki używana z linkiem Powrót do góry Powrót do góry

Testowanie zakresu

Poniższa wbudowana funkcja testuje bieżący kontekst elementu raportu, aby sprawdzić, czy jest członkiem określonego zakresu.

Funkcja Description
InScope Wskazuje, czy bieżące wystąpienie elementu znajduje się w określonym zakresie.

Ikona strzałki używana z linkiem Powrót do góry Powrót do góry

Pobieranie poziomu rekurencyjnego

Następująca wbudowana funkcja pobiera bieżący poziom, gdy jest przetwarzana hierarchia cyklisywna. Użyj wyniku tej funkcji z właściwością Dopełnienie w polu tekstowym, aby kontrolować poziom wcięcia hierarchii wizualnej dla grupy rekurencyjnej. Aby uzyskać więcej informacji, zobacz Tworzenie cyklicznych grup hierarchii (Report Builder i SSRS).

Funkcja Description
Poziom Zwraca bieżący poziom głębokości w hierarchii rekursywnej.

Ikona strzałki używana z linkiem Powrót do góry Powrót do góry

Treści powiązane

  • Last updated on