Como criar um aplicativo de exemplo que usa as APIs de SOAP Reporting Services para processar um relatório para um formato de arquivo selecionado em uma página da Web

Este artigo passo a passo descreve como criar um aplicativo do Microsoft ASP.NET exemplo que usa o Microsoft SQL Server 2000 Reporting Services SOAP APIs e o Microsoft SQL Server 2005 Reporting Services SOAP APIs para executar o seguinte:

• Processa um relatório que é implantado em um servidor de relatório para um formato de arquivo com suporte, como o formato de arquivo .pdf.
• Abra o relatório processado em uma página da Web sem salvar o arquivo que corresponde ao relatório processado no seu computador.

Observação Para processar o relatório para o formato de arquivo solicitada usando o aplicativo ASP.NET, o programa que suporte o formato de arquivo deve ser instalado em seu computador. Por exemplo, para exibir um relatório que é processado para o formato de arquivo .pdf, Adobe Acrobat Reader deve ser instalado em seu computador.

Você pode gerar um relatório usando o Reporting Services, e você pode exibir o relatório usando o Gerenciador de relatório. O Gerenciador de relatório está incluído no Reporting Services. Usando o Gerenciador de relatórios, você pode processar o relatório de diferentes formatos de arquivo que são suportados pelo Reporting Services. Para processar um relatório para um formato de arquivo específico, execute estas etapas:

1. Inicie o Gerenciador de relatório.
2. Localize o relatório no Report Manager e, em seguida, clique no relatório para visualizar o relatório.
3. Na lista Selecione um formato , clique no formato de arquivo que você deseja usar para processar o relatório e, em seguida, clique em Exportar .

Após você clicar em Exportar no Report Manager, a caixa de diálogo Download de arquivo é aberta. A caixa de diálogo Download de arquivo fornece uma opção para salvar o relatório processado no seu computador. Mesmo se você abrir o relatório sem salvar o relatório, um arquivo que corresponde ao relatório processado é criado no computador.

Se você deseja processar um relatório para o formato de arquivo solicitada sem criar o arquivo que corresponde ao relatório processado no seu computador, você pode usar o método Render nas APIs de SOAP Reporting Services. Para obter mais informações sobre o método Render para o SQL Server 2000 Reporting Services, visite o seguinte site:Para obter mais informações sobre o método Render para o SQL Server 2005 Reporting Services, visite o seguinte site:Para criar um exemplo de aplicativo ASP.NET para processar um relatório que é implantado em um servidor de relatório para o formato de arquivo solicitada e abra o relatório processado em uma página da Web usando as APIs de SOAP Reporting Services, siga estas etapas.

Observação Esse aplicativo de exemplo processa o relatório de exemplo de vendas da empresa para o formato de arquivo .pdf. Portanto, você deve se certificar que vendas da empresa exemplo de relatório é implantado em seu servidor de relatório na pasta SampleReports. Você também deve certificar-se de que um programa, como o Adobe Acrobat Reader é instalado no computador antes de executar este aplicativo.

Usar o Microsoft Visual Studio .NET 2003 para processar o relatório de exemplo de vendas da empresa que é incluído no SQL Server 2000 Reporting Services ou SQL Server 2005 Reporting Services

1. Inicie o Microsoft Visual Studio .NET 2003.
2. No menu arquivo , clique em novo e, em seguida, clique em Project .
3. Na caixa de diálogo New Project , em Project Types , clique em translation from VPE for Csharp Visual projetos .
4. Na caixa de diálogo New Project , em modelos , clique em ASP.NET Web Application .
5. Na caixa Location , digite http:// ReportServerName / RenderCompanySales e em seguida, clique em OK para criar o projeto.
6. Adicione uma referência da Web para o serviço da ReportService Web. Para fazer isso, execute as seguintes etapas:
   1. No menu Project , clique em Add Web Reference .
   2. Na caixa de diálogo Add Web Reference , digite http:// ReportServerName /ReportServer/ReportService.asmx na caixa URL e em seguida, clique em Ir .
   3. Na caixa Web reference name , digite RSWebReference e, em seguida, clique em Add Reference .
7. No painel esquerdo, em Toolbox , clique em Web Forms e, em seguida, clique duas vezes o botão para adicionar um controle de botão para o formulário da Web.
8. Defina as propriedades do controle de botão, usando as seguintes informações:
   • (ID) : RenderTest
   • texto : Render relatório em PDF Formatar
9. No menu Exibir , clique em código .
10. Adicione o seguinte código na parte superior da janela de código:

    using RenderCompanySales.RSWebReference;

11. Adicione o seguinte método como o manipulador de eventos do evento click do botão RenderTest em seu código:

    		private void RenderTest_Click(object sender, System.EventArgs e)
    		{
    			RSWebReference.ReportingService rs = new RSWebReference.ReportingService(); 
    			rs.Credentials = System.Net.CredentialCache.DefaultCredentials;
    
    			Byte[] result; 
    
    			string encoding;
    			string mimetype;
    			ParameterValue[] parametersUsed;
    			Warning[] warnings;
    			string[] streamids;
    
    			result = rs.Render("/SampleReports/Company Sales","PDF",null,null,null,null,null,out encoding,out mimetype,out parametersUsed,out warnings,out streamids); 
    						
    			Response.ClearContent();
    			Response.AppendHeader("content-length", result.Length.ToString());
    			Response.ContentType = "application/pdf";
    			Response.BinaryWrite(result);
    			Response.Flush();
    			Response.Close();
    		}
    

12. No menu Debug , clique em Iniciar para executar o código.
13. Na página de Web WebForm1 , clique em Processar o relatório em formato PDF .

Usar o Microsoft Visual Studio 2005 para processar o relatório de exemplo de vendas da empresa que está incluído no SQL Server 2005 Reporting Services

1. Inicie o Microsoft Visual Studio 2005.
2. No menu arquivo , clique em novo e em seguida, clique em Site .
3. Na caixa de diálogo New Web Site , clique em Site ASP.NET em Visual Studio installed templates ,
4. Clique em HTTP na lista local e, em seguida, digite http:// ReportServerName / RenderCompanySales na caixa que é próxima à lista local
5. Na lista Language , clique em translation from VPE for Csharp Visual e, em seguida, clique em OK .
6. Adicione uma referência da Web para o serviço da ReportService Web. Para fazer isso, execute as seguintes etapas:
   1. No menu Website , clique em Add Web Reference .
   2. Na caixa de diálogo Add Web Reference , digite http:// ReportServerName /ReportServer/ReportExecution2005.asmx na caixa URL e em seguida, clique em Ir .
   3. Na caixa Web reference name , digite RSWebReference e, em seguida, clique em Add Reference .
7. No menu Exibir , clique em Designer e, em seguida, adicione um controle Button ao formulário da Web.
8. Defina as propriedades do controle Button , usando as seguintes informações:
   • (ID) : RenderTest
   • texto : Render relatório em PDF Formatar
9. No menu Exibir , clique em código .
10. Adicione a seguinte linha de código na parte superior da janela de código:

    using RSWebReference;

11. Add the following method as the event handler of the click event for the RenderTest button in your code.

    protected void RenderTest_Click(object sender, EventArgs e)
        {
            ReportExecutionService rs = new ReportExecutionService();
            rs.Credentials = System.Net.CredentialCache.DefaultCredentials;
    
            // Render arguments
            byte[] result = null;
            string reportPath = "/AdventureWorks Sample Reports/Company Sales";
            string format = "PDF";
            string historyID = null;
    
            string encoding;
            string mimeType;
            string extension;
            Warning[] warnings = null;
            string[] streamIDs = null;
    
            ExecutionInfo execInfo = new ExecutionInfo();
            ExecutionHeader execHeader = new ExecutionHeader();
    
            rs.ExecutionHeaderValue = execHeader;
    
            execInfo = rs.LoadReport(reportPath, historyID);
    
            String SessionId = rs.ExecutionHeaderValue.ExecutionID;
    
            result = rs.Render(format, null, out extension, out encoding, out mimeType, out warnings, out streamIDs);
    
            Response.ClearContent();
            Response.AppendHeader("content-length", result.Length.ToString());
            Response.ContentType = "application/pdf";
            Response.BinaryWrite(result);
            Response.Flush();
            Response.Close();
    
        }

12. No menu Debug , clique em Iniciar a depuração para executar o código.
13. Na página da Web que abre do Visual Studio 2005, clique em Processar o relatório em formato PDF .

Para obter mais informações, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft: