Criar relatórios paginados do Reporting Services com o Designer de relatórios (SSRS)

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

O Designer de Relatórios é um recurso do SSDT (SQL Server Data Tools), um ambiente do Microsoft Visual Studio para criação de soluções de business intelligence. SQL Server Data Tools (SSDT) não está incluído no SQL Server. Baixar o SQL Server Data Tools.

Benefícios dos projetos de relatório

Os projetos de relatório atuam como contêineres para recursos e definições de relatório. 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 primárias para relatórios e itens relacionados. Depois da implantação, os relatórios publicados podem ser modificados acidentalmente.

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

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, confira 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 Report Data Pane. 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 SQL Server Data Tools. Para esse recurso, use o Ambiente de criação do Construtor de Relatórios (SSRS).

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, confira Reporting Services no SSDT (SQL Server Data Tools).

Para saber mais, confira Criar cadeias de conexão de dados – Construtor de Relatórios e SSRS.

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, confira 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 Report Data Pane. 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 Ambiente de criação do Construtor de Relatórios (SSRS) no modo de Conjunto de Dados Compartilhado.

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, confira Conjuntos de dados inseridos e compartilhados de relatório (Construtor de Relatórios e SSRS), Ferramentas de Design da Consulta (SSRS), e Gerenciar conjuntos de dados compartilhados.

Relatórios paginados

Relatórios paginados 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, confira 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, confira Exemplos de URL para itens de relatório publicados em um Servidor de Relatório no modo do 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, confira 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, confira 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 Upgrade Reports.

• Importe 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, confira 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, confira Implantação e suporte de versão no SQL Server Data Tools (SSRS).

  A edição direta do RDL pode resultar em um relatório que não pode ser publicado no servidor de relatório ou executado. 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. As extensões de renderização personalizadas podem ler o elemento Personalizado. Mas, as extensões de renderização que o Reporting Services fornece ignoram o elemento . Por exemplo, você pode usar o elemento Personalizado para armazenar comentários no relatório.

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

Partes de relatório

Observação

As partes de relatório são preteridas para todas as versões de SQL Server Reporting Services, começando com o SQL Server Reporting Services 2019, e para todas as versões do Servidor de Relatórios do Power BI, começando com o Servidor de Relatórios do Power BI de setembro de 2022.

No Designer de Relatórios, você pode criar tabelas, gráficos e outros itens de relatório paginados em um projeto. Após criá-los, você poderá publicá-los como partes de relatório em um servidor de relatório ou site do SharePoint integrado a um servidor de relatório. Essa ação permite que você e outras pessoas os reutilizem em outros relatórios. Para obter mais informações, confira 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, confira Definir propriedades de implantação (Reporting Services).

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 saber mais, confira Recursos.

Layout do relatório paginado

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 é semelhante entre Construtor de Relatórios e Designer de Relatórios.

Visualizar um relatório paginado

Use a Visualização para verificar os dados e o design de 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 Output .

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 é 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 Selecione a guia Visualizar. O relatório é executado localmente e usa a mesma funcionalidade de processamento e renderização de relatório fornecida com o servidor de relatório. O relatório será exibido como uma imagem interativa: é possível selecionar parâmetros, selecionar 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, selecione Iniciar Depuração.

  • Na barra de ferramentas padrão do Visual Studio, selecione o 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 Propriedadese, em StartItem, selecione o nome do relatório a ser exibido.

  Se desejar visualizar um relatório específico que não seja o item inicial do projeto, selecione uma configuração que crie o relatório, mas não o implante (por exemplo, a configuração DebugLocal), clique com o botão direito no relatório e selecione Executar. Você deve escolher uma configuração que não implante o relatório. Caso contrário, o relatório não será publicado no servidor de relatório em vez de ser exibido localmente em uma 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 exibição não é HTML, mas o layout e a paginação do relatório são semelhantes à saída HTML.

  Você pode alterar a exibição para representar um relatório impresso alternando para o modo Visualizar Impressão. Selecione o botão Visualizar impressão na barra de ferramentas de exibição. O relatório é exibido como se estivesse em uma página física. 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 exibição de 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.

  • As quebras de página entre grupos não funcionam da maneira desejada.

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

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

Salvar e implantar relatórios paginados

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 de configuração e implantação.

No Designer de Relatórios, é importante entender que você cria um relatório usando o esquema de definição de relatório compatível com a versão atual do Reporting Services no SQL Server Data Tools (SSDT). Você pode definir propriedades de implantação de projeto para um servidor de relatório específico ou site do SharePoint. Quando você salva o relatório, o Report Designer salva a definição do relatório no diretório de criaçã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. Esta ação ocorre automaticamente e sem aviso prévio. Quando essa ação 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çãoExibir Código-Fonte exibe a origem da definição de relatório na pasta do projeto.

Para obter mais informações, confira Implantação e suporte de versão no SQL Server Data Tools (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 usar 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 relatórios paginados

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, confira Propriedades e configuração e de implantação e Definir propriedades de implantação (Reporting Services).

Exportar um relatório paginado 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, confira Exportar relatórios (Construtor de Relatórios e SSRS).

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. Muitos problemas de criação podem ocorrer quando os relatórios são criados. 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 build. 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. Os avisos e erros são gravados na janela SQL Server Data Tools (SSDT)Saída .

Problemas com níveis de severidade menor ou igual ao valor ErrorLevel são relatados como erros; caso contrário, eles 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 2016 (13.x) Reporting Services (SSRS) ou versões posteriores, 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 de build do relatório quando o mapa é removido. Porém, se você alterar o valor da propriedade ErrorLevel para 0 ou 1, o mapa será removido, um aviso será emitido e o processo de build continuará.

Conteúdo relacionado

Baixe o SQL Server Data Tools
Reporting Services no SQL Server Data Tools
Ferramentas de Design da Consulta
Implantação e suporte de versão no SQL Server Data Tools

Mais perguntas? Experimente perguntar no fórum do Reporting Services