Freigeben über


Integrierte Globalen und Benutzerverweise (Berichts-Generator und SSRS)

Die integrierte Felderammlung, die sowohl die Globals- als auch die User-Sammlungen umfasst, stellt globale Werte dar, die von Reporting Services bereitgestellt werden, wenn ein Bericht verarbeitet wird. Die Globals Auflistung enthält Werte wie den Namen des Berichts, den Zeitpunkt der Berichtsverarbeitung und aktuelle Seitenzahlen für die Kopf- oder Fußzeile des Berichts. Die User Sammlung stellt die Benutzer-ID und Die Spracheinstellungen bereit. Diese Werte können in Ausdrücken verwendet werden, um Ergebnisse in einem Bericht zu filtern.

Hinweis

Sie können Berichtsdefinitionen (RDL) im Berichts-Generator und im Berichts-Designer in SQL Server-Datentools erstellen und ändern. Jede Erstellungsumgebung bietet verschiedene Möglichkeiten zum Erstellen, Öffnen und Speichern von Berichten und verwandten Elementen. Weitere Informationen finden Sie unter Entwerfen von Berichten im Berichts-Designer und Berichts-Generator (SSRS) im Web unter microsoft.com.

Verwenden der Globals-Auflistung

Die Globals Auflistung enthält die globalen Variablen für den Bericht. Auf der Entwurfsoberfläche werden diese Variablen mit einem & (kaufmännisches Und-Zeichen) als Präfix angezeigt, z.B. [&ReportName]. In der folgenden Tabelle werden die Elemente der Globals Auflistung beschrieben.

Mitglied Typ Beschreibung
Ausführungszeit DateTime Das Datum und die Uhrzeit, zu der die Berichtsausführung begann.
Seitenzahl Integer Die aktuelle Seitenzahl in Relation zu Seitenumbrüchen, mit denen die Seitenzahl zurückgesetzt wird. Am Anfang der Berichtsverarbeitung wird der Anfangswert auf 1 festgelegt. Die Seitenzahl wird mit jeder gerenderten Seite inkrementiert.

Wenn Sie Seiten innerhalb von Seitenumbrüchen für ein Rechteck, einen Datenbereich, eine Datenbereichsgruppe oder eine Karte auf der PageBreak-Eigenschaft nummerieren möchten, legen Sie die ResetPageNumber-Eigenschaft auf True. Dies wird nicht in den Hierarchiegruppen von Tablix-Spalten unterstützt.

PageNumber kann nur in einem Ausdruck in einer Kopf- oder Fußzeile verwendet werden.
Berichtsordner String Der vollständige Pfad des Ordners mit dem Bericht. Dies schließt nicht die Url des Berichtsservers ein.
Berichtsname String Der Name, unter dem der Bericht in der Berichtsserver-Datenbank gespeichert wird.
ReportServerUrl String Die URL des Berichtsservers, auf dem der Bericht ausgeführt wird.
Gesamtseitenzahl Integer Die Gesamtzahl der Seiten relativ zu Seitenumbrüchen, die PageNumber zurücksetzen. Wenn keine Seitenumbrüche festgelegt sind, ist dieser Wert identisch mit OverallTotalPages.

TotalPages können nur in einem Ausdruck in einer Seitenkopf- oder Seitenfußzeile verwendet werden.
Seitenname String Der Name der Seite. Am Anfang der Berichtsverarbeitung wird der Anfangswert aus InitialPageName, einer Berichtseigenschaft, festgelegt. Da jedes Berichtselement verarbeitet wird, wird dieser Wert durch den entsprechenden Wert von PageName aus einem Rechteck, einem Datenbereich, einer Datenbereichsgruppe oder einer Karte ersetzt. Dies wird nicht in den Hierarchiegruppen von Tablix-Spalten unterstützt.

PageName kann nur in einem Ausdruck in einer Seitenkopf- oder Seitenfußzeile verwendet werden.
Gesamtseitennummer Integer Die Seitenzahl der aktuellen Seite im ganzen Bericht. Dieser Wert ist von ResetPageNumber nicht betroffen.

OverallPageNumber kann nur in einem Ausdruck in einer Kopf- oder Fußzeile verwendet werden.
GesamtanzahlSeiten Integer Die Gesamtanzahl der Seiten für den gesamten Bericht. Dieser Wert ist von ResetPageNumber nicht betroffen.

OverallTotalPages können nur innerhalb eines Ausdrucks im Seitenkopf oder in der Seitenfußzeile verwendet werden.
RenderFormat RenderFormat Informationen zur aktuellen Renderinganforderung.

Weitere Informationen finden Sie im nächsten Abschnitt unter "RenderFormat".

Elemente der Globals Auflistung geben eine Variante zurück. Wenn Sie ein Element dieser Auflistung in einem Ausdruck verwenden möchten, der einen bestimmten Datentyp erfordert, müssen Sie die Variable zunächst umwandeln. Zum Konvertieren der Ausführungszeitvariante in ein Datumsformat können Sie beispielsweise =CDate(Globals!ExecutionTime)verwenden. Weitere Informationen finden Sie unter Datentypen in Ausdrücken (Berichts-Generator und SSRS).

RenderFormat

In der folgenden Tabelle werden die Mitglieder für RenderFormat beschrieben.

Mitglied Typ BESCHREIBUNG
Name String Der Name des Renderers, wie er in der RSReportServer-Konfigurationsdatei registriert ist.

Verfügbar während bestimmter Teile des Berichtsverarbeitungs-/Renderingzyklus.
IsInteractive Boolean Gibt an, ob die aktuelle Renderinganforderung ein interaktives Renderingformat verwendet.
Geräteinformationen Schreibgeschützte Namens-/Werteauflistung Schlüssel-Wert-Paare für Deviceinfo-Parameter für die aktuelle Renderinganforderung.

Zeichenfolgenwerte können mit dem Schlüssel oder einem Index in der Auflistung angegeben werden.

Beispiele

Die folgenden Beispiele zeigen, wie Sie einen Verweis auf die Globals Auflistung in einem Ausdruck verwenden:

  • Dieser Ausdruck ist in einem Textfeld in der Fußzeile eines Berichts platziert und stellt die Seitenzahl und die Gesamtseitenzahl im Bericht bereit:

    =Globals.PageNumber & " of " & Globals.TotalPages

  • Dieser Ausdruck stellt den Namen des Berichts und die Zeit seiner Ausführung bereit. Die Zeit wird mit der Microsoft .NET Framework-Formatzeichenfolge für das kurze Datum formatiert:

    =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")

  • Dieser Ausdruck, der im Dialogfeld "Spaltensichtbarkeit " für eine ausgewählte Spalte platziert wird, zeigt die Spalte nur an, wenn der Bericht nach Excel exportiert wird. Andernfalls ist die Spalte ausgeblendet.

    EXCELOPENXML bezieht sich auf das Excel-Format aus Office 2007. EXCEL bezieht sich auf das Excel-Format aus Office 2003.

    =IIF(Globals!RenderFormat.Name = "EXCELOPENXML" OR Globals!RenderFormat.Name = "EXCEL", false, true)

Verwenden der Benutzersammlung

Die User Sammlung enthält Daten über den Benutzer, der den Bericht ausführt. Mit dieser Auflistung können Sie die Daten filtern, die in einem Bericht angezeigt werden, z. B. nur die Daten des aktuellen Benutzers anzeigen oder die UserID anzeigen, z. B. in einem Berichtstitel. Auf der Entwurfsoberfläche werden diese Variablen mit einem & (kaufmännisches Und-Zeichen) als Präfix angezeigt, z.B. [&UserID].

In der folgenden Tabelle werden die Elemente der User Auflistung beschrieben.

Mitglied Typ Beschreibung
Language String Die Sprache des Benutzers, der den Bericht ausführt. Beispiel: en-US.
UserID String Die Benutzer-ID des Benutzers, der den Bericht ausführt. Wenn Sie die Windows-Authentifizierung verwenden, ist dieser Wert das Domänenkonto des aktuellen Benutzers. Der Wert wird durch die Reporting Services-Sicherheitserweiterung bestimmt, die windows-Authentifizierung oder benutzerdefinierte Authentifizierung verwenden kann.

Weitere Informationen zur Unterstützung mehrerer Sprachen in einem Bericht finden Sie unter "Überlegungen zum Lösungsentwurf für mehrsprachige oder globale Bereitstellungen" in der Reporting Services-Dokumentation in SQL Server Books Online.

Verwenden von Lokaleinstellungen

Mithilfe von Ausdrücken können Sie durch den User.Language-Wert auf die Gebietsschemaeinstellungen auf einem Clientcomputer verweisen, um zu bestimmen, wie ein Bericht für den Benutzer angezeigt wird. Beispielsweise können Sie einen Bericht erstellen, in dem je nach Gebietsschemawert ein unterschiedlicher Abfrageausdruck verwendet wird. Die Abfrage kann je nach zurückgegebener Sprache geändert werden, um lokalisierte Informationen aus einer anderen Spalte abzurufen. Sie können auch in den Spracheinstellungen des Berichts oder Berichtselements einen Ausdruck verwenden, der auf dieser Variablen basiert.

Hinweis

Wenn Sie die Spracheinstellungen eines Berichts ändern, müssen Sie darauf achten, dass dies keine Probleme bei der Anzeige verursacht. Durch das Ändern der Gebietsschemaeinstellung des Berichts kann beispielsweise das Datumsformat im Bericht geändert werden, gleichzeitig ändert sich jedoch möglicherweise auch das Währungsformat. Falls kein Konvertierungsprozess für die Währung installiert ist, wird möglicherweise das falsche Währungssymbol im Bericht angezeigt. Sie können dies vermeiden, indem Sie die Sprachinformationen für die einzelnen Elemente festlegen, die Sie ändern möchten, oder indem Sie das Element mit den Währungsdaten auf eine bestimmte Sprache festlegen.

Identifizieren von Benutzer-ID für Snapshot- oder Historieberichte

In einigen Fällen zeigen Berichte, die die Variable Benutzer!UserID enthalten, keine Berichtsdaten an, die spezifisch für den aktuellen Benutzer sind, der den Bericht betrachtet.

Siehe auch

Ausdrücke (Berichts-Generator und SSRS)
Ausdruck (Dialogfeld) (Berichts-Generator)
Datentypen in Ausdrücken (Berichts-Generator und SSRS)
Formatieren von Zahlen und Datumsangaben (Berichts-Generator und SSRS)
Beispiele für Ausdrücke (Berichts-Generator und SSRS)