Reporting Services no SQL Server Data Tools (SSDT)

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

SQL Server Data Tools (SSDT) é um ambiente Microsoft Visual Studio para criar soluções de business intelligence. O SSDT conta com o ambiente de criação do Report Designer. Você pode usar o Report Designer para abrir, modificar, visualizar, salvar e implantar definições de relatório paginado, fontes de dados compartilhadas, conjuntos de dados compartilhados e partes de relatório do SQL Server Reporting Services (SSRS).

Este artigo descreve soluções, projetos, modelos de projeto e configurações do SSDT usados por você para o SSRS. Ele também descreve as exibições, os menus, as barras de ferramentas e os atalhos que podem ser usados no Report Designer.

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.

Para começar a criação de relatórios, consulte Criar relatórios paginados do Reporting Services com o Designer de Relatórios (SSRS).

Soluções e projetos

Um projeto de relatório atua como um contêiner para recursos e definições de relatório. Cada arquivo no projeto de relatório é publicado no servidor de relatório quando o projeto é implantado. Quando você cria um projeto pela primeira vez, uma solução também é criada como contêiner para o projeto. É possível adicionar vários projetos a uma única solução.

Configurações

Para criar vários conjuntos de propriedades de projeto para variações de implantação como servidores de relatórios empresariais, de teste e de produção, use o recurso Configuration Manager do Visual Studio. Para obter mais informações, confira Implantação e suporte de versão no SQL Server Data Tools (SSRS).

Projetos do servidor de relatórios

Quando você instala a extensão do SSRS para Visual Studio, conforme descrito anteriormente na instalação do SSDT, os seguintes modelos de projeto são disponibilizados no SSDT:

• Projeto do servidor de relatório. Quando você seleciona um modelo de projeto do Servidor de Relatório, o Report Designer é aberto. Você pode encontrar este modelo de projeto de business intelligence na caixa de diálogo Criar um novo projeto. Para obter mais informações, consulte Criar um projeto de servidor de relatório.

  As propriedades do projeto do Report Server se aplicam a todos os relatórios e todas as fontes de dados compartilhadas em um projeto do SSDT. Estas propriedades incluem a URL para o servidor de relatórios e os nomes de pastas para relatórios e fontes de dados compartilhadas. Você pode usar a caixa de diálogo Páginas de Propriedades do Projeto para exibir os valores da propriedade atual. Para abrir essa caixa de diálogo, vá para o menu Projeto e selecione Propriedades.

• Assistente de projeto do servidor de relatório. Quando você usa o modelo de projeto do assistente do Servidor de Relatório, um projeto do servidor de relatório é criado automaticamente e o assistente de relatório é aberto. No assistente, você pode criar um relatório seguindo as instruções em cada página. As instruções descrevem como:

  • Crie uma cadeia de conexão para uma fonte de dados.
  • Definir credenciais da fonte de dados.
  • Crie uma consulta.
  • Adicione tabela ou região de dados em matriz.
  • Especifique dados e grupos de relatório.
  • Escolha uma fonte e um estilo de cor.
  • Publique o relatório em um servidor de relatório.
  • Visualize o relatório localmente.

  Depois de criar um relatório com o assistente, você pode alterar os dados e o design do relatório, usando o Report Designer no projeto do servidor de relatório.

Janelas e painéis do Designer de Relatórios

O Report Designer oferece várias janelas e painéis para ajudar você a criar relatórios e exibir relatórios renderizados.

Painel Dados do Relatório

O painel Dados do Relatório exibe objetos de dados que você pode usar em um relatório.

Para abrir o painel Dados do Relatório, mude o foco para a área de design. Em seguida, no menu Exibir, selecione Dados do Relatório.

Os seguintes tipos de objetos estão disponíveis no painel de dados do relatório:

• Campos internos. Esses campos contêm informações predefinidas do relatório, como o nome do relatório ou a hora em que o relatório foi processado.
• Fontes de dados. Uma fonte de dados representa o nome e as informações de conexão de uma fonte de dados.
• Conjuntos de dados. Cada conjunto de dados inclui uma consulta que especifica quais dados recuperar da fonte de dados. Você pode expandir o conjunto de dados para visualizar a coleção de campos que a consulta do conjunto de dados especifica. Em alguns designers de consulta de conjuntos de dados multidimensionais, você pode especificar filtros no painel Filtros e indicar se deseja criar parâmetros de relatório. Se você especificar a opção de parâmetro de relatório, um conjunto de dados especial será criado automaticamente para popular a lista de valores válidos dos parâmetros. Por padrão, esses conjuntos de dados não são exibidos no painel de dados do relatório. Para obter mais informações, confira Mostrar conjuntos de dados ocultos para valores de parâmetros – dados multidimensionais.
• Parâmetros de relatório. Você pode criar parâmetros de relatório manual ou automaticamente quando uma consulta de conjunto de dados inclui parâmetros de consulta.
• Imagens. As imagens nesta lista estão disponíveis para inclusão como itens de relatório de imagem em um relatório.

As fontes de dados e os conjuntos de dados no painel Dados do Relatório representam os elementos da definição do relatório. O painel de Dados do Relatório é um recurso que conta com o suporte de vários ambientes de criação de relatórios.

• No Report Builder, esse é o único painel disponível para gerenciar fontes de dados e conjuntos de dados.
• No Designer de Relatórios, o painel de Dados do Relatório funciona com o Gerenciador de Soluções, que lista fontes de dados e conjuntos de dados compartilhados como arquivos. As fontes de dados compartilhadas e os conjuntos de dados compartilhados do painel de Dados do Relatório devem apontar para suas fontes de dados compartilhadas e conjuntos de dados compartilhados no Gerenciador de Soluções. Os elementos do painel de Dados do Relatórios então contêm uma referência aos arquivos de dados no Gerenciador de Soluções. As propriedades do projeto determinam se as fontes de dados compartilhadas e os conjuntos de dados compartilhados são implantados no servidor de relatório ou no site do SharePoint. Para obter mais informações, confira Converter fontes de dados (Construtor de Relatórios e SSRS).

Se o painel de dados do relatório estiver flutuando, é possível ancorá-lo. Para obter mais informações, confira Encaixar o painel de dados do relatório no Designer de Relatórios (SSRS).

Painel de agrupamento

Você pode usar o painel de Agrupamento para definir grupos para uma região de dados tablix. É possível definir grupos de linhas e de detalhes para tabelas, além de grupos de linhas e de colunas para matrizes. Você não pode usar o painel de Agrupamento para definir grupos para Gráficos ou outras regiões de dados. Para obter mais informações, consulte Grupos um relatório paginado do Report Builder.

O painel de Agrupamento tem dois modos:

• Default. Use o modo padrão para exibir todos os grupos de linhas e colunas em um formato hierárquico que mostra os relacionamentos entre grupos pais, grupos filhos, grupos adjacentes e grupos de detalhes. Um grupo filho aparece em e sob o próximo nível de recuo em relação ao respectivo grupo pai. Um grupo adjacente é exibido no mesmo nível de recuo que seus grupos irmãos ou pares.

  Você também pode usar o modo padrão para adicionar, editar ou excluir grupos. Para grupos baseados em um único campo de conjunto de dados, arraste o campo para o painel de Grupos de Linhas ou de Grupos de Colunas. Você pode inserir o grupo próximo a um grupo existente. Para adicionar um grupo adjacente, use o menu de atalho do grupo irmão. Para exibir quais células tablix pertencem a um grupo, selecione o grupo no painel de Agrupamento.

• Avançado. Use o modo avançado para exibir membros de grupos de linhas e colunas estáticos e dinâmicos de uma região de dados Tablix selecionada. No modo avançado, você também pode definir propriedades que controlam a visibilidade das linhas e colunas associadas a um grupo ou membro do grupo. Essas propriedades determinam as regras que os renderizadores usam para tentar manter os grupos juntos em uma página. Os membros do grupo aparecem na superfície de design como células no grupo de linhas e nas áreas do grupo de colunas.

Para obter mais informações, consulte Grouping Pane.

Painel Caixa de ferramentas

O painel Caixa de Ferramentas contém itens de relatório que você pode arrastar para a superfície de design.

• Regiões de dados são itens de relatório que você usa para organizar os dados no relatório. Exemplos de regiões de dados incluem tabela, matriz, lista, gráfico, medidor, barra de dados, minigráfico e indicador.
• Outros itens de relatório incluem um mapa, caixa de texto, retângulo, linha, imagem e sub-relatório.
• Itens de relatório personalizados também poderão aparecer no painel Caixa de Ferramentas se o administrador do sistema os instalar e registrar.

Painel de propriedades

O painel Propriedades é uma janela do Visual Studio padrão que apresenta os nomes e os valores das propriedades para o item de relatório atualmente selecionado na superfície de design.

Para exibir o painel Propriedades, vá para o menu Exibir e selecione Janela Propriedades. É possível desencaixar esse painel e movê-lo para outra área da janela do SSDT ou exibi-lo como uma exibição com guias na superfície de design.

Na maioria dos casos, os nomes de propriedades correspondem aos elementos e atributos no arquivo de linguagem RDL. Você pode definir as propriedades mais comumente usadas usando a caixa de diálogo Propriedades de um item selecionado. Para abrir a caixa de diálogo Propriedades de um item, selecione o item e, em seguida, selecione o botão Páginas de Propriedades na barra de ferramentas do painel Propriedades. Os usuários avançados podem definir valores de propriedades diretamente no painel de Propriedades.

Você pode usar o painel Propriedades para as seguintes tarefas:

• Definir propriedades para o item selecionado na superfície de design. Algumas propriedades apresentam uma lista suspensa de valores. Também é possível inserir o valor diretamente na célula. Algumas propriedades contêm uma coleção de valores, indicada pelo valor (Coleção) . A maioria das propriedades pode aceitar uma expressão. Expressões complexas são indicadas pelo valor <expressão>. Para abrir a caixa de diálogo Expressão, selecione o botão Expressão (fx). Para obter mais informações, consulte Caixa de diálogo Expressão.
• Use os botões da barra de tarefas do painel Propriedades para alterar a grade de uma exibição por categoria para exibição alfabética. Na exibição por categoria, talvez seja necessário expandir a categoria para ver todas as propriedades que ela contém. Para abrir a caixa de diálogo Propriedades de um item, você pode selecionar o botão Páginas de Propriedades na barra de ferramentas. Ou você pode clicar com o botão direito do mouse no item e selecionar Propriedades.
• Defina as propriedades do membro do grupo selecionado atualmente no painel de Agrupamento. A propriedades de membro do grupo ajudam a controlar como as linhas de cabeçalho e de rodapé de grupos estáticos são repetidas para cada instância do grupo. Para obter mais informações, consulte Exibir cabeçalhos e rodapés com um grupo em um relatório paginado (Report Builder).

Gerenciador de Soluções

O Gerenciador de Soluções é um componente padrão do Visual Studio que exibe todos os itens do projeto. Para um projeto do servidor de relatório, esta lista de itens inclui pastas para organizar fontes de dados compartilhadas, conjuntos de dados compartilhados, relatórios e recursos. Os itens de pasta são automaticamente alfabetizados quando você abre o arquivo da solução. Para exibir propriedades de itens no painel de Propriedades, selecione o item.

janela Saída

A janela Saída exibe os erros de processamento que ocorrem quando você visualiza um relatório. Essa janela também exibe erros de publicação que ocorrem quando você implanta um relatório ou uma fonte de dados compartilhada.

Você pode usar a janela Saída para ajudar a depurar erros em expressões.

Painel Estrutura de Tópicos do Documento

O painel Estrutura de Tópicos do Documento exibe uma lista hierárquica de todos os itens de relatório na definição do relatório. Para abrir o painel Estrutura de Tópicos do Documento, você pode selecionar Exibir>Outras Janelas>Estrutura de Tópicos do Documento.

O painel Estrutura de Tópicos do Documento é útil para identificar caixas de texto e outros itens de relatório por nome. Quando você seleciona um item no painel Estrutura de Tópicos do Documento, o item também é selecionado na superfície de design.

Você pode usar o painel Estrutura de Tópicos do Documento para ajudar a depurar erros em expressões.

Janela Lista de Tarefas

A janela Lista de Tarefas exibe erros de compilação que ocorrem quando você importa um relatório de outro aplicativo. Por exemplo, se você importar um relatório do Microsoft Access e o relatório contiver um recurso ao qual o SSRS não oferece suporte, um erro será relatado na janela Lista de Tarefas.

Exibições do Report Designer

O Designer de Relatórios dá suporte a dois modos de exibição:

• Design, para definir os dados e o layout de um relatório
• Visualização, para mostrar uma exibição renderizada do relatório

Modo de exibição de Design

Por padrão, quando você cria um projeto do servidor de relatório, o Report Designer é aberto na exibição Design e exibe a superfície de design. Por padrão, a superfície de design exibe o corpo do relatório e o plano de fundo do relatório.

O plano de fundo da superfície de design tem um menu de atalho. Esse menu fornece opções para adicionar um cabeçalho e um rodapé de página. Ele também contém um menu Exibir que você pode usar para exibir a régua, o painel de agrupamento e o painel Parâmetros.

Você pode usar o controle de zoom para aumentar ou diminuir a ampliação do relatório.

Para criar um relatório, arraste itens de relatório do painel Caixa de Ferramentas para a superfície de design. Em seguida, você configura suas propriedades e altera sua disposiçãono relatório.

Modo visualizar

Na exibição Visualização, execute e exiba o relatório renderizado no Report Viewer. Você também pode definir as propriedades de configuração para executar o relatório no modo de depuração usando um navegador.

Quando você visualiza um relatório, o Report Designer:

• Conecta-se às fontes de dados do relatório.
• Executa consultas no conjunto de dados.
• Armazena os dados em cache no computador local.
• Processa o relatório para combinar dados e layout.
• Renderiza o relatório.

Há alguns pontos a serem lembrados ao usar o modo de exibição de Visualização:

• Relatórios com parâmetros. Quando você visualiza um relatório, ele será processado automaticamente se todos os parâmetros forem valores padrão válidos. Se um ou mais parâmetros do relatório não tiver um valor padrão válido, você deverá escolher um valor para cada parâmetro não atribuído. Na barra de ferramentas do relatório, você deve selecionar Exibir relatório.
• O cache de dados local. Quando você visualiza um relatório, o processador de relatório executa todas as consultas de conjuntos de dados no relatório usando os padrões de parâmetro atuais. Ele salva os resultados como um arquivo de cache de dados local (.rdl.data). É possível continuar a criar o relatório sem incorrer na sobrecarga de recuperar os dados novamente caso você não faça nenhuma alteração nas consultas do conjunto de dados de relatório ou nos parâmetros do relatório.
• Configuration Manager e depuração. No SSDT, as propriedades do projeto definem como você deseja implantar e depurar seus relatórios. Essas propriedades são aplicadas a todos os relatórios e fontes de dados compartilhadas no projeto. Para definir as propriedades de projeto, no menu Projeto, selecione Propriedades. Na caixa de diálogo Páginas de propriedades do projeto, selecione Configuration Manager. Você pode usar essas configurações para testar seus relatórios e publicá-los no servidor de relatórios.
• O painel Saída. Quando você visualiza um relatório e o processador de relatório detecta um problema, ele registra as mensagens de erro no painel Saída.

Menus do Designer de Relatórios

Quando um projeto do Designer de Relatórios está ativo no SSDT, as barras de ferramentas a seguir são adicionadas à barra de ferramentas principal.

Menu de formatação

Quando você seleciona um item na superfície de design, o menu Formatar contém as seguintes opções:

Menu de relatório e menu de atalho da superfície de design

Você pode usar as opções a seguir para definir as configurações que se aplicam a um relatório inteiro. A disponibilidade e o local dessas opções dependem da versão do Visual Studio utilizada:

• Em versões anteriores, você pode encontrar essas opções no menu Relatório.
• Em versões posteriores, a maioria das opções está no menu de atalho da tela de fundo da superfície de design.

Menu Exibir

Você pode usar as seguintes opções do menu Exibir para mostrar ou ocultar várias janelas e barras de ferramentas do Report Designer:

Menu Projeto

Você pode usar as seguintes opções do menu Projeto para gerenciar fontes de dados e relatórios compartilhados em um projeto. Quando você adiciona ou remove itens do projeto, a exibição hierárquica de itens de projeto no Gerenciador de Soluções é atualizada automaticamente.

Barras de ferramentas do Designer de Relatórios

O Report Designer fornece as seguintes barras de ferramentas especializadas para criação de relatórios:

Você pode usar o menu Exibir para mostrar ou ocultar essas barras de ferramentas. Outras barras de ferramentas do Visual Studio poderão não estar disponíveis se a funcionalidade não se aplicar aos recursos do Designer de Relatórios.

Controle do código-fonte

O SSDT pode se integrar a plug-ins de origem. Você pode usar as páginas Controles do código-fonte na caixa de diálogo Opções para especificar um plug-in e configurar propriedades.

Modelos de relatório personalizados

Para usar relatórios personalizados como modelos de novos relatórios, basta copiá-los na pasta ReportProject no computador em que o SSDT está instalado.

O local padrão dessa pasta depende da versão e edição do Visual Studio que você usa. Para Visual Studio 2022, 2019 e 2017, essa pasta está no seguinte local:

%ProgramFiles%\Microsoft Visual Studio\<release-year>\<edition>\Common7\IDE\CommonExtensions\Microsoft\SSRS\ProjectItems\ReportProject

Para o Visual Studio 2015, o local padrão é a seguinte pasta:

%ProgramFiles%\Microsoft Visual Studio 14.0\Common7\IDE\Private Assemblies\ProjectItems\ReportProject

Quando você adiciona um novo item ao projeto de relatório, o relatório personalizado aparece no painel Modelos. Também é possível adicionar estilos personalizados ao assistente de relatório.

Suporte à linha de comando para o SSDT

O SSDT se baseia no Visual Studio e no aplicativo devenv.exe subjacente. Este aplicativo oferece várias opções de linha de comando que são úteis para trabalhar com relatórios.

Antes de usar as opções de linha de comando descritas nesta seção, você deve definir valores válidos para os dois itens a seguir:

• Propriedades do projeto para OverwriteDataSources, TargetDataSourceFolder, TargetReportFolder e TargetServerURL.
• Pelo menos um conjunto de propriedades de configuração, por exemplo, Debug ou Release.

Para obter mais informações, consulte Publicar fontes de dados e relatórios.

Para um projeto de servidor de relatório, é possível especificar as seguintes opções pela linha de comando:

• /deploy: implanta relatórios usando as propriedades de projeto especificadas no arquivo de configuração. Por exemplo, o comando a seguir implanta os relatórios que o arquivo de solução Reports.sln especifica. Ele usa as definições de configuração de versão especificadas nas propriedades do projeto:

  devenv.exe "C:\Users\<user-name>\source\repos\Reports\Reports.sln" /deploy "Release"
  

• /build: compila o arquivo de solução, mas não o implanta. Por exemplo, o comando a seguir compila os relatórios que o arquivo de solução Reports.sln especifica. Ele usa as definições de configuração de depuração especificadas nas propriedades do projeto:

  devenv.exe "C:\Users\<user-name>\source\repos\Reports\Reports.sln" /build "Debug"
  

• /out: redireciona a saída gerada pela criação de uma solução para o arquivo especificado. Por exemplo, o comando a seguir redireciona a saída da criação no exemplo anterior para um arquivo denominado mybuildlog.txt.

  devenv.exe "C:\Users\<user-name>\source\repos\Reports\Reports.sln" /build "Debug" /out mybuildlog.txt
  

Atalhos de teclado no SSDT

Você pode usar os atalhos do teclado para:

• Controlar janelas e modos no SSDT:

  Descrição	Combinação de teclas
  Compilar o projeto selecionado	CTRL+SHIFT+B
  Exibir a janela Propriedades	F4
  Exibir a janela Dados do Relatório	Ctrl+Alt D+
  Iniciar a depuração	F5
  Mover de uma janela aberta para outra	F6

• Controlar itens na superfície de design de relatório:

  Descrição	Combinação de teclas
  Mover o foco de um item de relatório para o próximo item de relatório	Tab
  Mover o item de relatório selecionado	Teclas de direção
  Cutucar o item de relatório selecionado	Ctrl+Teclas de seta
  Aumentar ou diminuir o tamanho do item de relatório selecionado	Ctrl+Shift + Teclas de direção
  Em uma caixa de texto, mover o cursor para o início do texto de exibição visível	Ctrl+Home
  Em uma caixa de texto, mover o cursor para o fim do texto de exibição visível	Ctrl+End
  Em uma caixa de texto, selecionar o texto a partir da posição atual do cursor até o início do texto de exibição visível	Shift+Home
  Em uma caixa de texto, selecionar o texto a partir da posição atual do cursor até o fim do texto de exibição visível	Shift+End
  Em uma caixa de texto, selecionar o texto a partir da posição atual do cursor até o início da expressão	Ctrl+Shift+Home
  Em uma caixa de texto, selecionar o texto a partir da posição atual do cursor até o fim da expressão	Ctrl+Shift+End
  Abrir o atalhe de menu do item de relatório selecionado	Shift+F10

Conteúdo relacionado

• Gerenciador de Soluções
• Relatórios do Reporting Services (SSRS)
• Linguagem RDL (SSRS)