Compartilhar via


Renderizar em HTML (Construtor de Relatórios)

A extensão de renderização HTML renderiza um relatório paginado no formato HTML. A extensão de renderização também pode produzir páginas HTML totalmente formadas ou fragmentos de HTML a serem inseridos em outras páginas HTML. Todo o HTML é gerado com a codificação UTF-8.

A extensão de renderização HTML é a extensão de renderização padrão para relatórios exibidos em um navegador, incluindo quando executados no portal da Web do SSRS (SQL Server 2016 Reporting Services) 2016 (13.x) ou posterior. A extensão de renderização HTML pode renderizar HTML como um fragmento ou como um documento HTML completo. Se o HTML for um fragmento, as marcas HEAD, HTMLe BODY do documento HTML serão removidas. Somente o conteúdo da marca BODY será renderizado. Este resultado é útil para inserir o HTML no HTML produzido por outro aplicativo.

Em alguns cenários, parâmetros de relatório podem ser usados para iniciar ataques de injeção de script durante a renderização de relatórios em HTML. Para obter mais informações sobre como proteger relatórios, confira Proteger relatórios e recursos.

Para obter mais informações sobre navegadores, confira Suporte ao navegador para Reporting Services.

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Renderizar em MHTML

A extensão de renderização HTML também pode renderizar relatórios em MHTML (encapsulamento MIME de documentos HTML agregados). O MHTML estende o HTML para inserir objetos codificados, como imagens, no documento HTML. Usando a extensão de renderização MHTML, você pode inserir recursos, como imagens, documentos ou outros arquivos binários, como estruturas MIME, no relatório HTML, em um único arquivo. Os relatórios MHTML também são úteis para serem inseridos em mensagens de email, pois todos os recursos estão incluídos no relatório. Embora na verdade seja a extensão de renderização HTML que renderiza o MHTML, esse recurso também pode ser referido como a extensão de renderização MHTML.

Suporte ao navegador

Essa extensão de renderização oferece suporte às seguintes versões de navegador:

  • Internet Explorer 5.5 e posterior

  • Firefox 1.5 e posterior

  • Safari 3.0 e posterior

Devido a considerações de navegador cruzadas, o relatório renderizado pode variar ligeiramente do navegador para navegador. Por exemplo, a caixa de texto contém uma propriedade chamada WritingMode. O Firefox não oferece suporte a essa propriedade.

Regras de renderização específicas de HTML

As seguintes regras específicas de HTML são aplicadas ao renderizar:

  • O processador criará uma estrutura de tabela HTML para conter todos os itens em cada coleção de ReportItems, se houver mais de uma.

  • Todo item na estrutura da tabela ocupa uma única célula.

  • Células vazias são recolhidas juntas o máximo possível para reduzir o tamanho do HTML.

  • Uma linha de células vazias é adicionada à borda superior e outra coluna à borda esquerda para melhorar a velocidade na qual os navegadores podem renderizar a tabela.

  • São atribuídas larguras e alturas fixas às colunas ou linhas da tabela que não contêm itens, somente lacunas entre os itens.

  • Todas as outras linhas e colunas têm permissão para crescer, dependendo do tamanho de cada item de relatório.

  • Todas as coordenadas e tamanhos de item de relatório são convertidos para milímetros. Todos os outros tamanhos, inclusive propriedades de estilo, retêm suas unidades originais. Diferenças de tamanho e posição menores que 0,2 mm são tratadas como 0 mm.

Interatividade

Alguns elementos interativos têm suporte em HTML. A seção a seguir é uma descrição dos comportamentos específicos.

Mostrar e ocultar

Um item de relatório cuja visibilidade pode ser alternada é renderizado com uma imagem de alternância de +/- e pode ser selecionada. Quando o item é selecionado, ocorre um retorno de chamada ao servidor para que ele renderize novamente a saída com o estado mostrar ou ocultar alterado.

Mapa do documento

Os rótulos do mapa do documento são renderizados e podem ser navegados usando o mapa do documento no controle do visualizador. Para cabeçalhos de região de dados omitidos, os rótulos são renderizados na primeira célula filho. Se não houver nenhuma célula filho presente, o rótulo será renderizado no filho que a antecede.

Indicadores

Links de indicadores são renderizados e são exibidos como hyperlinks. Destinos de indicadores são renderizados e podem ser navegados, selecionando os links de indicadores. Quando um link de indicador é selecionado, o relatório vai para a primeira ocorrência do rótulo do indicador de destino. Em seguida, quando possível, o navegador é rolado para que o link do indicador fique na parte superior da janela. As marcações de âncora de HTML (<a>) são usadas para marcar destinos de indicadores.

Classificação interativa

Se uma caixa de texto tiver uma classificação de usuário definida, a extensão de renderização HTML renderizará os ícones de classificação na caixa de texto à direita do conteúdo. Se um relatório contiver qualquer caixa de texto onde a classificação do usuário é definida, o JavaScript será renderizado. O JavaScript causa um postback no servidor quando a imagem de classificação é selecionada.

Os hiperlinks e links de detalhamento são renderizados como hiperlinks em itens de relatório usando as marcações de âncora HTML (<a>) ao redor do item no qual elas estão definidas.

O recurso Pesquisar permite que os usuários procurem uma cadeia de caracteres de texto no relatório.

Uma funcionalidade adicional de pesquisa e localização é fornecida pelo controle Web Forms do ReportViewer.

Fontes no computador cliente

Quando uma fonte personalizada é usada no relatório, o computador usado para exibir o relatório (o computador cliente) precisa ter a fonte personalizada instalada para o relatório ser exibido corretamente. Se a fonte não estiver instalada no computador cliente, o relatório exibe uma fonte padrão do sistema em vez de a fonte personalizada.

Configurações de informações de dispositivo

Você pode alterar algumas configurações padrão para este processador, incluindo qual modo deve ser renderizado, alterando as configurações de informações de dispositivo: Para obter mais informações, consulte Configurações de informações do dispositivo HTML.