Справочник по параметрам доступа по URL-адресу
Параметры можно использовать как часть URL-адреса для настройки внешнего вида отчетов SQL Server 2016 (13.x) Reporting Services или более поздних версий (SSRS). В этой статье описываются наиболее часто используемые параметры.
Параметры не учитывает регистр. Для них требуется префикс:
rs:: предназначен для сервера отчетов.rc:: предназначен для средства просмотра HTML.rv:: предназначен для веб-части средства просмотра отчетов.
Также можно указать конкретные параметры устройств или модулей подготовки отчетов. Дополнительные сведения о параметрах, определяемых устройством, см. в разделе Указание настройки сведений об устройстве в URL-адресе.
Внимание
Для сервера отчетов в режиме SharePoint важно, чтобы URL-адрес включает _vti_bin синтаксис прокси-сервера для маршрутизации запроса через SharePoint и HTTP-прокси служб Reporting Services. Прокси-сервер добавляет в HTTP-запрос контекст, чтобы правильно выполнять отчет для серверов отчетов в режиме интеграции с SharePoint. Примеры см. в разделе "Доступ к элементам сервера отчетов" с помощью URL-адреса.
Интеграция служб Reporting Services с SharePoint больше не доступна после выхода SQL Server 2016.
Команды средства просмотра HTML (rc:)
Нацелите средство просмотра HTML с помощью префикса rc:.
| Команда | Параметр | Описание |
|---|---|---|
Toolbar |
True |
Отображает панель инструментов. Значение по умолчанию — true Примечание. Если этот параметр опущен, панель инструментов автоматически отображается для форматов отрисовки, поддерживающих ее. |
Toolbar |
False |
Скрывает панель инструментов. Если этот параметр имеет значение false, все остальные параметры игнорируются. |
Toolbar |
Navigation |
на панели инструментов отображается только разбиение на страницы. |
Parameters |
True |
Отображает область параметров панели инструментов. Значение по умолчанию — true Примеры: Собственный режим: https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedРежим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Parameters |
False |
Скрывает область параметров, и пользователь не может отобразить его. |
Parameters |
Collapsed |
Скрывает область параметров, но пользователь может переключаться на нее. Примеры: Собственный режим: https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedРежим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Zoom |
Page Width |
Задайте масштаб отчета, чтобы он соответствовал ширине страницы. Примеры: Собственный режим: https://myrshost/reportserver?/Sales&rc:Zoom=Page%20WidthРежим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width |
Zoom |
Whole Page |
Задайте масштаб отчета, чтобы он соответствовал всей странице. |
Zoom |
<integer percentage> |
Задайте для отчета размер определенного процента. Значение по умолчанию — 100. |
Section |
<page number> |
Задайте для отображения страницы отчета. Любое значение, превышающее количество страниц в отчете, отображает последнюю страницу. Любое значение меньше 0 отображает страницу 1 отчета. Значение по умолчанию — 1. Примеры: Собственный режим: https://myrshost/reportserver?/Sales&rc:Section=2Режим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2 |
FindString |
<text> |
Выполните поиск отчета по определенному набору текста и выделите текст. Примечание. rc:FindString Не работает, если вы не включаете rc:Toolbar=false в строку доступа ПО URL-адреса.Примеры: Собственный режим: https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400Режим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400 |
StartFind |
<start page> |
Укажите первый раздел для поиска. Значение по умолчанию — первая страница отчета. Пример: Собственный режим: https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400 |
EndFind |
<end page> |
Задайте номер последней страницы, которую вы хотите использовать в поиске. Значением по умолчанию является номер текущей страницы. Используйте этот параметр с параметром StartFind .Пример. См StartFind. пример. |
FallbackPage |
<page number> |
Задайте номер страницы, отображаемой, если поиск или выбор карты документа завершается сбоем. Значением по умолчанию является номер текущей страницы. |
GetImage |
<icon name> |
Получите определенное изображение для пользовательского интерфейса средства просмотра HTML. |
Icon |
<icon name> |
Получите значок определенного модуля отрисовки. |
Stylesheet |
<stylesheet file name> |
Укажите таблицу стилей, которую нужно применить к средству просмотра HTML. |
| Параметр сведений об устройстве | Укажите параметр сведений об устройстве в виде rc:tag=value, где tag имя параметра сведений об устройстве, относяющегося к расширению отрисовки. Дополнительные сведения см. в описании Format команды.Вы можете использовать OutputFormat параметр сведений об устройстве для модуля отрисовки IMAGE для отображения отчета в формате JPEG с помощью следующих параметров в строке доступа к URL-адресу: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG Дополнительные сведения обо всех параметрах сведений об устройстве для различных модулей см. в статье Параметры сведений об устройстве для модулей подготовки отчетов к просмотру (службы Reporting Services). |
Команды сервера отчетов (rs:)
Нацелите сервер отчетов с помощью префикса rs:.
| Команда | Параметр | Описание |
|---|---|---|
Command |
ListChildren и GetChildren. |
Отображение содержимого папки. Элементы папки отображаются на странице универсальной навигации по элементам. Примеры: Собственный режим: https://myrshost/reportserver?/Sales&rs:Command=GetChildrenИменованный экземпляр в собственном режиме: https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildrenРежим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren |
Command |
Render |
Отчет отображается в браузере, чтобы просмотреть его. Примеры: Собственный режим: https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderРежим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render |
Command |
GetSharedDatasetDefinition |
Отображение определения XML, связанного с общим набором данных. Свойства общего набора данных сохраняются в определении. К этим свойствам относятся запрос, параметры набора данных, значения по умолчанию, фильтры наборов данных и параметры данных, такие как параметры сортировки и конфиденциальность регистра. Чтобы использовать это значение, требуется разрешение Чтение определения отчета на общий набор данных. Пример: Собственный режим: https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition |
Command |
GetDataSourceContents |
Отображение свойств заданного общего источника данных в формате XML. Если браузер поддерживает XML и если вы являетесь пользователем, прошедшим проверку подлинности, с разрешением на чтение содержимого в источнике данных, отображается определение источника данных. Примеры: Собственный режим: https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContentsРежим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents |
Command |
GetResourceContents |
Отрисовка ресурса и его отображение на HTML-странице, если ресурс совместим с браузером. В противном случае можно открыть или сохранить файл или ресурс на диск. Примеры: Собственный режим: https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsРежим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
Command |
GetComponentDefinition |
Отображение определения XML, связанного с опубликованным элементом отчета. Чтобы использовать это значение, необходимо иметь разрешение Чтение содержимого на элемент опубликованного отчета. |
Format |
HTML5PPTXATOMHTML4.0MHTMLIMAGEEXCEL (для .xls)EXCELOPENXML (для .xlsx)WORD (для .doc)WORDOPENXML (для .docx)CSVPDFXML |
Укажите формат, в котором будет отображаться отчет и просматривать его. Значение по умолчанию — HTML5. Дополнительные сведения см. в статье "Экспорт отчета с помощью доступа по URL-адресу". Полный список см. в \<Render> разделе расширения файла сервера rsreportserver.config отчетов. Дополнительные сведения см . в файле конфигурации RsReportServer.config. Примеры: Собственный режим: https://myrshost/ReportServer?/myreport&rs:Format=PDF Режим SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF |
ParameterLanguage |
en-us, de-DEи т. д. |
Укажите язык для параметров, переданных в URL-адрес, который не зависит от языка браузера. Значение по умолчанию — язык веб-браузера. Пример: Собственный режим: https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE |
Snapshot |
Отрисовка отчета на основе моментального снимка журнала отчетов. Дополнительные сведения см. в разделе Обработка моментального снимка журнала отчета с использованием доступа по URL-адресу. Пример: Собственный режим: https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02 |
|
PersistStreams |
truefalse |
Отрисовка отчета в одном сохраняемом потоке. Средство отрисовки изображений использует этот параметр для передачи отрисованного отчета по одному блоку за раз. После использования этого параметра в строке доступа по URL-адресу используйте ту же строку доступа к URL-адресу, GetNextStream а не PersistStreams параметр, чтобы получить следующий фрагмент в сохраняемом потоке. В конечном счете эта URL-команда возвращает 0-байтовый поток, обозначающий конец сохраняемого потока. Значение по умолчанию равно false. |
GetNextStream |
truefalse |
Получите следующий блок данных в сохраняемом потоке, к которому обращается доступ с помощью PersistStreams параметра. Дополнительные сведения см. в описании PersistStreams команды. Значение по умолчанию равно false. |
SessionID |
Укажите установленный активный сеанс отчета между клиентским приложением и сервером отчетов. В качестве значения этого параметра задается идентификатор сеанса. Идентификатор сеанса можно задать в виде куки-файла или ввести в состав URL-адреса. Если сервер отчетов не использует файлы cookie сеанса, первый запрос без указанного идентификатора сеанса приводит к перенаправлению с идентификатором сеанса. Дополнительные сведения о сеансах сервера отчетов см. в разделе "Определение состояния выполнения". |
|
ClearSession |
truefalse |
Удалите все экземпляры отчета, связанные с прошедшим проверку подлинности пользователем из сеанса отчета. Экземпляр отчета определяется как один и тот же отчет выполняется несколько раз с разными значениями параметров отчета. Значение по умолчанию равно false. Допустимые значения: true и false. |
ResetSession |
truefalse |
Сбросьте сеанс отчета, удалив связь сеанса отчета со всеми моментальными снимками отчета. Значение по умолчанию равно false. Допустимые значения: true и false. |
ShowHideToggle |
<positive integer> |
Переключите отображение и скрытие состояния раздела отчета. Для переключения отображения раздела укажите положительное целое число. |
Команды веб-части средства просмотра отчетов (rv:)
Нацелите веб-часть средства просмотра отчетов, которая интегрируется с SharePoint с помощью префикса rv:. Веб-часть средства просмотра отчетов также принимает rs:ParameterLanguage параметр.
| Команда | Параметр | Описание |
|---|---|---|
Toolbar |
Full |
панель инструментов отображается полностью. Значение по умолчанию — Full. |
Toolbar |
Navigation |
на панели инструментов отображается только разбиение на страницы. Пример: Режим SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation |
Toolbar |
None |
панель инструментов не отображается. |
HeaderArea |
Full |
заголовок отображается полностью. Значение по умолчанию — Full. |
HeaderArea |
BreadCrumbsOnly |
в заголовке отображаются только элементы иерархической навигации, чтобы информировать пользователей о том, где они находятся в приложении. Пример: Режим SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly |
HeaderArea |
None |
Скрывает заголовок. |
DocMapAreaWidth |
Управление шириной отображения (в пикселях) области параметров в веб-части средства просмотра отчетов. Значение по умолчанию совпадает со значением по умолчанию для веб-части средства просмотра отчетов. Значением должно быть неотрицательное целое число. | |
AsyncRender |
truefalse |
Управление асинхронным отображением отчета. По умолчанию устанавливается значение true, которое указывает, что отчет должен быть подготовлен к просмотру асинхронно. Значение должно иметь логический тип и принимать значение true или false. |
ParamMode |
Full |
область запроса параметров отображается. Значение по умолчанию — Full. |
Collapsed |
область запроса параметров сворачивается. Пример: Режим SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed |
|
ParamMode |
Hidden |
область запроса параметров скрыта. |
DocMapMode |
Full |
область схемы документа отображается. Значение по умолчанию — Full. |
DocMapMode |
Collapsed |
область схемы документа сворачивается. |
DocMapMode |
Hidden |
область схемы документа скрывается. |
DockToolBar |
Top |
Закрепление панели инструментов в верхней части. Значение по умолчанию — Top. |
DockToolBar |
Bottom |
Закрепление панели инструментов внизу. Пример: Режим SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom |
ToolBarItemsDisplayMode |
1 (0x1) |
Кнопка "Назад" |
ToolBarItemsDisplayMode |
2 (0x2) |
Элементы управления поиском текста |
ToolBarItemsDisplayMode |
4 (0x4) |
Элементы управления навигацией по страницам |
ToolBarItemsDisplayMode |
8 (0x8) |
Кнопка "Обновить" |
ToolBarItemsDisplayMode |
16 (0x10) |
Поле списка масштабирования |
ToolBarItemsDisplayMode |
32 (0x20) |
Кнопка "Канал Atom" |
ToolBarItemsDisplayMode |
64 (0x40) |
Пункт меню "Печать " в меню "Действия" |
ToolBarItemsDisplayMode |
128 (0x80) |
Экспорт подменю в actions |
ToolBarItemsDisplayMode |
256 (0x100) |
Открыть с параметром меню построитель отчетов в "Действия" |
ToolBarItemsDisplayMode |
512 (0x200) |
Пункт меню "Подписка" в меню "Действия" |
ToolBarItemsDisplayMode |
1024 (0x400) |
Пункт меню "Новое оповещение данных" в меню "Действия" |
ToolBarItemsDisplayMode |
Несколько значений | Управление отображаемыми элементами панели инструментов. Это значение представляет собой побитовое значение перечисления. Чтобы включить элемент панели инструментов, добавьте значение элемента к общему значению. Например, для меню "Действия " не используется rv:ToolBarItemsDisplayMode=63 (или 0x3F) — 1+2+4+8+16+32. Только для элементов меню "Действия ", используйте rv:ToolBarItemsDisplayMode=960 (или 0x3C0). Значение по умолчанию равно -1, что включает все элементы панели инструментов. Допустимые значения:Пример: Режим SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |