Compartilhar via

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

  • Artigo

Aplica-se a: Microsoft Report Builder (SSRS) Power BI Report Builder Report Designer no SQL Server Data Tools

A extensão de renderização CSV (Comma-Separated Value) renderiza relatórios paginados como uma representação mesclada dos dados de um relatório padronizado, em formato de texto simples que pode ser facilmente lido e que também permite a troca com vários aplicativos.

A extensão de renderização do CSV usa um delimitador de caracteres da cadeia de caracteres para separar campos e linhas, um delimitador 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 pode ser utilizado como um formato de importação para outros programas. O relatório exportado torna-se um arquivo .csv e retorna um tipo MIME de text/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 e SSRS) para obter detalhes sobre como exportar para o formato CSV.

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.

renderização de CSV

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

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

    Observação

    Você pode alterar o delimitador de campo para qualquer caractere que desejar, inclusive o TAB, alterando as configurações de informações de dispositivo. Para obter mais informações, confira Configurações das informações do dispositivo para CSV.

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

  • A cadeia de caracteres qualificadora de texto é formada por aspas (").

    O renderizador de CSV não adiciona qualificadores ao redor de todas as cadeias de caracteres de texto. Os qualificadores de texto são adicionados apenas quando o valor contém o caractere delimitador ou uma quebra de linha.

  • Se o texto contiver uma cadeia de caracteres delimitadora inserida ou uma cadeia de caracteres qualificadora, o qualificador de texto será posicionado ao redor do texto e as cadeias de caracteres qualificadoras inseridas 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é

  • Itens de relatório personalizados

  • Linha

  • Imagem

  • Retângulo

  • Subtotais automáticos

Os demais itens do relatório são classificados de cima para baixo e da esquerda para a direita. Cada item é renderizado em uma coluna. Se o relatório aninhou itens de dados como listas ou tabelas, os itens pai serão repetidos em cada registro.

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

Item Comportamento da renderização
Caixa de texto 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, as configurações de informações do dispositivo podem alterar a formatação. Para obter mais informações sobre os modos de renderização de CSV, consulte mais adiante neste artigo.
Tabela Renderiza expandindo a tabela e criando uma linha e uma coluna para cada linha e coluna no nível mais baixo de detalhe. As linhas e colunas de subtotal não têm cabeçalhos de coluna ou de linha. Não há suporte para relatórios de detalhamento.
Matriz Renderiza expandindo a matriz e criando uma linha e uma coluna para cada linha e coluna no nível mais baixo de detalhe. As linhas e colunas de subtotal não têm cabeçalhos de coluna ou de linha.
Lista Renderiza um registro para cada linha de detalhes ou instância na lista.
Sub-relatório O item pai é repetido para cada instância de conteúdos.
Gráfico Renderiza criando uma linha para cada valor de gráfico e rótulos de membro. Os rótulos de séries e categorias em hierarquias são mesclados e incluídos na linha para obter 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.
Minigráficos 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 de início e fim do intervalo e valor do ponteiro.
Indicador Renderiza como um único registro com o nome do estado ativo, estados disponíveis e o valor de dados.
Mapeamento Renderiza uma linha com os rótulos e os valores para cada membro do mapa de uma camada do mapa.

Quando o mapa tem várias camadas, os valores nas linhas variam, dependendo do fato de as camadas do mapa usarem as mesmas regiões de dados do mapa ou regiões de dados do mapa diferentes. Se várias camadas do 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 para ser mesclados para que possam ser representados no formato CSV.

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

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

  • As colunas são ordenadas da seguinte forma: caixas de texto ordenadas da esquerda para a direita, de cima para baixo, seguida pelas regiões de dados ordenadas da esquerda para a direita, de cima para baixo.

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

  • As regiões de dados semelhantes são grupos de regiões de dados ou grupos dinâmicos que compartilham uma região de dados comum ou o ancestral dinâmico. Os dados pares são identificados pela ramificação da árvore mesclada.

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

Modos do renderizador

A extensão de renderização CSV pode operar em dois modos: um otimizado para o Excel e o outro otimizado para aplicativos não Microsoft que requerem total compatibilidade com a especificação CSV no RFC 4180. Dependendo do modo usado, as regiões de dados semelhantes são controladas de maneira diferente.

Modo padrão

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 por CSV. Cada região de dados semelhante é delimitada por uma linha vazia. As regiões de dados semelhantes dentro do corpo do relatório são renderizadas como blocos de dados separados dentro do arquivo CSV. O resultado é um arquivo CSV em que:

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

  • Cada região de dados semelhante 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.

Formatar

Os valores numéricos são renderizados em seus estados de formatação. O Excel pode reconhecer os valores numéricos formatados, como moeda, porcentagem e data, e formatar as células de maneira adequada quando importar o arquivo CSV.

Modo de conformidade

O modo compatível é otimizado para aplicativos que não são da Microsoft.

Regiões de Dados

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

Formatar

Os valores não são formatados.

Interatividade

Esse renderizador não oferece suporte à interatividade nos formatos CSV gerados. Os elementos interativos a seguir não são renderizados:

  • Hiperlinks

  • Mostrar ou ocultar

  • Mapa do documento

  • Links de detalhamento ou de clique

  • Classificação de usuário final

  • Cabeçalhos fixos

  • Indicadores

Configurações de informações de dispositivo

Você pode alterar algumas configurações padrão para esse renderizador. Essas configurações incluem o modo de renderização, os caracteres a serem usados como delimitadores e os caracteres a serem usados como a cadeia padrão do qualificador de texto. Você pode alterar essas configurações modificando as configurações de informações do dispositivo. Para obter mais informações, confira Configurações das informações do dispositivo para CSV.

Conteúdo relacionado