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. .gif "Observação importante") Importante
rc:Toolbar=false não funciona para cadeias de caracteres de acesso a URL que usam um endereço IP, em vez de um nome de domínio, para definir um relatório armazenado em um site do SharePoint como destino.
|
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 Internet Explorer anteriores ao Internet Explorer 5.0 e todos os navegadores 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. |
PersistStreams |
Renderiza um relatório em um único fluxo persistido. Esse parâmetro é usado pelo renderizador de imagem para transmitir uma parte de cada vez do relatório renderizado. Depois de usar esse parâmetro em uma cadeia de caracteres de acesso a URL, use a mesma cadeia de caracteres de acesso a URL com o parâmetro GetNextStream em vez do parâmetro PersistStreams para obter a próxima parte do fluxo persistido. Esse comando URL retornará eventualmente um fluxo de 0 byte para indicar o fim do fluxo persistido. O valor padrão é false. |
GetNextStream |
Obtém a próxima parte de dados em um fluxo persistido que é acessado usando o parâmetro PersistStreams. Para obter mais informações, consulte a descrição de PersistStreams. O valor padrão é false. |
Comandos da Web Part do Visualizador de Relatórios
A tabela a seguir descreve os nomes dos parâmetros de relatório reservados do SQL Server que são usados para focar a Web Part do Visualizador de Relatórios quando o Reporting Services está integrado com o Windows SharePoint Services (WSS) 3.0 ou posterior, bem como com o Microsoft Office SharePoint Server 2007 ou posterior. Esses nomes de parâmetro são prefixados com rv:. A Web Part do Visualizador de Relatórios 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 booliano true ou false. |
ParamMode |
Controla como a área de prompt de parâmetro de Web Part do Visualizador de Relatórios é exibida na página inteira. Os valores válidos são:
O valor padrão é Full. |
DocMapMode |
Controla como a área de mapa de documento de Web Part do Visualizador de Relatórios é exibida na página inteira. Os valores válidos são:
O valor padrão é Full. |
DockToolBar |
Controla se a barra de ferramentas de Web Part do Visualizador de Relatórios é fixada na parte superior ou inferior. Os valores válidos são Top e Bottom. O valor padrão é Top. |
ToolBarItemsDisplayMode |
Controla quais itens da barra de ferramentas são exibidos. Esse é um valor de enumeração bit a bit. Para incluir um item de barra de ferramentas, adicione o valor do item ao valor total. Por exemplo: para não ter o menu Ações, use rv:ToolBarItemsDisplayMode=63 (ou 0x3F), que é 1+2+4+8+16+32; para somente itens do menu Ações, use rv:ToolBarItemsDisplayMode=960 (ou 0x3C0). Os valores válidos são:
O valor padrão é -1, que inclui todos os itens da barra de ferramentas. |
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