Referência de parâmetro de acesso de URL
Use os parâmetros a seguir como parte de uma URL para configurar a aparência de seus relatórios do . 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 do dispositivo, consulte Especificar as configurações de informações sobre o dispositivo em uma URL.
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 de relatório em uma URL, além de exemplos, consulte Passar um parâmetro de relatório em uma URL.
Comandos do Visualizador HTML (rc:)
A tabela a seguir descreve os parâmetros de acesso à URL prefixados com rc: e são usados para direcionar o Visualizador HTML.
| Parâmetro | Descrição | Valores |
|---|---|---|
| Barra de ferramentas | Mostra ou oculta a barra de ferramentas. ** Importante ** rc:Toolbar= false não funciona para cadeias de caracteres de acesso de URL que usam um endereço IP, em vez de um nome de domínio, para direcionar um relatório hospedado em um site do SharePoint. |
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.true false |
| Parâmetros | Mostra ou oculta a área de parâmetros da barra de ferramentas.Native Exemplo de modo:http://myrshost/reportserver?/Sales&rc:Parameters=CollapsedSharePoint Exemplo de modo:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed |
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. Os valores válidos são:true false Collapsed |
| Zoom | Define o valor de zoom do relatório como uma porcentagem de número inteiro ou uma constante de cadeia de caracteres.Native Exemplo de modo:http://myrshost/reportserver?/Sales&rc:Zoom=Page WidthSharePoint Exemplo de modo:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width |
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. |
| Seção | Define a página do relatório a ser exibida.Native Exemplo de modo para exibir a página 2 do relatório:http://myrshost/reportserver?/Sales&rc:Section=2SharePoint Exemplo de modo para exibir a página 2 do relatório:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2 |
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. |
| FindString | Pesquise um relatório por um conjunto específico de texto.Native Exemplo de modo:http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400SharePoint Exemplo de modo:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400 |
|
| IniciarEncontrar | Especifica a última seção a ser pesquisada.Native que procura a primeira ocorrência do texto "Mountain-400" no relatório de amostra do Catálogo de Produtos, começando com a página um e terminando com a página cinco:https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400 |
O valor padrão desse parâmetro é a última página do relatório. |
| Localização final | 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. Use esse parâmetro junto com o parâmetro StartFind . Consulte o exemplo acima para StartFind . |
O valor padrão é o número da página atual. |
| Página alternativa | 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. | |
| Ícone | Obtém o ícone de uma extensão de renderização específica. | |
| Folha de estilo | 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 na forma de rc:tag=value, em que tag é o nome de uma configuração de informações de dispositivo específico para a extensão de renderização sendo usada no momento (confira a descrição do parâmetro Format). Por exemplo, você pode usar a configuração de informações sobre o dispositivo OutputFormat para que a extensão de renderização de IMAGE renderize o relatório em uma imagem JPEG usando os seguintes parâmetros 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 da extensão, consulte Configurações de informações do dispositivo para renderizar extensões (Reporting Services). |
Comandos do servidor de relatório (rs:)
A tabela a seguir descreve os parâmetros de acesso à URL prefixados com rs: e são usados para direcionar o servidor de relatório.
| Parâmetro | Descrição |
|---|---|
| Comando | 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:ListChildren e GetChildren Exibe o conteúdo de uma pasta. Os itens dessa pasta são exibidos em uma página da navegação de item genérica.Native Exemplo de modo:http://myrshost/reportserver?/Sales&rs:Command=GetChildrenSharePoint Exemplo de modo:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren |
Render Renderiza o relatório especificado.Native Exemplo de modo:http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderSharePoint Exemplo de modo:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render |
|
GetSharedDatasetDefinition Exibe a definição XML associada a um conjunto de dados compartilhado. As propriedades do conjunto de dados compartilhado, inclusive a consulta, os parâmetros do conjunto de dados, os valores padrão, os filtros de conjunto de dados e as opções de dados, como ordenação e diferenciação entre maiúsculas e minúsculas, são salvas na definição. É necessário ter a permissão Ler Definição de Relatório em um conjunto de dados compartilhado para usar esse valor.Native Exemplo de modo:https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition |
|
GetDataSourceContents Exibe as propriedades de uma determinada fonte de dados compartilhada como XML. Se houver suporte para XML em seu navegador e se você for um usuário autenticado com a permissão Read Contents na fonte de dados, a definição de fonte de dados será exibida.Native Exemplo de modo:http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContentsSharePoint Exemplo de modo:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents |
|
GetResourceContents Renderiza um recurso e o exibe em uma página HTML se o recurso for compatível com o navegador. Caso contrário, você será solicitado a abrir ou salvar o arquivo ou recurso em disco.Native Exemplo de modo:http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsSharePoint Exemplo de modo:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
|
GetComponentDefinition Exibe a definição XML associada a um item de relatório publicado. Você deve ter Read Contents permissão em um item de relatório publicado para usar esse valor. |
|
| Formato | 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 saber mais, confira Export a Report Using URL Access.Por exemplo, para obter uma cópia em PDF de um relatório diretamente de um servidor de relatório de modo Native.http://myrshost/ReportServer?/myreport&rs:Format=PDFPor exemplo, no SharePoint modo.http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF |
| Linguagem de parâmetros | 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.http://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE |
| Instantâneo | Renderiza um relatório com base em um instantâneo de histórico de relatório. Para obter mais informações, consulte Renderizar um instantâneo de histórico de relatório usando 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.http://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13: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 à URL, use a mesma cadeia de caracteres de acesso à 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 acessado com o parâmetro PersistStreams . Para obter mais informações, consulte a descrição de PersistStreams. O valor padrão é false. |
| ID da sessão | 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 as sessões do servidor de relatório, consulte Identificando o estado de execução. |
| Limpar sessão | 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 é definida como a mesma execução de relatório várias vezes com diferentes valores de parâmetro de relatório.) 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. |
| MostrarOcultarAlternar | 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âmetro de relatório reservados do SQL Server que são usados para direcionar a Web Part do Visualizador de Relatórios integrada ao SharePoint. Esses nomes de parâmetro são prefixados com rv: . A Web Part Visualizador de Relatórios também aceita o parâmetro rs:ParameterLanguage .
| Parâmetro | Ação |
|---|---|
| Barra de ferramentas | 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:Full: exiba a barra de ferramentas completa.Navigation: exibir apenas a paginação na barra de ferramentas.None: não exibir a barra de ferramentas.Por exemplo, no SharePoint, para exibir apenas a paginação na barra de ferramentas.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation |
| Área de cabeçalho | 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:Full: exiba o cabeçalho completo.BreadCrumbsOnly: exibir apenas a navegação da trilha no cabeçalho para informar ao usuário sua localização no aplicativo.None: não exibir o cabeçalho.Por exemplo, no modo SharePoint, para exibir apenas a navegação da trilha no cabeçalho.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly |
| 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. |
| Renderização 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. |
| Modo de Parada | Controla como a área de prompt de parâmetros da Web Part do Visualizador de Relatórios é mostrada na exibição de página inteira. O valor padrão é Full. Os valores válidos são:Full: exibir a área de prompt de parâmetros.Collapsed: recolhe a área de prompt de parâmetros.Hidden: ocultar a área de prompt de parâmetros.Por exemplo, no modo SharePoint, para recolher a área de prompt de parâmetros.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed |
| DocMapMode | Controla como a área do mapa do documento da Web Part do Visualizador de Relatórios é mostrada na exibição de página inteira. O valor padrão é Full. Os valores válidos são:Full: exibi a área de mapa do documento.Collapsed: recolher a área de mapa do documento.Hidden: ocultar a área de mapa do documento. |
| Barra de ferramentas do Dock | Controla se a barra de ferramentas da Web Part do Visualizador de Relatórios está encaixada 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.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom |
| 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). O valor padrão é -1, que inclui todos os itens da barra de ferramentas. Os valores válidos são:1 (0x1): o botão Voltar 2 (0x2): os controles de pesquisa de texto 4 (0x4): os controles de navegação da página 8 (0x8): o botão Atualizar 16 (0x10): a caixa de listagem Zoom 32 (0x20): o botão Feed Atom 64 (0x40): a opção de menu Imprimir em Ações 128 (0x80): o submenu Exportar em Ações 256 (0x100): a opção de menu Abrir com o Construtor de Relatórios em Ações 512 (0x200): a opção de menu Assinar em Ações 1024 (0x400): a opção de menu Novo Alerta de Dados em Ações Por exemplo, no SharePoint modo para exibir apenas o botão Voltar , controles de pesquisa de texto, controles de navegação de página e o botão Atualizar .http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |