Partilhar via


Usando parâmetros de acesso a URL

Você pode usar os parâmetros a seguir como parte de uma URL para configurar a aparência de seus relatórios. Os parâmetros mais comuns estão listados nesta seção. Os parâmetros não diferenciam maiúsculas de minúsculas e começam com o prefixo de parâmetro rs: quando direcionados ao servidor de relatório e com rc: quando direcionados a um Visualizador de HTML. Você também pode especificar parâmetros que são específicos de dispositivos ou extensões de renderização. Para obter mais informações sobre parâmetros específicos de dispositivos, consulte Especificando configurações de informações do dispositivo em uma URL.

Comandos do Visualizador de HTML

A tabela a seguir descreve os parâmetros de acesso a URL que são prefixados com rc: e usados para focar o Visualizador de HTML.

Parâmetro

Ação

Toolbar

Mostra ou oculta a barra de ferramentas. Se o valor desse parâmetro for false, todas as demais opções serão ignoradas. Se você omitir esse parâmetro, a barra de ferramentas será exibida automaticamente para renderizar formatos que dão suporte a ele. O padrão desse parâmetro é true.

Parameters

Mostra ou oculta a área de parâmetros da barra de ferramentas. Se você definir esse parâmetro como true, a área de parâmetros da barra de ferramentas será exibida. Se você definir esse parâmetro como false, a área de parâmetros não será exibida e não poderá ser exibida pelo usuário. Se você definir esse parâmetro com um valor Collapsed, a área de parâmetros não será exibida, mas poderá ser alternada pelo usuário final. O valor padrão desse parâmetro é true.

Zoom

Define o valor de zoom do relatório como uma porcentagem de número inteiro ou uma constante de cadeia de caracteres. Os valores de cadeia de caracteres padrão incluem Page Width e Whole Page. Esse parâmetro é ignorado pelas versões do Microsoft Internet Explorer anteriores ao Internet Explorer 5.0 e por todos os pesquisadores que não são da Microsoft. O valor padrão desse parâmetro é 100.

Section

Define a página do relatório a ser exibida. Qualquer valor maior que o número de páginas do relatório exibe a última página. Qualquer valor menor que 0 exibe a página 1 do relatório. O valor padrão desse parâmetro é 1.

StartFind

Especifica a última seção a ser pesquisada. O valor padrão desse parâmetro é a última página do relatório.

EndFind

Define o número da última página a ser usada na pesquisa. Por exemplo, um valor 5 indica que a última página a ser pesquisada é a página 5 do relatório. O valor padrão é o número da página atual. Use esse parâmetro junto com o parâmetro StartFind.

FallbackPage

Define o número da página a ser exibido em caso de falha em uma pesquisa ou em uma seleção de mapa de documento. O valor padrão é o número da página atual.

GetImage

Obtém um ícone específico para a interface de usuário do Visualizador de HTML.

Icon

Obtém o ícone de uma extensão de renderização específica.

Stylesheet

Especifica uma folha de estilos a ser se aplicada ao Visualizador de HTML.

Você pode passar parâmetros adicionais em uma URL para direcionar a saída para a renderização HTML. Para obter mais informações, consulte Configurações de informações do dispositivo HTML.

Comandos do Servidor de Relatórios

A tabela a seguir descreve os parâmetros de acesso a URL que são prefixados com rs: e usados para focar o servidor de relatórios.

Parâmetro

Ação

Command

Especifica a última seção a ser pesquisada. O valor padrão desse parâmetro é a última página do relatório.

Format

Especifica o formato no qual um relatório deve ser renderizado. Os valores comuns incluem HTML3.2, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML e NULL. Para obter mais informações, consulte Especificando um formato de renderização em uma URL.

ParameterLanguage

Fornece um idioma para parâmetros passados em uma URL que independe do idioma do pesquisador. O valor padrão é o idioma do pesquisador. O valor pode ser um valor de cultura, como en-us ou de-de.

Snapshot

Renderiza um relatório com base em um instantâneo de histórico de relatório. Para obter mais informações, consulte Renderizando instantâneos de histórico de relatório usando o acesso à URL.

PersistStream

Renderiza um relatório em um único fluxo persistente. Esse parâmetro é usado pelo renderizador de imagem para transmitir o relatório renderizado uma parte por vez. Depois que você usar o parâmetro em uma cadeia de caracteres de acesso à URL, use a mesma cadeia de caracteres, mas substitua o parâmetro PersistStream pelo parâmetro GetNextStream para obter a próxima parte no fluxo persistente. Esse comando URL finalmente retornará um fluxo de 0 byte para indicar o término do fluxo persistente. O valor padrão é false.

GetNextStream

Obtém a próxima parte de dados de um fluxo persistente cujo acesso é por meio do parâmetro PersistStream. Para obter mais informações, consulte a descrição de PersistStream. O valor padrão é false.

Comandos da Web Part do Report Viewer

A tabela a seguir descreve os novos nomes de parâmetro de relatório reservado do SQL Server 2008 que são usados para focar a Web Part do Report Viewer quando a Reporting Services é integrada ao Windows SharePoint Services (WSS) 3.0 ou MicrosoftOffice SharePoint Server (MOSS) 2007. Esses nomes de parâmetro são prefixados com rv:. A Web Part do Report Viewer também aceita o parâmetro rs:ParameterLanguage.

Parâmetro

Ação

Toolbar

Controla a exibição da barra de ferramentas para a Web Part do Report Viewer. O valor padrão é Full. Os valores podem ser:

  • Full: exiba a barra de ferramentas completa.

  • Navigation: exiba apenas a paginação na barra de ferramentas.

  • None: não exiba a barra de ferramentas.

HeaderArea

Controla a exibição do cabeçalho para a Web Part do Report Viewer. O valor padrão é Full. Os valores podem ser:

  • Full: exiba o cabeçalho completo.

  • BreadCrumbsOnly: exiba apenas a navegação da trilha no cabeçalho para informar ao usuário sua localização no aplicativo.

  • None: não exiba o cabeçalho.

DocMapAreaWidth

Controla a largura de exibição, em pixels, da área de parâmetro na Web Part do Report Viewer. O valor padrão é o mesmo do padrão da Web Part do Report Viewer. O valor deve ser um inteiro não negativo.

AsyncRender

Controla se um relatório é renderizado de forma assíncrona. O valor padrão é true, que especifica que um relatório deve ser renderizado de forma assíncrona. O valor deve ser um Booleano true ou false.

Exemplos

Este exemplo oculta a barra de ferramentas do Visualizador de HTML, definindo o valor de parâmetro rc:Toolbar como false:

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Toolbar=false

Este exemplo passa um parâmetro embutido em código e oculta o campo de entrada para parâmetros fornecidos pelo usuário:

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Parameters=false&Year=2002

Este exemplo usa o parâmetro rc:Zoom para definir a propriedade de zoom do relatório como Page Width:

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Zoom=Page Width

Este exemplo alterna a seção 13 do relatório:

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:ShowHideToggle=13

Consulte também

Referência

Outros recursos