Condividi tramite

Esempio: Web Log Analyzer per ReportViewer

  • Articolo

Download sample

L'esempio Web Log Analyzer è un'applicazione Windows Form che consente di analizzare i file di log creati da server Web, ad esempio Microsoft Internet Information Server (IIS). Include report in cui sono riportate statistiche sul numero di visite alle pagine, sull'attività del server e sui riferimenti da altri siti.

Web Log Analyzer comprende funzionalità che consentono di configurare i file inclusi nell'analisi. È possibile selezionare i file di log generati dal server Web e di filtrare tipi di file specifici.

Questo esempio è disponibile in Visual Basic. Per copiare tutti i file di esempio nel computer, fare clic sul pulsante Disco nella parte superiore della pagina. Per visualizzare un singolo file, selezionarne il nome e fare clic sul pulsante Visualizza. Da questa pagina non è possibile visualizzare direttamente tutti i file di esempio. L'elenco non include infatti i file di esempio archiviati in cartelle.

In questo argomento viene illustrato come eseguire e modificare l'esempio. Sono inoltre incluse istruzioni facoltative per la modifica di una tabella in un report. Le tabelle sono composte da più parti, ciascuna delle quali dispone di proprietà e azioni personalizzate. Per aggiungere una colonna, è ad esempio necessario selezionare una colonna adiacente. Per ulteriori informazioni sulle tabelle, vedere Aggiunta di aree dati tabella (Progettazione report di Visual Studio). Per ulteriori informazioni su altri esempi e scenari per gli sviluppatori, vedere Esempi e scenari.

NoteNota

Assicurarsi di generare l'applicazione prima di aprire MainForm.vb.

Per eseguire l'esempio

  1. Aprire WebLogAnalyzer.sln in Visual Studio 2008.

  2. Premere F5 per compilare ed eseguire l'esempio. All'avvio dell'applicazione viene analizzato un file di log di esempio incluso nel progetto. I risultati vengono visualizzati sotto forma di tabelle e grafici. È possibile utilizzare file di log diversi disponibili nel computer in uso per visualizzare i dati effettivi.

  3. In Web Log Analyzer scegliere Open Log Files dal menu File. Per impostazione predefinita, i log Web vengono archiviati nella directory C:\Windows\System32\LogFiles\W3SVC1.

  4. Selezionare la cartella che contiene i file di log e quindi fare clic su OK. L'applicazione legge tutti i file di log presenti nella cartella selezionata, analizza i dati e visualizza i risultati.

  5. Facoltativamente, è possibile filtrare i tipi di file che non si desidera analizzare, ad esempio file immagine e fogli di stile. A tale scopo, scegliere Ignore Files dal menu View. Nella finestra di dialogo digitare un elenco di estensioni di file da ignorare, separate da virgole. Fare clic su OK. Per aggiornare il report, scegliere Open Log Files dal menu File per riaprire i file di log.

    Provare a utilizzare le opzioni della barra degli strumenti di ReportViewer per verificare il funzionamento delle operazioni di stampa, ricerca e spostamenti nelle pagine. Nel report principale è disponibile una mappa documento, utilizzata per spostarsi in sezioni specifiche del report. Per aprire la mappa documento, utilizzare la barra degli strumenti di ReportViewer.

Per modificare il testo visualizzato nella barra del titolo

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse su MainForm.vb e scegliere Visualizza finestra di progettazione.

  2. Nella finestra Proprietà accertarsi che MainForm sia selezionato nell'elenco a discesa prima di individuare e modificare il valore della proprietà Text. Per personalizzare il testo, modificare ad esempio "Web Log Analyzer" in "<Nome società> Web Log Analyzer".

  3. Il valore della proprietà Text del form viene modificato quando si preme INVIO. Si noti che il nuovo testo è visualizzato nella barra del titolo del form.

Per aggiungere un effetto 3D ai grafici

  1. In Esplora soluzioni fare doppio clic su MainReport.rdlc per aprire il report.

  2. Fare clic con il pulsante destro del mouse sul grafico e quindi selezionare Proprietà.

  3. Nella finestra di dialogo Proprietà grafico passare alla scheda Effetto 3D.

  4. Selezionare Visualizza grafico con effetto 3-D.

  5. Utilizzare i dispositivi di scorrimento per ruotare il grafico 3D.

  6. Fare clic su OK per chiudere la finestra di dialogo.

Per cambiare il colore delle barre nel grafico

  1. In Esplora soluzioni fare doppio clic su MainReport.rdlc per aprire il report.

  2. Fare clic con il pulsante destro del mouse sul grafico e quindi selezionare Proprietà.

  3. Selezionare la scheda Dati e fare clic sul pulsante Modifica accanto all'elenco Valori.

  4. Nella finestra di dialogo Modifica valore grafico selezionare la scheda Aspetto.

  5. Fare clic sul pulsante Stile serie per aprire la finestra di dialogo Proprietà stile.

  6. Selezionare la scheda Riempimento e scegliere i nuovi colori.

Per cambiare il numero delle pagine visualizzate più di frequente

  1. In Esplora soluzioni fare doppio clic su MainReport.rdlc.

  2. Fare clic nella tabella sotto il titolo "Most popular pages". Verranno visualizzati i diversi selettori disponibili nella tabella.

  3. Fare clic con il pulsante destro del mouse sul selettore della riga di dettaglio e scegliere Modifica gruppo.

  4. Nella finestra di dialogo Raggruppamento dettagli fare clic sulla scheda Filtri. Nella colonna Valore del primo filtro immettere il numero di righe da visualizzare. Il valore deve iniziare con un segno di uguale (=) per poter essere interpretato come numero anziché come stringa di testo.

Per visualizzare i riferimenti più frequenti ai propri siti Web

  1. In Esplora soluzioni fare doppio clic su LogFileEntry.vb.

  2. Individuare la classe LogFileEntry e aggiungere una proprietà Referrer:

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

  3. Scegliere Genera WebLogAnalyzer dal menu Genera per accertarsi che non vengano restituiti errori.

  4. In Esplora soluzioni espandere la cartella Reports e fare doppio clic su MainReport.rdlc.

  5. Scorrere fino alla parte inferiore del report e quindi trascinare il bordo inferiore del corpo del report verso l'alto per creare spazio per una nuova tabella.

  6. Trascinare una tabella dalla Casella degli strumenti nel report.

  7. Per impostazione predefinita, la tabella include tre colonne. È possibile eliminare l'ultima perché non è necessaria. Fare clic con il pulsante destro del mouse sull'intestazione di colonna dell'ultima colonna e scegliere Elimina.

  8. Per adattare le colonne ai dati, ridimensionarle trascinandone il bordo. Ridurre la larghezza della seconda colonna in quanto deve contenere solo un numero. È possibile allargare la prima colonna in modo da utilizzare lo spazio rimanente nella tabella.

  9. Scegliere Mostra origini dati dal menu Dati. Nella finestra Origini dei dati vengono visualizzate le proprietà pubbliche della classe LogFileEntry. Si noti che risulta visibile anche la proprietà Referrer appena aggiunta.

  10. Nella finestra Origini dei dati trascinare la proprietà Referrer nella riga di dettaglio della prima colonna della tabella. La riga di dettaglio corrisponde alla riga centrale. Si noti che la riga di intestazione viene automaticamente completata con un'intestazione di colonna predefinita.

  11. Fare clic con il pulsante destro del mouse sul selettore della riga di dettaglio e scegliere Modifica gruppo.

  12. Nella finestra di dialogo Raggruppamento dettagli fare clic sulla prima riga del Gruppo nella tabella. Selezionare =Fields!Referrer.Value dall'elenco a discesa.

  13. Nella finestra di dialogo Raggruppamento dettagli passare alla scheda Filtri. Nella colonna Espressione digitare =CountRows(). Nella colonna Operatore scegliere Top N. Nella colonna Valore digitare =10, quindi fare clic su OK per chiudere la finestra di dialogo.

  14. Nella seconda colonna della tabella digitare Referrals nella riga di intestazione e =CountRows() nella riga di dettaglio.

  15. Fare clic con il pulsante destro del mouse sul selettore della tabella e quindi scegliere Proprietà.

  16. Nella finestra di dialogo Proprietà tabella selezionare la scheda Ordinamento. Nella colonna Espressione digitare =CountRows(), mentre nella colonna Direzione scegliere Decrescente.

  17. Facoltativamente, è possibile filtrare riferimenti specifici, ad esempio il proprio sito. Nella finestra di dialogo Proprietà tabella selezionare la scheda Filtri. Nella colonna Espressione digitare =Fields!Referrer.Value.StartsWith("http://mysite"). Sostituire"http://mysite" con l'URL del proprio sito. Nella colonna Operatore scegliere =. Nella colonna Valore, digitare =false.

  18. Facoltativamente, specificare i tipi di carattere, i colori e i bordi per le righe di intestazione e di dettaglio e per la tabella nella finestra Proprietà.

  19. Generare l'applicazione per visualizzare le modifiche apportate.

Requisiti

È necessario disporre di Microsoft Visual Studio 2008 con il compilatore Visual Basic.

I dati utilizzati nei report sono quelli inclusi nei log Web di IIS. L'esempio include un file di dati statico per l'esecuzione dell'esempio. Se si desidera utilizzare file di log del proprio server Web, è necessario accedere a un'istanza di IIS.

Dimostrazione

Il codice sorgente illustra le seguenti operazioni:

  1. Creazione di file di definizione del report del client (con estensione rdlc) che includono grafici, tabelle, mappe documento e altro ancora.

  2. Creazione di un controllo ReportViewer che esegue report dall'interno di un form Windows.

  3. Utilizzo dei metodi ReportRefresh e Drillthrough della classe ReportViewer.

  4. Utilizzo delle proprietà LocalReport e DocumentMapCollapsed della classe ReportViewer.

  5. Utilizzo della proprietà DataSources della classe LocalReport.

  6. Utilizzo del metodo GetDocumentMap della classe Report.