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

  • Artigo

Aplica-se a: SQL Server 2016 (13.x) Reporting Services e versões posteriores

Você pode usar o Report Designer para criar relatórios paginados e soluções de relatórios do completas do SSRS (SQL Server Reporting Services). O Report Designer fornece:

  • Uma maneira de definir fontes de dados, conjuntos de dados e consultas.
  • Recursos para projetar e personalizar o layout de regiões de dados e campos.
  • 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.

Instalação do SSDT

O SSDT não está incluído no SQL Server. Você deverá instalá-lo separadamente. Para obter instruções, consulte Instalar SSDT com Visual Studio.

Para usar modelos do Report Designer, você também precisa instalar uma extensão do SSRS para Visual Studio. Para obter instruções, consulte Instalar extensões para Analysis Services, Serviços de Integração e Reporting Services.

Benefícios dos projetos de relatório

No Report Designer, você pode usar projetos para organizar relatórios. Os projetos de relatório atuam como contêineres para recursos e definições de relatório. Você pode usar projetos para as seguintes tarefas:

  • 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. Você pode usar propriedades de projeto e gerenciamento de configuração para implantar itens em vários ambientes.
  • Preservar um conjunto de cópias primárias para relatórios e itens relacionados, pois após a 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 do SSDT. Para obter mais informações sobre soluções e vários projetos no SSDT, consulte Reporting Services nas SQL Server Data Tools (SSDT).

Fontes de dados e conjuntos de dados compartilhados

O SSDT fornece uma maneira de definir e implantar fontes de dados compartilhadas e conjuntos de dados compartilhados para uma solução de relatório.

  • Para implantar uma fonte de dados compartilhada independentemente de outros itens em um projeto, você pode usar as propriedades OverwriteDataSources e TargetDataSourceFolder.
  • Para implantar um conjunto de dados compartilhado independentemente de outros itens em um projeto, você pode usar as propriedades OverwriteDatasets e TargetDatasetFolder.

Para obter mais informações, consulte Definir propriedades de implantação (Reporting Services).

No Report Designer, você trabalha no painel de Dados do Relatório e no Gerenciador de Soluções para definir as fontes de dados e os conjuntos de dados compartilhados usados em um relatório. Para obter mais informações, consulte Report Data Pane.

Se uma fonte de dados for publicada em um servidor de relatório ou site do SharePoint, mas não estiver incluída na solução SSDT, você não poderá usar o SSDT para abrir essa fonte de dados. Da mesma forma, você não pode usar o SSDT para abrir conjuntos de dados publicados diretamente de um servidor de relatórios ou site do SharePoint. Para abrir uma fonte de dados ou conjunto de dados nesses cenários, você pode usar o Construtor de Relatórios. Para obter mais informações, consulte SSRS (Ambiente de criação do Construtor de Relatórios). Para conjuntos de dados, use esse ambiente no modo de conjunto de dados compartilhado.

O SSDT é uma ferramenta de cliente. Você pode usá-lo para:

  • Testar sua solução de relatórios localmente em seu computador.
  • Testar sua solução de servidor implantando sua solução de relatório em um ambiente de teste.
  • Implantar sua solução de relatórios em um ambiente de produção.
  • Ajude a criar e testar os resultados de suas consultas usando recursos de preview dos designers de consultas do SSDT.

Após a implantação:

Para obter mais informações sobre a inclusão de dados em relatórios paginados, consulte Criar cadeias de conexão de dados no Construtor de Relatórios.

Relatórios paginados

Relatórios paginados são arquivos armazenados em um projeto de relatório. Você pode usar um arquivo de relatório paginado como um relatório independente, um sub-relatório ou como um destino para ações de consulta drill-through nos relatórios principais. Para implantar um relatório independentemente de outros itens em um projeto, você pode usar a propriedade TargetReportFolder e outras propriedades. Para obter mais informações, consulte Definir propriedades de implantação (Reporting Services).

Observação

Se você publicar em um servidor de relatório no modo do SharePoint, não será possível testar alguns recursos de solução de relatório no projeto do Report Designer. 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 em um servidor de relatório – modo do SharePoint (SSRS).

Se você instalar a extensão do SSRS no Visual Studio, conforme explicado anteriormente na instalação do SSDT, poderá usar o modelo de Projeto do Servidor de Relatório para criar um novo projeto. Você pode adicionar relatórios ao seu projeto de uma das seguintes maneiras:

  • Use o 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 novo relatório usando o assistente de relatório.

  • Adicione um novo item do tipo relatório. Um relatório em branco é aberto no Designer de Relatórios. Para obter mais informações, consulte Adicionar um relatório vazio.

  • Adicionar um item Existente. Um arquivo de definição de relatório existente (.rdl) é aberto no Report Designer. A abertura de um relatório ou projeto em uma versão anterior do SSRS 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 (SSRS).

  • Importe um relatório do Microsoft Access. O processo de importação importa todos os relatórios de um banco de dados do Access (.mdb, .accdb) ou arquivo de projeto (.adp). O Report Designer converte cada relatório em um banco de dados ou arquivo de projeto em linguagem RDL e o salva 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).

    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.

  • Trabalhe diretamente em um arquivo RDL. O relatório é salvo em formato XML como um arquivo RDL. Você poderá editar esse arquivo no Report Designer, em um editor de texto ou em qualquer editor de XML.

    Ao editar a origem da definição do relatório no Report Designer, você trabalha 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 no SQL Server Data Tools (SSDT).

    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. Como em qualquer arquivo XML, certifique-se de codificar corretamente os caracteres específicos de XML que você usa nos elementos. Quando o relatório é publicado, 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 em um elemento personalizado. As extensões de renderização personalizadas podem ler elementos personalizados. No entanto, as extensões de renderização fornecidas pelo SSRS ignoram o elemento. Por exemplo, você pode usar um 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).

Você pode implantar partes de relatório independentemente de outros itens em um projeto usando a propriedade TargetReportPartFolder e outras propriedades. Para obter mais informações, consulte 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 ou arquivos de forma do Environmental Systems Research Institute, Inc. (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 do Report Designer para a superfície de design e organize-os. Ao arrastar campos de conjunto de dados para os itens na superfície de design, é possível 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 de agrupamento. Como as ferramentas de criação de relatório são essencialmente uma maneira de criar definições de relatório, a abordagem ao design de relatórios é semelhante entre o Report Builder e o Report Designer.

Visualizar um relatório paginado

É possível usar a exibição Visualizar 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. Ele também lista os problemas na janela Saída.

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 <report-name>.rdl.data no mesmo diretório do arquivo de definição de relatório. O arquivo não é excluído quando você fechar o Report Designer.

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

  • Exibição de visualização Se você selecionar a guia Visualizar, o relatório será executado localmente. Ele usa a mesma funcionalidade de processamento e renderização de relatório fornecida pelo servidor de relatório. O relatório exibido é 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. Você pode executar 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, você pode selecionar Iniciar Depuração.
    • Na barra de ferramentas padrão do Visual Studio, você pode selecionar o botão Iniciar.
    • Você pode selecionar F5.

    Se você usar uma 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

    É necessário definir um item inicial para usar o modo de Depuração. Para definir um item inicial, vá para o Gerenciador de Soluções, clique com o botão direito do mouse no projeto de relatório e selecione Propriedades. Em seguida, em StartItem, selecione o nome do relatório a ser exibido.

    Se você quiser visualizar um relatório específico que não seja o item inicial do projeto, poderá selecionar uma configuração que compile o relatório, mas não o implante. Por exemplo, você pode usar a configuração DebugLocal. Em seguida, clique com o botão direito do mouse no relatório e selecione Executar. Você deve selecionar uma configuração que não implante o relatório. Caso contrário, o relatório será publicado no servidor de relatório em vez de ser exibido localmente em uma janela de visualização.

  • Visualização de impressão. Na primeira vez em que você exibir um 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 produzido 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. Quando você seleciona Visualização de impressão na barra de ferramentas Visualizaçã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 à saída nesses formatos. Você pode escolher o tamanho da imagem do relatório, por exemplo, e definir a largura da página.

    A visualização de impressão ajuda a identificar problemas de renderização que você poderia 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 especificada do papel.
    • As quebras de página entre grupos não funcionam da maneira desejada.
    • Cabeçalhos e rodapés não são mostrados conforme o esperado.
    • Layouts de relatório que precisam de modificação para aparecerem melhor 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 Report Designer, você cria um relatório usando o esquema de definição de relatório suportado pela versão atual do SSRS no 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 que usa uma versão anterior do SSRS, o Report Designer descarta 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 pelo Report Designer 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 no menu de atalho do arquivo de relatório para exibir a definição de relatório nesse caso. Ao selecionar Exibir Código, você abre 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 no SQL Server Data Tools (SSDT).

Salvar um relatório localmente

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

Se você usa software de controle do código-fonte, o ato de salvar um relatório poderá fazer seu check-in no servidor de controle do código-fonte. Para obter mais informações, consulte Controle do código-fonte.

Implantar ou publicar relatórios paginados

No SSDT, você pode implantar relatórios ou outros itens de projeto em várias versões de servidores de relatório SSRS. 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 servidores de relatório de destino. As configurações de projeto controlam algumas propriedades, incluindo 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 vários 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 paginados (Report Builder).

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 podem ocorrer quando os relatórios são criados. Os relatórios podem conter sequências de caracteres como expressões ou consultas incompatíveis com a versão do SSRS que a configuração do projeto especifica, por exemplo.

Use a propriedade ErrorLevel para gerenciar os avisos e os erros de build. Você pode atribuir um valor de 0 a 4 (inclusive) à propriedade ErrorLevel. 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 Saída do SSDT.

Problemas com níveis de gravidade menores ou iguais ao valor ErrorLevel são relatados como erros. Outros problemas 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 que impedem a visualização e a implantação de relatórios
1 Problemas de compilação severos que alteram o layout do relatório drasticamente
2 Problemas de compilação menos severos que alteram o layout do relatório de forma significativa
3 Problemas de compilação secundários que alteram o layout do relatório de maneira quase imperceptível
4 Avisos sobre problemas de publicação

Você pode tentar visualizar ou implantar um relatório que contém itens de relatório que não são compatíveis com sua versão do SSRS. Mas esses itens de relatório às vezes são removidos do relatório e um erro de nível 2 é emitido. Se sua propriedade ErrorLevel estiver definida como o valor padrão de 2, a compilação falhará nesse caso.

Você pode contornar esse problema alterando o valor de ErrorLevel para 0 ou 1. Em seguida, quando o item é descartado, um aviso é emitido e o processo de compilação continua.

Conteúdo relacionado