Criar relatórios com o Designer de Relatórios (SSRS)

Use o Designer de Relatórios para criar relatórios e soluções completos do Reporting Services. O Designer de Relatórios fornece uma interface gráfica na qual você pode definir fontes de dados, conjuntos de dados e consultas, posições do layout do relatório para regiões de dados e campos e recursos interativos, como parâmetros e conjuntos de relatórios que funcionam em conjunto.

Beneficia para projetos

Use projetos para:

• Organizar relatórios e itens relacionados em um contêiner.

• Testar soluções de relatório que incluem relatórios e itens relacionados localmente.

• Implantar itens relacionados em conjunto. Usar propriedades de projeto e gerenciamento de configuração para implantação em vários ambientes.

• Preservar um conjunto de cópias mestres para relatórios e itens relacionados. Depois da implantação, os relatórios publicados podem ser modificados acidentalmente.

Use as informações deste tópico para criar relatórios e itens relacionados para um único projeto de relatório em uma solução do SSDT (SQL Server Data Tools). Para obter mais informações sobre soluções e vários projetos no SSDT (SQL Server Data Tools), consulte Reporting Services no SQL Server Data Tools (SSRS).

Neste artigo

Fontes de dados compartilhadas

Conjuntos de dados compartilhados

Relatórios

Partes de relatório

Recursos

Layout do relatório

Visualização

Salvar e implantar

Validação de relatórios e níveis de erro

Fontes de dados compartilhadas

Use o SQL Server Data Tools para definir e implantar fontes de dados compartilhadas para uma solução de relatório. As fontes de dados compartilhadas podem ser implantadas independentemente de outros itens em um projeto por meio das propriedades OverwriteDataSources e TargetDataSourceFolder. Para obter mais informações, consulte Definir propriedades de implantação (Reporting Services).

No Designer de Relatórios, você trabalha no painel Dados do Relatório e no Gerenciador de Soluções para definir as fontes de dados usadas em um relatório. Para obter mais informações, consulte Painel de dados do relatório. Você não pode usar o SQL Server Data Tools para abrir fontes de dados publicadas em um servidor de relatório ou site do SharePoint, mas não incluídas na solução do SQL Server Data Tools. Para esse recurso, use o Construtor de Relatórios (SSRS).

O SQL Server Data Tools é uma ferramenta de cliente. Você pode testar sua solução de relatório localmente em seu computador, implantá-la em um ambiente de teste para testar a solução de servidor e, em seguida, implantá-la em um ambiente de produção. Depois da implantação, verifique se as extensões de processamento de fonte de dados e as credenciais de fonte de dados estão configuradas para o ambiente de servidor de relatório. Você pode usar o Gerenciador de Configurações para ajudar a gerenciar as propriedades de diferentes implantações. Para obter mais informações, consulte Reporting Services no SQL Server Data Tools (SSRS).

Para obter mais informações, consulte Conexões de dados, fontes de dados e cadeias de conexão (SSRS).

Voltar ao início

Conjuntos de dados compartilhados

Use o SQL Server Data Tools para definir e implantar conjuntos de dados compartilhados para uma solução de relatório. Os conjuntos de dados compartilhados podem ser implantadas independentemente de outros itens em um projeto por meio das propriedades OverwriteDatasets e TargetDatasetFolder. Para obter mais informações, consulte Definir propriedades de implantação (Reporting Services).

No Designer de Relatórios, você trabalha no painel Dados do Relatório e no Gerenciador de Soluções para definir os conjuntos de dados compartilhados usados em um relatório. Para obter mais informações, consulte Painel de dados do relatório. Você não pode usar o SQL Server Data Tools para abrir conjuntos de dados publicados diretamente em um servidor de relatório ou site do SharePoint. Para esse recurso, use o Construtor de Relatórios (SSRS) no modo de Conjunto de Dados Compartilhado.

O SQL Server Data Tools é uma ferramenta de cliente. Você pode usar designers de consulta para ajudar a criar e testar os resultados de suas consultas localmente em Visualização. Depois da implantação, você pode gerenciar conjuntos de dados compartilhados independentemente das fontes de dados compartilhadas e dos relatórios dos quais eles dependem. Para obter mais informações, consulte Conjuntos de dados inseridos e compartilhados de relatório (Construtor de Relatórios e SSRS), Ferramentas de design de consulta no SQL Server Data Tools (SSRS) do Designer de Relatórios e Gerenciar conjuntos de dados compartilhados.

Voltar ao início

Relatórios

Relatórios são arquivos armazenados em um projeto de relatório. Os relatórios podem ser usados como relatórios autônomos, sub-relatórios ou os destinos para ações de detalhamento de relatórios principais. Os relatórios podem ser implantadas independentemente de outros itens em um projeto por meio da propriedade TargetReportFolder e de outras propriedades. Para obter mais informações, consulte Definir propriedades de implantação (Reporting Services).

Observação

Se você estiver publicando em um servidor de relatório em modo do SharePoint, alguns recursos de solução de relatório não poderão ser testados no projeto do Designer de Relatórios. As referências a relatórios, sub-relatórios e relatórios detalhados devem usar URLs totalmente qualificadas que possam ser testadas apenas depois de você implantar o projeto de relatório. Para obter mais informações, consulte Exemplos de URL para itens de relatório publicados em um servidor de relatório em modo de SharePoint (SSRS).

Você pode adicionar relatórios a um projeto das seguintes maneiras:

• Adicionar um novo projeto de relatório. Por padrão, um relatório em branco é aberto no Designer de Relatórios. Para obter mais informações, consulte Adicionar um relatório novo ou existente a um projeto de relatório (SSRS).

• Adicionar um projeto de Assistente de Relatório. Você cria um relatório de uma maneira orientada passo a passo. O Assistente de Relatório simplifica a definição de dados e o design de relatórios em uma série de etapas que fornecem um relatório concluído. Você pode adicionar estilos para personalizar o assistente para sua própria organização. Para obter mais informações, consulte Adicionar um relatório novo ou existente a um projeto de relatório (SSRS).

• Adicionar um novo item de tipo Relatório. Um relatório em branco é aberto no Designer de Relatórios.

• Adicionar um item Existente. Uma definição de relatório existente (.rdl) é aberta no Designer de Relatórios. A abertura de um relatório ou projeto em uma versão anterior do Reporting Services pode atualizar o projeto automaticamente para a versão atual, e o relatório para o esquema atual. Para obter mais informações, consulte Atualizar relatórios.

• Importar um relatório do Microsoft Access. Importe todos os relatórios de um banco de dados do Access (.mdb, .accdb) ou arquivo de projeto (.adp). O Designer de Relatórios converte cada relatório em um arquivo de banco de dados ou de projeto em RDL e salva-o no projeto de relatório. Nem todas as funcionalidades de um relatório do Access são transferidas para um arquivo de definição de relatório (.rdl). Para obter mais informações, consulte Importar relatórios do Microsoft Access (Reporting Services) e Recursos de relatórios do Access com suporte (SSRS).

  Observação
  Para usar o recurso de importação, você deve ter o Access 2002 ou uma versão posterior no mesmo computador que o Designer de Relatórios está instalado. A fonte de dados para os relatórios de Access deverá estar disponível quando os relatórios forem importados.

• Trabalhar diretamente em RDL. Quando você grava um relatório no Designer de Relatórios, o relatório é salvo no formato XML como um arquivo de linguagem RDL. Você poderá editar esse arquivo no Designer de Relatórios, em um editor de texto ou em qualquer ferramenta na qual possa editar XML.

  Ao editar a origem da definição do relatório no Designer de Relatórios, você está trabalhando no esquema RDL atual para a versão do SQL Server da qual você instalou as ferramentas de desenvolvimento. Quando você compila um projeto, a versão do esquema pode ser alterada de acordo com as propriedades de sua implantação. Para obter mais informações, consulte Implantação e suporte de versão nas Ferramentas de Dados do SQL Server (SSRS).

  Editar o RDL diretamente pode fazer com que um relatório não possa ser publicado ou executado no servidor de relatórios. Assim como em qualquer arquivo XML, verifique se os caracteres específicos da linguagem XML usados dentro dos elementos estão codificados corretamente. Ao publicar o relatório, o servidor de relatórios usa o esquema para validar o XML que está no arquivo RDL.

  Para incluir elementos que não fazem parte do esquema RDL, coloque-os no Elemento Personalizado. O Elemento Personalizado pode ser lido por extensões de renderização personalizadas, mas é ignorado por extensões de renderização fornecidas com o Reporting Services. Por exemplo, você pode usar o elemento Personalizado para armazenar comentários no relatório.

  Para obter mais informações, consulte Linguagem RDL (SSRS).

Voltar ao início

Partes de relatório

No Designer de Relatórios, depois de criar tabelas, gráficos e outros itens de relatório em um projeto, você pode publicá-los como partes de relatório em um servidor de relatório ou site do SharePoint integrado com um servidor de relatório de forma que você e outros usuários possam reutilizá-las em outros relatórios. Para obter mais informações, consulte Partes de relatório no Designer de Relatórios (SSRS).

As partes de relatório podem ser implantadas independentemente de outros itens em um projeto por meio da propriedade TargetReportPartFolder e de outras propriedades. Para obter mais informações, consulte Definir propriedades de implantação (Reporting Services).

Voltar ao início

Recursos

Você pode adicionar arquivos a seu projeto que estejam relacionados a seu relatório, mas não sejam processados pelo servidor de relatório. Por exemplo, você pode adicionar imagens para imagens ou arquivos de forma ESRI para dados espaciais. Para obter mais informações, consulte Recursos.

Voltar ao Início

Layout do relatório

Para criar o layout do relatório, arraste itens do relatório e regiões de dados da Caixa de Ferramentas para a superfície de design e organize-os. Arraste os campos de conjunto de dados para os itens na superfície de design para adicionar dados ao relatório. Para organizar dados em grupos em uma região de dados tablix, arraste campos de conjunto de dados para o painel Agrupamento. Como as ferramentas de criação de relatório são essencialmente uma maneira de criar definições de relatório, a abordagem do design de relatórios é bastante semelhante entre Construtor de Relatórios e Designer de Relatórios.

Voltar ao Início

Visualização

Use a Visualização para verificar os dados e o design do layout do relatório. Quando você visualiza um relatório, o processador de relatório valida o esquema de definição de relatório e a sintaxe de expressão e lista os problemas na janela ms173745(v=sql.110).md.

Observação

Quando você visualizar um relatório, seus dados serão armazenados em cache em um arquivo no computador local. Ao visualizar novamente o mesmo relatório usando a mesma consulta, os mesmos parâmetros e as mesmas credenciais, o Designer de Relatórios recuperará a cópia em cache em vez de executar a consulta mais uma vez. O arquivo de dados será salvo como <reportname>.rdl.data no mesmo diretório do arquivo de definição de relatório. Ele não será excluído quando você fechar o Designer de Relatórios.

Você pode visualizar um relatório das seguintes maneiras:

• Exibição de visualização Clique na guia Visualizar. O relatório é executado localmente, por meio da mesma funcionalidade de processamento e renderização de relatório do servidor de relatório. O relatório será exibido como uma imagem interativa: é possível selecionar parâmetros, clicar em links, exibir o mapa do documento e expandir e recolher áreas ocultas do relatório. Também é possível exportar o relatório para qualquer formato de renderização instalado.

• Visualização autônoma. Execute o relatório local em um navegador. Por meio de uma configuração de depuração, você também pode usar esse modo para depurar assemblies personalizados criados por você. Há três maneiras de executar um projeto em modo de Depuração:

  • No menu Depurar, clique em Iniciar.

  • Na barra de ferramentas padrão do Visual Studio, clique no botão Iniciar.

  • Pressione F5.

  Se você usar a configuração de projeto que cria um relatório mas não o implanta, o relatório especificado na propriedade StartItem da configuração atual será aberto em outra janela de visualização.

  Observação
  Para usar o modo de Depuração, defina um item inicial. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto de relatório, clique em Propriedades e, em StartItem, selecione o nome do relatório a ser exibido.

  Para visualizar um relatório em particular que não é o item inicial do projeto, selecione uma configuração que cria o relatório mas não o implanta (por exemplo, a configuração DebugLocal), clique com o botão direito do mouse no relatório e, em seguida, clique em Executar. Escolha uma configuração que não implante o relatório, caso contrário, o relatório será publicado no servidor de relatórios em vez de ser exibido localmente na janela de visualização.

• Visualizar Impressão.

  Na primeira vez em que você visualizar o relatório em modo de Visualização ou na janela de visualização, a exibição do relatório será similar a um relatório gerado pela extensão de renderização HTML. A visualização não é HTML, mas o layout e a paginação do relatório são semelhantes a uma saída em HTML.

  Você pode alterar a exibição para representar um relatório impresso alternando para o modo Visualizar Impressão. Clique no botão Visualizar Impressão na barra de ferramentas de visualização. O relatório será exibido como se tivesse sido impresso. Essa exibição é semelhante à saída produzida pelas extensões de renderização de Imagem e PDF. A visualização de impressão não é um arquivo de imagem ou PDF, mas o layout e a paginação do relatório são semelhantes a uma saída nesses formatos. Você pode escolher o tamanho da imagem do relatório, por exemplo, definir a largura da página.

  A visualização da impressão ajuda a identificar muitos dos problemas de renderização que você pode encontrar ao imprimir o relatório. Os problemas comuns de renderização incluem:

  • Páginas em branco extras porque o relatório é muito largo para se ajustar ao tamanho do papel especificado para o relatório.

  • Páginas em branco extras porque o relatório contém uma matriz que se expande dinamicamente para exceder a largura do papel especificado.

  • Quebras de páginas entre grupos que não funcionam da maneira desejada.

  • Cabeçalhos e rodapés que não são exibidos como esperado.

  • O layout do relatório precisa de modificação para melhor leitura em um formato impresso.

Voltar ao início

Salvar e implantar

No Designer de Relatórios, você pode salvar relatórios e outros arquivos de projeto localmente ou implantá-los em um servidor de relatório ou site do SharePoint. Fontes de dados compartilhadas, conjuntos de dados compartilhados, relatórios, recursos e partes de relatório podem ser implantados independentemente ou em conjunto dependendo das propriedades de implantação configuradas. Para obter mais informações, consulte Propriedades e configuração e de implantação.

No Designer de Relatórios, é importante entender que você cria um relatório por meio do esquema de definição de relatório com suporte da versão atual do Reporting Services no SSDT (SQL Server Data Tools). Quando você define propriedades de implantação de projeto para um servidor de relatório específico ou site do SharePoint e, em seguida, salva o relatório, o Designer de Relatórios salva a definição de relatório no diretório de compilação no esquema que corresponde à versão no servidor de relatório de destino. Para criar relatórios que podem ser publicados em um servidor de relatório de versão anterior, o Designer de Relatórios remove itens de relatório que não existem no esquema de destino. Isto ocorre automaticamente e sem solicitar. Quando isso ocorre, a definição de relatório original é preservada na pasta do projeto. A definição de relatório modificada que é implantada está na pasta de compilação.

Observação
Para depurar erros de expressões e de implantação, exiba a definição de relatório na pasta de compilação. Não use Exibir Código-Fonte. A opção Exibir Código-Fonte exibe a origem da definição de relatório na pasta do projeto.

Para obter mais informações, consulte Implantação e suporte de versão nas Ferramentas de Dados do SQL Server (SSRS).

Salvar um relatório localmente

Quando você trabalha em um relatório ou em outros itens de projeto no Designer de Relatórios, os arquivos são salvos em seu computador local ou em um compartilhamento em outro computador ao qual você tem acesso.

Se estiver usando software de controle de código-fonte, você talvez esteja verificando seus relatórios no servidor de controle do código-fonte ao salvar o relatório. Para obter mais informações, consulte Controle do código-fonte.

Implantar ou publicar

No SQL Server Data Tools, você pode implantar relatórios ou outros itens de projeto em várias versões de servidores de relatório do Reporting Services. Use as configurações de projeto para controlar a atualização de definições de relatório para versões de esquema compatíveis com os servidores de relatório de destino. As propriedades controladas por configurações de projeto incluem o servidor de relatório de destino, a pasta onde o processo de compilação armazena temporariamente as definições de relatórios para visualização e implantação e os níveis de erro. Para obter mais informações, consulte Propriedades e configuração e de implantação e Definir propriedades de implantação (Reporting Services).

Exportar um relatório para um formato de arquivo diferente.

Os relatórios podem ser exportados para diversos formatos; esses formatos afetam o funcionamento de alguns recursos de interatividade e de layout de relatório. Para obter mais informações sobre considerações de design para vários formatos de saída, consulte Exportando relatórios (Construtor de Relatórios e SSRS).

Voltar ao início

Validação de relatórios e níveis de erro

Os relatórios são validados antes da visualização e durante a implantação. Vários problemas de compilação podem ocorrer ao compilar relatórios. Os relatórios podem conter cadeias de caracteres como expressões ou consultas incompatíveis com a versão do Reporting Services que a configuração do projeto especifica, por exemplo.

Use a propriedade ErrorLevel para gerenciar os avisos e os erros de compilação. A propriedade ErrorLevel pode conter um valor de 0 a 4, inclusive. O valor determina quais problemas de compilação são relatados como erros e quais são relatados como avisos. O valor padrão é 2. Avisos e erros são gravados na janela de SSDT (SQL Server Data Tools) Saída.

Os problemas com níveis de severidade menor ou igual ao valor de ErrorLevel são relatados como erros; caso contrário, são relatados como avisos.

A tabela a seguir lista os níveis de erro.

Nível de erro	Descrição
0	Problemas de compilação mais severos e inevitáveis que impedem a visualização e a implantação de relatórios.
1	Problemas de compilação severos que alteram o layout de relatório drasticamente.
2	Problemas de compilação menos severos que alteram o layout de relatório de forma significativa.
3	Problemas de compilação secundários que alteram o layout de relatório de maneira quase imperceptível.
4	Somente usado para publicar avisos.

Quando você tenta visualizar ou implantar um relatório que contém novos itens de relatório no SQL Server 2008 R2, como mapas e barras de dados, esses itens de relatório podem ser removidos do relatório. Por padrão, a propriedade ErrorLevel da configuração é definida como 2, o que causa a falha na compilação do relatório quando o mapa é removido. Porém, se você alterar o valor da propriedade ErrorLevel para 0 ou 1, o mapa será descartado, um aviso será emitido e o processo de compilação continuará.

Voltar ao início

Consulte também

Conceitos

Reporting Services no SQL Server Data Tools (SSRS)

Ferramentas de design de consulta no SQL Server Data Tools (SSRS) do Designer de Relatórios

Implantação e suporte de versão nas Ferramentas de Dados do SQL Server (SSRS)