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