Identificando o estado de execução

Http (Protocolo de Transferência de Hipertexto) é um protocolo sem conexão e sem estado, o que significa que ele não indica automaticamente se diferentes solicitações vêm do mesmo cliente ou mesmo se uma única instância do navegador ainda está exibindo ativamente uma página ou site. As sessões criam uma conexão lógica para manter o estado entre o servidor e o cliente por HTTP. As informações específicas do usuário relevantes para uma sessão específica são conhecidas como o estado da sessão.

O gerenciamento de sessão envolve a correlação de uma solicitação HTTP com outras solicitações anteriores geradas da mesma sessão. Sem o gerenciamento de sessão, essas solicitações parecem não relacionadas ao serviço Web servidor de relatório devido à natureza sem conexão e sem estado do protocolo HTTP.

O Reporting Services não expõe um conceito holístico de estado de sessão, como o exposto por ASP.NET. No entanto, ao executar relatórios, o servidor de relatório mantém o estado entre chamadas de método na forma de uma execução. Uma execução permite que o usuário interaja com o relatório de várias maneiras , incluindo carregar o relatório do servidor de relatório, definir credenciais e parâmetros para o relatório e renderizar o relatório.

Enquanto se comunicam com um servidor de relatório, os clientes usam a execução para gerenciar a exibição de relatórios e a navegação do usuário para outras páginas em um relatório e para mostrar ou ocultar seções de um relatório. Existe uma execução exclusiva para cada relatório em que o aplicativo cliente está em execução.

Em geral, o tempo de vida de uma execução começa quando um usuário navega para um navegador ou aplicativo cliente e seleciona um relatório para exibir. A execução é descartada após um curto período de tempo limite após a última solicitação para a execução ter sido recebida (o tempo limite padrão é de 20 minutos).

Do ponto de vista do serviço Web, o tempo de vida começa quando o serviço LoadReportLoadReportDefinitionWeb servidor de relatório ou Render métodos são chamados. O aplicativo pode usar outros métodos para manipular a execução ativa (por exemplo, definir parâmetros e definir fontes de dados). A execução é descartada após um curto período de tempo limite após a última solicitação para a execução ter sido recebida (o tempo limite padrão é de 20 minutos).

Um aplicativo controla várias execuções ativas entre chamadas para o serviço Render Web e RenderStream métodos salvando o ExecutionID, que é retornado no cabeçalho SOAP dos métodos e LoadReportDefinition dos LoadReport métodos.

O diagrama a seguir mostra o caminho de processamento e renderização para relatórios.

Para dar suporte às funções descritas acima, o método soap render atual foi dividido em vários métodos que abrangem fases de inicialização, processamento e renderização de execução.

Para renderizar programaticamente um relatório, você deve:

• Carregue o relatório ou a definição do relatório usando LoadReport ou LoadReportDefinition.

• Verifique se o relatório precisa de credenciais ou parâmetros verificando os valores e as CredentialsRequiredParametersRequired propriedades do ExecutionInfo objeto retornados por LoadReport ou LoadReportDefinition

• Se necessário, defina as credenciais e/ou parâmetros usando os métodos eSetExecutionParameters.SetExecutionCredentials

• Chame o Render método para renderizar o relatório.

Enquanto um relatório está em sessão, o relatório subjacente armazenado no banco de dados do servidor de relatório pode ser alterado. Por exemplo, a definição do relatório pode ser alterada, o relatório pode ser excluído ou movido e as permissões do usuário podem ser alteradas. Se o relatório estiver em uma sessão ativa, ele não será afetado por alterações feitas no relatório subjacente (ou seja, o relatório armazenado no banco de dados do servidor de relatório).

Você também pode gerenciar uma sessão de relatório usando comandos de acesso à URL.

Consulte Também

Render Referência técnica (SSRS)usando cabeçalhos SOAP do Reporting Services