Partilhar via

Conceba relatórios paginados dos Serviços de Relatórios com o Designer de Relatórios (SSRS)

Aplica-se a: SQL Server 2016 (13.x) Serviços de Relatórios e versões posteriores

Pode usar o Designer de Relatórios para criar relatórios e soluções de relatórios paginados completos do SQL Server Reporting Services (SSRS). O Designer de Relatórios fornece:

  • Uma forma de definir fontes de dados, conjuntos de dados e consultas.
  • Capacidades para desenhar e personalizar o layout de regiões e campos de dados.
  • Funcionalidades interativas como parâmetros e conjuntos de relatórios que funcionam em conjunto.

O Designer de Relatórios é uma funcionalidade do SQL Server Data Tools (SSDT), um ambiente Microsoft Visual Studio para criar soluções de inteligência empresarial.

Instalação do SSDT

O SSDT não está incluído no SQL Server. Tens de instalar o SSDT separadamente. Para instruções, consulte Instalar SSDT com Visual Studio.

Para usar modelos do Report Designer, também precisa de instalar uma extensão SSRS para o Visual Studio. Para instruções, consulte Instalar extensões para Serviços de Análise, Serviços de Integração e Serviços de Relatórios.

Benefícios dos projetos de relatório

No Designer de Relatórios, pode usar projetos para organizar relatórios. Os projetos de relatório funcionam como recipientes para definições de relatórios e recursos. Pode usar projetos para as seguintes tarefas:

  • Organizar relatórios e itens relacionados num só contentor.
  • Testar soluções de relatórios que incluem relatórios e itens relacionados localmente.
  • Colocar os itens relacionados em conjunto. Podes usar propriedades de projetos e gestão de configuração para implementar itens em vários ambientes.
  • Preservar um conjunto de cópias primárias para relatórios e itens relacionados, porque após a implementação, os relatórios publicados podem ser acidentalmente modificados.

Pode usar a informação deste artigo para desenhar relatórios paginados e itens relacionados para um único projeto de reporte numa solução SSDT. Para mais informações sobre soluções e múltiplos projetos em SSDT, consulte Serviços de Relatórios nas Ferramentas de Dados SQL Server (SSDT).

Fontes de dados e conjuntos de dados partilhados

O SSDT fornece uma forma de definir e implementar fontes de dados partilhadas e conjuntos de dados partilhados para uma solução de relatórios.

  • Para implementar uma fonte de dados partilhada de forma independente de outros itens num projeto, pode usar as propriedades OverwriteDataSources e TargetDataSourceFolder.
  • Para implementar um conjunto de dados partilhado independentemente de outros itens num projeto, pode usar as propriedades OverwriteDatasets e TargetDatasetFolder.

Para mais informações, consulte Definir propriedades de implementação (Serviços de Relatório).

No Designer de Relatórios, trabalha tanto no painel de Dados do Relatório como no Explorador de Soluções para definir as fontes de dados e conjuntos de dados partilhados que utiliza num relatório. Para mais informações, consulte o painel de Dados de Relatório.

Se uma fonte de dados for publicada num servidor de relatórios ou site SharePoint mas não incluída na solução SSDT, não pode usar SSDT para abrir essa fonte de dados. Da mesma forma, não pode usar SSDT para abrir conjuntos de dados publicados diretamente a partir de um servidor de relatórios ou site SharePoint. Para abrir uma fonte de dados ou conjunto de dados nestes cenários, pode usar o Construtor de Relatórios. Para mais informações, consulte o ambiente de autoria do Construtor de Relatórios (SSRS). Para conjuntos de dados, use esse ambiente em modo de conjunto de dados partilhado.

SSDT é uma ferramenta para clientes. Você pode usá-lo para:

  • Teste a sua solução de relatórios localmente no seu computador.
  • Teste a sua solução de servidor implementando a sua solução de relatórios num ambiente de teste.
  • Implemente a sua solução de reporte num ambiente de produção.
  • Ajude a criar e testar os resultados das suas consultas localmente, utilizando as capacidades de pré-visualização dos designers de consultas SSDT.

Após o destacamento:

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

Relatórios paginados

Relatórios paginados são ficheiros que são armazenados num projeto de relatório. Pode usar um ficheiro de relatório paginado como relatório independente, subrelatório, ou como alvo para ações de perfuração a partir dos relatórios principais. Para implementar um relatório independentemente de outros itens num projeto, pode usar TargetReportFolder e outras propriedades. Para mais informações, consulte Definir propriedades de implementação (Serviços de Relatório).

Observação

Se publicar num servidor de relatórios em modo SharePoint, não pode testar algumas funcionalidades da solução de relatórios no projeto Designer de Relatórios. As referências a relatórios, subrelatórios e relatórios de detalhamento devem usar URLs completamente qualificadas que só podem ser testadas após a implementação do projeto de relatório. Para mais informações, consulte exemplos de URL para itens num servidor de relatórios - modo SharePoint.

Se instalar a extensão SSRS no Visual Studio, como explicado anteriormente na instalação do SSDT, pode usar o modelo de Project Report Server para criar um novo projeto. Depois, pode adicionar um relatório ao seu projeto de qualquer uma das seguintes formas:

  • Use o assistente de relatório. Cria um relatório de forma guiada, passo a passo. O assistente de relatórios simplifica a definição de dados e o desenho de relatórios numa série de passos que lhe dão um relatório finalizado. Podes adicionar estilos para personalizar o assistente para a tua própria organização. Para 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 abre-se no Designer de Relatórios. Para mais informações, consulte Adicionar um novo relatório em branco.

  • Adiciona um item já existente. Um ficheiro de definição de relatório (.rdl) existente abre-se no Designer de Relatórios. Abrir um relatório ou projeto a partir de uma versão anterior do SSRS pode atualizar automaticamente o projeto para a versão atual e o relatório para o esquema atual. Para mais informações, consulte Relatórios de Atualização (SSRS).

  • Importa um relatório do Microsoft Access. O processo de importação importa todos os relatórios de uma base de dados Access (.mdb, .accdb) ou ficheiro de projeto (.adp). O Designer de Relatórios converte cada relatório numa base de dados ou ficheiro de projeto em Linguagem de Definição de Relatórios (RDL) e guarda-o no projeto de relatório. Nem toda a funcionalidade de um relatório Access é transferida para um ficheiro de definição de relatório (.rdl). Para mais informações, consulte Relatórios de Importação do Microsoft Access (Serviços de Relatórios).

    Observação

    Deve ter o Access 2002 ou uma versão posterior instalada no mesmo computador onde o Report Designer está instalado para poder usar a funcionalidade de importação. A fonte de dados para os relatórios de acesso deve estar disponível quando os relatórios são importados.

  • Trabalhar diretamente num ficheiro RDL. O relatório é guardado em formato XML como um ficheiro RDL. Pode editar este ficheiro no Report Designer, num editor de texto ou em qualquer editor XML.

    Quando editas a fonte da definição de relatório no Designer de Relatórios, trabalhas no esquema RDL atual para a versão do SQL Server de onde instalaste as ferramentas de desenvolvimento. Quando constróis um projeto, a versão do esquema pode mudar dependendo das propriedades de implementação. Para mais informações, consulte Implementação e suporte a versões nas Ferramentas de Dados do SQL Server (SSDT).

    Editar diretamente o RDL pode resultar num relatório que não pode ser publicado no servidor de relatórios ou não pode ser executado. Tal como em qualquer ficheiro XML, certifique-se de que codifica corretamente caracteres específicos de XML que utiliza dentro dos elementos. Quando publica o relatório, o servidor de relatórios usa o esquema para validar o XML no ficheiro RDL.

    Para incluir elementos que não fazem parte do esquema RDL, coloque-os num elemento personalizado. Extensões de renderização personalizadas podem ler elementos personalizados. Mas as extensões de renderização que o SSRS fornece ignoram esse elemento. Por exemplo, pode usar um elemento personalizado para armazenar comentários no seu relatório.

    Para mais informações, consulte Linguagem de Definição de Relatórios (SSRS).

Partes do relatório

Observação

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

No Designer de Relatórios, pode criar tabelas, gráficos e outros itens de relatório paginados num projeto. Depois de os criar, pode publicá-los como partes de relatório num servidor de relatórios ou site SharePoint integrado com um servidor de relatórios. Esta ação permite que você e outros os reutilizem noutros relatórios. Para mais informações, consulte Reportar peças no Report Designer (SSRS).

Pode implementar partes do relatório de forma independente de outros itens num projeto, usando a TargetReportPartFolder propriedade e outras propriedades. Para mais informações, consulte Definir propriedades de implementação (Serviços de Relatório).

Recursos

Pode adicionar ficheiros ao seu projeto que estejam relacionados com o seu relatório mas que não sejam processados pelo servidor de relatórios. Por exemplo, pode adicionar imagens, ou pode adicionar shapefiles do Environmental Systems Research Institute, Inc. (ESRI) para dados espaciais. Para obter mais informações, consulte Recursos.

Layout de relatório paginado

Para criar o layout do relatório, arrasta-se os itens do relatório e regiões de dados da caixa de ferramentas do Designer de Relatórios para a superfície de design e organiza-os. Ao arrastar os campos do conjunto de dados para os itens na superfície de desenho, pode adicionar os dados ao relatório. Para organizar os dados em grupos numa região de dados tablix, arrasta-se os campos do conjunto de dados para o painel de Agrupamento. Como as ferramentas de criação de relatórios são essencialmente uma forma de criar definições de relatórios, a abordagem ao design de relatórios é semelhante no Construtor de Relatórios e no Designer de Relatórios.

Pré-visualizar um relatório paginado

Pode usar a vista de Pré-visualização para verificar os dados do relatório e o design do layout. Quando faz uma pré-visualização de um relatório, o processador de relatórios valida o esquema de definição do relatório e a sintaxe da expressão. Também lista os problemas na janela de Saída .

Observação

Quando faz uma pré-visualização de um relatório, os dados do relatório são armazenados em cache num ficheiro no computador local. Quando volta a pré-visualizar o mesmo relatório usando a mesma consulta, parâmetros e credenciais, o Designer de Relatórios recupera a cópia em cache em vez de repetir a consulta. O ficheiro de dados é guardado no <report-name>.rdl.data mesmo diretório que o ficheiro de definição de relatório. O ficheiro não é eliminado quando fecha o Designer de Relatórios.

Pode pré-visualizar um relatório das seguintes formas:

  • Vista de prévia. Se selecionares o separador Pré-visualização , o relatório é executado localmente. Utiliza a mesma funcionalidade de processamento de relatórios e renderização que o servidor de relatórios fornece. O relatório apresentado é uma imagem interativa. Pode selecionar parâmetros, selecionar links, visualizar o mapa do documento e expandir e recolher áreas ocultas do relatório. Também pode exportar o relatório para qualquer um dos formatos de renderização instalados.

  • Pré-visualização independente. Pode executar o relatório local num navegador. Ao utilizar uma configuração de depuração, também poderá usar este modo para diagnosticar e depurar assemblies personalizados que criar. Existem três formas de executar um projeto em modo de depuração:

    • No menu Debug , podes selecionar Iniciar Depuração.
    • Na barra de ferramentas padrão do Visual Studio, pode selecionar o botão Iniciar .
    • Pode selecionar F5.

    Se usares uma configuração de projeto que constrói o relatório mas não o implementa, o relatório especificado na StartItem propriedade da configuração atual abre-se numa janela de pré-visualização separada.

    Observação

    Tens de definir um item inicial para usar o modo de depuração. Para definir um item inicial, vai ao Explorador de Soluções, clica com o botão direito no projeto de relatório e seleciona Propriedades. Depois, no StartItem, seleciona o nome do relatório para mostrar.

    Se quiseres pré-visualizar um relatório específico que não seja o item inicial do projeto, podes selecionar uma configuração que constrói o relatório mas não o implementa. Por exemplo, pode usar a configuração DebugLocal. Depois clica com o botão direito no relatório e seleciona Executar. Deve selecionar uma configuração que não implemente o relatório. Caso contrário, o relatório é publicado no servidor de relatórios em vez de ser exibido localmente numa janela de pré-visualização.

  • Pré-visualização impressa. Quando visualiza um relatório pela primeira vez em modo de pré-visualização ou na janela de pré-visualização, a visualização do relatório assemelha-se a um relatório produzido por uma extensão de renderização HTML. A pré-visualização não é HTML, mas o layout e a paginação do relatório são semelhantes ao resultado HTML.

    Pode alterar a vista para representar um relatório impresso ao mudar para o modo de pré-visualização de impressão. Quando seleciona Pré-visualização de Impressão na barra de Pré-visualização, o relatório é apresentado como se estivesse numa página física. Esta vista assemelha-se à saída produzida pelas extensões de renderização de imagem e PDF. A pré-visualização de impressão não é uma imagem ou ficheiro PDF, mas o layout e a paginação do relatório são semelhantes à saída nesses formatos. Pode, por exemplo, escolher o tamanho da imagem do relatório e definir a largura da página.

    A pré-visualização de impressão ajuda-o a identificar problemas de renderização que possa encontrar ao imprimir o relatório. Problemas comuns de renderização incluem:

    • Páginas em branco extra porque o relatório é demasiado largo para caber no tamanho do papel que especificas para o relatório.
    • Páginas em branco extra porque o relatório contém uma matriz que se expande dinamicamente para ultrapassar a largura especificada do papel.
    • Quebras de página entre grupos que não funcionam como queres.
    • Cabeçalhos e rodapés que não aparecem conforme esperado.
    • Layouts de relatórios que precisam de modificações para parecerem melhores num formato impresso.

Guardar e implementar relatórios paginados

No Designer de Relatórios, pode guardar relatórios e outros ficheiros de projeto localmente, ou implementá-los num servidor de relatórios ou num site SharePoint. Fontes de dados partilhadas, conjuntos de dados partilhados, relatórios, recursos de relatórios e partes de relatórios podem ser implementados de forma independente ou em conjunto, dependendo das propriedades de implementação do projeto que configurar. Para mais informações, consulte Configurações e propriedades de implementação.

No Designer de Relatórios, desenha-se um relatório utilizando o esquema de definição de relatório que a versão atual do SSRS no SSDT suporta. Pode definir as propriedades de implementação do projeto para um servidor de relatórios ou site SharePoint específico. Quando guarda o relatório, o Designer de Relatórios guarda a definição do relatório no diretório de build no esquema que corresponde à versão do servidor de relatórios alvo. Para criar relatórios que podem ser publicados num servidor de relatórios que utiliza uma versão anterior do SSRS, o Designer de Relatórios elimina itens de relatório que não existem no esquema alvo. Esta ação ocorre automaticamente e sem necessidade de solicitação. Quando esta ação acontece, a definição original do relatório é preservada na pasta do projeto. A definição modificada de relatório que o Report Designer implementa encontra-se na pasta de build.

Observação

Para depuração de expressões e erros de implementação, deverá visualizar a definição do relatório na pasta de compilação. Neste caso, não use o Código de Visualização no menu de atalhos do ficheiro de relatório para visualizar a definição do relatório. Quando seleciona Ver Código, abre a fonte de definição do relatório a partir da pasta do projeto.

Para mais informações, consulte Implementação e suporte a versões nas Ferramentas de Dados do SQL Server (SSDT).

Guarde um relatório localmente

Quando trabalha em relatórios ou outros itens de projeto no Designer de Relatórios, os ficheiros são guardados no seu computador local ou numa partilha de ficheiros noutro computador a que tenha acesso.

Se usares software de controlo de versão, o ato de guardar um relatório pode ser verificado no servidor de controlo de versão. Para mais informações, veja Controlo de Código.

Implementar ou publicar relatórios paginados

A partir do SSDT, pode implementar relatórios ou outros itens do projeto para múltiplas versões dos servidores de relatórios SSRS. Use configurações de projeto para controlar a atualização das definições de relatórios para versões de esquema compatíveis com servidores de relatórios alvo. As configurações do projeto controlam certas propriedades, incluindo o servidor de relatórios alvo, a pasta onde o processo de compilação armazena temporariamente definições de relatórios para pré-visualização e implementação, e níveis de erro. Para mais informações, consulte Configurações e propriedades de implementação e Definir propriedades de implementação (Serviços de Relatório).

Exportar um relatório paginado para um formato de ficheiro diferente

Os relatórios podem ser exportados para vários formatos. Estes formatos afetam o funcionamento de algumas funcionalidades de layout de relatórios e de interatividade. Para mais informações sobre considerações de design para vários formatos de saída, consulte Exportar relatórios paginados (Construtor de Relatórios).

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

Os relatórios são validados antes da pré-visualização e durante a implementação. Muitos problemas podem ocorrer quando os relatórios são elaborados. Por exemplo, os relatórios podem conter cadeias como expressões ou consultas que são incompatíveis com a versão do SSRS especificada pela configuração do projeto.

Use a ErrorLevel propriedade para gerir os avisos e erros de construção. Pode atribuir à ErrorLevel propriedade um valor de 0 a 4, inclusive. O valor determina quais os problemas de compilação reportados como erros e quais como avisos. O valor predefinido é 2. Os avisos e erros são escritos na janela de Saída SSDT.

Problemas com níveis de gravidade que são inferiores ou iguais ao valor ErrorLevel são reportados como erros. Outros problemas são reportados como avisos.

A tabela seguinte lista os níveis de erro.

Nível de erro Description
0 Problemas de compilação mais graves impedem a pré-visualização e o desdobramento de relatórios
1 Problemas graves de construção que alteram drasticamente o layout dos relatórios
2 Problemas de construção menos graves que alteram significativamente o layout dos relatórios
3 Pequenos problemas de construção que alteram o layout dos relatórios de formas menores que podem não ser visíveis
4 Avisos sobre problemas de publicação

Pode tentar pré-visualizar ou implementar um relatório que contenha itens de relatório que não são suportados na sua versão do SSRS. Mas esses itens do relatório por vezes são removidos do relatório e é emitido um erro de nível 2. Se a tua ErrorLevel propriedade estiver definida para o valor padrão de 2, a build falha neste caso.

Pode contornar este problema mudando o ErrorLevel valor para 0 ou 1. Depois, quando o item é descartado, um aviso é emitido e o processo de construção continua.

Conteúdo relacionado

  • Last updated on