• Artigo

Exportando para um arquivo CSV

A extensão de renderização CSV (Comma-Separated Value) renderiza relatórios 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.

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çãoObservaçã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, consulte Configurações de Informações de Dispositivo do Reporting Services.

  • 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 incorporada ou uma cadeia de caracteres qualificadora, o qualificador de texto será posicionado ao redor do texto e as cadeias de caracteres qualificadoras incorporadas serão duplicadas.

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

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

  • Gráfico

  • Indicador

  • Cabeçalho

  • Rodapé

  • Itens personalizados

  • Linhas

  • Imagem

  • 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, a formatação pode ser alterada pelas configurações das informações do dispositivo. Para obter mais informações sobre os modos de renderização de CSV, consulte as informações a seguir.

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.

Retângulo

O item pai é repetido para cada instância de conteúdos.

Sub-relatório

O item pai é repetido para cada instância de conteúdos.

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.

  • Os membros da hierarquia de linha são renderizados para o arquivo de CSV antes dos membros da 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 semelhantes são identificados pela ramificação da árvore mesclada.

Para obter mais informações, consulte Trabalhando com regiões de dados Tablix.

Modos do Renderizador

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 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.

Formatação

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 Compatível

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

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.

Formatação

Os valores não são formatados.

Interatividade

A interatividade não é suportada por formatos de CSV gerados por este renderizador. Os elementos interativos a seguir não são renderizados:

  • Hiperlinks

  • Mostrar ou ocultar

  • Mapa do documento

  • Vínculos de detalhamento ou de clickthrough

  • 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 deste renderizador, incluindo qual o modo de processamento, quais caracteres serão usados como delimitadores e quais caracteres serão usados como a cadeia de caracteres padrão do qualificador de texto, alterando as configurações de informações de dispositivo. Para obter mais informações, consulte Configurações de Informações de Dispositivo do Reporting Services.