Usando o Acesso à URL em um aplicativo Web

O acesso à URL no Reporting Services foi projetado especificamente para habilitar o acesso a relatórios individuais em uma rede. Esse tipo de acesso é melhor para integrar a exibição de relatório e a navegação em um aplicativo Web personalizado. Para usar o acesso à URL em aplicativos Web, você pode:

• Endereçar uma URL a um servidor de relatório específico de um site ou portal.

• Use um método POST de formulário e passe parâmetros de cadeia de caracteres de consulta para uma URL do servidor de relatório usando campos de formulário.

Acesso à URL por meio de endereçamento direto

Para acessar um servidor de relatório ou um item de banco de dados do servidor de relatório usando uma URL, basta fornecer o endereço de URL de dentro de um navegador da Web ou aplicativo. Você também pode fornecer parâmetros para a URL que podem afetar a aparência do relatório ou do recurso que está sendo acessado. Uma URL pode ser direcionada a um servidor de relatório por meio da barra de endereços de um navegador da Web ou uma URL pode ser a origem de um IFrame que faz parte de um aplicativo Web ou portal maior. Você pode incluir hiperlinks para relatórios em várias páginas da Web do portal, bem como direcionar um quadro específico para o relatório ou abrir uma nova janela do navegador no processo.

No exemplo a seguir, o hiperlink tem como destino um quadro chamado "main", que pode ser diferente daquele que inclui o hiperlink. O hiperlink pode fazer parte do portal da Web.

<a href="https://server/reportserver?/SampleReports/Territory Sales   
Drilldown&rs:Command=Render&rc:LinkTarget=main" target="main" >  
   Click here for the Territory Sales Drilldown sample report  
</a>  

No exemplo anterior, a configuração de informações do dispositivo LinkTarget é passada com um valor "principal" na cadeia de caracteres de consulta da URL. Isso garante que todos os hiperlinks de detalhamento no relatório também direcionem o quadro chamado "principal".

Para obter mais informações sobre as configurações de informações do dispositivo, consulte Passando as configurações de informações do dispositivo para extensões de renderização.

Observe que muitos servidores e navegadores limitam o número de caracteres permitido em uma URL. Em alguns casos, um limite de 256 caracteres é imposto. Para contornar essa limitação, você pode usar solicitações POST usando o envio de formulário.

Acesso à URL por meio de um método POST de formulário

Quando um usuário solicita dados de um servidor de relatório usando o acesso à URL, a solicitação HTTP usa o método GET. Isso é equivalente a um envio de formulário em que METHOD="GET". Solicitações de URL ou envios de formulário que usam METHOD="GET" são limitados pelo número máximo de caracteres que um servidor ou navegador da Web pode processar.

Com solicitações POST (METHOD="POST" e campos de entrada), os pares nome/valor são transferidos no cabeçalho e não na URL. Portanto, os pares nome/valor da cadeia de caracteres de consulta não fazem parte da URL, permitindo que você forneça listas de parâmetros muito mais longas e mais complexas.

Usando o acesso direto, um usuário pode ver a URL do servidor de relatório e pode ser capaz de modificar a cadeia de caracteres de consulta ou observar os parâmetros específicos de solicitação de URL e servidor de relatório para uso posterior.

O HTML de exemplo a seguir demonstra o uso de um formulário que você pode usar para direcionar um servidor de relatório com uma URL específica e passar parâmetros de cadeia de caracteres de consulta como parte dos campos de entrada do formulário.

<FORM id="frmRender" action="https://server/reportserver?/SampleReports/  
   Territory Sales Drilldown" method="post" target="_self">  
   <INPUT type="hidden" name="rs:Command" value="Render">   
   <INPUT type="hidden" name="rc:LinkTarget" value="main">  
   <INPUT type="hidden" name="rs:Format" value="HTML4.0">  
   <INPUT type="submit" value="Button">  
</FORM>  

No exemplo anterior, se um usuário clicar no botão no formulário, o servidor de relatório retornará um relatório renderizado em HTML direcionado ao quadro atual. Uma cadeia de caracteres de acesso de URL comparável pode ser semelhante à seguinte:

https://server/reportserver?/SampleReports/Territory Sales   
Drilldown&rs:Command=Render&rc:LinkTarget=main&rs:Format=HTML4.0  

Consulte Também

Integrando o Reporting Services em aplicativos
Integrando os Serviços de Relatórios usando Acesso à URL
Usando o Acesso à URL em um aplicativo do Windows
Acesso à URL (SSRS)