Partilhar via


Exportar relatório paginado do Power BI para um arquivo CSV (Construtor de Relatórios do Power BI)

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

A extensão de renderização CSV (Comma-Separated Value) renderiza relatórios paginados como uma representação nivelada de dados de um relatório em um formato padronizado de texto simples que é facilmente legível e trocável com muitos aplicativos.

A extensão de renderização CSV usa um delimitador de caracteres de cadeia de caracteres para separar campos e linhas, com o delimitador de caracteres de cadeia configurável para ser um caractere diferente de uma vírgula. O arquivo resultante pode ser aberto em um programa de planilha como o Microsoft Excel ou usado como um formato de importação para outros programas. O relatório exportado torna-se um arquivo .csv e retorna um tipo MIME de texto/csv.

Se você quiser trabalhar com dados relacionados a gráficos, barras de dados, minigráficos, medidores e indicadores no Microsoft Excel, exporte o relatório para um arquivo CSV e abra o arquivo no Microsoft Excel.

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

Nota

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios do Power BI.

Renderização CSV

Quando renderizado usando as configurações padrão, um relatório CSV tem as seguintes características:

  • A cadeia de caracteres do delimitador de campo padrão é uma vírgula (,).

    Nota

    Você pode alterar o delimitador de campo para qualquer caractere desejado, incluindo TAB, alterando as configurações de informações do dispositivo. Para obter mais informações, consulte Configurações de informações do dispositivo CSV.

  • A cadeia de caracteres do delimitador de registro é o retorno de carro e alimentação de linha (<cr><lf>).

  • A cadeia de caracteres do qualificador de texto é uma aspa (").

    O renderizador CSV não adiciona qualificadores em torno de todas as cadeias de texto. Os qualificadores de texto são adicionados somente quando o valor contém o caractere delimitador ou quando o valor tem uma quebra de linha.

  • Se o texto contiver uma cadeia de caracteres de delimitador incorporado ou uma cadeia de caracteres de qualificador, o qualificador de texto será colocado ao redor do texto e as cadeias de caracteres de qualificador incorporadas serão duplicadas.

  • A formatação e o layout são ignorados.

Os seguintes itens são ignorados durante a renderização:

  • Cabeçalho da página

  • Rodapé da página

  • Itens de relatório personalizados

  • Line

  • Image

  • Retângulo

  • Subtotais automáticos

Os restantes itens de relatório são ordenados de cima para baixo e, em seguida, da esquerda para a direita. Cada item é então renderizado em uma coluna. Se o relatório tiver itens de dados aninhados, como listas ou tabelas, os itens pai serão repetidos em cada registro.

A tabela a seguir indica a aparência dos itens de relatório quando renderizados:

Item Comportamento de renderização
Text box Renderiza o conteúdo da caixa de texto. No modo padrão, os itens são formatados com base nas propriedades de formatação do item. No modo compatível, a formatação pode ser alterada pelas configurações de informações do dispositivo. Para obter mais informações sobre os modos de renderização CSV, consulte abaixo.
Tabela Renderiza expandindo a tabela e criando uma linha e coluna para cada linha e coluna no nível mais baixo de detalhes. As linhas e colunas do subtotal não têm cabeçalhos de coluna ou linha. Não há suporte para relatórios de detalhamento.
Matriz Renderiza expandindo a matriz e criando uma linha e coluna para cada linha e coluna no nível mais baixo de detalhes. As linhas e colunas do subtotal não têm cabeçalhos de coluna ou linha.
Listagem Renderiza um registro para cada linha ou instância de detalhe na lista.
Sub-relatório O item pai é repetido para cada instância do conteúdo.
Gráfico Renderiza criando uma linha para cada valor de gráfico e rótulos de membros. Os rótulos de séries e categorias em hierarquias são nivelados e incluídos na linha para um valor de gráfico.
Barra de dados Renderiza como um gráfico. Normalmente, uma barra de dados não inclui hierarquias ou rótulos.
Gráfico Sparkline Renderiza como um gráfico. Normalmente, um minigráfico não inclui hierarquias ou rótulos.
Medidor Renderiza como um único registro com os valores mínimo e máximo da escala linear, valores iniciais e finais do intervalo e o valor do ponteiro.
Indicador Renderiza como um único registro com o nome do estado ativo, os estados disponíveis e o valor dos dados.
Mapa Renderiza uma linha com os rótulos e valores para cada membro do mapa de uma camada de mapa.

Se o mapa tiver várias camadas, os valores nas linhas variam dependendo se as camadas do mapa usam as mesmas regiões de dados do mapa ou diferentes. Se várias camadas de mapa usarem a mesma região de dados, as linhas conterão dados de todas as camadas.

Dados hierárquicos e agrupados

Os dados hierárquicos e agrupados devem ser nivelados para serem representados no formato CSV.

A extensão de renderização nivela o relatório em uma estrutura de árvore que representa os grupos aninhados dentro da região de dados. Para achatar o relatório:

  • Uma hierarquia de linha é nivelada antes de uma hierarquia de coluna.

  • As colunas são ordenadas da seguinte forma: caixas de texto em ordem de corpo da esquerda para a direita, de cima para baixo seguidas por regiões de dados ordenadas da esquerda para a direita, de cima para baixo.

  • Dentro de uma região de dados, as colunas são ordenadas da seguinte forma: membros de canto, membros da hierarquia de linha, membros da hierarquia de coluna e, em seguida, células.

  • Regiões de dados de mesmo nível são regiões de dados ou grupos dinâmicos que compartilham uma região de dados comum ou ancestral dinâmico. Os dados de pares são identificados pela ramificação da árvore achatada.

Para obter mais informações, consulte Tabelas, matrizes e listas (Construtor de Relatórios do Power BI).

Modos de renderização

A extensão de renderização CSV pode operar em dois modos: um é otimizado para Excel e o outro é otimizado para aplicativos de terceiros que exigem estrita conformidade CSV com a especificação CSV na RFC 4180. Dependendo do modo usado, as regiões de dados de mesmo nível são tratadas de forma diferente.

Modo predefinido

O modo padrão é otimizado para Excel. Quando renderizado no modo padrão, o relatório é renderizado como um arquivo CSV com várias seções de dados renderizados em CSV. Cada região de dados de mesmo nível é delimitada por uma linha vazia. As regiões de dados de mesmo nível no corpo do relatório são renderizadas como blocos separados de dados dentro do arquivo CSV. O resultado é um arquivo CSV no qual:

  • As caixas de texto individuais no corpo do relatório são renderizadas uma vez como o primeiro bloco de dados dentro do arquivo CSV.

  • Cada região de dados de nível superior no corpo do relatório é renderizada em seu próprio bloco de dados.

  • As regiões de dados aninhadas são renderizadas diagonalmente no mesmo bloco de dados.

Formatação

Os valores numéricos são renderizados em seu estado formatado. O Excel pode reconhecer valores numéricos formatados, como moeda, porcentagem e data, e formatar as células adequadamente ao importar o arquivo CSV.

Modo compatível

O modo compatível é otimizado para aplicativos de terceiros.

Regiões de dados

Apenas a primeira linha do ficheiro contém os cabeçalhos das colunas e cada linha tem o mesmo número de colunas.

Formatação

Os valores não estão formatados.

Interatividade

A interatividade não é suportada por nenhum dos formatos CSV gerados por este renderizador. Os seguintes elementos interativos não são renderizados:

  • Hiperligações

  • Mostrar ou ocultar

  • Mapa do Documento

  • Links de detalhamento ou clickthrough

  • Classificação do usuário final

  • Corrige cabeçalhos

  • Marcadores

Configurações de informações do dispositivo

Você pode alterar algumas configurações padrão para esse renderizador, incluindo em qual modo renderizar, quais caracteres usar como delimitadores e quais caracteres usar como a cadeia de caracteres padrão do qualificador de texto, alterando as configurações de informações do dispositivo. Para obter mais informações, consulte Configurações de informações do dispositivo CSV.