Partilhar via

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

Aplica-se a: Construtor de Relatórios da Microsoft (SSRS) Designer de Relatórios do Power BI no SQL Server Data Tools

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 os relatórios de exportação (Construtor de Relatórios e SSRS) para detalhes sobre como exportar para 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, no Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Renderização CSV

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

  • A cadeia delimitadora de campo por defeito é uma vírgula (,).

    Observação

    Podes mudar o delimitador de campo para qualquer carácter que queiras, incluindo Tab, alterando as definições de informação do dispositivo. Para obter mais informações, consulte Configurações de informações do dispositivo CSV.

  • A cadeia delimitadora de registo é o retorno do carro e o avanço da linha (<cr><lf>).

  • A cadeia de qualificadores de texto é uma aspa (").

    O renderizador CSV não adiciona qualificadores em 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 de página

  • Rodapé da página

  • Itens de relatório personalizados

  • Linha

  • Imagem

  • 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
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. Em modo compatível, as definições de informação do dispositivo podem alterar a formatação. Para mais informações sobre modos de renderização CSV, veja mais adiante neste artigo.
Table 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 de subtotais não têm cabeçalhos de coluna nem de linha. Os relatórios Drillthrough não são suportados.
Matriz Renderiza expandindo a matriz e criando uma linha e coluna para cada linha e coluna no nível mais baixo de detalhes. Subtotais de linhas e colunas não têm cabeçalhos de linha ou coluna.
List 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, uma Sparkline 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.
Indicator Renderiza como um único registro com o nome do estado ativo, os estados disponíveis e o valor dos dados.
Map Renderiza uma linha com os rótulos e valores para cada membro do mapa de uma camada de mapa.

Quando o mapa tem múltiplas camadas, os valores nas linhas variam dependendo se as camadas do mapa usam as mesmas ou diferentes regiões de dados do mapa. 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 mais informações, consulte Tabelas, matrizes e listas (Construtor de Relatórios e SSRS).

Modos de renderização

A extensão de renderização CSV pode operar em dois modos: um está otimizado para Excel e o outro é otimizado para aplicações não Microsoft que requerem estrita conformidade com CSV com a especificação CSV no 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 do par é delimitada por linhas vazias. 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.

Formato

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 aplicações não Microsoft.

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.

Formato

Os valores não estão formatados.

Interatividade

Este renderizador não suporta interatividade nos formatos CSV gerados. Os seguintes elementos interativos não são renderizados:

  • Hyperlinks

  • Mostrar ou ocultar

  • Mapa do Documento

  • Links de detalhamento ou clickthrough

  • Classificação do usuário final

  • Corrige cabeçalhos

  • Bookmarks

Configurações de informações do dispositivo

Podes alterar algumas definições predefinidas para este renderizador. Estas definições incluem em que modo renderizar, que caracteres usar como delimitadores e que caracteres usar como cadeia padrão de qualificadores de texto. Pode alterar estas definições modificando as informações do dispositivo. Para obter mais informações, consulte Configurações de informações do dispositivo CSV.

Conteúdo relacionado

  • Last updated on