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:
|
HeaderArea |
Controla a exibição do cabeçalho para a Web Part do Report Viewer. O valor padrão é Full. Os valores podem ser:
|
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