Compartilhar via


Como importar HTML em um relatório paginado (Construtor de Relatórios)

Aplica-se a: SSRS (Construtor de Relatórios da Microsoft) Power BI Report Builder Report Designer no SQL Server Data Tools

É possível usar uma caixa de texto para inserir em um relatório paginado um texto formatado em HTML recuperado de um campo no seu conjunto de dados. O texto pode ser de qualquer expressão simples ou complexa avaliada como HTML formatado corretamente. O texto formatado pode ser renderizado em todos os formatos de saída com suporte, inclusive PDF.

rs_HTMLFormatting

Esta ilustração mostra texto com formatação HTML em uma exibição de design de relatório, além do mesmo texto como é renderizado quando o relatório é executado.

Observação

Ao importar texto contendo marcação HTML, os dados sempre devem ser analisados primeiro pela caixa de texto. Como apenas um subconjunto de marcas HTML possui suporte, o HTML mostrado no relatório renderizado pode ser diferente do HTML original.

Para começar a usar rapidamente, confira Tutorial: Formatar texto (Construtor de Relatórios).

Tags HTML Suportadas

A seguir, há uma lista completa de marcas que são renderizadas como HTML quando definidas como texto de espaço reservado:

  • Hiperlinks: <A HREF>

  • Fontes: <FONT>

  • Elementos de cabeçalho, estilo e bloco: <H{n}>, <DIV>, <SPAN>,<P>, <DIV>, <LI> e <HN>

  • Formato de texto: <B>, <I>, <U> e <S>

  • Manipulação de lista: <OL>, <UL> e <LI>

Qualquer outra marcação HTML será ignorada durante o processamento de relatório. Se o HTML representado pela expressão no texto de espaço reservado não for bem formado, o espaço reservado será processado como texto sem-formatação. Todas as marcas HTML não diferenciam maiúsculas de minúsculas.

Se o texto na sua caixa de texto tiver apenas um bloco de texto, qualquer HTML no espaço reservado que define os elementos do bloco será renderizado corretamente. Entretanto, se a caixa de texto tiver vários blocos de texto, as marcas HTML serão ignoradas e a estrutura do texto será definida pelos blocos de texto.

Se mais de uma marca for definida para o texto e o Construtor de Relatórios detectar um conflito entre o HTML e as restrições de relatório existentes, somente a marca HTML mais interna será tratada como HTML.

Para obter mais informações, confira Adicionar HTML a um relatório (Construtor de Relatórios e SSRS).

Limitações de atributos de folha de estilos em cascata

Ao usar atributos de folha de estilos em cascata (CSS), somente um conjunto básico de marcas é definido. Estes são os atributos com suporte:

  • alinhamento de texto, recuo de texto

  • font-family

  • font-size

    • Há suporte somente para valores de tamanho RDL válido em unidades de comprimento CSS absoluto. Unidades com suporte: in, cm, mm, pt, pc.

    • As unidades de comprimento CSS relativas são ignoradas e não têm suporte. As unidades com suporte são em, ex, px,%,rem.

  • cor

  • preenchimento, preenchimento inferior, preenchimento superior, preenchimento à direita, preenchimento à esquerda

  • espessura da fonte

Eis algumas considerações quanto ao uso de CSS:

  • Valores CSS malformados são ignorados da mesma maneira que HTML malformado.

  • Quando o atributo e os atributos de estilo CSS existirem na mesma marca, a propriedade CSS tem maior precedência. Por exemplo, se o texto for <p style="text-align: right" align="left">, somente o atributo de alinhamento de texto será aplicado e o texto será alinhado à direita.

  • Para atributos e a estilos CSS, se uma propriedade for especificada mais de uma vez, somente sua última instância será aplicada. Por exemplo, se o texto for <p align="left" align="right">, ele será alinhado à direita.