Używanie odwołań do kolekcji zmiennych raportu i zmiennych grupy (program Report Builder i usługi SSRS)

Jeśli użytkownik korzysta ze złożonego obliczenia używanego wielokrotnie w wyrażeniach w raporcie, warto utworzyć zmienną.Można utworzyć zmienną raportu lub zmienną grupy.Domyślnie zmienna raportu jest ustawiana raz i można jej używać w wyrażeniach w dowolnym miejscu raportu.Zmienne raportu domyślnie są zmiennymi tylko do odczytu.Można zmienić ustawienie domyślne, aby zmienna raportu była zmienną do odczytu i zapisu.Wartość w zmiennej raportu jest zachowywana w czasie sesji, dopóki raport nie zostanie ponownie przetworzony.Zmienna grupy jest ustawiana raz dla unikatowej wartości grupy i można jej używać w wyrażeniach na bieżącym poziomie w hierarchii grup lub niższym.Zmiennych grupy nie można ustawić jako zmiennych do odczytu i zapisu.

Ostrzeżenie

Program Business Intelligence Development Studio umożliwia tworzenie i modyfikowanie definicji raportów (rdl) przy użyciu programów Report Builder 3.0 i Report Designer. Każde ze środowisk obsługuje różne sposoby tworzenia, otwierania i zapisywania raportów oraz powiązanych z nimi elementów. Aby uzyskać więcej informacji, zobacz temat Projektowanie raportów w programach Report Designer i Report Builder 3.0 (usługi SSRS) w witrynie sieci Web microsoft.com.

Zmienne raportu

Zmienna raportu służy do przechowywania wartości używanej w obliczeniach zależnych od czasu, takich jak kursy wymiany walut czy sygnatury czasowe, lub w celu przeprowadzenia skomplikowanego obliczenia, do którego występuje wiele odwołań.Po zainicjowaniu zmiennej wartość pozostaje stała w trakcie sesji raportu.

To add a report variable, open the ReportProperties dialog box, click Variables, and provide a name and a value.

Aby odwołać się do zmiennej w wyrażenie, na przykład, należy użyć składni globalnego kolekcja =Variables!CustomTimeStamp.Value.Na powierzchni projektu wartość pojawia się w polu tekstowym jako <<Expr>>.

Zmiennych raportu można używać na następujące sposoby:

  • Użycie w trybie tylko do odczytu. Wartość jest ustawiana raz w celu utworzenia stałej dla sesji raportu, na przykład w celu utworzenia sygnatury czasowej.

    Ponieważ wyrażenia w polach tekstowych są ocenione na żądanie jako stron użytkownika raport wartości dynamicznych (na przykład, wyrażenie zawierające Now() funkcja, która zwraca czas) może zwracać różne wartości, jeśli strona do przodu i wstecz za pomocą ponownie przycisku.Ustawiając wartość zmiennej raportu do wyrażenie =Now(), a następnie dodając zmiennej do wyrażenie, upewnij się, sama wartość jest używana w całym raporcie przetwarzania.

  • Użyj odczytu i zapisuustawić wartość jeden raz i serializować wartość w ramach sesja raportu.Opcja użycia zmiennych w trybie do odczytu i zapisu stanowi lepszą alternatywę użycia zmiennej statycznej w bloku kodu w definicji raportu.

    Po wyczyszczeniu Tylko do odczytu opcja dla zmiennej, Writable Właściwość zmiennej jest zestaw do true.Aby zaktualizować wartości z wyrażenie, użyj SetValue metoda, na przykład =Variables!MyVariable.SetValue("123").

    Ostrzeżenie

    Nie można określić, kiedy procesor raportów ma zainicjować zmienną lub obliczyć wyrażenie aktualizujące zmienną.Kolejność wykonywania inicjowania zmiennych jest niezdefiniowana.

Aby uzyskać więcej informacji o sesjach, zobacz Wyświetlanie podglądu raportów w programie Report Builder 3.0.

Zmienne grupy

Zmienna grupy służy do obliczania wartości w zakresie grupy.Zmienna grupy jest prawidłowa tylko w zakresie grupy i w jej grupach podrzędnych.

Na przykład w obszarze danych są wyświetlane dane magazynowe dotyczące elementów należących do różnych kategorii podatkowych i trzeba zastosować inną stawkę podatku do każdej kategorii.Czy grupa danych na Category i zdefiniować Tax zmienna w grupie nadrzędnej.Następnie należy zdefiniować zmienną grupy dla ItemTax dla każdej kategorii podatku i przypisać każdej z różnych Category podgrupy do poprawnej grupy zmiennych.Na przykład:

  • Nadrzędna grupa oparta na [Category], zdefiniować zmienną Tax z wartością [Tax].Niech wartościami kategorii będą Food i Clothing.

  • Dla grupy podrzędność na podstawie [Subcategory], zdefiniować zmienną ItemsTax jako =Variables!Tax.Value * Sum(Fields!Price.Value).Niech wartościami podkategorii dla kategorii Food będą Beverages i Bread.Niech wartościami podkategorii dla kategorii Clothing będą Shirts i Hats.

  • Dla pola tekstowego w wierszu w grupie podrzędność, należy dodać wyrażenie =Variables!ItemsTax.Value.

    Pole tekstowe zawiera Suma podatku napoje i chleb, za pomocą podatku żywności oraz koszule i Kapelusze, za pomocą podatku odzieży.

Aby dodać zmienną grupy, otwórz Właściwości grupy element tablix okno dialogowe, kliknij przycisk zmiennychi podać nazwę i wartość.Zmienna grupy jest obliczana raz dla unikatowej wartości grupy.

Aby odwołać się do zmiennej w wyrażenie, na przykład, należy użyć składni globalnego kolekcja =Variables!GroupDescription.Value.Na powierzchni projektu wartość pojawia się w polu tekstowym jako <<Expr>>.