Exportar um relatório paginado do Power BI para o Microsoft Excel (Construtor de Relatórios do Power BI)

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

A extensão de renderização do Excel renderiza um relatório paginado do Power BI para o formato do Microsoft Excel (.xlsx). Com a extensão de renderização do Excel, a largura das colunas no Excel reflete com mais precisão a largura das colunas nos relatórios.

O formato é Office Open XML. O tipo de conteúdo de arquivos gerados por este renderizador é application/vnd.openxmlformats-officedocument.spreadsheetml.sheet e a extensão do arquivo é .xlsx.

Você pode alterar algumas configurações padrão para esse renderizador alterando as configurações de informações do dispositivo. Para obter mais informações, consulte Configurações de informações do dispositivo Excel.

Consulte Exportar relatórios (Construtor de Relatórios do Power BI) para obter detalhes sobre como exportar para o Excel.

Importante

Quando você define um parâmetro do tipo String, o usuário é apresentado com uma caixa de texto que pode ter qualquer valor. Se um parâmetro de relatório não estiver vinculado a um parâmetro de consulta e os valores de parâmetro forem incluídos no relatório, será possível para um usuário de relatório digitar sintaxe de expressão, script ou uma URL no valor do parâmetro e renderizar o relatório no Excel. Se outro usuário exibir o relatório e selecionar o conteúdo do parâmetro renderizado, o usuário poderá executar inadvertidamente o script ou link mal-intencionado.

Para reduzir o risco de executar scripts mal-intencionados inadvertidamente, abra relatórios renderizados somente de fontes confiáveis. Para obter mais informações sobre como proteger relatórios, consulte Proteger relatórios e recursos.

Limitações do Excel

O Microsoft Excel coloca limitações nos relatórios exportados devido aos recursos do Excel e seus formatos de arquivo. As mais significativas são as seguintes:

• A largura máxima da coluna é limitada a 255 caracteres ou 1726,5 pontos. O renderizador não verifica se a largura da coluna é menor que o limite.

• O número máximo de caracteres em uma célula é limitado a 32.767. Se isso for excedido, o renderizador exibirá uma mensagem de erro.

• A altura máxima da linha é de 409 pontos. Se o conteúdo da linha fizer com que a altura da linha aumente além de 409 pontos, a célula do Excel mostrará uma quantidade parcial de texto até 409 pontos. O resto do conteúdo da célula ainda está dentro da célula (até o número máximo de caracteres do Excel de 32.767).

• Como a altura máxima da linha é de 409 pontos, se a altura definida da célula no relatório for maior que 409 pontos, o Excel dividirá o conteúdo da célula em várias linhas.

• O número máximo de planilhas não é definido no Excel, mas fatores externos, como memória e espaço em disco, podem causar limitações a serem aplicadas.

• Nos contornos, o Excel permite apenas até sete níveis aninhados.

• Se o item de relatório que controla se outro item está alternado não estiver na linha ou coluna anterior ou seguinte do item que está sendo alternado, a estrutura de tópicos também será desabilitada.

Para obter mais detalhes sobre as limitações do Excel, consulte Especificações e limites do Excel.

Caixas de texto e texto

As seguintes limitações aplicam-se a caixas de texto e texto:

• Os valores de caixa de texto que são expressões não são convertidos em fórmulas do Excel. O valor de cada caixa de texto é avaliado durante o processamento do relatório. A expressão avaliada é exportada conforme o conteúdo de cada célula do Excel.

• As caixas de texto são renderizadas dentro de uma célula do Excel. O tamanho da fonte, o rosto da fonte, a decoração e o estilo da fonte são a única formatação suportada em texto individual dentro de uma célula do Excel.

• O efeito de texto "Overline" não é suportado no Excel.

• O Excel adiciona um preenchimento padrão de aproximadamente 3,75 pontos aos lados esquerdo e direito das células. Se as configurações de preenchimento de uma caixa de texto forem inferiores a 3,75 pontos e forem pouco largas o suficiente para acomodar o texto, o texto poderá ser quebrado no Excel.

  Nota

  Para contornar esse problema, aumente a largura da caixa de texto no relatório.

Imagens

As seguintes limitações aplicam-se às imagens:

• As imagens de fundo para itens de relatório são ignoradas porque o Excel não suporta imagens de fundo para células individuais.

• A extensão de renderização do Excel suporta apenas a imagem de plano de fundo do corpo do relatório. Se uma imagem de plano de fundo do corpo do relatório for exibida no relatório, a imagem será renderizada como uma imagem de plano de fundo da planilha.

Retângulos

A seguinte limitação aplica-se aos retângulos.

• Os retângulos nos rodapés do relatório não são exportados para o Excel. No entanto, retângulos no corpo do relatório, células tablix e assim por diante são renderizados como um intervalo de células do Excel.

Cabeçalhos e rodapés do relatório

As seguintes limitações aplicam-se aos cabeçalhos e rodapés do relatório:

• Os cabeçalhos e rodapés do Excel suportam um máximo de 256 caracteres, incluindo marcação. A extensão de renderização trunca a cadeia de caracteres em 256 caracteres.

• O Reporting Services não oferece suporte a margens em cabeçalhos e rodapés de relatório. Quando exportados para o Excel, esses valores de margem são definidos como zero e qualquer cabeçalho ou rodapé que contenha várias linhas de dados pode não imprimir várias linhas, dependendo das configurações da impressora.

• As caixas de texto em um cabeçalho ou rodapé mantêm sua formatação, mas não seu alinhamento quando exportadas para o Excel. Isso ocorre porque os espaços à esquerda e à direita são cortados quando o relatório é renderizado no Excel.

Fusão de células

A seguinte limitação aplica-se à fusão de células:

• Se as células forem mescladas, a quebra automática de texto não funcionará corretamente. Se existirem células mescladas em uma linha em que uma caixa de texto é renderizada com a propriedade AutoSize, o tamanho automático não funcionará.

O renderizador do Excel é principalmente um renderizador de layout. Seu objetivo é replicar o layout do relatório renderizado o mais próximo possível em uma planilha do Excel e, consequentemente, as células podem ser mescladas na planilha para preservar o layout do relatório. As células mescladas podem causar problemas porque a funcionalidade de classificação no Excel exige que as células sejam mescladas de uma maneira muito específica para que a classificação funcione corretamente. Por exemplo, o Excel requer que os intervalos de células mescladas tenham o mesmo tamanho para serem classificados.

Se for importante que os relatórios exportados para planilhas do Excel possam ser classificados, o seguinte pode ajudá-lo a reduzir o número de células mescladas em suas planilhas do Excel, que é a causa comum de dificuldades com a funcionalidade de classificação do Excel.

• Não alinhar itens à esquerda e à direita é a causa mais comum de células mescladas. Verifique se as bordas esquerda e direita de todos os itens de relatório estão alinhadas entre si. Fazer com que os itens se alinhem e a mesma largura resolverá o problema na maioria dos casos.

• Embora você alinhe todos os itens com precisão, você pode encontrar em alguns casos raros que algumas colunas continuam a ser mescladas. Isso pode ser causado pela conversão e arredondamento da unidade interna quando a planilha do Excel é renderizada. Na linguagem de definição de relatório (RDL), você pode especificar a posição e o tamanho em diferentes unidades de medida, como polegadas, pixels, centímetros e pontos. Internamente o Excel usa pontos. Para minimizar a conversão e a potencial imprecisão do arredondamento ao converter polegadas e centímetros em pontos, considere especificar todas as medições em pontos inteiros para obter os resultados mais diretos. Uma polegada é 72 pontos.

Grupos de linhas de relatório e grupos de colunas

Os relatórios que incluem grupos de linhas ou grupos de colunas contêm células vazias quando exportados para o Excel. Imagine um relatório que agrupa linhas na distância de deslocamento. Cada distância de deslocamento pode conter mais de um cliente. A imagem a seguir mostra o relatório.

Quando o relatório é exportado para o Excel, a distância de deslocamento aparece apenas em uma célula da coluna Distância de deslocamento. Dependendo do alinhamento do texto no relatório (superior, médio ou inferior), o valor está na primeira, média ou última célula. As outras células estão vazias. A coluna Nome que contém nomes de clientes não tem células vazias. A imagem a seguir mostra o relatório depois que ele é exportado para o Excel. As bordas dos glóbulos vermelhos foram adicionadas para ênfase. As caixas cinzentas são as células vazias. (Nem as linhas vermelhas nem as caixas cinzentas fazem parte do relatório exportado.)

Isso significa que os relatórios com grupos de linhas ou grupos de colunas exigem modificações após a exportação para o Excel e antes que você possa exibir os dados exportados na tabela dinâmica. Você deve adicionar o valor de grupo às células nas quais elas estão faltando para tornar a planilha uma tabela simples com valores em todas as células. A imagem a seguir mostra a planilha atualizada.

Portanto, se você criar um relatório com a finalidade específica de exportá-lo para o Excel para análise adicional dos dados do relatório, considere não agrupar em linhas ou colunas no relatório.

Renderizador do Excel

Renderizador de arquivo do Excel atual (.xlsx)

No Reporting Services, o renderizador defaultExcel é a versão compatível com os arquivos atuais (.xlsx) do Microsoft Excel. Esta é a opção do Excel nos menus Exportando no portal da Web dos Serviços do Power BI e na lista do SharePoint.

Ao usar o renderizador padrão do Excel, em vez do renderizador anterior do Excel 2003 (.xls), você pode instalar o Pacote de Compatibilidade do Microsoft Office para Word, Excel e PowerPoint para permitir que versões anteriores do Excel abram os arquivos exportados.

Diferenças entre os renderizadores atuais (.xlsx) do Excel e do Excel 2003

Os relatórios, renderizados usando o (.xlsx) Excel atual ou os renderizadores do Excel 2003 são normalmente idênticos e somente em raras circunstâncias você notará diferenças entre os dois formatos. A tabela a seguir compara os renderizadores do Excel e do Excel 2003.

Property	Excel 2003	Excel atual
Máximo de colunas por folha de cálculo	256	16,384
Máximo de linhas por folha de cálculo	65 536	1 048 576
Número de cores permitidas numa folha de cálculo	56 (paleta) Se mais de 56 cores forem usadas no relatório, a extensão de renderização corresponderá a cor necessária a uma das 56 cores já disponíveis na paleta personalizada.	Aproximadamente 16 milhões (cor de 24 bits)
Arquivos compactados ZIP	Nenhuma	Compressão ZIP
Família de fontes padrão	Arial	Calibri
Tamanho de fonte padrão	10 pt	11 pt
Altura da linha padrão	12,75 pt	15 pt

Como o relatório define explicitamente a altura da linha, a altura da linha padrão afeta apenas as linhas que são dimensionadas automaticamente após a exportação para o Excel.

Itens de relatório no Excel

Retângulos, sub-relatórios, o corpo do relatório e regiões de dados são renderizados como um intervalo de células do Excel. Caixas de texto, imagens e gráficos, barras de dados, minigráficos, mapas, medidores e indicadores devem ser renderizados dentro de uma célula do Excel, que pode ser mesclada dependendo do layout do restante do relatório.

Imagens, gráficos, minigráficos, barras de dados, mapas, medidores, indicadores e linhas são posicionados dentro de uma célula do Excel, mas ficam na parte superior da grade da célula. As linhas são renderizadas como bordas de célula.

Gráficos, minigráficos, barras de dados, mapas, medidores e indicadores são exportados como imagens. Os dados que eles representam, como o valor e os rótulos de membro de um gráfico, não são exportados com eles e não estão disponíveis na pasta de trabalho do Excel, a menos que sejam incluídos em uma coluna ou linha em uma região de dados dentro de um relatório.

Se você quiser trabalhar com gráficos, minigráficos, barra de dados, mapas, medidores e dados de indicadores, exporte o relatório para um arquivo de .csv do relatório. Para obter mais informações, consulte Exportando para um arquivo CSV (Construtor de Relatórios do Power BI).

Dimensionamento da página

A extensão de renderização do Excel usa as configurações de altura e largura da página para determinar qual configuração de papel definir na planilha do Excel. O Excel tenta fazer corresponder as configurações das propriedades PageHeight e PageWidth a um dos tamanhos de papel mais comuns.

Se não forem encontradas correspondências, o Excel utiliza o tamanho de página predefinido para a impressora. A orientação é definida como Retrato se a largura da página for menor que a altura da página; caso contrário, a orientação será definida como Paisagem.

Nomes dos separadores da folha de cálculo

Quando você exporta um relatório para o Excel, as páginas de relatório que foram criadas por quebras de página são exportadas para planilhas diferentes. Se você forneceu um nome de página inicial para o relatório, cada planilha da pasta de trabalho do Excel terá esse nome por padrão. O nome aparece na guia da planilha. No entanto, como cada planilha em uma pasta de trabalho deve ter um nome exclusivo, um inteiro começando em 1 e incrementado por 1 é anexado ao nome da página inicial para cada planilha adicional. Por exemplo, se o nome da página inicial for Relatório de vendas por ano fiscal, a segunda planilha será denominada Relatório de vendas por ano fiscal1, a terceira Relatório de vendas por ano fiscal2 e assim por diante.

Se todas as páginas de relatório criadas por quebras de página fornecerem novos nomes de página, cada planilha terá o nome de página associado. No entanto, esses nomes de página podem não ser exclusivos. Se os nomes de página não forem exclusivos, as planilhas serão nomeadas da mesma forma que os nomes de página inicial. Por exemplo, se o nome da página de dois grupos for Sales for NW, uma guia da planilha terá o nome Sales para NW e a outra Sales para NW1.

Se o relatório não fornecer um nome de página inicial, nem nomes de página relacionados a quebras de página, as guias da planilha terão os nomes padrão Sheet1, Sheet2 e assim por diante.

O Reporting Services fornece propriedades para definir em relatórios, regiões de dados, grupos e retângulos para ajudá-lo a criar relatórios que podem ser exportados para o Excel da maneira desejada. Para obter mais informações, consulte Paginação no Reporting Services (Construtor de Relatórios do Power BI).

Propriedades do documento

O renderizador do Excel grava os seguintes metadados no arquivo do Excel.

Propriedades do elemento de relatório	Description
Criado	Data e hora da execução do relatório como um valor de data/hora ISO.
Autor	Relatório.Autor
Description	Relatório.Descrição
LastSaved	Data e hora da execução do relatório como um valor de data/hora ISO.

Cabeçalhos e rodapés de páginas

Dependendo da configuração Device Information SimplePageHeaders, o cabeçalho da página pode ser renderizado de duas maneiras: o cabeçalho da página pode ser renderizado na parte superior de cada grade de célula da planilha ou na seção real do cabeçalho da planilha do Excel. Por padrão, o cabeçalho é renderizado para a grade de células na planilha do Excel.

O rodapé da página é sempre renderizado para a seção real do rodapé da planilha do Excel, independentemente do valor da configuração SimplePageHeaders.

As secções de cabeçalho e rodapé do Excel suportam um máximo de 256 carateres, incluindo marcação. Se esse limite for excedido, o renderizador do Excel removerá caracteres de marcação começando no final da cadeia de caracteres de cabeçalho e/ou rodapé para reduzir o número total de caracteres. Se todos os caracteres de marcação forem removidos e o comprimento ainda exceder o máximo, a cadeia de caracteres será truncada a partir da direita.

Configurações do SimplePageHeader

Por padrão, a configuração Device Information SimplePageHeaders é definida como False, portanto, os cabeçalhos de página são renderizados como linhas no relatório na superfície da planilha do Excel. As linhas da planilha que contêm os cabeçalhos tornam-se linhas bloqueadas. Você pode congelar ou descongelar o painel no Excel. Se a opção Imprimir Títulos estiver selecionada, esses cabeçalhos serão automaticamente definidos para impressão em todas as páginas da planilha.

O cabeçalho da página se repete na parte superior de todas as planilhas da pasta de trabalho, exceto na folha de rosto do mapa do documento, se a opção Imprimir Títulos estiver selecionada na guia Layout de Página no Excel. Se a opção Imprimir na primeira página ou Imprimir na última página não estiver selecionada nas caixas de diálogo Propriedades do Cabeçalho do Relatório ou Propriedades do Rodapé do Relatório, o cabeçalho não será adicionado à primeira ou à última página, respectivamente.

Os rodapés de página são renderizados na seção de rodapé do Excel.

Devido às limitações do Excel, as caixas de texto são o único tipo de item de relatório que pode ser processado na seção cabeçalho/rodapé do Excel.

Interatividade

Alguns elementos interativos são suportados no Excel. Segue-se uma descrição de comportamentos específicos.

Mostrar e ocultar

O Microsoft Excel tem limitações com a forma como gerencia itens de relatório ocultos e exibidos quando eles são exportados. Grupos, linhas e colunas que contêm itens de relatório que podem ser alternados são renderizados como contornos do Excel. O Excel cria contornos que expandem e recolhem linhas e colunas em toda a linha ou coluna, o que pode causar o colapso de itens de relatório que não se destinam a ser recolhidos. Além disso, os símbolos de contorno do Excel podem ficar confusos com contornos sobrepostos. Para resolver esses problemas, as seguintes regras de estrutura de tópicos são aplicadas ao usar a extensão de renderização do Excel:

• O item de relatório no canto superior esquerdo que pode ser alternado pode continuar a ser alternado no Excel. Os itens de relatório que podem ser alternados e compartilhar espaço vertical ou horizontal com o item de relatório que pode ser alternado no canto superior esquerdo não podem ser alternados no Excel.

• Para determinar se uma região de dados será recolhível por linhas ou colunas, a posição do item de relatório que controla a alternância e a posição do item de relatório que é alternado são determinadas. Se o item que controla a alternância aparecer antes do item a ser alternado, o item será recolhível por linhas. Caso contrário, o item é recolhível por colunas. Se o item que controla a alternância aparecer ao lado e acima da área a ser alternada igualmente, o item será renderizado com linha recolhível por linhas.

• Para determinar onde os subtotais são colocados no relatório renderizado, a extensão de renderização examina a primeira instância de um membro dinâmico. Se um membro estático de mesmo nível aparecer imediatamente acima dele, o membro dinâmico é assumido como sendo os subtotais. Os contornos são definidos para indicar que se trata de dados resumidos. Se não houver irmãos estáticos de um membro dinâmico, a primeira instância da instância será o subtotal.

• Devido a uma limitação do Excel, os contornos podem ser aninhados até sete níveis apenas.

Mapa do documento

Se existirem rótulos de mapa de documento no relatório, um mapa de documento será renderizado. O mapa do documento é renderizado como uma planilha de capa do Excel inserida na posição da primeira guia na pasta de trabalho. A planilha é chamada Mapa do documento.

O texto exibido no mapa do documento é determinado pela propriedade DocumentMapLabel do item ou grupo de relatório. Os rótulos do mapa do documento são listados na ordem em que aparecem no relatório, começando na primeira linha, na primeira coluna. Cada célula do rótulo do mapa do documento é recuada e o número de níveis de profundidade que aparece no relatório. Cada nível de recuo é representado colocando o rótulo em uma coluna subsequente. O Excel suporta até 256 níveis de aninhamento de estrutura de tópicos.

O contorno do mapa do documento é renderizado como um contorno recolhível do Excel. A estrutura de tópicos corresponde à estrutura aninhada do mapa do documento. O estado de expansão e colapso do contorno começa no segundo nível.

O nó raiz do mapa é o nome do relatório, o <reportname.rdl>, e não é interativo. A fonte dos links do mapa do documento é Arial, 10 pt.

Links de detalhamento

Os links de detalhamento que aparecem em caixas de texto são renderizados como hiperlinks do Excel na célula na qual o texto é renderizado. Os links de detalhamento para imagens e gráficos são renderizados como hiperlinks do Excel na imagem quando renderizados. Quando selecionado, o link de detalhamento abre o navegador padrão do cliente e navega até a visualização HTML do destino.

Hiperligações

Os hiperlinks que aparecem em caixas de texto são renderizados como hiperlinks do Excel na célula na qual o texto é renderizado. Os hiperlinks para imagens e gráficos são renderizados como hiperlinks do Excel na imagem quando renderizados. Quando selecionado, o hiperlink abre o navegador padrão do cliente e navega até a URL de destino.

Classificação interativa

O Excel não suporta a classificação interativa.

Marcadores

Os links de favoritos em caixas de texto são renderizados como hiperlinks do Excel na célula na qual o texto é renderizado. Os links de favoritos para imagens e gráficos são renderizados como hiperlinks do Excel na imagem quando renderizados. Quando selecionado, o indicador vai para a célula do Excel na qual o item de relatório marcado é renderizado.

Alterando relatórios em tempo de execução

Se um relatório precisar ser renderizado em vários formatos e não for possível criar um layout de relatório que renderize da maneira desejada em todos os formatos necessários, considere usar o valor no global interno RenderFormat para alterar condicionalmente a aparência do relatório em tempo de execução. Dessa forma, você pode ocultar ou mostrar itens de relatório dependendo do renderizador usado para obter os melhores resultados em cada formato. Para obter mais informações, consulte Referências globais e de usuários internas (Construtor de Relatórios do Power BI).

Conteúdos relacionados

• Paginação no Reporting Services (Construtor de Relatórios do Power BI)
• Comportamentos de renderização (Construtor de Relatórios do Power BI)
• Funcionalidade interativa para diferentes extensões de renderização de relatório (Construtor de Relatórios do Power BI)
• Renderizando itens de relatório (Construtor de Relatórios do Power BI)
• Tabelas, matrizes e listas (Construtor de Relatórios do Power BI)