Artigo
09/28/2010

Exportando para um arquivo CSV (Construtor de Relatórios 2.0)

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çã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
Gauge
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.
Rectangle	O item pai é repetido para cada instância de conteúdos.
Subreport	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 (Construtor de Relatórios 2.0).

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.