Partilhar via

Referência de parâmetro de acesso a URL

Você pode usar parâmetros como parte de uma URL para configurar a aparência de seus relatórios do SQL Server 2016 (13.x) Reporting Services ou posteriores (SSRS). Este artigo descreve os parâmetros mais comumente usados.

Os parâmetros não diferenciam maiúsculas de minúsculas. Eles exigem um prefixo:

  • rs:: Destina-se ao servidor de relatório.
  • rc:: Destina-se a um visualizador HTML.
  • rv:: Destina-se à Web Part do Visualizador de Relatórios.

Você também pode especificar parâmetros específicos para dispositivos ou extensões de renderização. Para obter mais informações sobre parâmetros específicos do dispositivo, consulte Especificar configurações de informações do dispositivo em uma URL.

Comandos do Visualizador de HTML (rc:)

Direcione o Visualizador de HTML usando o prefixo rc:.

Comando Parâmetro Descrição
Toolbar True Exibe a barra de ferramentas. O valor padrão é true.

Exemplo: https://myrshost/reportserver?/Sales&rc:Toolbar=True

Nota: Se você omitir esse parâmetro, a barra de ferramentas será exibida automaticamente para formatos de renderização que o suportam.
Toolbar False Oculta a barra de ferramentas. Se esse parâmetro for false, todas as opções restantes serão ignoradas.

Exemplo: https://myrshost/reportserver?/Sales&rc:Toolbar=False
Parameters True Exibe a área de parâmetros da barra de ferramentas. O valor padrão é true.

Exemplo: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed
Parameters False Oculta a área de parâmetros e o usuário não pode exibi-la.
Parameters Collapsed Oculta a área de parâmetros, mas o usuário pode alternar para vê-la.

Exemplos:

Modo nativo: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

Modo do SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Zoom Page Width Defina o zoom do relatório para se ajustar à largura da página.

Exemplos:

Modo nativo: https://myrshost/reportserver?/Sales&rc:Zoom=Page%20Width

Modo do SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width
Zoom Whole Page Defina o zoom do relatório para caber em toda a página.
Zoom <integer percentage> Defina o zoom do relatório para uma porcentagem específica. O valor padrão é 100.
Section <page number> Defina qual página do relatório será exibida. Qualquer valor maior que o número de páginas no relatório exibe a última página. Qualquer valor inferior a 0 exibe a página 1 do relatório. O valor padrão é 1.

Exemplos:

Modo nativo: https://myrshost/reportserver?/Sales&rc:Section=2

Modo do SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2
FindString <text> Pesquise um conjunto específico de texto num relatório e realce o texto. Observação:rc:FindString não funciona a menos que você inclua rc:Toolbar=false na cadeia de caracteres de acesso à URL.

Exemplos:

Modo nativo: https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400

Modo do SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400
StartFind <start page> Especifique a primeira seção a ser pesquisada. O valor padrão é a primeira página do relatório.

Exemplo:

Modo nativo: https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400
EndFind <end page> Defina o número da última página que pretende utilizar na pesquisa. O valor padrão é o número da página atual. Use este parâmetro com o StartFind parâmetro.

Exemplo: Veja o StartFind exemplo.
FallbackPage <page number> Defina o número da página a ser exibido se uma pesquisa ou uma seleção de mapa de documento falhar. O valor padrão é o número da página atual.
GetImage <icon name> Obtenha uma imagem específica para a interface do usuário do Visualizador de HTML.
Icon <icon name> Obtenha o ícone de uma extensão de renderização específica.
Stylesheet <stylesheet file name> Especifique uma folha de estilos que deseja aplicar ao Visualizador de HTML.
Configuração de informações do dispositivo Especifique uma configuração de informações do dispositivo na forma de , onde tag é o nome de uma configuração de informações do dispositivo específica para a extensão de rc:tag=valuerenderização. Para obter mais informações, consulte a descrição do Format comando.

Você pode usar a configuração de informações do OutputFormat dispositivo para a extensão de renderização IMAGE para renderizar 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 extensões de renderização (Reporting Services).

Comandos do servidor de relatório (rs:)

Direcione o servidor de relatório usando o prefixo rs:.

Comando Parâmetro Descrição
Command ListChildren e GetChildren Exiba o conteúdo de uma pasta. Os itens de pasta são exibidos em uma página de navegação de item genérica.

Exemplos:

Modo nativo: https://myrshost/reportserver?/Sales&rs:Command=GetChildren

Uma instância nomeada no modo nativo: https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildren

Modo do SharePoint:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren
Command Render O relatório é renderizado no navegador para que você possa visualizá-lo.

Exemplos:

Modo nativo:https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

Modo do SharePoint:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
Command GetSharedDatasetDefinition Exiba a definição XML associada a um conjunto de dados compartilhado. As propriedades do conjunto de dados compartilhado são salvas na definição. Essas propriedades incluem a consulta, parâmetros do conjunto de dados, valores padrão, filtros de conjunto de dados e opções de dados, como agrupamento e diferenciação de maiúsculas e minúsculas. Você deve ter a permissão Ler Definição de Relatório em um conjunto de dados compartilhado para usar esse valor.

Exemplo:

Modo nativo: https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
Command GetDataSourceContents Exiba as propriedades de uma determinada fonte de dados compartilhada como XML. Se o seu navegador oferecer suporte a XML e se você for um usuário autenticado com permissão Ler Conteúdo na fonte de dados, a definição da fonte de dados será exibida.

Exemplos:

Modo nativo: https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

Modo do SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents
Command GetResourceContents Renderize um recurso e exiba-o em uma página HTML se o recurso for compatível com o navegador. Caso contrário, você pode optar por abrir ou salvar o arquivo ou recurso no disco.

Exemplos:

Modo nativo: https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

Modo do SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
Command GetComponentDefinition Exiba a definição XML associada a um item de relatório publicado. Você deve ter a permissão Ler Conteúdo em um item de relatório publicado para usar esse valor.
Format HTML5
PPTX
ATOM
HTML4.0
MHTML
IMAGE
EXCEL (para .xls)
EXCELOPENXML (para .xlsx)
WORD (para .doc)
WORDOPENXML (para .docx)
CSV
PDF
XML		 Especifique o formato no qual renderizar e exibir um relatório. O valor padrão é HTML5. Para obter mais informações, consulte Exportar um relatório usando o acesso à URL. Para obter uma lista completa, consulte a \<Render> seção de extensão do arquivo do servidor rsreportserver.config de relatório. Para obter mais informações, consulte RsReportServer.config arquivo de configuração.

Exemplos:

Modo nativo: https://myrshost/ReportServer?/myreport&rs:Format=PDF

Modo do SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF
ParameterLanguage en-us, de-DE, etc. Forneça um idioma para parâmetros passados em uma URL que seja independente do idioma do navegador. O valor padrão é o idioma do navegador.

Exemplo:

Modo nativo: https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE
Snapshot Renderize um relatório com base em um instantâneo do histórico de relatórios. Para obter mais informações, consulte Renderizar um instantâneo do histórico de relatórios usando o acesso à URL.

Exemplo:

Modo nativo: https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02
PersistStreams true
false		 Renderizar um relatório em um único fluxo persistente. O renderizador de imagem usa esse parâmetro para transmitir o relatório renderizado um pedaço de cada vez. 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 GetNextStream parâmetro em vez do PersistStreams parâmetro para obter a próxima parte no fluxo persistente. Esse comando URL eventualmente retorna um fluxo de 0 bytes para indicar o fim do fluxo persistente. O valor padrão é false.
GetNextStream true
false		 Obtenha o próximo bloco de dados em um fluxo persistente que é acessado usando o PersistStreams parâmetro. Para obter mais informações, consulte a descrição do PersistStreams comando. O valor padrão é false.
SessionID Especifique 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 o ID da sessão como um cookie ou como parte do URL. Quando você configura o servidor de relatório para não usar cookies de sessão, a primeira solicitação sem um ID de sessão especificado resulta em um redirecionamento com um ID de sessão. Para obter mais informações sobre sessões do servidor de relatório, consulte Identificar o estado de execução.
ClearSession true
false		 Remova todas as instâncias de relatório associadas a um usuário autenticado da sessão de relatório. Uma instância de relatório é definida como o mesmo relatório executado várias vezes com valores de parâmetros de relatório diferentes. O valor padrão é false. Os valores válidos são verdadeiro e falso.
ResetSession true
false		 Redefina a sessão de relatório removendo a associação da sessão de relatório com todos os instantâneos de relatório. O valor padrão é false. Os valores válidos são verdadeiro e falso.
ShowHideToggle <positive integer> Alterne o show e oculte o estado de uma seção do relatório. Especifique um inteiro positivo para representar a seção a ser alternada.

Comandos da Web Part do Visualizador de Relatórios (rv:)

Direcione a Web Part do Visualizador de Relatórios que se integra ao SharePoint usando o prefixo rv:. A Web Part do Visualizador de Relatórios também aceita o rs:ParameterLanguage parâmetro.

Comando Parâmetro Descrição
Toolbar Full Exibe a barra de ferramentas completa. O valor padrão é Full.
Toolbar Navigation Exibe apenas paginação na barra de ferramentas.

Exemplo:

Modo do SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation
Toolbar None Não exibe a barra de ferramentas.
HeaderArea Full Exibe o cabeçalho completo. O valor padrão é Full.
HeaderArea BreadCrumbsOnly Exibe apenas a navegação de trilha no cabeçalho para informar ao usuário onde eles estão no aplicativo.

Exemplo:

Modo do SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly
HeaderArea None Oculta o cabeçalho.
DocMapAreaWidth Controle a largura de exibição, em pixels, da área de parâmetros na Web Part do Visualizador de Relatórios. O valor padrão é o mesmo que o padrão da Web Part do Visualizador de Relatórios. O valor deve ser um número inteiro não negativo.
AsyncRender true
false		 Controle se um relatório é renderizado de forma assíncrona. O valor padrão é true, que especifica que um relatório seja processado de forma assíncrona. O valor deve ser um valor booleano de true ou false.
ParamMode Full Exibe a área de prompt de parâmetro. O valor padrão é Full.
Collapsed Recolhe a área de prompt de parâmetro.

Exemplo:

Modo do SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed
ParamMode Hidden Oculta a área de prompt de parâmetro.
DocMapMode Full Exibe a área do mapa do documento. O valor padrão é Full.
DocMapMode Collapsed Recolhe a área do mapa do documento.
DocMapMode Hidden Oculta a área do mapa do documento.
DockToolBar Top Encaixa a barra de ferramentas na parte superior. O valor padrão é Top.
DockToolBar Bottom Encaixa a barra de ferramentas na parte inferior.

Exemplo:

Modo do SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom
ToolBarItemsDisplayMode 1 (0x1) botão Voltar
ToolBarItemsDisplayMode 2 (0x2) Controles de pesquisa de texto
ToolBarItemsDisplayMode 4 (0x4) Controles de navegação de página
ToolBarItemsDisplayMode 8 (0x8) Botão Atualizar
ToolBarItemsDisplayMode 16 (0x10) Caixa de listagem Zoom
ToolBarItemsDisplayMode 32 (0x20) Botão Atom Feed
ToolBarItemsDisplayMode 64 (0x40) Opção do menu Imprimir em Ações
ToolBarItemsDisplayMode 128 (0x80) Submenu Exportar em Ações
ToolBarItemsDisplayMode 256 (0x100) Abrir com a opção de menu Construtor de Relatórios em Ações
ToolBarItemsDisplayMode 512 (0x200) Opção do menu Subscrever em Ações
ToolBarItemsDisplayMode 1024 (0x400) Opção do menu Novo Alerta de Dados em Ações
ToolBarItemsDisplayMode Vários valores Controle quais itens da barra de ferramentas exibir. Esse valor é um valor de enumeração bitwise. Para incluir um item da 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. Apenas para itens do menu Ações , 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:

Exemplo:

Modo do SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

Conteúdo relacionado

  • Last updated on