Compartilhar via

Exportar um relatório paginado para o Microsoft Word (Construtor de Relatórios)

  • Artigo

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

A extensão de renderização do Word renderiza relatórios paginados para o formato do Microsoft Word (.docx). O formato é o Office Open XML.

O tipo de conteúdo dos arquivos gerados por esse renderizador é application/vnd.openxmlformats-officedocument.wordprocessingml.document e a extensão do arquivo é .docx.

Confira Exportar relatórios (Construtor de Relatórios e SSRS) para obter detalhes sobre como exportar para o Word.

Depois que o relatório é exportado para um documento do Word, você pode alterar seu conteúdo e criar relatórios com estilo de documento, como etiquetas de endereçamento, ordens de compra ou cartas-modelo.

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.

Itens de relatório no Word

Os relatórios exportados para Word aparecem como uma tabela aninhada que representa o corpo do relatório. Uma região de dados tablix é renderizada como uma tabela aninhada que reflete a estrutura da região dos dados no relatório. As caixas de texto e os retângulos são renderizados cada um como uma célula dentro da tabela. O valor da caixa de texto é exibido dentro da célula.

Imagens, gráficos e barras de dados, minigráficos, mapas e indicadores são renderizados cada um como uma imagem estática dentro da célula da tabela. Hiperlinks e links de detalhamento nesses itens de relatórios são renderizados. Não há suporte para áreas e mapas que podem ser selecionados em um gráfico.

Relatórios de colunas tipo boletins informativos não são renderizados no Word. O corpo de relatório e as imagens de fundo das páginas e as cores não são renderizados.

Paginação

Após o relatório ser aberto, o Word repagina o relatório inteiro novamente baseado no tamanho da página. A repaginação pode fazer com que quebras de página sejam inseridas em locais onde você não pretendia adicioná-las. Em alguns casos, esse resultado pode fazer com que o relatório exportado tenha duas quebras de página sucessivas em uma linha ou adicione páginas em branco. Você pode tentar alterar a paginação do Word ajustando as margens das páginas.

Este processador dá suporte somente às quebras de página lógicas.

Tamanho da página

Quando o relatório é renderizado, as seguintes propriedades RDL definem a altura e a largura da página do Word: altura e largura do tamanho do papel, margens esquerda e direita da página e margens superior e inferior da página.

Largura da página

O Word dá suporte às larguras de página que tiverem até 22 polegadas de largura. Se o relatório for maior que 22 polegadas, o renderizador ainda renderizará o relatório. No entanto, o Word não exibe o conteúdo do relatório enquanto estiver no modo de layout de impressão ou no modo de layout de leitura. Para exibir os dados, alterna para a exibição normal ou para a exibição de layout de Web. Nestes exibições, o Word reduz a quantidade de espaços em branco, exibindo portanto uma parte maior do conteúdo de seu relatório.

Quando o relatório é renderizado, sua largura aumenta na extensão necessária, atingindo até 22 polegadas, com o intuito de exibir o conteúdo. A largura mínima do relatório baseia-se na propriedade Width do RDL no painel Propriedades.

Propriedades do documento

O processador do Word grava os seguintes metadados no arquivo DOCX.

Propriedades do Elemento de Relatório Descrição
Título do Relatório (título do relatório) Título
Autor do Relatório Autor
Descrição do Relatório Comentários

Cabeçalhos e rodapés de página

Os cabeçalhos e os rodapés das páginas são renderizados no Word como regiões de rodapé e cabeçalho. Se um número de página de relatório ou uma expressão que indique o número total de páginas de relatório aparecer no cabeçalho ou no rodapé da página, o valor será convertido em um campo do Word. Essa ação garante que o número de página exato seja exibido no relatório renderizado. Se a altura do cabeçalho ou do rodapé estiver definida no relatório, o Word não poderá dar suporte a esta configuração. A propriedade PrintOnFirstPage pode, em algumas circunstâncias, especificar se o texto do cabeçalho e do rodapé de uma página é impresso na primeira página de um relatório. Se o relatório renderizado tiver várias páginas e cada página contiver apenas uma seção, você poderá definir PrintOnFirstPage como False. O texto é suprimido na primeira e na página. Caso contrário, o texto será impresso independentemente do valor da propriedade PrintOnFirstPage.

O renderizador do Word tenta analisar todas as expressões em cabeçalhos e rodapés de páginas quando estes são exportados para o Word. Muitos formulários de expressões são analisados com êxito, e os valores esperados aparecem nos rodapés e cabeçalhos de todas as páginas do relatório.

No entanto, um rodapé ou um cabeçalho da página pode conter uma expressão complexa que é avaliada como valores diferentes em páginas diferentes de um relatório. Nesse caso, o mesmo valor pode ser exibido em todas as páginas do relatório. Os números de página nas duas expressões a seguir não incrementam no relatório exportado. O número da página é traduzido como o mesmo valor em todas as páginas do relatório.

  • ="Page: " + Globals!PageNumber.ToString + " of " + Globals!TotalPages.ToString

  • =Avg(Fields!YTDPurchase.Value, "Sales") & " Page Number " & Globals!PageNumber

Esse resultado ocorre porque o renderizador do Word analisa o relatório em busca de campos relacionados à paginação como PageNumber e TotalPages, e trata somente de referências simples, não chamadas para uma função. Neste caso, a expressão chama a função ToString . As duas expressões a seguir são equivalentes e ambas renderizam corretamente quando você visualiza o relatório no Construtor de Relatórios ou no Designer de Relatórios, ou quando renderiza o relatório publicado em um portal da Web do Reporting Services ou em uma biblioteca do SharePoint. Porém, o renderizador do Word analisa somente a segunda expressão com êxito e renderiza os números de página corretos.

  • Expressão complexa: a expressão é ="Average Sales " & Avg(Fields!YTDPurchase.Value, "Sales") & " Page Number " & Globals!PageNumber

  • Expressão com Sequências de texto: Texto, Vendas Comuns e expressão, =Avg(Fields!YTDPurchase.Value, "Sales) e texto, Número de Página e expressão =Globals!PageNumber

Para evitar esse problema, use sequências de texto em vez de uma expressão complexa quando usar expressões em rodapés e cabeçalhos. As duas expressões a seguir são equivalentes. A primeira é uma expressão complexa, e a segunda usa sequências de texto. O renderizador de Word analisa somente a segunda expressão com êxito.

Mapa do documento

Se existirem rótulos de mapa de documento no relatório, eles estarão disponíveis para serem usados como rótulos do Sumário do Word (TOC) nos respectivos itens do relatório e grupos. A etiqueta do mapa do documento é usada como o texto de etiqueta para as etiquetas de TOC. O link de destino é posicionado perto do item no qual a etiqueta está definida. Embora um sumário não seja criado para você na exportação do documento do Word, você pode criar seu próprio sumário usando os rótulos de mapa do documento que são renderizados no relatório com as etapas a seguir.

  1. No documento do Word, selecione a posição para onde o sumário deve ir.
  2. Na faixa de opções, selecione Inserir.
  3. Selecione o menu Partes rápidas.
  4. Selecione Campo no menu.
  5. Em Nomes de campos, selecione TOC e selecione o botão Índice no painel Propriedades do campo.
  6. Na janela pop-up, selecione o botão Opções e verifique se a caixa Campos de entrada da tabela está marcada.
  7. Selecione OK em ambas as janelas pop-up para concluir o processo e gerar o sumário.

Confira Criar um mapa de documentos ou um sumário (Construtor de Relatórios) para saber mais.

Interatividade

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

Mostrar e ocultar

O processador do Word renderiza os itens de relatório com base no seu estado quando renderizado. Se o estado de um item de relatório for oculto, este item não será renderizado no documento do Word. Se o estado de um item de relatório for mostrado, oculto, este item será renderizado no documento do Word. A funcionalidade para alternar não tem suporte no Word.

Hiperlinks e links de detalhamento in caixa de texto e itens de relatório tipo imagem são renderizados como hiperlinks no documento de Word. Quando você selecionar o hiperlink, o navegador padrão da Web será aberto e navegará até a URL. Quando você selecionar o hiperlink de detalhamento, o servidor de relatório de origem é acessado.

Classificação interativa

Os conteúdos de relatório são renderizados com base em como eles estão classificados no momento dentro da região de dados do relatório. O Word não dá suporte à classificação interativa. Após o relatório ser renderizado, você pode aplicar a tabela de classificação do Word.

Indicadores

Os indicadores no relatórios são renderizados como indicadores do Word. Links de indicadores são renderizados como hiperlinks que se conectam aos rótulos de indicadores no documento. Os rótulos de indicadores precisam ter menos de 40 caracteres. O único caractere especial que pode ser usado em um rótulo de indicador é o sublinhado (_). Carateres especiais sem-suporte são eliminados do rótulo do indicador e, se o nome for mais comprido que 40 caracteres, o nome é truncado. Se houver nomes de indicadores duplicados no relatório, esses indicadores não serão renderizados no Word.

Renderizar estilos do Word

A seção a seguir é uma descrição breve de como os estilos são renderizados no Word.

Paleta de cores

As cores incluídas no relatório são renderizadas no documento do Word.

Borda

As bordas dos itens de relatório, além da borda da página, são renderizadas no Word como bordas de células de tabela.

Linhas onduladas em relatórios exportados

Quando exportados e exibidos no Word, os dados de relatório ou constantes podem ser sublinhadas com linhas curvadas vermelhas ou verdes. As linhas curvadas vermelhas identificam erros de ortografia. As linhas curvadas verdes identificam erros gramaticais. Esse resultado ocorre quando o relatório inclui palavras que não estão de acordo com a revisão de texto (ortografia e gramática) do idioma de edição que é especificado no Word. Por exemplo, os títulos de coluna de relatório em inglês provavelmente serão sublinhados por linhas curvadas vermelhas quando o relatório for renderizado em uma versão do Word em espanhol. Erros de ortografia percebidos são mais comuns em relatórios do que erros gramaticais percebidos porque relatórios costumam incluir apenas texto curto, e não frases ou parágrafos inteiros.

A presença de linhas curvadas em relatórios implica que o relatório tem erros, o que provavelmente não ocorre. Você pode remover as linhas curvadas alterando o idioma da revisão de texto para o relatório. Para alterar o idioma da revisão de texto, selecione o conteúdo do relatório e especifique o idioma adequado ao conteúdo. Você pode selecionar todo o documento ou parte dele. No Word, a opção de idioma Definir Idioma de Revisão de Texto fica na área Idioma da guia Revisão. Após atualizar o conteúdo, é preciso salvar o documento novamente.

Dependendo da versão do idioma do programa Office, as ferramentas de revisão de texto (por exemplo, o dicionário) do idioma escolhido são incluídas no programa ou fornecidas em um pacote de idioma do Microsoft Office que você adquiriu.

Os artigos a seguir fornecem informações adicionais sobre como definir opções do Office e do Word.

Observação

Quando você altera o idioma de edição na caixa de diálogo Preferências de Idioma do Microsoft Office ou Opções do Word no Word, a alteração se aplica a todos os programas do Office.

Limitações do Word

O Microsoft Word aplica as seguintes limitações:

  • As tabelas de Word dão suporte a um máximo de 63 colunas. Se o seu relatório tiver mais de 63 colunas e você tentar renderizá-lo, o Word dividirá a tabela. As outras colunas são colocadas ao lado das 63 colunas exibidas no corpo do relatório. Portanto, as colunas do relatório podem não ser alinhadas conforme o esperado.

  • O Word dá suporte uma largura de página máxima de 22 polegadas e uma altura também de 22 polegadas alto. Se o conteúdo for mais largo que 22 polegadas, alguns dados poderão não ser exibidos no Layout de impressão.

  • O Word ignora as configurações de altura de cabeçalho e rodapé.

  • Após o relatório ser exportado, o Word pagina o relatório novamente. Esse resultado pode fazer com que mais quebras de página sejam adicionadas ao relatório renderizado.

  • O Word não repete linhas de cabeçalho na página dois e acima, embora você defina a propriedade RepeatOnNewPage da linha de cabeçalho estática em um tablix (tabela, matriz ou lista) como True. Você pode definir quebras de página explícitas em seu relatório para forçar linhas de cabeçalho a aparecerem em novas páginas. Porém, como o Word aplica sua própria paginação ao relatório renderizado exportado para o Word, os resultados poderão variar, e a linha de cabeçalho talvez não se repita de maneira previsível. A linha de cabeçalho estática é a linha que contém os cabeçalhos de coluna.

  • Caixas de Texto crescem quando contêm espaços sem-quebras.

  • Quando o texto é exportado para o Word, o texto que apresenta certas fontes com decoração pode gerar glifos inesperados ou não exibidos no relatório renderizado.

Benefícios do uso do renderizador do Word

Além de disponibilizar os recursos que são novos nos arquivos .docx do Microsoft Word para relatórios exportados, os arquivos *.docx dos relatórios exportados tendem a ser menores. Os relatórios exportados usando o renderizador do Word são geralmente menores que os mesmos relatórios exportados usando o renderizador do Word 2003.

Compatibilidade com versões anteriores de relatórios exportados

Você pode selecionar um modo de compatibilidade de Word e definir opções de compatibilidade. O renderizador do Word cria documentos com o modo de compatibilidade ligado. Salvar novamente os documentos com o modo de compatibilidade desligado pode afetar o layout do documento.

Se você desligar o modo de compatibilidade e salvar um relatório novamente, o layout do relatório pode alterar de maneiras inesperadas.

O renderizador do Word 2003

Importante

A extensão de renderização do Microsoft Word 2003 (.doc) é substituída. Para obter mais informações, consulte Recursos preteridos no SQL Server Reporting Services no SQL Server 2016.

O renderizador do Word é compatível com o Microsoft Word 2003 e com o Pacote de Compatibilidade do Microsoft Office para Word, Excel e PowerPoint instalado. Para obter mais informações, consulte Pacote de Compatibilidade do Microsoft Office para Word, Excel e PowerPoint.

A versão anterior da extensão de renderização do Word, compatível com o Microsoft Word 2003, é renomeada como Word 2003. Apenas a extensão de renderização do Word está disponível por padrão. Você deve atualizar os arquivos de configuração do Reporting Services para disponibilizar a extensão de renderização do Word 2003. O tipo de conteúdo dos arquivos gerados pelo renderizador do Word 2003 é application/vnd.ms-word e a extensão de nome de arquivo dos arquivos é .doc.

No SQL Server Reporting Services, o renderizador padrão do Word é a versão que renderiza para o formato Microsoft Word (.docx). Esse formato é a opção do Word listada pelos menus Exportar em um portal da Web do Reporting Services e no SharePoint. A versão anterior, compatível somente com o Microsoft Word 2003, é chamada agora Word 2003 e listada em menus que usam esse nome. A opção de menu Word 2003 não é visível por padrão, mas um administrador pode torná-la visível atualizando o arquivo de configuração RSReportServer. Para exportar relatórios do SSDT (SQL Server Data Tools) usando o renderizador do Word 2003, atualize o arquivo de configuração RSReportDesigner. Porém, tornar o renderizador do Word 2003 visível não significa disponibilizá-lo em todos os cenários. Como o arquivo de configuração de RSReportServer reside no servidor de relatório, as ferramentas ou produtos de que onde você exporta relatórios devem estar conectados a um servidor de relatório para ler o arquivo de configuração. Se você usar ferramentas ou produtos em modo desconectado ou local, tornar o renderizador do Word 2003 visível não terá efeito. A opção de menu Word 2003 permanece indisponível. Se você tornar o renderizador do Word 2003 visível no arquivo de configuração RSReportDesigner, a opção de menu Word 2003 sempre estará disponível na visualização de relatório do SSDT (SQL Server Data Tools).

A opção de menu do Word 2003 nunca fica visível nos seguintes cenários:

Se o renderizador do Word 2003 estiver configurado para ficar visível, as opções de menu do Word e do Word 2003 estarão disponíveis nos seguintes cenários:

  • Portal da Web do Reporting Services quando o Reporting Services é instalado no modo nativo.

  • Site do SharePoint quando o Reporting Services é instalado no modo integrado do SharePoint.

  • SSDT (SQL Server Data Tools) quando você visualiza os relatórios.

  • Construtor de Relatórios conectado a um servidor de relatórios.

  • O Web Part do Visualizador de Relatórios em modo remoto.

O seguinte XML mostra os elementos para as duas extensões de renderização do Word nos arquivos de configuração RSReportServer e RSReportDesigner:

<Extension Name="WORDOPENXML" Type="Microsoft.ReportingServices.Rendering.WordRenderer.WordOpenXmlRenderer.WordOpenXmlDocumentRenderer,Microsoft.ReportingServices.WordRendering"/>

<Extension Name="WORD" Type="Microsoft.ReportingServices.Rendering.WordRenderer.WordDocumentRenderer,Microsoft.ReportingServices.WordRendering" Visible="false"/>

A extensão WORDOPENXML define o renderizador do Word para arquivos .docx do Microsoft Word. A extensão WORD define a versão do Microsoft Word 2003. Visible = "false" indica que o renderizador do Word 2003 está oculto. Para obter mais informações, consulte Arquivo de configuração RsReportServer.config e Arquivo de configuração RSReportDesigner.

Diferenças entre os renderizadores do Word e do Word 2003

Relatórios, renderizados usando renderizadores do Word ou Word 2003 tendem a ser visualmente indistinguíveis. Porém, você pode notar diferenças sutis entre os dois formatos do Word ou Word 2003.

Configurações de informações de dispositivo

Você pode alterar algumas configurações padrão desse renderizador alterando as configurações de informações de dispositivo. Você pode alterar algumas configurações padrão, como omitir hiperlinks e links de drillthrough ou expandir todos os itens que podem ser alternados independentemente do estado original do item quando renderizado. Para obter mais informações, confira Configurações das informações do dispositivo para Word.

Conteúdo relacionado

Mais perguntas? Experimente perguntar no fórum do Reporting Services