Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Параметры можно использовать как часть URL-адреса для настройки внешнего вида отчетов SQL Server 2016 (13.x) Reporting Services или более поздних версий (SSRS). В этой статье описываются наиболее часто используемые параметры.
Параметры не учитывают регистр. Для них требуется префикс:
-
rs:: Нацелен на сервер отчётов. -
rc:: предназначен для средства просмотра HTML. -
rv:: предназначен для веб-части средства просмотра отчетов.
Можно также указать параметры, специфичные для устройств или расширений отрисовки. Дополнительные сведения о параметрах, определяемых устройством, см. в разделе Указание настройки сведений об устройстве в URL-адресе.
Команды средства просмотра HTML (rc:)
Нацелите средство просмотра HTML с помощью префикса rc:.
| Команда | Параметр | Описание |
|---|---|---|
Toolbar |
True |
Отображает панель инструментов. Значение по умолчанию — true Пример: https://myrshost/reportserver?/Sales&rc:Toolbar=TrueПримечание. Если этот параметр опущен, панель инструментов автоматически отображается для форматов отрисовки, поддерживающих ее. |
Toolbar |
False |
Скрывает панель инструментов. Если этот параметр имеет значение false, все остальные параметры игнорируются. Пример: https://myrshost/reportserver?/Sales&rc:Toolbar=False |
Parameters |
True |
Отображает область параметров панели инструментов. Значение по умолчанию — true Пример: https://myrshost/reportserver?/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 .Пример: См. пример. |
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:)
Укажите веб-часть Report Viewer, интегрированную с 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 |