Representación en HTML (Report Builder)

  • Artículo

La extensión de representación en HTML representa un informe paginado en formato HTML. La extensión de representación también puede generar páginas HTML completas o fragmentos de HTML para incrustarlos en otras páginas HTML. Todos los HTML se generan con la codificación UTF-8.

La extensión de representación en HTML es la extensión predeterminada de representación para los informes que se visualizan en un explorador, incluido cuando se ejecutan en el portal web de SQL Server 2016 (13.x) Reporting Services o posteriores (SSRS). La extensión de representación en HTML puede representar HTML como un fragmento o como un documento HTML completo. Si el HTML es un fragmento, se quitan las etiquetas HEAD, HTMLy BODY del documento HTML. Solo se representa el contenido de la etiqueta BODY . Esto resulta de gran utilidad para incrustar el HTML en el HTML generado en otra aplicación.

En algunos escenarios, los parámetros de informe se pueden utilizar para iniciar ataques de inserción de script al representar los informes en HTML. Para obtener más información sobre cómo proteger informes, vea Proteger informes y recursos.

Para obtener más información sobre navegadores, consulte Compatibilidad del navegador de Reporting Services.

Nota:

Puede crear y modificar los archivos de definición de informes paginados (.rdl) en el Generador de informes de Microsoft, en Power BI Report Builder y en el Diseñador de informes de SQL Server Data Tools.

Representación en MHTML

La extensión de representación en HTML también puede representar informes en MHTML (Encapsulación MIME de documentos HTML agregados). MHTML extiende HTML para incrustar objetos codificados, como imágenes, en el documento HTML. Con la extensión de representación en MHTML, puede incrustar en un único archivo recursos tales como imágenes, documentos u otros archivos binarios como estructuras MIME incluidas en el informe HTML. Los informes MHTML también resultan útiles para incrustarlos en mensajes de correo electrónico porque todos los recursos se incluyen en el informe. Aunque la extensión de representación en HTML es la que en realidad representa el MHTML, esta funcionalidad también se denomina extensión de representación en MHTML.

Compatibilidad con navegadores

Esta extensión de representación admite las versiones siguientes de los exploradores:

  • Internet Explorer 5.5 y versiones posteriores

  • Firefox 1.5 y versiones posteriores

  • Safari 3.0 y versiones posteriores

Debido a los distintos comportamientos de los navegadores, el informe representado puede variar ligeramente de un navegador a otro. Por ejemplo, el cuadro de texto contiene una propiedad denominada WritingMode. Esta propiedad no es compatible con Firefox.

Reglas de representación específicas de HTML

Durante la representación se aplican las siguientes reglas específicas de HTML:

  • El representador genera una estructura de tabla HTML en la que se alojarán todos los elementos existentes en cada colección ReportItems, si hubiera más de uno.

  • Cada elemento de la estructura de tabla ocupa una única celda.

  • Las celdas vacías se contraen tanto como es posible para reducir el tamaño del HTML.

  • Para mejorar la velocidad a la que los exploradores pueden representar la tabla, se agrega una fila de celdas vacías en el borde superior y una columna en el borde izquierdo.

  • La filas o las columnas de la tabla que no contienen elementos, tan solo espacios entre los elementos, adoptan anchos y altos fijos.

  • Las demás filas y columnas pueden aumentar en función del tamaño de cada elemento de informe.

  • Todas las coordenadas y los tamaños de los elementos de informe se convierten a milímetros. Todos los demás tamaños, incluidas las propiedades de estilo, conservan sus unidades originales. Las diferencias de tamaño y posición menores que 0,2 mm se tratan como 0 mm.

Interactividad

Algunos elementos interactivos se admiten en HTML. En la siguiente sección, se describen sus comportamientos específicos.

Mostrar y ocultar

Un elemento de informe cuya visibilidad se puede alternar se representa con la imagen de alternancia +/- y es seleccionable. Cuando el elemento se está seleccionado, se vuelve a realizar una llamada al servidor para que vuelva a representar la salida con el estado de mostrar u ocultar cambiado.

Mapa del documento

Para representar y navegar por las etiquetas de mapa de documento, use el mapa del documento del control de visor. Para los encabezados de región de datos omitidos, las etiquetas se representan en la primera celda secundaria. Si no hay ninguna celda secundaria, la etiqueta se representa en el elemento secundario que la precede.

Marcadores

Los vínculos de marcador se representan y aparecen como hipervínculos. Para representar y navegar por los destinos de marcador, seleccione los vínculos de marcador. Cuando se selecciona un vínculo de marcador, el informe va a la primera aparición de la etiqueta de marcador de destino. A continuación, siempre que sea posible, el navegador se desplaza para que el vínculo de marcador esté en la parte superior de la ventana. Las etiquetas de delimitador HTML (<a>) se usan para marcar destinos de marcador.

Ordenación interactiva

Si un cuadro de texto tiene definida la ordenación de usuario, la extensión de representación en HTML representa los iconos de ordenación en el cuadro de texto situado a la derecha de su contenido. Si un informe contiene un cuadro de texto en el que se define la ordenación del usuario, se representa JavaScript. JavaScript provoca un postback en el servidor cuando se seleccione la imagen de ordenación.

Los hipervínculos y los vínculos de obtención de detalles se representan como hipervínculos en los elementos de informe que usan las etiquetas de anclaje HTML (<a>) alrededor del elemento en el que están definidas.

La característica Buscar permite a los usuarios buscar una cadena de texto dentro del informe.

El control ReportViewer de Web Forms proporciona funcionalidad adicional de búsqueda.

Fuentes en el equipo cliente

Cuando una fuente personalizada se usa en el informe, el equipo que se usa para ver el informe (equipo cliente) debe tener la fuente personalizada instalada para que el informe se muestre correctamente. Si la fuente no está instalada en el ordenador cliente, el informe muestra una fuente predeterminada del sistema en lugar de la fuente personalizada.

Valores de configuración de la información del dispositivo

Para cambiar algunos valores de configuración predeterminados para este representador, incluido el modo de representación, solo tiene que cambiar la configuración de la información del dispositivo. Para obtener más información, consulte Configuración de la información de dispositivos HTML.

Contenido relacionado