Справочник по параметрам доступа по 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

Связанный контент