Artigo
09/28/2010

Renderizando para HTML

A extensão de renderização HTML renderiza um relatório no formato HTML. A extensão de renderização também pode produzir páginas HTML totalmente formadas ou fragmentos de HTML a serem incorporados a 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 que são exibidos em um navegador, incluindo quando executados no Gerenciador de Relatórios. A extensão de renderização HTML pode renderizar HTML como um fragmento ou como um documento HTML completo. Se o MHTML for um fragmento, as marcas HEAD, HTML e BODY do documento HTML serão removidas. Apenas o conteúdo da marca BODY é processado. Isso é útil para incorporar o HTML ao HTML produzido por outro aplicativo.

Observação sobre segurança
Ao definir um parâmetro do tipo String no relatório, é exibida para o usuário uma caixa de texto que pode ter qualquer valor. Se um parâmetro de relatório não estiver associado a um parâmetro de consulta e os valores de parâmetro forem incluídos no relatório, um usuário do relatório poderá digitar a sintaxe de expressão, um script ou um URL no valor de parâmetro e processar o relatório em HTML. Se outro usuário exibir o relatório e clicar no conteúdo do parâmetro processado, o usuário poderá executar acidentalmente o script ou link mal-intencionado. Para reduzir o risco de execução acidental de scripts mal-intencionados, só abra relatórios processados de fontes confiáveis. Para obter mais informações sobre como proteger relatórios, consulte Protegendo relatórios e recursos.

Ao definir um parâmetro do tipo String no relatório, é exibida para o usuário uma caixa de texto que pode ter qualquer valor. Se um parâmetro de relatório não estiver associado a um parâmetro de consulta e os valores de parâmetro forem incluídos no relatório, um usuário do relatório poderá digitar a sintaxe de expressão, um script ou um URL no valor de parâmetro e processar o relatório em HTML. Se outro usuário exibir o relatório e clicar no conteúdo do parâmetro processado, o usuário poderá executar acidentalmente o script ou link mal-intencionado.

Para reduzir o risco de execução acidental de scripts mal-intencionados, só abra relatórios processados de fontes confiáveis. Para obter mais informações sobre como proteger relatórios, consulte Protegendo relatórios e recursos.

Para obter mais informações sobre navegadores e renderização de relatórios, consulte Planejando o suporte do navegador e Exportando relatórios.

Renderizando em MHTML

A extensão de renderização HTML também pode renderizar relatórios em MHTML. O MHTML estende o HTML para incorporar objetos codificados, como imagens, ao documento HTML. Usando a extensão de renderização MHTML, você pode incorporar recursos como imagens, documentos ou outros arquivos binários como estruturas MIME ao relatório HTML, em um único arquivo. Os relatórios MHTML também são úteis para serem incorporados 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 do 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.

HTML - Regras específicas de renderização

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

O processador cria 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 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 clicada. Quando o item é clicado, 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 na 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, clicando nos links de indicadores. Quando um link de indicador é clicado, o relatório vai para a primeira ocorrência do rótulo do indicador de destino e, quando possível, o navegador é rolado para que o link do indicador fique na parte superior da janela. As marcas 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 na qual a classificação do usuário está definida, o JavaScript será renderizado, gerando um “postback” para o servidor quando a imagem de classificação for clicada.

Hyperlinks e detalhamento

Os hyperlinks e links de detalhamento são renderizados como hyperlinks em itens de relatórios usando as marcas de âncora HTML (<a>) ao redor do item no qual elas estão definidas.

Pesquisa

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

A pesquisa adicional e função de localização são fornecidas pelo controle de Formulários da Web do Report Viewer.

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 de Dispositivo do Reporting Services.