Share via

Exemple : Analyseur de journal Web pour ReportViewer

  • Article

Download sample

L'exemple Analyseur de journal Web est une application de formulaire Windows qui analyse les fichiers journaux créés par des serveurs Web, tels que Microsoft Internet Information Server (IIS). Il inclut des rapports qui montrent des statistiques sur les accès aux pages, l'activité du serveur et les références d'autres sites.

L'analyseur de journal Web inclut des fonctionnalités permettant de configurer les fichiers inclus dans l'analyse. Vous pouvez sélectionner les fichiers journaux qui sont générés par votre serveur Web et filtrer des types de fichiers spécifiques.

Cet exemple est écrit en Visual Basic. Pour copier tous les fichiers d'exemple sur votre ordinateur, cliquez sur le bouton Disque en haut de la page. Pour afficher un fichier spécifique, sélectionnez le nom du fichier et cliquez sur le bouton Afficher. Certains fichiers d'exemples ne peuvent pas être affichés directement à partir de cette page. Les fichiers d'exemples se trouvant dans des dossiers n'apparaissent pas dans la liste.

Cette rubrique explique comment exécuter et modifier l'exemple. Elle inclut également des instructions facultatives pour modifier un tableau dans un rapport. Les tableaux sont composés de plusieurs parties. Chaque partie a ses propres propriétés et actions (par exemple, pour ajouter une colonne, vous devez sélectionner une colonne adjacente). Pour en savoir plus sur les tableaux, consultez Ajout de régions de données de tableau (Concepteur de rapports Visual Studio). Pour plus d'informations sur d'autres exemples et solutions de développeurs, consultez Exemples et procédures pas à pas.

NoteRemarque

Avant d'ouvrir MainForm.vb, veillez à d'abord générer l'application.

Pour exécuter l'exemple

  1. Ouvrez WebLogAnalyzer.sln dans Visual Studio 2008.

  2. Appuyez sur F5 pour compiler et exécuter l'exemple. Lorsque l'application démarre, un exemple de fichier journal inclus dans le projet est analysé et les résultats sont affichés sous la forme de tableaux et de graphiques. Vous pouvez utiliser différents fichiers journaux depuis votre ordinateur pour afficher les données réelles.

  3. Dans l'analyseur de journal Web, sélectionnez Open Log Files dans le menu File. Par défaut, les journaux Web se trouvent dans le répertoire C:\Windows\System32\LogFiles\W3SVC1.

  4. Spécifiez le dossier qui contient les fichiers journaux, puis cliquez sur OK. L'application lit tous les fichiers journaux du dossier sélectionné, analyse les données et affiche les résultats.

  5. (Facultatif) Vous pouvez également filtrer les types de fichiers que vous ne souhaitez pas analyser (par exemple, les fichiers image et les feuilles de style). Pour cela, ouvrez le menu View et sélectionnez Ignore Files. Dans la boîte de dialogue, tapez un liste d'extensions de fichiers à ignorer, séparées par des virgules. Cliquez sur OK. Pour actualiser le rapport, rouvrez les fichiers journaux en sélectionnant Open Log Files dans le menu File.

    Tentez les options de la barre d'outils de ReportViewer pour essayer l'impression, la recherche et la navigation entre les pages. Le principal rapport inclut un plan du document qui permet d'accéder rapidement à des zones spécifiques du rapport. Vous pouvez ouvrir le plan du document au moyen de la barre d'outils de ReportViewer.

Pour changer le texte affiché dans la barre de titre

  1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur MainForm.vb, puis choisissez Concepteur de vues.

  2. Dans la fenêtre Propriétés, assurez-vous que MainForm est sélectionné dans la liste déroulante, puis localisez et modifiez la valeur de la propriété Text. Par exemple, remplacez « Analyseur de journal Web » par « <Nom_Votre_Entreprise> Analyseur de journal Web ».

  3. La propriété Text du formulaire est modifiée lorsque vous appuyez sur ENTRÉE. Notez que votre nouveau texte apparaît maintenant dans la barre de titre.

Pour ajouter un effet 3D à des graphiques

  1. Dans l'Explorateur de solutions, double-cliquez sur MainReport.rdlc pour ouvrir le rapport.

  2. Cliquez avec le bouton droit sur le graphique et sélectionnez Propriétés.

  3. Dans la boîte de dialogue Propriétés du graphique, ouvrez l'onglet Effet 3D.

  4. Sélectionnez Afficher le graphique avec un effet visuel 3D.

  5. Utilisez les curseurs pour faire pivoter le graphique 3D.

  6. Cliquez sur OK pour fermer la boîte de dialogue.

Pour changer la couleur des barres du graphique

  1. Dans l'Explorateur de solutions, double-cliquez sur MainReport.rdlc pour ouvrir le rapport.

  2. Cliquez avec le bouton droit sur le graphique et sélectionnez Propriétés.

  3. Ouvrez l'onglet Données et cliquez sur le bouton Modifier en regard de la liste Valeurs.

  4. Dans la boîte de dialogue Modifier une valeur du graphique, ouvrez l'onglet Apparence.

  5. Cliquez sur le bouton Style de séries pour ouvrir la boîte de dialogue Propriétés de style.

  6. Ouvrez l'onglet Remplissage et sélectionnez les nouvelles couleurs.

Pour changer le nombre des pages les plus fréquemment employées

  1. Dans l'Explorateur de solutions, double-cliquez sur MainReport.rdlc.

  2. Cliquez sur le tableau sous le titre « Most popular pages ». Les divers sélecteurs du tableau deviennent visibles.

  3. Cliquez avec le bouton droit sur le sélecteur de ligne de la ligne de détail, puis sélectionnez Modifier le groupe.

  4. Dans la boîte de dialogue Regroupement des détails, cliquez sur l'onglet Filtres. Dans la colonne Valeur du premier filtre, tapez le nombre de lignes qu'il convient d'afficher. Notez que la valeur doit commencer par un signe égal (=) pour pouvoir être interprétée comme un nombre et non comme une chaîne de texte.

Pour afficher les sites recommandant le plus fréquemment vos sites Web

  1. Dans l'Explorateur de solutions, double-cliquez sur LogFileEntry.vb.

  2. Recherchez la classe LogFileEntry et ajoutez une propriété Referrer :

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

  3. Dans le menu Générer, cliquez sur Générer WebLogAnalyzer pour vérifier l'absence d'erreurs.

  4. Dans l'Explorateur de solutions, développez le dossier Reports et double-cliquez sur MainReport.rdlc.

  5. Passez en bas du rapport, puis faites glisser le bord inférieur du corps du rapport vers le haut pour créer de la place pour un nouveau tableau.

  6. Dans la boîte à outils, faites glisser un tableau sur le rapport.

  7. Par défaut, le tableau a trois colonnes. Vous pouvez supprimer la dernière colonne parce qu'elle est inutile. Cliquez avec le bouton droit sur l'en-tête de la dernière colonne, puis cliquez sur Supprimer.

  8. Redimensionnez les colonnes pour recevoir les données. Vous pouvez faire glisser le bord de la colonne pour la redimensionner. Réduisez la largeur de la deuxième colonne ; elle ne doit recevoir qu'un nombre. Vous pouvez élargir la première colonne pour utiliser l'espace restant dans le tableau.

  9. Dans le menu Données, sélectionnez Afficher les sources de données. La fenêtre Sources de données affiche les propriétés publiques de la classe LogFileEntry. Notez que la nouvelle propriété Referrer est également visible.

  10. Dans la fenêtre Sources de données, faites glisser la propriété Referrer sur la ligne de détails de la première colonne du tableau (la ligne de détails est celle du milieu). Notez que la ligne d'en-tête est automatiquement remplie avec un en-tête de colonne par défaut.

  11. Cliquez avec le bouton droit sur le sélecteur de ligne de la ligne de détail, puis sélectionnez Modifier le groupe.

  12. Dans la boîte de dialogue Regroupement des détails, cliquez sur la première ligne du Groupe dans le tableau. Dans la liste déroulante, sélectionnez =Fields!Referrer.Value.

  13. Dans la boîte de dialogue Regroupement des détails, cliquez sur l'onglet Filtres. Dans la colonne Expression, tapez =CountRows(). Dans la colonne Opérateur, choisissez Top N. Dans la colonne Valeur, tapez =10, puis cliquez sur OK pour fermer la boîte de dialogue.

  14. Dans la deuxième colonne du tableau, tapez Referrals dans la ligne d'en-tête et tapez =CountRows() dans la ligne de détails.

  15. Cliquez avec le bouton droit sur le sélecteur de tableau et sélectionnez Propriétés.

  16. Dans la boîte de dialogue Propriétés du tableau, cliquez sur l'onglet Tri. Dans la colonne Expression, tapez =CountRows() et dans la colonne Direction, choisissez Décroissant.

  17. Vous pouvez également filtrer sur des référants spécifiques, par exemple votre propre site. Dans la boîte de dialogue Propriétés du tableau, cliquez sur l'onglet Filtres. Dans la colonne Expression, tapez =Fields!Referrer.Value.StartsWith("http://mysite"). (Remplacez « http://mysite » par l'URL de votre site.) Dans la colonne Opérateur, choisissez =. Dans la colonne Valeur, tapez =false.

  18. Vous pouvez éventuellement spécifier les polices, les couleurs et les bordures des lignes d'en-tête et de détails et du tableau dans la fenêtre Propriétés.

  19. Générez l'application pour afficher vos modifications.

Spécifications

Vous devez posséder Microsoft Visual Studio 2008 avec le compilateur Visual Basic.

Les journaux Web d'IIS fournissent les données employées dans les rapports. L'exemple inclut un fichier de données statiques pour vous permettre d'exécuter l'exemple. Si vous souhaitez utiliser des fichiers journaux depuis votre serveur Web, vous devez avoir accès à une instance d'IIS.

Montre

Le code source illustre les opérations suivantes :

  1. Création de fichiers de définition de rapport client (.rdlc) qui incluent des graphiques, des tableaux, des plans du document, etc.

  2. Création d'un contrôle ReportViewer qui exécute des rapports à partir d'un formulaire Windows.

  3. Utilisation des méthodes ReportRefresh and Drillthrough de la classe ReportViewer.

  4. Utilisation des propriétés LocalReport and DocumentMapCollapsed de la classe ReportViewer.

  5. Utilisation de DataSources de la classe LocalReport.

  6. Utilisation de la méthode GetDocumentMap de la classe Report.