Używanie odwołań do wbudowanych kolekcji Globals i Users (program Report Builder 3.0 i usługi SSRS)
Kolekcja, która obejmuje zarówno pola wbudowane Globals i User kolekcje, reprezentują wartości globalnego przez usługi Reporting Services podczas przetwarzania raportu.Globals Kolekcja zawiera wartości, takie jak nazwa raportu, czas rozpoczęcia przetwarzania raportu oraz bieżące strona numery nagłówek raportu lub stopka.User kolekcja zawiera identyfikator użytkownika i ustawień języka.Tych wartości można używać w wyrażeniach w celu filtrowania wyników w raporcie.
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.
Używanie kolekcji Globals
Globals Kolekcja zawiera zmienne globalne dla raportu.Na powierzchni projektu zmienne te pojawiają się uprzednio ustalonych przez & (handlowe i), na przykład [&ReportName].W poniższej tabela opisano członków Globals kolekcja.
Element członkowski |
Typ |
Opis |
|---|---|---|
ExecutionTime |
DateTime |
Data i czas rozpoczęcia uruchamiania raportu. |
PageNumber |
Integer |
Bieżący numer strony względem podziałów strony resetujących numer strony.Po rozpoczęciu przetwarzania raportu jest ustawiana początkowa wartość równa 1.Numer strony jest zwiększany dla każdej renderowanej strony. Do numerów stron w obrębie strona podziały prostokąt, obszar danych, grupa obszar danych lub mapę, na PageBreak właściwość, zestaw ResetPageNumber Właściwość True.Ta właściwość jest nieobsługiwana w grupach hierarchii kolumn elementu tablix. PageNumber może być używany tylko w wyrażenie w nagłówku lub stopce strona. |
ReportFolder |
String |
Pełna ścieżka do folderu zawierającego raport.Ścieżka nie zawiera adresu URL serwera raportów. |
ReportName |
String |
Nazwa raportu przechowywana w bazie danych serwera raportów. |
ReportServerUrl |
String |
Adres URL serwera raportów, na którym uruchomiono raport. |
TotalPages |
Integer |
Całkowita liczba stron względem strona podziały resetowania tej PageNumber.Jeśli podziały stron nie są zestaw, wartość ta jest taka sama, jak OverallTotalPages. TotalPages może być używany tylko w wyrażenie w nagłówku lub stopce strona. |
PageName |
String |
Nazwa strony.Na początku przetwarzania raportu wartość początkowa jest zestaw z InitialPageName, właściwość raportu.Każdy element raportu jest przetwarzany, ta wartość zastępuje odpowiednie wartości PageName z prostokątem danych region, danych region grupy lub mapy.Ta właściwość jest nieobsługiwana w grupach hierarchii kolumn elementu tablix. PageName może być używany tylko w wyrażenie w nagłówku lub stopce strona. |
OverallPageNumber |
Integer |
Numer bieżącej strony dla całego raportu.Ta wartość nie jest zagrożony ResetPageNumber. OverallPageNumber może być używany tylko w wyrażenie w nagłówku lub stopce strona. |
OverallTotalPages |
Integer |
Łączna liczba stron w całym raporcie.Ta wartość nie jest zagrożony ResetPageNumber. OverallTotalPages może być używany tylko w wyrażenie w nagłówku lub stopce strona. |
RenderFormat |
RenderFormat |
Informacje dotyczące bieżącego żądania renderowania. Aby uzyskać więcej informacji, zobacz opis kolekcji RenderFormat w następnej sekcji. |
Członkowie Globals kolekcja zwracać wariantów.Aby użyć elementu członkowskiego tej kolekcji w wyrażeniu wymagającym określonego typu danych, należy najpierw wykonać rzutowanie zmiennej.Na przykład czas wykonania wariant przekonwertować na format daty, należy użyć =CDate(Globals!ExecutionTime).Aby uzyskać więcej informacji, zobacz Praca z typami danych w wyrażeniach (program Report Builder 3.0 i usługi SSRS).
RenderFormat
W poniższej tabela opisano elementy członkowskie dla RenderFormat.
Element członkowski |
Typ |
Opis |
|---|---|---|
Nazwa |
String |
Nazwa modułu renderowania zarejestrowanej w RSReportServer plik konfiguracji. Dostępne podczas określonych części raportu cyklu przetwarzania/renderowania. |
IsInteractive |
Boolean |
Wskazuje, czy w bieżącym żądaniu renderowania jest używany interakcyjny format renderowania. |
DeviceInfo |
Kolekcja par nazwa/wartość tylko do odczytu. |
Pary klucz/wartość dla parametrów informacji o urządzeniu związanych z bieżącym żądaniem renderowania. Wartości typu ciąg można określać, używając klucza lub indeksu z kolekcji. |
Przykłady
Następujące przykłady przedstawiają metody korzystania z odwołania do Globals kolekcja w wyrażenie:
To wyrażenie, umieszczony w polu tekstowym w stopce raportu, zawiera numer strona i całkowita liczba stron w raporcie:
=Globals.PageNumber & " of " & Globals.TotalPages
To wyrażenie dostarcza nazwę raportu oraz godzinę jego uruchomienia.The time is formatted with the Microsoft .NET Framework formatting string for short date:
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
Używanie kolekcji User
User kolekcja zawiera dane dotyczące użytkownika, który jest uruchomiony raport.Używając tej kolekcji, można filtrować dane wyświetlane w raporcie, na przykład można wyświetlać tylko dane bieżącego użytkownika albo wyświetlić identyfikator użytkownika na przykład w tytule raportu.Na powierzchni projektu zmienne te pojawiają się uprzednio ustalonych przez & (handlowe i), na przykład [&UserID].
W poniższej tabela opisano członków User kolekcja.
Element członkowski |
Typ |
Opis |
|---|---|---|
Language |
String |
Język użytkownika uruchamiającego raport.Na przykład en-US. |
UserID |
String |
Identyfikator użytkownika uruchamiającego raport.Jeśli jest używane uwierzytelnianie systemu Windows, ta wartość to konto domeny bieżącego użytkownika.Wartość jest określana przez Reporting Services rozszerzenie zabezpieczeń, którego można używać uwierzytelnianie systemu Windows lub niestandardowego uwierzytelnianie. |
Aby uzyskać więcej informacji na temat obsługi wielu języków w raporcie zobacz "Rozwiązania projekt zagadnienia dla Multi-Lingual lub globalnego Deployments" w Reporting Services w dokumentacji sql Server Books Online.
Używanie ustawień regionalnych
Wyrażenia mogą być używane do odwoływania się do ustawienia regionalne na klient komputera za pośrednictwem User.Language wartość, aby określić sposób wyświetlania raportu do użytkownika.Na przykład można utworzyć raport, w którym w zależności od wartości ustawień regionalnych będą używane różne wyrażenia zapytania.Zapytanie może się zmieniać w celu pobierania zlokalizowanych informacji z różnych kolumn, w zależności od zwróconego języka.Wyrażenia opartego na tej zmiennej można również użyć w ustawieniach językowych raportu lub elementach raportu.
Ostrzeżenie
Co prawda można zmienić ustawienia językowe raportu, ale należy pamiętać o problemach z wyświetlaniem, jakie ta zmiana może spowodować.Na przykład zmiana ustawień regionalnych raportu może spowodować zmianę formatu daty w raporcie, a także zmianę formatu waluty.Jeśli nie będzie używany proces konwersji waluty, może to spowodować wyświetlenie niepoprawnego symbolu waluty w raporcie.Aby uniknąć tego problemu, należy ustawić informacje dotyczące języka poszczególnych elementów, dla których mają zostać wprowadzone zmiany, lub ustawić element zawierający dane walutowe na określony język.
Identyfikowanie identyfikatora użytkownika na potrzeby migawek lub raportów historii
W niektórych przypadkach raporty zawierające User!UserID zmienna nie powiedzie się pokazać dane raportu jest specyficzne dla bieżącego użytkownika, który jest wyświetlanie raportu.Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z raportami: Przetwarzanie raportów.
Zobacz także