Share via

Integrar o Reporting Services usando o acesso à URL - aplicativo Web

  • Artigo

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

  • Envie uma URL a um servidor de relatório específico a partir de um site ou de portal.

  • Use um método POST e passe parâmetros de cadeia de caracteres da 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 item de banco de dados do servidor de relatório usando uma URL, forneça o endereço da URL de dentro de um navegador da Web ou aplicativo. Você também pode fornecer parâmetros à URL que podem afetar a aparência do relatório ou do recurso acessado. Uma URL pode ter como destino 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 maior ou de um portal. Você pode incluir hiperlinks para relatórios em várias páginas da Web do seu portal e 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 poderia ser diferente do que inclui o hiperlink. O hiperlink poderia fazer parte de um 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 de "main" na cadeia de caracteres de consulta da URL, o que garante que todos os hiperlinks de detalhamento no relatório também tenham como alvo o quadro chamado "main".

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

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

Observação

O Internet Explorer tem um comprimento máximo de URL de 2.083 caracteres. Esse limite se aplica às URLs de solicitação POST e GET. No entanto, POST não está limitado pelo tamanho da URL para o envio de pares de nome/valor como parte de um formulário, já que eles são transferidos no cabeçalho e não na URL.

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 acesso à URL, a solicitação HTTP usa o método GET. Esta solicitação é equivalente a um envio de formulário onde METHOD="GET". Solicitações de URL ou submissões de formulário que usam METHOD= "GET" estão limitados pelo número máximo de caracteres que um servidor ou navegador da Web pode processar.

Com as solicitações POST (METHOD= "POST" e campos de entrada), os pares de 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 mais longas e complexas.

Um usuário pode usar o acesso direto para ver a URL do servidor de relatório. O usuário pode modificar a cadeia de caracteres de consulta ou observar a solicitação de URL específica e os parâmetros do servidor de relatório para uso posterior.

O HTML de exemplo a seguir demonstra a utilização de um formulário que pode ser usado para ter como destino 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 selecionar o botão no formulário, o servidor de relatório retornará um relatório renderizado em HTML direcionado ao quadro atual. O exemplo a seguir é uma cadeia de caracteres de acesso de URL comparável:

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

Conteúdo relacionado

Integração do Reporting Services em aplicativos
Integrando o Reporting Services usando o acesso à URL
Usar o acesso à URL em um aplicativo do Windows
Acesso à URL (SSRS)