Freigeben über

Beispiel: Web Log Analyzer für ReportViewer

  • Artikel

Download sample

Das Web Log Analyzer-Beispiel ist eine Windows Forms-Anwendung zum Analysieren von Protokolldateien, die von Webservern, z. B. von den Microsoft Internetinformationsdiensten (Internet Information Server, IIS), erstellt werden. Es enthält Berichte, die statistische Informationen zu Seitenzugriffen, zur Serveraktivität und zu Weiterleitungen von anderen Websites anzeigen.

Web Log Analyzer enthält Funktionalität, die es Ihnen ermöglicht, die in die Analyse einbezogenen Dateien zu konfigurieren. Sie können Protokolldateien auswählen, die vom Webserver generiert werden, und bestimmte Dateitypen herausfiltern.

Dieses Beispiel wird in Visual Basic zur Verfügung gestellt. Um alle Beispieldateien auf Ihren Computer zu kopieren, klicken Sie am Anfang der Seite auf die Schaltfläche Datenträger. Zum Anzeigen einer einzelnen Datei wählen Sie den Dateinamen aus und klicken auf die Schaltfläche Ansicht. Nicht alle Beispieldateien können direkt von dieser Seite aus angezeigt werden. Beispieldateien, die sich in Ordnern befinden, werden in der Liste nicht aufgeführt.

In diesem Thema wird erläutert, wie das Beispiel ausgeführt und geändert werden kann. Es enthält außerdem optionale Anweisungen zum Ändern einer Tabelle in einem Bericht. Tabellen setzen sich aus mehreren Teilen zusammen. Jeder Teil weist eigene Eigenschaften und Aktionen auf. (Um z. B. eine Spalte hinzuzufügen, müssen Sie eine angrenzende Spalte auswählen.) Weitere Informationen zu Tabellen finden Sie unter Hinzufügen von Tabellendatenbereichen (Visual Studio-Berichts-Designer). Weitere Informationen zu anderen Beispielen und Anleitungen für Entwickler finden Sie unter Beispiele und Anleitungen.

NoteHinweis

Vor dem Öffnen von MainForm.vb müssen Sie zuerst die Anwendung erstellen.

So führen Sie das Beispiel aus

  1. Öffnen Sie WebLogAnalyzer.sln in Visual Studio 2008.

  2. Drücken Sie F5, um das Beispiel zu kompilieren und auszuführen. Wenn die Anwendung gestartet wird, wird eine im Projekt enthaltene Beispielprotokolldatei analysiert; die Ergebnisse werden in Form von Tabellen und Diagrammen angezeigt. Sie können andere Protokolldateien von Ihrem Computer verwenden, um tatsächliche Daten anzuzeigen.

  3. Wählen Sie in Web Log Analyzer im Menü Datei den Befehl Protokolldateien öffnen aus. Webprotokolle werden standardmäßig im Verzeichnis C:\Windows\System32\LogFiles\W3SVC1 gespeichert.

  4. Wählen Sie den Ordner aus, der die Protokolldateien enthält, und klicken Sie dann auf OK. Die Anwendung liest alle Protokolldateien im ausgewählten Ordner, analysiert die Daten und zeigt die Ergebnisse an.

  5. (Optional) Sie haben die Möglichkeit, Dateitypen herauszufiltern, die Sie nicht analysieren möchten (z. B. Bilddateien und Stylesheets). Wählen Sie hierzu im Menü Ansicht den Befehl Dateien ignorieren aus. Geben Sie im Dialogfeld eine durch Kommas getrennte Liste der Dateierweiterungen ein, die nicht berücksichtigt werden sollen. Klicken Sie auf OK. Zum Aktualisieren des Berichts öffnen Sie die Protokolldateien erneut, indem Sie im Menü Datei den Befehl Protokolldateien öffnen auswählen.

    Verwenden Sie die Optionen auf der ReportViewer-Symbolleiste, um die Funktionsweise von Druckvorgängen, Suchvorgängen und der Seitenavigation zu testen. Der Hauptbericht enthält eine Dokumentstruktur, mit deren Hilfe Sie zu bestimmten Abschnitten im Bericht navigieren können. Sie können die Dokumentstruktur über die ReportViewer-Symbolleiste öffnen.

So ändern Sie den in der Titelleiste angezeigten Text

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf MainForm.vb, und wählen Sie Ansicht-Designer aus.

  2. Stellen Sie im Fenster Eigenschaften sicher, dass MainForm in der Dropdownliste ausgewählt ist, und ändern Sie dann den Wert der Text-Eigenschaft. Ersetzen Sie z. B. "Web Log Analyzer" durch "<Name Ihrer Firma> Web Log Analyzer", um den Text anzupassen.

  3. Wenn Sie die EINGABETASTE drücken, ändert sich die Text-Eigenschaft des Formulars. In der Titelleiste des Formulars wird nun der neue Text angezeigt.

So fügen Sie Diagrammen 3D-Effekte hinzu

  1. Doppelklicken Sie im Projektmappen-Explorer auf MainReport.rdlc, um den Bericht zu öffnen.

  2. Klicken Sie mit der rechten Maustaste auf das Diagramm, und wählen Sie Eigenschaften aus.

  3. Wechseln Sie im Dialogfeld Diagrammeigenschaften zur Registerkarte 3D-Effekt.

  4. Wählen Sie Diagramm mit 3D-Effekt anzeigen aus.

  5. Mithilfe der Schieberegler können Sie das 3D-Diagramm drehen.

  6. Klicken Sie auf OK, um das Dialogfeld zu schließen.

So ändern Sie die Farbe der Balken im Diagramm

  1. Doppelklicken Sie im Projektmappen-Explorer auf MainReport.rdlc, um den Bericht zu öffnen.

  2. Klicken Sie mit der rechten Maustaste auf das Diagramm, und wählen Sie Eigenschaften aus.

  3. Wechseln Sie zur Registerkarte Daten, und klicken Sie neben der Liste Werte auf die Schaltfläche Bearbeiten.

  4. Wechseln Sie im Dialogfeld Diagrammwert bearbeiten zur Registerkarte Darstellung.

  5. Klicken Sie auf die Schaltfläche Reihenart, um das Dialogfeld Stileigenschaften zu öffnen.

  6. Wechseln Sie zur Registerkarte Ausfüllen, um die neuen Farben auszuwählen.

So ändern Sie die Anzahl der am häufigsten angezeigten Seiten

  1. Doppelklicken Sie im Projektmappen-Explorer auf MainReport.rdlc.

  2. Klicken Sie auf die Tabelle unter dem Titel "Most popular pages". Die verschiedenen Auswahlzeiger der Tabelle werden eingeblendet.

  3. Klicken Sie mit der rechten Maustaste auf den Zeilenauswahlzeiger für die Detailzeile, und wählen Sie Gruppe bearbeiten aus.

  4. Wählen Sie im Dialogfeld Detailgruppierung die Registerkarte Filter aus. Geben Sie in der Spalte Wert des ersten Filters die Anzahl der Zeilen an, die angezeigt werden sollen. Beachten Sie, dass der Wert mit einem Gleichheitszeichen (=) beginnen muss, um als Zahl und nicht als Textzeichenfolge interpretiert zu werden.

So zeigen Sie die Websites an, von denen Benutzer am häufigsten zu Ihrer Website weitergeleitet werden

  1. Doppelklicken Sie im Projektmappen-Explorer auf LogFileEntry.vb.

  2. Suchen Sie die LogFileEntry-Klasse, und fügen Sie die Referrer-Eigenschaft hinzu:

    Public ReadOnly Property Referrer() As String
    Get
        Return m_referrer
    End Get
End Property

  3. Klicken Sie im Menü Erstellen auf WebLogAnalyzer erstellen, um sicherzustellen, dass keine Fehler enthalten sind.

  4. Erweitern Sie im Projektmappen-Explorer den Ordner Berichte, und doppelklicken Sie auf MainReport.rdlc.

  5. Scrollen Sie zum Ende des Berichts, und ziehen Sie den unteren Rand des Hauptteils des Berichts nach oben, um mehr Platz für eine neue Tabelle zu schaffen.

  6. Ziehen Sie eine Tabelle aus der Toolbox in den Bericht.

  7. Die Tabelle verfügt standardmäßig über drei Spalten. Sie können die letzte Spalte löschen, da sie nicht benötigt wird. Klicken Sie mit der rechten Maustaste auf die Spaltenüberschrift der letzten Spalte, und klicken Sie auf Löschen.

  8. Passen Sie die Größe der Spalte an die Daten an. Durch Ziehen des Spaltenrahmens können Sie die Größe verändern. Reduzieren Sie die Breite der zweiten Spalte; diese Spalte muss nur Platz für eine Zahl bieten. Sie können die Breite der erste Spalte so weit vergrößern, dass sie den verbleibenden Platz in der Tabelle verwendet.

  9. Wählen Sie im Menü Daten den Befehl Datenquellen anzeigen aus. Im Fenster Datenquellen werden die öffentlichen Eigenschaften der LogFileEntry-Klasse angezeigt. Beachten Sie, dass die neu hinzugefügte Referrer-Eigenschaft ebenfalls sichtbar ist.

  10. Ziehen Sie die Referrer-Eigenschaft aus dem Fenster Datenquellen in die Detailzeile der ersten Spalte der Tabelle (die Detailzeile ist die mittlere Zeile). Die Kopfzeile wird automatisch mit einem Standardspaltenheader gefüllt.

  11. Klicken Sie mit der rechten Maustaste auf den Zeilenauswahlzeiger für die Detailzeile, und wählen Sie Gruppe bearbeiten aus.

  12. Klicken Sie im Dialogfeld Detailgruppierung auf die erste Zeile der Tabelle Gruppieren nach. Wählen Sie aus der Dropdownliste =Fields!Referrer.Value aus.

  13. Wechseln Sie im Dialogfeld Detailgruppierung zur Registerkarte Filter. Geben Sie in der Spalte Ausdruck=CountRows() ein. Wählen Sie in der Spalte Operator die Option Top N aus. Geben Sie in der Spalte Wert=10 ein, und klicken Sie dann auf OK, um das Dialogfeld zu schließen.

  14. Geben Sie in der zweiten Spalte der Tabelle Referrals in die Kopfzeile ein, und geben Sie =CountRows() in die Detailzeile ein.

  15. Klicken Sie mit der rechten Maustaste auf den Tabellenauswahlzeiger, und wählen Sie Eigenschaften aus.

  16. Wechseln Sie im Dialogfeld Tabelleneigenschaften zur Registerkarte Sortierung. Geben Sie in der Spalte Ausdruck=CountRows() ein, und wählen Sie in der Spalte Richtung die Option Absteigend aus.

  17. Sie haben die Möglichkeit, bestimmte weiterleitende Websites, z. B. Ihre eigene Website, herauszufiltern. Wechseln Sie im Dialogfeld Tabelleneigenschaften zur Registerkarte Filter. Geben Sie in der Spalte Ausdruck=Fields!Referrer.Value.StartsWith("http://mysite") ein. (Ersetzen Sie "http://mysite" durch die URL Ihrer Website.) Wählen Sie in der Spalte Operator die Option = aus. Geben Sie in der Spalte Wert=false ein.

  18. Falls gewünscht, können Sie im Fenster Eigenschaften Schriftarten, Farben und Rahmen für die Kopf- und Detailzeilen sowie für die Tabelle angeben.

  19. Erstellen Sie einen Build der Anwendung, um die Änderungen anzuzeigen.

Anforderungen

Sie müssen über Microsoft Visual Studio 2008 mit dem Visual Basic-Compiler verfügen.

Webprotokolle aus IIS stellen die Daten bereit, die in den Berichten verwendet werden. Das Beispiel enthält eine statische Datendatei, damit Sie das Beispiel ausführen können. Wenn Sie Protokolldateien Ihres Webservers verwenden möchten, muss Ihnen der Zugriff auf eine Instanz von IIS möglich sein.

Veranschaulicht

Der Quellcode veranschaulicht Folgendes:

  1. Erstellung von Client-Berichtsdefinitionsdateien (RDLC), die Diagramme, Tabellen, Dokumentstrukturen und andere Elemente enthalten.

  2. Erstellung eines ReportViewer-Steuerelements, das Berichte innerhalb eines Windows Form ausführt.

  3. Verwendung der Methoden ReportRefresh und Drillthrough der ReportViewer-Klasse.

  4. Verwendung der Eigenschaften LocalReport und DocumentMapCollapsed der ReportViewer-Klasse.

  5. Verwendung von DataSources der LocalReport-Klasse.

  6. Verwendung der GetDocumentMap-Methode der Report-Klasse.