Exportar um relatório paginado do Power BI para o Microsoft Word (Power BI Report Builder)

  • Artigo

APLICA-SE A: Power BI Report Builder Power BI Desktop

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

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

Confira Exportar relatórios (Power BI Report Builder) para obter detalhes sobre como exportá-lo 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 Power BI Report Builder.

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 causar a inserção de quebras de páginas em locais onde você não pretendia acrescentá-las e, em alguns casos, pode fazer com que o relatório exportado tenha duas quebras de página sucessivas em uma linha ou até acrescentar 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.

Dimensionamento da página

Quando o relatório é renderizado, a altura e a largura da página do Word são definidas pelas seguintes propriedades RDL: altura e largura do tamanho do papel, margens direta e esquerda da página e as 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 mais largo de que 22 polegadas, mesmo assim o processador irá renderizar o relatório, porém o Word não exibirá o conteúdo do relatório quando em exibição de layout de impressão ou exibição 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 o número de página de um relatório ou uma expressão que indica o número total de páginas do relatório aparecer no cabeçalho ou rodapé da página, eles são transferidos para um campo do word para que o número preciso da página 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 somente uma única seção, você poderá definir PrintOnFirstPage como False e o texto será suprimido na primeira 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, quando um rodapé ou um cabeçalho da página contém uma expressão complexa que é avaliada como valores diferentes em páginas diferentes de um relatório, 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

Isto 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 são renderizadas corretamente quando você visualiza o relatório no Power BI Report Builder ou quando renderiza o relatório publicado em um portal da Web de Serviços do Power BI 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, Média de vendas e expressão, =Avg(Fields!YTDPurchase.Value, "Sales), e texto, Número da página e expressão =Globals!PageNumber

Para evitar esse problema, use várias 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 etiquetas de mapas de documentos existirem no relatório, elas são renderizadas como etiquetas de Índice nos itens e grupos do respectivo item de relatório. 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ê no 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 suspenso Partes rápidas.
  4. Selecione Campo no menu suspenso.
  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 do documento ou um sumário (Power BI Report Builder) para obter mais informações.

Interatividade

Alguns elementos interativos têm suporte no Word. 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.

Renderização de estilo no Word

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. Isso 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. Depois de atualizar o conteúdo, você precisa 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 tópicos 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

As limitações a seguir são aplicadas pelo Microsoft Word:

  • 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 colunas adicionais serão colocadas adjacente às 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. Isto pode fazer com que quebras de página adicionais seja acrescentadas 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 significativamente 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.

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ê poderá observar diferenças sutis entre os dois formatos do Word ou do Word 2003.

Configurações de informações de dispositivo

É possível alterar algumas configurações padrão para este processador, como omitir hiperlinks e links de detalhamento ou expandir todos os itens que podem ser alternados independentemente do estado original do item quando renderizado, mudando as configurações das informações do dispositivo. Para obter mais informações, confira Configurações das informações do dispositivo para Word.

Conteúdo relacionado