Referência de parâmetro de acesso de 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 Especificar configurações de informações do dispositivo em uma URL.
.gif "Observação importante") Importante |
|---|
É importante que a URL inclua a sintaxe do proxy _vti_bin para rotear a solicitação através do SharePoint e do proxy HTTP Reporting Services. O proxy adiciona qualquer contexto à solicitação HTTP, o contexto necessário para garantir a execução adequada do relatório para servidores de relatório no modo do SharePoint. Para obter exemplos, consulte Acessar itens do Servidor de Relatório usando o acesso à URL. |
Para obter informações sobre como incluir parâmetros do relatório em uma URL, e exemplos, consulte Transmitir um parâmetro de relatório em uma URL.
Comandos do Visualizador HTML (rc:)
A tabela a seguir descreve os parâmetros de acesso a URL que são prefixados com rc: e usados com o Visualizador de HTML como destino.
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. Para obter um exemplo no modo do Native. Para obter um exemplo no modo do SharePoint. |
||
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. Para obter um exemplo no modo do Native. Para obter um exemplo no modo do SharePoint. |
||
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. Por exemplo, no modo Native, para exibir a página 2 do relatório. Por exemplo, no modo SharePoint, para exibir a página 2 do relatório. |
||
FindString |
Pesquise um relatório por um conjunto específico de texto. Para obter um exemplo no modo do Native. Para obter um exemplo no modo do SharePoint. |
||
StartFind |
Especifica a última seção a ser pesquisada. O valor padrão desse parâmetro é a última página do relatório. Para obter um exemplo no modo Native que procura a primeira ocorrência do texto "Mountain-400" no relatório de exemplo Catálogo de Produtos começando pela primeira página e terminando na página cinco. |
||
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. Consulte o exemplo acima. |
||
FallbackPage |
Define o número da página a ser exibido em caso de falha em uma pesquisa ou em uma seleção do mapa do 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. |
||
Configuração de informações de dispositivo |
Especifica uma configuração de informações de dispositivo no formulário de rc:tag=value, onde tag é o nome de uma configuração de informações de dispositivo específicas à extensão de renderização usada atualmente (consulte a descrição do parâmetro Format). Por exemplo, você pode usar a configuração de informações de dispositivo OutputFormat para a extensão de renderização de IMAGE para renderizar o relatório em uma imagem JPEG por meio dos parâmetros a seguir na cadeia de caracteres de acesso à URL: …&rs:Format=IMAGE&rc:OutputFormat=JPEG. Para obter mais informações sobre todas as configurações de informações de dispositivo específicas à extensão, consulte Configurações de informações de dispositivos para extensões de renderização (Reporting Services). |
Comandos do servidor de relatório (rs:)
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 |
Executa uma ação em um item do catálogo, dependendo do tipo do item. O valor padrão é determinado pelo tipo do item do catálogo referenciado na cadeia de caracteres de acesso à URL. Os valores válidos são:
|
Format |
Especifica o formato no qual um relatório deve ser renderizado. Os valores comuns incluem ATOM, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML. O valor padrão é HTML4.0. Para obter mais informações, consulte Exportar um relatório com acesso à URL. Por exemplo, para obter uma cópia em PDF de um relatório diretamente de um servidor de relatório de modo Native. Para obter um exemplo no modo do SharePoint. |
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. Por exemplo, no modo Native, para substituir o idioma do navegador e especificar um valor de cultura 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 Renderizar instantâneo de histórico de relatório com o acesso à URL. Por exemplo, no modo Native, recuperar um instantâneo de histórico de relatórios datado de 2003-04-07 com um carimbo de data/hora de 13:40:02. |
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. |
SessionID |
Especifica uma sessão de relatório ativa estabelecida entre o aplicativo cliente e o servidor de relatório. O valor desse parâmetro é definido como o identificador de sessão. Você pode especificar a ID da sessão como um cookie ou como parte da URL. Quando o servidor de relatório tiver sido configurado para não usar cookies de sessão, a primeira solicitação sem uma ID de sessão especificada resultará no redirecionamento com uma ID de sessão. Para obter mais informações sobre sessões de servidor de relatório, consulte Identificando o estado de execução. |
ClearSession |
Um valor igual a true direciona o servidor de relatório para remover um relatório da sessão de relatório. Todas as instâncias de relatório associadas a um usuário autenticado são removidas da sessão de relatório. (Uma instância de relatório será definida já que o mesmo relatório é executado várias vezes com valores de parâmetro de relatório diferentes). O valor padrão é false. |
ResetSession |
Um valor igual a true direciona o servidor de relatório a redefinir a sessão de relatório com a remoção da associação da sessão de relatório a todos os instantâneos de relatório. O valor padrão é false. |
ShowHideToggle |
Alterna o estado de mostrar e ocultar de uma seção do relatório. Especifique um número inteiro positivo para representar a seção a ser alternada. |
Comandos da Web Part do Visualizador de Relatórios (rv:)
A tabela a seguir descreve os nomes de parâmetros de relatório reservados do SQL Server que são usados para direcionar a Web Part do Visualizador de Relatórios que está integrada com o SharePoint. 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 Visualizador de Relatórios. O valor padrão é Full. Os valores podem ser:
Por exemplo, no SharePoint, para exibir apenas a paginação na barra de ferramentas. |
HeaderArea |
Controla a exibição do cabeçalho para a Web Part do Visualizador de Relatórios. O valor padrão é Full. Os valores podem ser:
Por exemplo, no modo SharePoint, para exibir apenas a navegação da trilha no cabeçalho. |
DocMapAreaWidth |
Controla a largura de exibição, em pixels, da área de parâmetro na Web Part do Visualizador de Relatórios. O valor padrão é o mesmo do padrão da Web Part do Visualizador de Relatórios. 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âmetros da Web Part do Visualizador de Relatórios é exibida na exibição de página inteira. Os valores válidos são:
O valor padrão é Full. Por exemplo, no modo SharePoint, para recolher a área de prompt de parâmetros. |
DocMapMode |
Controla como a área do mapa do documento da Web Part do Visualizador de Relatórios é exibida na exibição de página inteira. Os valores válidos são:
O valor padrão é Full. |
DockToolBar |
Controla se a barra de ferramentas da Web Part do Visualizador de Relatórios é ancorada na parte superior ou na parte inferior. Os valores válidos são Top e Bottom. O valor padrão é Top. Por exemplo, no modo SharePoint, para encaixar a barra de ferramentas na parte inferior. |
ToolBarItemsDisplayMode |
Controlar quais itens da barra de ferramentas são exibidos. Esse é um valor de enumeração de bit a bit. Para incluir um item de barra de ferramentas, adicione o valor do item ao valor total. Por exemplo: para nenhum menu Ações, use rv:ToolBarItemsDisplayMode=63 (ou 0x3F) que é 1+2+4+8+16+32; para itens de menu Ações apenas, 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. Por exemplo, no modo SharePoint, para exibir somente o botão Voltar, os controles de pesquisa de texto, os controles da página de navegação e o botão Atualizar. |