Udostępnij za pośrednictwem

Wbudowane kolekcje — odwołania do zmiennych raportu i grupowania w raporcie podzielonym na strony (Power BI Report Builder)

DOTYCZY: Power BI Report Builder Power BI Desktop

Jeśli masz złożone obliczenie, które jest używane więcej niż raz w wyrażeniach w raporcie podzielonym na strony, możesz utworzyć zmienną. Możesz utworzyć zmienną raportu lub zmienną grupową. Nazwy zmiennych muszą być unikatowe w raporcie.

Zmienne raportu

Użyj zmiennej raportu, aby przechowywać wartość obliczeń zależnych od czasu, takich jak kursy walut lub sygnatury czasowe, lub złożone obliczenie, do którego odwołuje się wiele razy. Domyślnie zmienna raportu jest obliczana raz i może być używana w wyrażeniach w raporcie. Zmienne raportu są domyślnie tylko do odczytu. Możesz zmienić wartość domyślną, aby włączyć zmienną raportu jako odczyt-zapis. Wartość w zmiennej raportu jest zachowywana w całej sesji do momentu ponownego przetworzenia raportu.

Aby dodać zmienną raportu, otwórz okno dialogowe ReportProperties , wybierz pozycję Zmienne i podaj nazwę i wartość. Nazwy to ciągi z uwzględnieniem wielkości liter, które zaczynają się literą i nie mają spacji. Nazwa może zawierać litery, cyfry lub podkreślenia (_).

Aby odwołać się do zmiennej w wyrażeniu, użyj składni kolekcji globalnej, na przykład =Variables!CustomTimeStamp.Value. Na powierzchni projektowej wartość jest wyświetlana w polu tekstowym jako <<Expr>>.

Zmienne raportu można używać w następujący sposób:

  • Ustawienie wartości tylko do odczytu służy raz, aby utworzyć stałą dla sesji raportu, na przykład w celu utworzenia sygnatury czasowej.

    Ponieważ wyrażenia w polach tekstowych są oceniane na żądanie jako strony użytkownika za pośrednictwem raportu, wartości dynamiczne (na przykład wyrażenie zawierające Now() funkcję, która zwraca godzinę dnia) może zwracać różne wartości, jeśli strona do przodu i do tyłu przy użyciu przycisku Wstecz . Ustawiając wartość zmiennej raportu na wyrażenie =Now(), a następnie dodając zmienną do wyrażenia, upewnij się, że ta sama wartość jest używana podczas przetwarzania raportów.

  • Funkcja odczytu i zapisu służy do ustawiania wartości raz i serializowania wartości w sesji raportu. Opcja odczytu i zapisu dla zmiennych zapewnia lepszą alternatywę niż użycie zmiennej statycznej w bloku Kod w definicji raportu.

    W przypadku wyczyszczenia opcji Tylko do odczytu dla zmiennej właściwość Writable dla zmiennej ma wartość true. Aby zaktualizować wartość z wyrażenia, użyj metody SetValue, na przykład =Variables!MyVariable.SetValue("123").

    Uwaga

    Nie można kontrolować, kiedy procesor raportów inicjuje zmienną lub oblicza wyrażenie, które aktualizuje zmienną. Kolejność wykonywania inicjowania zmiennej jest niezdefiniowana.

Aby uzyskać więcej informacji na temat sesji, zobacz Podgląd raportów w programie Report Builder.

Zmienne grupy

Użyj zmiennej grupy, aby obliczyć wyrażenie złożone raz w zakresie grupy. Zmienna grupy jest prawidłowa tylko w zakresie grupy i jej grup podrzędnych.

Załóżmy na przykład, że w regionie danych są wyświetlane dane spisu elementów, które znajdują się w różnych kategoriach podatkowych, i chcesz zastosować różne stawki podatkowe dla każdej kategorii. Pogrupuj dane w kolumnie Category i zdefiniuj zmienną podatkową w grupie nadrzędnej. Następnie zdefiniujesz zmienną grupową dla elementu ItemTax dla każdej kategorii podatkowej i przypiszesz każdą z różnych podgrup Kategorii do poprawnej zmiennej grupy. Na przykład:

  • Dla grupy nadrzędnej na [Category]podstawie , zdefiniuj zmienną Tax z wartością [Tax]. Załóżmy, że wartości kategorii to Food and Clothing.

  • Dla grupy podrzędnej na [Subcategory]podstawie elementu zdefiniuj zmienną ItemsTax jako =Variables!Tax.Value * Sum(Fields!Price.Value). Załóżmy, że wartości podkategorii kategorii Jedzenie to Napoje i Chleb. Załóżmy, że wartości podkategorii dla odzieży to Koszule i Kapelusze.

  • W przypadku pola tekstowego w wierszu w grupie podrzędnej dodaj wyrażenie =Variables!ItemsTax.Value.

    W polu tekstowym zostanie wyświetlony całkowity podatek od napojów i chleba przy użyciu podatku od żywności oraz koszul i kapeluszy przy użyciu podatku odzieżowego.

Aby dodać zmienną grupową, otwórz okno dialogowe Właściwości grupy elementu Tablix, wybierz pozycję Zmienne i podaj nazwę i wartość. Zmienna grupy jest obliczana raz na unikatową wartość grupy.

Aby odwołać się do zmiennej w wyrażeniu, użyj składni kolekcji globalnej, na przykład =Variables!GroupDescription.Value. Na powierzchni projektowej wartość jest wyświetlana w polu tekstowym jako <<Expr>>.

Następne kroki