Serviços de Relatórios nas Ferramentas de Dados SQL Server (SSDT)

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

SQL Server Data Tools (SSDT) é um ambiente Microsoft Visual Studio destinado à criação de soluções de business intelligence. O SSDT apresenta o ambiente de autoria do Designer de Relatórios. Pode usar o Designer de Relatórios para abrir, modificar, pré-visualizar, guardar e implementar definições de relatórios paginadas do SQL Server Reporting Services (SSRS), fontes de dados partilhadas, conjuntos de dados partilhados e partes de relatório.

Este artigo descreve soluções SSDT, projetos, modelos de projeto e configurações utilizadas para o SSRS. Também descreve as vistas, menus, barras de ferramentas e atalhos que pode usar no Designer de Relatórios.

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.

Para começar a criar relatórios paginados com os Serviços de Relatórios usando o Designer de Relatórios (SSRS), consulte Design Reporting Services paginated reports with Report Designer (SSRS).

Soluções e projetos

Um projeto de relatório funciona como um recipiente para definições e recursos de relatórios. Cada ficheiro no projeto de relatório é publicado no servidor de relatórios quando o projeto é implementado. Quando cria um projeto pela primeira vez, também é criada uma solução para funcionar como um contêiner para o projeto. Podes adicionar vários projetos a uma única solução.

Configurações

Para criar múltiplos conjuntos de propriedades de projeto para variações de implementação, como servidores de relatórios empresariais, de teste e de produção, utiliza-se a funcionalidade Gestor de Configuração no Visual Studio. Para mais informações, consulte Implementação e suporte a versões nas Ferramentas de Dados do SQL Server (SSRS).

Projetos de servidores de reporte

Quando instala a extensão SSRS para o Visual Studio, como descrito anteriormente na instalação do SSDT, os seguintes modelos de projeto ficam disponíveis no SSDT:

• Projeto de Servidor de Relatórios. Quando utiliza o modelo de projeto do Servidor de Relatórios, o Designer de Relatórios é aberto. Pode encontrar este modelo de projeto de business intelligence no diálogo Criar um novo projeto . Para mais informações, consulte Criar um projeto de servidor de relatórios.

  As propriedades do projeto Report Server aplicam-se a todos os relatórios e a todas as fontes de dados partilhadas num projeto SSDT. Estas propriedades incluem a URL do servidor de relatórios e os nomes das pastas para relatórios e fontes de dados partilhadas. Pode usar o diálogo das Páginas de Propriedades do Projeto para ver os valores atuais das propriedades. Para abrir este diálogo, vai ao menu Projeto e depois seleciona Propriedades.

• Assistente do Projeto do Servidor de Relatórios. Quando utiliza o modelo de Projeto do Assistente de Servidor de Relatórios, um projeto de servidor de relatórios é criado automaticamente e o assistente de relatórios abre-se. No assistente, pode criar um relatório seguindo as instruções de cada página. As instruções descrevem como:

  • Crie uma cadeia de ligação a uma fonte de dados.
  • Defina as credenciais da fonte de dados.
  • Crie uma consulta.
  • Adicione uma tabela ou região de dados matriciais.
  • Especifique os dados e os grupos do relatório.
  • Escolhe uma fonte e um estilo de cor.
  • Publique o relatório num servidor de relatórios.
  • Pré-visualize o relatório localmente.

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

Janelas e painéis do Report Designer

O Designer de Relatórios oferece múltiplas janelas e painéis para o ajudar a desenhar relatórios e visualizar relatórios renderizados.

Painel de Dados de Relatório

O painel de Dados do Relatório mostra objetos de dados que pode usar num relatório.

Para abrir o painel de Dados de Relatório, muda o foco para a área de design. Depois, no menu Visualizar , seleciona Reportar Dados.

Os seguintes tipos de objetos estão disponíveis no painel de Dados de Relatório:

• Campos incorporados. Estes campos contêm informações pré-definidas do relatório, como o nome do relatório ou a hora em que o relatório foi processado.
• Origens de dados. Uma fonte de dados representa o nome e a informação de ligação para uma fonte de dados.
• Conjuntos de dados. Cada conjunto de dados inclui uma consulta que especifica quais os dados a recuperar da fonte de dados. Pode expandir o conjunto de dados para visualizar a coleção de campos que a consulta especifica. Em alguns designers de consultas para conjuntos de dados multidimensionais, pode especificar filtros no painel de Filtros e indicar se deve criar parâmetros de relatório. Se especificar a opção do parâmetro de relatório, é criado automaticamente um conjunto de dados especial para preencher a lista de valores válidos do parâmetro. Por defeito, o conjunto de dados não aparece no painel de Dados de Relatório. Para mais informações, consulte Mostrar conjuntos de dados ocultos para valores de parâmetros - dados multidimensionais.
• Reporte os parâmetros. Pode criar parâmetros de relatório manualmente ou automaticamente quando uma consulta de conjunto de dados inclui parâmetros de consulta.
• Imagens. As imagens desta lista estão disponíveis para serem incluídas como itens de relatório de imagem num relatório.

As fontes de dados e conjuntos de dados no painel de Dados de Relatório representam os elementos na definição do relatório. O painel de Dados de Relatórios é uma funcionalidade suportada por múltiplos ambientes de autoria de relatórios.

• No Construtor de Relatórios, é o único painel disponível para gerir fontes de dados e conjuntos de dados.
• No Designer de Relatórios, o painel de Dados de Relatórios funciona com o Explorador de Soluções, que lista fontes de dados partilhadas e conjuntos de dados partilhados como ficheiros. As fontes de dados partilhadas e os conjuntos de dados partilhados no painel de Dados de Relatório devem apontar para as respetivas fontes de dados partilhadas e conjuntos de dados partilhados no Explorador de Soluções. Os elementos do painel de Dados de Relatório contêm então uma referência aos ficheiros de dados no Explorador de Soluções. As propriedades do projeto determinam se as fontes de dados partilhadas e os conjuntos de dados partilhados são implementados no servidor de relatórios ou no site SharePoint. Para mais informações, consulte Converter fontes de dados (Construtor de Relatórios e SSRS).

Se o painel de Dados de Relatório estiver flutuante, podes ancorá-lo. Para mais informações, consulte o Painel de Dados de Relatório acoplado no Designer de Relatórios (SSRS).

Painel de agrupamento

Usas o painel de Agrupamento para definir grupos para uma região de dados tablix. Podes definir grupos de linhas e grupos de detalhe para tabelas, e podes definir grupos de linhas e colunas para matrizes. Não podes usar o painel de Agrupamento para definir grupos para gráficos ou outras regiões de dados. Para mais informações, consulte Grupos num relatório paginado do Construtor de Relatórios.

O painel de agrupamento tem dois modos:

• Default. Usas o modo predefinido para mostrar todos os grupos de linhas e colunas num formato hierárquico que mostra as relações entre grupos pais, grupos filhos, grupos adjacentes e grupos de detalhes. Um grupo filho aparece abaixo, no nível de indentação seguinte ao do seu grupo principal. Um grupo adjacente aparece ao mesmo nível de indentação que os seus grupos pares ou irmãos.

  Também usas o modo predefinido para adicionar, editar ou eliminar grupos. Para grupos baseados num único campo de conjunto de dados, arrasta-se o campo para o painel de Grupos de Linhas ou Grupos de Colunas. Podes inserir o grupo ao lado de um grupo já existente. Para adicionar um grupo adjacente, utiliza-se o menu de atalhos do grupo de irmãos. Para mostrar quais as células tablix pertencentes a um grupo, seleciona-se o grupo no painel de Agrupamento.

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

Para mais informações, consulte o painel de agrupamentos.

Painel da caixa de ferramentas

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

• As regiões de dados são itens do relatório que utilizas para organizar os dados no relatório. Exemplos de regiões de dados incluem uma tabela, matriz, lista, gráfico, medidor, barra de dados, linha de centelha e indicador.
• Outros itens do relatório incluem um mapa, caixa de texto, retângulo, linha, imagem e subrelatório.
• Itens de relatório personalizados também podem aparecer no painel Toolbox se o administrador do sistema os instalar e registar.

Painel de propriedades

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

Para mostrar o painel de Propriedades, vai ao menu Visualizar e depois seleciona a Janela de Propriedades. Podes desacoplar este painel e movê-lo para outra área da janela do SSDT, ou exibi-lo como uma vista separada na superfície de design.

Na maioria dos casos, os nomes das propriedades correspondem a elementos e atributos no ficheiro da Linguagem de Definição de Relatórios (RDL). Pode definir as propriedades mais usadas usando a janela de diálogo Propriedades de um item selecionado. Para abrir a caixa de diálogo Propriedades de um item, seleciona o item e depois seleciona o botão Páginas de Propriedades na barra de ferramentas de Propriedades. Utilizadores avançados podem definir valores de propriedade diretamente no painel de Propriedades.

Pode usar o painel de Propriedades para as seguintes tarefas:

• Defina as propriedades do item atualmente selecionado na superfície de design. Algumas propriedades fornecem uma lista suspensa de valores. Também podes introduzir o valor diretamente na célula. Algumas propriedades contêm uma coleção de valores, indicados pelo valor (Coleção). A maioria das propriedades pode aceitar uma expressão. As expressões complexas são indicadas pelo valor <expressão>. Para abrir o diálogo Expressão, seleciona o botão Expressão (fx). Para mais informações, consulte caixa de diálogo de Expressão.
• Use os botões da barra de ferramentas do painel de Propriedades para alterar a grelha de uma vista de categoria para uma vista alfabética. Na vista de categoria, pode ser necessário expandir uma categoria para ver todas as propriedades por baixo dela. Para abrir o diálogo de Propriedades de um item, pode selecionar o botão Páginas de Propriedades na barra de ferramentas. Ou pode clicar com o botão direito no item e selecionar Propriedades.
• Defina propriedades para o membro do grupo atualmente selecionado no painel de Agrupamento. As propriedades dos membros do grupo ajudam a controlar como as linhas estáticas do cabeçalho e rodapé do grupo são repetidas para cada instância do grupo. Para mais informações, consulte Exibir cabeçalhos e rodapés com um grupo num relatório paginado (Construtor de Relatórios).

Explorador de Soluções

O Solution Explorer é um componente padrão do Visual Studio que mostra todos os itens do seu projeto. Para um projeto de servidor de relatórios, esta lista de itens inclui pastas para organizar fontes de dados partilhadas, conjuntos de dados partilhados, relatórios e recursos. Os itens da pasta são automaticamente organizados alfabéticamente quando abres o ficheiro da solução. Para visualizar as propriedades dos itens no painel de Propriedades, selecione o item.

Janela de saída

A janela de Saída mostra erros de processamento que ocorrem quando pré-visualiza um relatório. Esta janela também mostra erros de publicação que ocorrem quando implementa um relatório ou uma fonte de dados partilhada.

Pode usar a janela de Saída para ajudar a depurar erros nas expressões.

Painel de Estrutura do Documento

O painel de Esboço do Documento apresenta uma lista hierárquica de todos os itens do relatório na definição do relatório. Para abrir o painel de Esboço do Documento, pode selecionar Ver>Outras Janelas>Esboço do Documento.

O painel de Esboço do Documento é útil para identificar caixas de texto e outros itens do relatório pelo nome. Quando seleciona um item no Painel de Estrutura do Documento, o item também é selecionado na área de design.

Também pode usar o painel de Mapa do Documento para ajudar a depurar erros nas expressões.

Janela da Lista de Tarefas

A janela da Lista de Tarefas mostra erros de construção que ocorrem quando importa um relatório de outra aplicação. Por exemplo, se importar um relatório do Microsoft Access e o relatório contiver uma funcionalidade que o SSRS não suporta, é reportado um erro na janela da Lista de Tarefas.

Perspetivas do Designer de Relatórios

O Designer de Relatórios suporta duas perspetivas:

• Design, para definir os dados e o layout de um relatório
• Pré-visualização, para mostrar uma vista renderizada de um relatório

vista Estrutura

Quando crias um projeto de servidor de relatórios, o Designer de Relatórios abre por defeito na vista de Design e mostra a superfície de design. Por padrão, a superfície de desenho mostra o corpo do relatório e o fundo do relatório.

O fundo da superfície do design tem um menu de atalho. Esse menu oferece opções para adicionar um cabeçalho de página e um rodapé de página. Também contém um menu de Visualização que pode usar para mostrar a régua, o painel de Agrupamento e o painel de Parâmetros.

Pode usar o controlo de zoom para aumentar ou diminuir a ampliação do relatório.

Para desenhar um relatório, arrasta-se os itens do relatório do painel Toolbox para a superfície de design. Depois configuras as propriedades deles e alteras a disposição no relatório.

Vista de pré-visualização

Na vista de Pré-visualização, executa o relatório e visualiza o relatório renderizado no visualizador de relatórios. Também pode definir as propriedades de configuração para executar o relatório em modo de depuração usando um navegador.

Quando faz uma pré-visualização de um relatório, Designer de Relatórios:

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

Há alguns pontos a ter em conta ao usar a vista de Pré-visualização:

• Relatórios parametrizados. Quando pré-visualiza um relatório, este é processado automaticamente se todos os parâmetros do relatório tiverem valores predefinidos válidos. Se um ou mais parâmetros de relatório não tiverem um valor padrão válido, deve escolher um valor para cada parâmetro não atribuído. Na barra de relatórios, tens de selecionar Ver Relatório.
• A cache local de dados. Quando faz uma pré-visualização de um relatório, o processador de relatórios executa todas as consultas para conjuntos de dados no relatório usando os parâmetros predefinidos atuais. Guarda os resultados como um ficheiro local de cache de dados (.rdl.data). Pode continuar a desenhar o seu relatório sem incorrer na sobrecarga de recuperar esses dados novamente se não fizer alterações nem às consultas do conjunto de dados do relatório nem aos parâmetros do relatório.
• Gestor de Configuração e despiste de erros. No SSDT, as propriedades do projeto definem como pretende implementar e depurar os seus relatórios. Estas propriedades aplicam-se a todos os relatórios e fontes de dados partilhadas no projeto. Para definir as propriedades do projeto, vai ao menu do Projeto e seleciona Propriedades. No diálogo Páginas de Propriedades, então seleciona Gestor de Configuração. Pode usar estas definições para testar os seus relatórios e publicá-los no servidor de relatórios.
• O painel de saída. Quando visualiza um relatório e o processador de relatórios deteta um problema, ele escreve mensagens de erro no painel de saída.

Menus do Designer de Relatórios

Quando um projeto de Designer de Relatórios está ativo no SSDT, os seguintes menus são adicionados ao menu principal.

Menu Formatar

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

Menu de relatórios e menu de atalhos da superfície de design

Pode usar as seguintes opções para configurar definições que se aplicam a um relatório completo. A disponibilidade e localização destas opções dependem da versão do Visual Studio que utiliza:

• Em versões anteriores, pode encontrar estas opções no menu de Relatório .
• Nas versões mais recentes, a maioria das opções encontra-se no menu de atalho do fundo da área de design.

Ver menu

Pode usar as seguintes opções do menu Visualizar para mostrar ou ocultar várias janelas e barras de ferramentas do Designer de Relatórios:

Menu do projeto

Pode usar as seguintes opções do menu do Projeto para gerir fontes de dados partilhadas e relatórios num projeto. Quando adiciona ou remove itens do projeto, a exibição hierárquica dos itens do projeto no Explorador de Soluções é atualizada automaticamente.

Barras de ferramentas do Designer de Relatórios

O Designer de Relatórios disponibiliza as seguintes barras de ferramentas especializadas para usar quando desenha relatórios:

Pode usar o menu Visualizar para mostrar ou esconder estas barras de ferramentas. Outras barras de ferramentas do Visual Studio podem não estar disponíveis se a sua funcionalidade não se aplicar às funcionalidades do Designer de Relatórios.

Controlo de origem

O SSDT pode integrar-se com plug-ins de origem. Podes usar as páginas de Controlo de Fonte na caixa de Opções para especificar um plug-in e configurar propriedades.

Modelos personalizados de relatórios

Para usar relatórios personalizados como modelos para novos relatórios, copia-os para a pasta ReportProject no computador onde o SSDT está instalado.

A localização padrão desta pasta depende da versão e edição do Visual Studio que utilizas. Para o Visual Studio 2022, 2019 e 2017, esta pasta encontra-se na seguinte localização:

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

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

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

Quando adiciona um novo item ao projeto de relatório, o seu relatório personalizado aparece no painel de Modelos. Também pode adicionar estilos personalizados ao assistente de relatório.

Suporte de linha de comandos para SSDT

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

Antes de poder usar as opções de linha de comandos que esta secção descreve, deve definir valores válidos para os seguintes dois itens:

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

Para mais informações, consulte Publicação de fontes de dados e relatórios.

Para um projeto de servidor de relatórios, pode especificar as seguintes opções a partir da linha de comandos:

• /deploy: Implementa relatórios utilizando as propriedades do projeto especificadas pelo ficheiro de configuração. Por exemplo, o comando seguinte implementa os relatórios que o ficheiro de solução Reports.sln especifica. Utiliza as definições de configuração de Release especificadas nas propriedades do projeto:

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

• /build: Constrói o ficheiro de solução, mas não o implementa. Por exemplo, o comando seguinte constrói os relatórios que o ficheiro de solução Reports.sln especifica. Utiliza 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 construção de uma solução para o ficheiro especificado. Por exemplo, o comando seguinte redireciona a saída da build no exemplo anterior para um ficheiro chamado mybuildlog.txt.

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

Atalhos de teclado no SSDT

Pode usar atalhos de teclado para:

• Controlar janelas e modos em SSDT:

  Description	Combinação de teclas
  Construir o projeto selecionado	Ctrl+Shift+B
  Mostrar a janela de Propriedades	F4
  Mostrar a janela de Dados do Relatório	+ Ctrl+ AltD
  Iniciar depuração	F5
  Passar de uma janela aberta para a seguinte	F6

• Itens de controlo na superfície de design do relatório:

  Description	Combinação de Teclas
  Mude o foco de um item do relatório para o próximo item do relatório	Tab
  Mover o item de relatório selecionado	Teclas de seta
  Empurrar o item selecionado do relatório	Ctrl+Teclas de seta
  Aumentar ou diminuir o tamanho do item selecionado do relatório	Ctrl+Shift+Teclas de seta
  Numa caixa de texto, move o cursor para o início do texto visível	+ CtrlCasa
  Numa caixa de texto, mova o cursor para o final do texto visível	+ CtrlFim
  Numa caixa de texto, selecione o texto da posição atual do cursor até ao início do texto visível	Turno+Casa
  Numa caixa de texto, selecione texto da posição atual do cursor até ao final do texto visível	Turno+Fim
  Numa caixa de texto, selecione texto desde a posição atual do cursor até ao início da expressão	+ CtrlTurno+Casa
  Numa caixa de texto, selecione texto desde a posição atual do cursor até ao fim da expressão	+ CtrlTurno+Fim
  Abra o menu de atalho para o item de relatório selecionado	Turno+F10

Conteúdo relacionado

• Explorador de Soluções
• Relatórios do Reporting Services (SSRS)
• Linguagem de Definição de Relatórios (SSRS)