Delen via


Naslaginformatie over URL-toegangsparameters

U kunt parameters gebruiken als onderdeel van een URL om het uiterlijk van uw RAPPORTEN van SQL Server 2016 (13.x) Reporting Services of hoger (SSRS) te configureren. In dit artikel worden de meest gebruikte parameters beschreven.

Parameters zijn niet hoofdlettergevoelig. Ze hebben een voorvoegsel nodig:

  • rs:: Is gericht op de rapportserver.
  • rc:: Is gericht op een HTML-viewer.
  • rv:: Is gericht op het webonderdeel Rapportviewer.

U kunt ook parameters opgeven die specifiek zijn voor apparaten of renderingextensies. Zie Instellingen voor apparaatgegevens opgeven in een URL voor meer informatie over apparaatspecifieke parameters.

HTML Viewer-opdrachten (rc:)

Richt de HTML Viewer op met behulp van het voorvoegsel rc:.

Opdracht Kenmerk Beschrijving
Toolbar True Hiermee wordt de werkbalk weergegeven. De standaardwaarde is waar.

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

Opmerking: Als u deze parameter weglaat, wordt de werkbalk automatisch weergegeven voor renderingindelingen die deze ondersteunen.
Toolbar False Hiermee verbergt u de werkbalk. Als deze parameter onwaar is, worden alle resterende opties genegeerd.

Voorbeeld: https://myrshost/reportserver?/Sales&rc:Toolbar=False
Parameters True Geeft het parametersgebied van de werkbalk weer. De standaardwaarde is waar.

Voorbeeld: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed
Parameters False Hiermee verbergt u het parametergebied en kan de gebruiker het niet weergeven.
Parameters Collapsed Hiermee verbergt u het parametersgebied, maar de gebruiker kan deze in-/uitschakelen om het te zien.

Voorbeelden:

Systeemeigen modus: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint-modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Zoom Page Width Stel de zoomfunctie van het rapport in op de paginabreedte.

Voorbeelden:

Systeemeigen modus: https://myrshost/reportserver?/Sales&rc:Zoom=Page%20Width

SharePoint-modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width
Zoom Whole Page Stel de zoomfunctie van het rapport in op de hele pagina.
Zoom <integer percentage> Stel de zoomfunctie van het rapport in op een specifiek percentage. De standaardwaarde is 100.
Section <page number> Stel in welke pagina in het rapport moet worden weergegeven. Elke waarde die groter is dan het aantal pagina's in het rapport, geeft de laatste pagina weer. Elke waarde kleiner dan 0 geeft pagina 1 van het rapport weer. De standaardwaarde is 1.

Voorbeelden:

Systeemeigen modus: https://myrshost/reportserver?/Sales&rc:Section=2

SharePoint-modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2
FindString <text> Zoek in een rapport naar een specifieke set tekst en markeer de tekst. Notitie:rc:FindString werkt alleen als u de URL-toegangstekenreeks opneemt rc:Toolbar=false .

Voorbeelden:

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

SharePoint-modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400
StartFind <start page> Geef de eerste sectie op die u wilt doorzoeken. De standaardwaarde is de eerste pagina van het rapport.

Voorbeeld:

Systeemeigen modus: https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400
EndFind <end page> Stel het nummer in van de laatste pagina die u wilt gebruiken in de zoekopdracht. De standaardwaarde is het nummer van de huidige pagina. Gebruik deze parameter met de StartFind parameter.

Voorbeeld: Zie het StartFind voorbeeld.
FallbackPage <page number> Stel het aantal pagina's in dat moet worden weergegeven als een zoekopdracht of een documentkaartselectie mislukt. De standaardwaarde is het nummer van de huidige pagina.
GetImage <icon name> Haal een bepaalde afbeelding op voor de gebruikersinterface van HTML Viewer.
Icon <icon name> Haal het pictogram van een bepaalde renderingsextensie op.
Stylesheet <stylesheet file name> Geef een opmaakmodel op dat u wilt toepassen op de HTML-viewer.
Instelling voor apparaatgegevens Geef een instelling voor apparaatgegevens op in de vorm van rc:tag=value, waarbij tag de naam van een apparaatgegevensinstelling is die specifiek is voor de renderingextensie. Zie de beschrijving van de Format opdracht voor meer informatie.

U kunt de OutputFormat instelling voor apparaatgegevens voor de renderingsextensie IMAGE gebruiken om het rapport weer te geven aan een JPEG-afbeelding met behulp van de volgende parameters in de URL-toegangsreeks: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG Zie Instellingen voor apparaatgegevens voor renderingextensies (Reporting Services) voor meer informatie over alle extensiespecifieke apparaatinformatie-instellingen.

Opdrachten voor rapportservers (rs:)

Richt u op de rapportserver met behulp van het voorvoegsel rs:.

Opdracht Kenmerk Beschrijving
Command ListChildren en GetChildren De inhoud van een map weergeven. De mapitems worden weergegeven op een algemene pagina met itemnavigatie.

Voorbeelden:

Systeemeigen modus: https://myrshost/reportserver?/Sales&rs:Command=GetChildren

Een benoemd exemplaar in de systeemeigen modus: https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildren

SharePoint-modus:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren
Command Render Het rapport wordt weergegeven in de browser, zodat u het kunt bekijken.

Voorbeelden:

Systeemeigen modus:https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

SharePoint-modus:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
Command GetSharedDatasetDefinition Geef de XML-definitie weer die is gekoppeld aan een gedeelde gegevensset. Eigenschappen van gedeelde gegevenssets worden opgeslagen in de definitie. Deze eigenschappen omvatten de query, gegevenssetparameters, standaardwaarden, gegevenssetfilters en gegevensopties, zoals sortering en hoofdlettergevoeligheid. U moet de machtiging Rapportdefinitie lezen hebben voor een gedeelde gegevensset om deze waarde te kunnen gebruiken.

Voorbeeld:

Systeemeigen modus: https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
Command GetDataSourceContents De eigenschappen van een bepaalde gedeelde gegevensbron weergeven als XML. Als uw browser XML ondersteunt en u een geverifieerde gebruiker bent met de machtiging Inhoud lezen voor de gegevensbron, wordt de definitie van de gegevensbron weergegeven.

Voorbeelden:

Systeemeigen modus: https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

SharePoint-modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents
Command GetResourceContents Geef een resource weer en geef deze weer op een HTML-pagina als de resource compatibel is met de browser. Anders kunt u ervoor kiezen om het bestand of de resource op schijf te openen of op te slaan.

Voorbeelden:

Systeemeigen modus: https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

SharePoint-modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
Command GetComponentDefinition De XML-definitie weergeven die is gekoppeld aan een gepubliceerd rapportitem. U moet de machtiging Inhoud lezen hebben voor een gepubliceerd rapportitem om deze waarde te kunnen gebruiken.
Format HTML5
PPTX
ATOM
HTML4.0
MHTML
IMAGE
EXCEL (voor .xls)
EXCELOPENXML (voor .xlsx)
WORD (voor .doc)
WORDOPENXML (voor .docx)
CSV
PDF
XML
Geef de indeling op waarin u een rapport wilt weergeven en weergeven. De standaardwaarde is HTML5. Zie Een rapport exporteren met behulp van URL-toegang voor meer informatie. Zie de \<Render> extensiesectie van het rapportserverbestand rsreportserver.config voor een volledige lijst. Zie RsReportServer.config configuratiebestand voor meer informatie.

Voorbeelden:

Systeemeigen modus: https://myrshost/ReportServer?/myreport&rs:Format=PDF

SharePoint-modus: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF
ParameterLanguage en-us, de-DE, enz. Geef een taal op voor parameters die zijn doorgegeven in een URL die onafhankelijk is van de browsertaal. De standaardwaarde is de taal van de browser.

Voorbeeld:

Systeemeigen modus: https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE
Snapshot Een rapport weergeven op basis van een momentopname van de rapportgeschiedenis. Zie Een momentopname van een rapportgeschiedenis weergeven met behulp van URL-toegang voor meer informatie.

Voorbeeld:

Systeemeigen modus: https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02
PersistStreams true
false
Een rapport weergeven in één persistente stream. De weergave van de afbeelding gebruikt deze parameter om het weergegeven rapport één segment tegelijk te verzenden. Nadat u deze parameter in een URL-toegangstekenreeks hebt gebruikt, gebruikt u dezelfde URL-toegangsreeks met de GetNextStream parameter in plaats van de PersistStreams parameter om het volgende segment in de persistente stream op te halen. Met deze URL-opdracht wordt uiteindelijk een 0-bytestream geretourneerd om het einde van de persistente stream aan te geven. De standaardwaarde is onwaar.
GetNextStream true
false
Haal het volgende gegevenssegment op in een persistente stream die toegankelijk is met behulp van de PersistStreams parameter. Zie de beschrijving van de PersistStreams opdracht voor meer informatie. De standaardwaarde is onwaar.
SessionID Geef een tot stand gebrachte actieve rapportsessie op tussen de clienttoepassing en de rapportserver. De waarde van deze parameter is ingesteld op de sessie-id.

U kunt de sessie-id opgeven als een cookie of als onderdeel van de URL. Wanneer u de rapportserver configureert om geen sessiecookies te gebruiken, resulteert de eerste aanvraag zonder een opgegeven sessie-id in een omleiding met een sessie-id. Zie Uitvoeringsstatus identificeren voor meer informatie over rapportserversessies.
ClearSession true
false
Verwijder alle rapportexemplaren die zijn gekoppeld aan een geverifieerde gebruiker uit de rapportsessie. Een rapportexemplaren worden meerdere keren als hetzelfde rapport uitgevoerd met verschillende rapportparameterwaarden. De standaardwaarde is onwaar. Geldige waarden zijn true en false.
ResetSession true
false
Stel de rapportsessie opnieuw in door de koppeling van de rapportsessie met alle rapportmomentopnamen te verwijderen. De standaardwaarde is onwaar. Geldige waarden zijn true en false.
ShowHideToggle <positive integer> Hiermee schakelt u de weergave en verbergt u de status van een sectie van het rapport. Geef een positief geheel getal op dat de sectie aangeeft die u wilt in- of uitschakelen.

Opdrachten voor webonderdelen rapportviewer (rv:)

Richt het webonderdeel Rapportviewer op dat met SharePoint kan worden geïntegreerd met behulp van het voorvoegsel rv:. Het webonderdeel Report Viewer accepteert ook de rs:ParameterLanguage parameter.

Opdracht Kenmerk Beschrijving
Toolbar Full Hiermee wordt de volledige werkbalk weergegeven. De standaardwaarde is Vol.
Toolbar Navigation Geeft alleen paginering weer in de werkbalk.

Voorbeeld:

SharePoint-modus: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation
Toolbar None De werkbalk wordt niet weergegeven.
HeaderArea Full Geeft de volledige koptekst weer. De standaardwaarde is Vol.
HeaderArea BreadCrumbsOnly Geeft alleen de breadcrumb-navigatie in de koptekst weer om de gebruiker te informeren waar deze zich in de toepassing bevindt.

Voorbeeld:

SharePoint-modus: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly
HeaderArea None Hiermee verbergt u de koptekst.
DocMapAreaWidth De weergavebreedte, in pixels, van het parametergebied in het webonderdeel Report Viewer beheren. De standaardwaarde is hetzelfde als het webonderdeel Report Viewer. De waarde moet een niet-negatief geheel getal zijn.
AsyncRender true
false
Bepalen of een rapport asynchroon wordt weergegeven. De standaardwaarde is waar, waarmee wordt aangegeven dat een rapport asynchroon wordt weergegeven. De waarde moet een Booleaanse waarde van waar of onwaar zijn.
ParamMode Full Geeft het gebied met parameterprompt weer. De standaardwaarde is Vol.
Collapsed Hiermee wordt het gebied met de parameterprompt samengevouwen.

Voorbeeld:

SharePoint-modus: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed
ParamMode Hidden Hiermee verbergt u het gebied met parameterprompts.
DocMapMode Full Hiermee wordt het documentoverzichtsgebied weergegeven. De standaardwaarde is Vol.
DocMapMode Collapsed Hiermee wordt het documentoverzichtsgebied samengevouwen.
DocMapMode Hidden Hiermee verbergt u het documentoverzichtsgebied.
DockToolBar Top Dockt de werkbalk bovenaan. De standaardwaarde is Top.
DockToolBar Bottom Dockt de werkbalk onderaan.

Voorbeeld:

SharePoint-modus: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom
ToolBarItemsDisplayMode 1 (0x1) Vorige knop
ToolBarItemsDisplayMode 2 (0x2) Besturingselementen voor zoeken in tekst
ToolBarItemsDisplayMode 4 (0x4) Besturingselementen voor paginanavigatie
ToolBarItemsDisplayMode 8 (0x8) Knop Vernieuwen
ToolBarItemsDisplayMode 16 (0x10) Keuzelijst in- en uitzoomen
ToolBarItemsDisplayMode 32 (0x20) Knop Atom Feed
ToolBarItemsDisplayMode 64 (0x40) Menuoptie Afdrukken in Acties
ToolBarItemsDisplayMode 128 (0x80) Submenu Exporteren in Acties
ToolBarItemsDisplayMode 256 (0x100) Openen met menuoptie Report Builder in Acties
ToolBarItemsDisplayMode 512 (0x200) Menuoptie Abonneren in Acties
ToolBarItemsDisplayMode 1024 (0x400) Menuoptie Nieuwe gegevenswaarschuwing in Acties
ToolBarItemsDisplayMode Meerdere waarden Bepalen welke werkbalkitems moeten worden weergegeven. Deze waarde is een bitwise opsommingswaarde. Als u een werkbalkitem wilt opnemen, voegt u de waarde van het item toe aan de totale waarde. Als u bijvoorbeeld geen menu Acties gebruikt rv:ToolBarItemsDisplayMode=63 (of 0x3F), is dit 1+2+4+8+16+32. Gebruik (of) voor rv:ToolBarItemsDisplayMode=960 alleen menu-items acties ( of 0x3C0). De standaardwaarde is -1, die alle werkbalkitems bevat. Geldige waarden zijn:

Voorbeeld:

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