Criando o projeto do servidor de relatório o projeto AdventureWorks2008R2_Base (SSRS)

No Business Intelligence Development Studio, é possível criar várias fontes de dados compartilhadas, conjuntos de dados compartilhados e relatórios e implantá-los em uma única etapa. Neste tutorial, você criará um projeto e uma solução do Servidor de Relatório e um relatório base. Para cada um dos relatórios de exemplo da AdventureWorks, você fará uma cópia do relatório base como o local inicial para a criação de cada relatório individual.

O que você aprenderá

Neste tutorial, você aprenderá a:

  • Criar e configurar um projeto do Servidor de Relatório

  • Adicionar um relatório em branco ao projeto.

  • Adicionar uma fonte de dados compartilhada ao projeto e uma referência à fonte de dados compartilhada ao relatório.

  • Adicionar um parâmetro booliano de relatório.

  • Adicionar e configurar o cabeçalho da página com o logotipo e o nome do relatório.

  • Adicionar e configurar o rodapé da página com a descrição do relatório.

  • Definir visibilidade condicional para permitir que um usuário mostre ou oculte conteúdo, conforme necessário, de duas maneiras: com base em uma alternância de caixa de texto ou em um parâmetro booliano.

  • Adicionar texto de descrição com visibilidade condicional que pode ser definido pelo usuário com base no parâmetro booliano.

  • Adicionar texto de descrição à propriedade Descrição do relatório. A descrição do relatório é exibida no servidor de relatório.

  • Adicionar texto de cenário com visibilidade condicional que pode ser alternada pelo usuário. O texto de cenário é texto personalizado que descreve as perguntas que o relatório é criado para responder.

  • Definir o tamanho da página para exportar o arquivo para o formato pdf.

  • Visualizar e verificar o relatório.

  • Implantar e verificar o relatório.

Tempo estimado para concluir este tutorial: 15 minutos.

Requisitos

Para obter a lista de requisitos, consulte Pré-requisitos para os relatórios de exemplo AdventureWorks 2008R2 (SSRS).

Dicas

Para obter uma lista de dicas gerais, consulte Dicas de design de relatórios (Construtor de Relatórios 3.0 e SSRS).

Definir as propriedades do projeto

Para criar uma solução e definir as propriedades do projeto

  1. Inicie o BI Development Studio.

    ObservaçãoObservação

    Se o UAC (Controle de Conta de Usuário) tiver suporte e estiver habilitado no sistema operacional, para implantar relatórios em um servidor de relatório, execute o BI Development Studio com privilégios elevados. Para obter mais informações, consulte Pré-requisitos para os relatórios de exemplo AdventureWorks 2008R2 (SSRS).

  2. Crie um novo projeto do Servidor de Relatório denominado Relatórios de Exemplo da AdventureWorks 2008R2.

    ObservaçãoObservação

    Se você já tiver instalado os Relatórios de Exemplo da AdventureWorks 2008R2 a partir do CodePlex, use um nome exclusivo para o projeto do Servidor de Relatório para evitar conflitos de nomenclatura.

  3. Abra as páginas de propriedades do projeto. Proceda da seguinte maneira:

    1. Defina TargetDatasetFolder como AdventureWorks 2008R2/Datasets.

    2. Defina TargetDataSourceFolder como AdventureWorks 2008R2/DataSources.

    3. Defina TargetReportFolder como AdventureWorks 2008R2.

    4. Defina TargetReportPartFolder como AdventureWorks 2008R2/ReportParts.

    5. Defina TargetServerURL como seu servidor de relatório ou site do SharePoint. Por exemplo, http://<nome_do_servidor>/servidor_de_relatórios.

    6. Verifique se TargetServerVersion é SQL Server 2008 R2.

  4. Aceite os outros valores padrão e crie o projeto.

Adicionar um relatório em branco

Para adicionar um relatório vazem branco

  1. No Gerenciador de Soluções, clique com o botão direito do mouse na pasta Relatórios, aponte para Adicionar e clique em Novo Item.

  2. Em Modelos, clique em Relatório.

  3. Defina Nome como AdventureWorks2008R2_Base.rdl.

  4. Clique em Adicionar.

Criar uma fonte de dados compartilhada para o projeto e no relatório

Para criar uma fonte de dados compartilhada para os dados da AdventureWorks

  1. No Gerenciador de Soluções, crie uma fonte de dados compartilhada do projeto para o banco de dados da AdventureWorks.

    1. Defina Nome como AdventureWorks2008R2.

    2. Crie uma cadeia de conexão semelhante à seguinte:

      Data Source=(servername); Initial Catalog=AdventureWorks2008R2

    3. Especifique as credenciais.

  2. No painel Dados do Relatório, adicione uma referência à fonte de dados do relatório que aponte para a fonte de dados do projeto.

  3. Altere Nome para AdventureWorks2008R2.

  4. Selecione Usar referência da fonte de dados compartilhada e clique em AdventureWorks2008R2.

Criar parâmetros do relatório

Um parâmetro de relatório é criado automaticamente para cada variável de consulta de conjunto de dados, parâmetro de entrada de procedimento armazenado ou parâmetro de conjunto de dados compartilhado. Também é possível criar um parâmetro manualmente.

No relatório padrão, você criará um parâmetro Booliano para que um usuário possa mostrar ou ocultar informações opcionais no relatório, por exemplo, a descrição do relatório ou os resultados da expressão.

Para adicionar um parâmetro Booliano para visibilidade condicional

  1. No painel Dados do Relatório, adicione um parâmetro denominado ShowAll.

  2. Na página Geral, altere Aviso para Mostrar todas as informações?

  3. Altere Tipo de dados para Booliano.

  4. Na página Valores Padrão, selecione Especificar valores.

  5. Adicione um valor e defina-o como false.

Depois que os parâmetros são publicados em um servidor de relatório ou site do SharePoint pela primeira vez, não é possível substituir as propriedades dos parâmetros no BI Development Studio. Por design, parâmetros publicados são gerenciados apenas no servidor de relatório. Para alterar um valor de propriedade depois de sua publicação, você deve atualizar a propriedade diretamente no servidor de relatório ou excluir e implantar o relatório novamente.

Adicionar o cabeçalho da página

Para adicionar o cabeçalho da página, o logotipo e o nome do relatório

  1. No menu Relatório, adicione um cabeçalho de página.

  2. No painel Dados do Relatório, adicione uma imagem. Navegue para a pasta do projeto e selecione AdventureWorksLogo.jpg.

  3. Arraste a imagem para o cabeçalho da página.

  4. Na caixa de diálogo Propriedades da Imagem, defina Nome como Logotipo.

  5. Verifique se a origem da imagem é Inserido.

  6. Depois de adicionar a imagem, arraste as alças da imagem para expandir o tamanho para aproximadamente 2,5 pol por 0,5 pol.

  7. No painel Dados do Relatório, expanda Campos Internos e arraste Nome do Relatório para a direita do cabeçalho da página. Formate conforme necessário.

  8. Arraste a parte inferior do cabeçalho da página para cima para remover espaço em branco adicional.

Adicionar o cabeçalho da página

É possível adicionar uma descrição ao relatório no rodapé da página e condicionalmente ocultar o conteúdo. O usuário pode decidir se deseja exibir as informações. Para exibir uma descrição no servidor de relatório, adicione as informações à propriedade Descrição do relatório.

Para adicionar o rodapé da página e uma descrição que fique oculta por padrão

  1. Adicione um rodapé de página.

  2. Em Propriedades do Rodapé, desmarque a opção Imprimir na primeira página.

  3. Adicione uma caixa de texto com o seguinte texto: <Substituir pela descrição.>.

  4. Altere o Nome da caixa de texto para tbDescription.

  5. Expanda o tamanho da caixa de texto para preencher o rodapé da página.

  6. Selecione a caixa de texto.

    ObservaçãoObservação

    O primeiro clique em uma caixa de texto abre o modo de edição. Para selecionar a caixa de texto depois de entrar no modo de edição, pressione ESC. Para obter mais informações, consulte Dicas de design de relatórios (Construtor de Relatórios 3.0 e SSRS).

  7. Nas propriedades da Caixa de Texto, na página Visibilidade, selecione Mostrar ou ocultar com base em uma expressão e adicione o seguinte texto: =NOT Parameters!ShowAll.Value.

Use o operador NOT porque a visibilidade define a propriedade Hidden na caixa de texto. Para o usuário, o parâmetro @ShowAll é definido como uma ação positiva. Quando @ShowAll for true, o texto não será ocultado.

Adicionar uma descrição

Para adicionar a descrição como uma propriedade de relatório

  1. Clique no plano de fundo do relatório para exibir Propriedades do Relatório no painel Propriedade.

  2. Localize Descrição e copie cole o texto da descrição da etapa anterior.

ObservaçãoObservação

O número máximo de caracteres de uma descrição é 512.

Depois que o texto da descrição é publicado pela primeira vez, não é possível substituir a propriedade Descrição do relatório no BI Development Studio. Para alterar um valor de propriedade depois de sua publicação, você deve atualizar a propriedade diretamente no servidor de relatório ou no site do SharePoint ou excluir e implantar o relatório novamente.

Adicionar o texto do cenário

O texto do cenário descreve o objetivo do relatório. Em alguns relatórios, esse texto pode fornecer orientação ao usuário sobre os recursos do relatório. Por padrão, o texto do cenário é ocultado, mas o usuário pode ativá-lo ou desativá-lo.

Para adicionar uma alternância para texto cuja visibilidade é condicional

  1. Na parte superior, à esquerda do relatório, sob o cabeçalho da página, adicione uma caixa de texto com o seguinte texto:

    Clique em + para exibir o histórico do cenário.

  2. Altere o Nome da caixa de texto para tbToggle.

  3. Defina o estilo da fonte conforme necessário.

Para permitir a exibição ou ocultação de uma caixa de texto de acordo com uma alternância

  1. Na parte superior, à direita do relatório, sob o cabeçalho da página, adicione uma caixa de texto.

  2. Altere o Nome da caixa de texto para tbScenario.

  3. Na caixa de texto, digite o seguinte texto: <Substituir pelo histórico do cenário para este relatório.>.

  4. Nas propriedades de Caixa de Texto, página Visibilidade, em Quando o relatório for executado inicialmente, selecione Ocultar.

  5. Selecione A exibição pode ser alternada por este item de relatório.

  6. Na lista suspensa, selecione tbToggle.

Em lições posteriores, você criará texto de cenário para cada relatório e adicionará links de palavras específicas no texto para indicadores em itens relacionados do relatório.

Definir o tamanho da página para exportação para arquivos pdf.

O design do relatório não é o que aparece na tela. Você não vê o relatório renderizado até que o visualize ou execute. Por design, cada região de dados será expandida automaticamente para acomodar todos os dados de seu conjunto de dados relacionado. O espaço em branco na superfície de design do relatório é preservado.

Se você planeja imprimir um relatório ou exportá-lo para um formato compatível com impressão, para evitar várias páginas horizontais, você deve definir explicitamente a largura da página e eliminar espaço em branco no relatório.

Para definir o tamanho da página para .pdf ou outros formatos de impressão

  1. Remova ou minimize espaço em branco adicional no relatório tornando os itens do relatório adjacentes e arrastando as bordas do relatório próximas às bordas dos itens do relatório.

  2. Clique com o botão direito do mouse na área do plano de fundo da superfície de design do relatório e clique em Régua.

  3. No menu Relatório, abra Propriedades do Relatório.

  4. Na página Configurar Página, proceda da seguinte maneira:

    1. Altere Largura para 7,9375 pol.

    2. Verifique se as margens Direita e Esquerda não são maiores do que 1 pol.

  5. Use a régua para verificar se a página agora é menor que 7 pol.

Visualizar o Relatório

Para visualizar e verificar o relatório

  1. Visualize o relatório.

  2. Verifique se o relatório é executado automaticamente.

  3. Na barra de ferramentas do visualizador de relatório, verifique se ExibirTudo tem os botões de opção True e False. Por padrão, o valor é False.

  4. No cabeçalho da página, o logotipo e o nome do relatório são exibidos.

  5. Uma caixa de texto com uma alternância é exibida. Quando você clica na alternância, o texto do cenário é exibido.

  6. Quando você define ExibirTudo como True e executa o relatório, a descrição é exibida no rodapé.

Implantar o relatório

Para implantar o relatório

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e clique em Implantar. Verifique se há erros na linha de status do BI Development Studio ou no painel Saída.

    ObservaçãoObservação

    Como o relatório depende de uma fonte de dados compartilhada, na primeira vez que implanta o relatório, você deve implantar o projeto inteiro. Em tutoriais subsequentes, você poderá implantar relatórios individualmente.

  2. Em um navegador, navegue para o servidor de relatório ou site do SharePoint, por exemplo, https://localhost/reports ou http://SharePointsite/subsite/reports.

  3. Verifique se a fonte de dados compartilhada e o relatório são exibidos nas pastas especificadas.

  4. Verifique se a descrição do relatório é exibida.

  5. Edite a fonte de dados compartilhada para usar credenciais que funcionem no servidor de relatório. No relatório base, você não recupera dados da AdventureWorks, portanto, o relatório é executado sem erros. Os tutoriais restantes exigem que as credenciais para a fonte de dados funcionem no servidor de relatório ou no site do SharePoint.

  6. Verifique se o relatório é executado.

Próximas etapas

Você criou um projeto de relatório e um relatório base. Você pode agora criar um relatório de exemplo. Para obter mais informações, consulte Tutoriais: Criando relatórios de exemplo do AdventureWorks 2008R2 (SSRS).