Verwenden von integrierten Feldverweisen in Ausdrücken (Berichts-Generator 2.0)
Die integrierte Feldauflistung, die sowohl die Globals-Auflistung als auch die User-Auflistung umfasst, stellt globale Werte dar, die von Reporting Services beim Verarbeiten eines Berichts bereitgestellt werden. Die Globals-Auflistung enthält Werte wie den Namen des Berichts, die Startzeit der Berichtsverarbeitung und die aktuellen Seitenzahlen für den Berichtskopf oder -fuß. Die User-Auflistung stellt die Benutzer-ID und Spracheinstellungen bereit. Diese Werte können in Ausdrücken verwendet werden, um Ergebnisse in einem Bericht zu filtern.
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ännischen Und-Zeichen (&) als Präfix angezeigt, z. B. [&ReportName]. In der folgenden Tabelle sind die Elemente der Globals-Auflistung beschrieben.
Element |
Typ |
Beschreibung |
|---|---|---|
ExecutionTime |
DateTime |
Das Datum und die Uhrzeit, zu der die Berichtsausführung begann. |
PageNumber |
Integer |
Die aktuelle Seitenzahl, die nur in Seitenkopf- und -fußzeilen verwendet werden kann. |
ReportFolder |
String |
Der vollständige Pfad des Ordners mit dem Bericht. Dies schließt nicht die Berichtsserver-URL ein. |
ReportName |
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. |
TotalPages |
Integer |
Die Gesamtseitenzahl im Bericht, die nur in Seitenkopf- und -fußzeilen verwendet werden kann. |
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 Arbeiten mit Datentypen in Ausdrücken (Berichts-Generator 2.0).
Beispiele
In den folgenden Beispielen wird gezeigt, wie ein Verweis auf die Globals-Auflistung in einem Ausdruck verwendet wird:
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 ein kurzes Datum formatiert:
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
Verwenden der User-Auflistung
Die User-Auflistung enthält Daten zu dem Benutzer, der den Bericht ausführt. Mit dieser Auflistung können Sie die in einem Bericht angezeigten Daten filtern, sodass z. B. nur die Daten des aktuellen Benutzers angezeigt werden, oder beispielsweise die Benutzer-ID in einem Berichtstitel anzeigen. Auf der Entwurfsoberfläche werden diese Variablen mit einem kaufmännischen Und-Zeichen (&) als Präfix angezeigt, z. B. [&UserID].
In der folgenden Tabelle sind die Elemente der User-Auflistung beschrieben.
Element |
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, stellt dieser Wert das Domänenkonto des aktuellen Benutzers dar. Der Wert wird von der Reporting Services-Sicherheitserweiterung bestimmt, für die die Windows-Authentifizierung oder die benutzerdefinierte Authentifizierung verwendet werden kann. |
Weitere Informationen zur Unterstützung mehrerer Sprachen in einem Bericht finden Sie unter "Überlegungen zu Lösungsentwürfen für mehrsprachige oder globale Bereitstellungen" in der Reporting Services-Dokumentation in der SQL Server-Onlinedokumentation.
Verwenden von Gebietsschemaeinstellungen
Sie können Ausdrücke verwenden, um auf die Gebietsschemaeinstellungen auf einem Clientcomputer zu verweisen. Mithilfe des User.Language-Wertes können Sie 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 z. B. so geändert werden, dass abhängig von der zurückgegebenen Sprache lokalisierte Informationen aus unterschiedlichen Spalten abgerufen werden. Sie können auch in den Spracheinstellungen des Berichts oder Berichtselements einen Ausdruck verwenden, der auf dieser Variablen basiert.
.gif "Hinweis") 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 UserID für Snapshots oder Verlaufsberichte
In manchen Fällen werden in Berichten, die die User!UserID-Variable enthalten, keine Berichtsdaten angezeigt, die für den aktuellen Benutzer spezifisch sind, der den Bericht anzeigt. Weitere Informationen finden Sie unter "Problembehandlung bei Berichtsverarbeitungsproblemen" in der Reporting Services-Dokumentation in der SQL Server-Onlinedokumentation.
Siehe auch