Ejemplo: Web Log Analyzer para ReportViewer

Download sample

El ejemplo Web Log Analyzer es una aplicación de formulario de Windows que analiza los archivos de registro creados por servidores web, como Microsoft Internet Information Server (IIS). Incluye informes que muestran estadísticas sobre aciertos de páginas, actividad del servidor y referencias de otros sitios.

Web Log Analyzer incluye una funcionalidad que le permite configurar los archivos incluidos en el análisis. Puede seleccionar archivos de registro generados por su servidor web y filtrar tipos de archivos específicos.

Este ejemplo está disponible en Visual Basic. Para copiar todos los archivos del ejemplo en su equipo, haga clic en el botón Disco en la parte superior de la página. Para ver un solo archivo, seleccione el nombre de archivo y haga clic en el botón Ver. No todos los archivos del ejemplo se pueden ver directamente desde esta página. Los archivos del ejemplo que se ubican en carpetas no aparecen en la lista.

En este tema se explica cómo ejecutar y modificar el ejemplo. También incluye instrucciones opcionales para modificar una tabla en un informe. Las tablas se componen de varias partes. Cada parte tiene sus propias propiedades y acciones (por ejemplo, para agregar una columna, debe seleccionar una columna adyacente). Para obtener más información sobre tablas, vea Agregar regiones de datos de tabla (Diseñador de informes de Visual Studio). Para obtener más información sobre otros ejemplos y visitas guiadas para programadores, vea Ejemplos y visitas guiadas.

Nota

Antes de abrir MainForm.vb, debe generar la aplicación.

Para ejecutar el ejemplo

  1. Abra WebLogAnalyzer.sln en Visual Studio 2008.

  2. Presione F5 para compilar y ejecutar el ejemplo. Cuando se inicia la aplicación, se analiza un archivo de registro de ejemplo incluido en el proyecto y los resultados se presentan en forma de tablas y gráficos. Puede usar diferentes archivos de registro de su equipo para ver datos reales.

  3. En Web Log Analyzer, seleccione Open Log Files en el menú File. De manera predeterminada, los registros web se guardan en el directorio C:\Windows\System32\LogFiles\W3SVC1.

  4. Seleccione la carpeta que contiene los archivos de registro y haga clic en OK. La aplicación lee todos los archivos de registro en la carpeta seleccionada, analiza los datos y muestra los resultados.

  5. Opcionalmente, puede filtrar los tipos de archivo que no desea analizar (por ejemplo, archivos de imagen y hojas de estilo). Para ello, vaya al menú View y seleccione Ignore Files. En el cuadro de diálogo, escriba una lista de extensiones de archivo que se deben pasar por alto, separadas por comas. Haga clic en OK. Para actualizar el informe, vuelva a abrir los archivos de registro seleccionando Open Log Files en el menú File.

    Pruebe las opciones en la barra de herramientas de ReportViewer para ver de qué manera se realizan las tareas de impresión, búsqueda y navegación de páginas. El informe principal incluye un mapa de documento que se usa para navegar a secciones específicas del informe. Puede abrir el mapa del documento mediante la barra de herramientas de ReportViewer.

Para cambiar el texto visualizado en la barra de título

  1. En el Explorador de soluciones, haga clic con el botón secundario en MainForm.vb y elija Diseñador de vistas.

  2. En la ventana Propiedades, asegúrese de que se seleccione MainForm en la lista desplegable, y luego busque y cambie el valor de la propiedad Text. Por ejemplo, cambie el texto de "Web Log Analyzer" por "<Nombre de su compañia> Web Log Analyzer" para personalizar el texto.

  3. La propiedad Text del formulario cambia al presionar ENTRAR. Observe que la barra de título del formulario muestra el nuevo texto.

Para agregar efectos tridimensionales a los gráficos

  1. En el Explorador de soluciones, haga doble clic en MainReport.rdlc para abrir el informe.

  2. Haga clic con el botón secundario en el gráfico y seleccione Propiedades.

  3. En el cuadro de diálogo Propiedades del gráfico, vaya a la ficha Efecto 3D.

  4. Seleccione Mostrar gráfico con efecto visual 3D.

  5. Use las barras de control deslizante para rotar el gráfico tridimensional.

  6. Haga clic en Aceptar para cerrar el cuadro de diálogo.

Para cambiar el color de las barras en el gráfico

  1. En el Explorador de soluciones, haga doble clic en MainReport.rdlc para abrir el informe.

  2. Haga clic con el botón secundario en el gráfico y seleccione Propiedades.

  3. Vaya a la ficha Datosy haga clic en el botón Editar junto a la lista Valores.

  4. En el cuadro de diálogo Editar valor del gráfico, vaya a la ficha Apariencia.

  5. Haga clic en el botón Estilo de serie para abrir el cuadro de diálogo Propiedades del estilo.

  6. Vaya a la ficha Rellenoy seleccione los nuevos colores.

Para cambiar el número de las páginas más populares que se muestran

  1. En el Explorador de soluciones, haga doble clic en MainReport.rdlc.

  2. Haga clic en la tabla bajo el título "Most popular pages". Los diversos selectores de la tabla se hacen visibles.

  3. Haga clic con el botón secundario en el selector de filas de la fila de detalle y seleccione Editar grupo.

  4. En el cuadro de diálogo Agrupación de detalles, haga clic en la ficha Filtros. En la columna Valor del primer filtro, escriba la cantidad de filas que se deben mostrar. Observe que el valor debe comenzar con un signo igual (=) para que sea interpretado como un número en lugar de una cadena de texto.

Para mostrar a quienes consultan con mayor frecuencia sus sitios web

  1. En el Explorador de soluciones, haga doble clic en LogFileEntry.vb.

  2. Busque la clase LogFileEntry y agregue una propiedad Referrer:

    Public ReadOnly Property Referrer() As String
        Get
            Return m_referrer
        End Get
    End Property
    
  3. Desde el menú Generar, haga clic en Generar WebLogAnalyzer para asegurarse de que no haya errores.

  4. En el Explorador de soluciones, expanda la carpeta Informes y haga doble clic en MainReport.rdlc.

  5. Vaya a la parte inferior del informe y arrastre el borde inferior del cuerpo del informe hacia arriba para dejar lugar para una nueva tabla.

  6. Desde el Cuadro de herramientas, arrastre una tabla al informe.

  7. De manera predeterminada, la tabla tiene tres columnas. Puede borrar la última columna porque no es necesaria. Haga clic con el botón secundario en el encabezado de columna de la última columna y haga clic en Eliminar.

  8. Cambie el tamaño de las columnas para que quepan los datos. Puede arrastrar el borde de las columnas para cambiar su tamaño. Reduzca el ancho de la segunda columna. Basta con que en ella quepa un número. Puede ensanchar la primera columna para usar el espacio restante en la tabla.

  9. En el menú Datos, elija Mostrar orígenes de datos. La ventana Orígenes de datos muestra las propiedades públicas de la clase LogFileEntry. Observe que la propiedad agregada Referrer también está visible.

  10. En la ventana Orígenes de datos, arrastre la propiedad Referrer a la fila de detalle de la primera columna de la tabla (la fila de detalle es la fila del medio). Observe que la fila del encabezado se llena automáticamente con un encabezado de columna predeterminado.

  11. Haga clic con el botón secundario en el selector de filas de la fila de detalle y elija Editar grupo.

  12. En el cuadro de diálogo Agrupación de detalles, haga clic en la primera fila del grupo en la tabla. En la lista desplegable, seleccione =Fields!Referrer.Value.

  13. En el cuadro de diálogo Agrupación de detalles, vaya a la ficha Filtros. En la columna Expresión, escriba =CountRows(). En la columna Operador, elija Top N. En la columna Valor, escriba =10 y haga clic en Aceptar para cerrar el cuadro de diálogo.

  14. En la segunda columna de la tabla, escriba Referrals en la fila del encabezado y escriba =CountRows() en la fila de detalle.

  15. Haga clic con el botón secundario en el selector de tablas y seleccione Propiedades.

  16. En el cuadro de diálogo Propiedades de la tabla, vaya a la ficha Ordenación. En la columna Expresión, escriba =CountRows() y en la columna Dirección, elija Descendente.

  17. Opcionalmente, puede filtrar referencias específicas, como su propio sitio. En el cuadro de diálogo Propiedades de la tabla, vaya a la ficha Filtros. En la columna Expresión, escriba =Fields!Referrer.Value.StartsWith("http://misitio"). (Reemplace "http://misitio" por la dirección URL de su sitio). En la columna Operador, elija =. En la columna Valor, escriba =false.

  18. Opcionalmente, especifique fuentes, colores y bordes para las filas del encabezado y de detalle y la tabla en la ventana Propiedades.

  19. Genere la aplicación para ver los cambios.

Requisitos

Debe tener Microsoft Visual Studio 2008 con el compilador Visual Basic.

Los registros web de IIS proporcionan los datos usados en los informes. El ejemplo incluye un archivo de datos estáticos para que pueda ejecutar el ejemplo. Si desea usar archivos de registro del servidor web, debe tener acceso a una instancia de IIS.

Demostraciones

El código fuente demuestra:

  1. Creación de archivos de definición de informe de cliente (.rdlc) que incluyen gráficos, tablas, mapas de documento, etc.

  2. Creación de un control ReportViewer que ejecuta informes desde dentro de un formulario de Windows.

  3. Uso de los métodos ReportRefresh y Drillthrough de la clase ReportViewer.

  4. Uso de las propiedades LocalReport y DocumentMapCollapsed de la clase ReportViewer.

  5. Uso de DataSources de la clase LocalReport.

  6. Uso del método GetDocumentMap de la clase Report.