Бөлісу құралы:

Доступ по URL-адресу (SSRS)

Доступ по URL-адресу к серверу отчетов в службах SQL Server Reporting Services (SSRS) позволяет отправлять команды на сервер отчетов через URL-запрос. Эта функция позволяет настроить отображение отчетов на сервере отчетов в собственном режиме или в библиотеке SharePoint. Например, можно просмотреть отчет с помощью определенного набора значений параметров отчета или просмотреть определенную страницу, интересную для отчета. Эти параметры можно определить в URL-адресе с помощью предопределенных параметров доступа к URL-адресу.

Вы можете настроить способ обработки отчета сервером отчетов, включив параметры для форматов отрисовки или указав внешний вид и ощущение средства просмотра отчетов. Затем этот URL-адрес можно отправить другим пользователям, чтобы они могли получить доступ к отчету таким же образом в браузере.

Другие действия, которые можно выполнить с помощью доступа по URL-адресу, включают:

Основные понятия доступа по URL-адресу

Сервер отчетов обрабатывает параметры, содержащиеся в URL-запросах на сервер отчетов. Как сервер отчетов обрабатывает запросы URL-адресов, зависит от параметров, префиксов параметров и типов элементов, включенных в URL-адрес. URL-адреса сервера отчетов соответствуют рекомендациям по форматированию URL-адресов из проекта совместного стандарта консорциума W3C/IETF. Функциональность URL служб Reporting Services совместима с большинством интернет-браузеров или приложений, поддерживающих стандартную адресацию URL.

Синтаксис доступа по URL-адресу

ЗАПРОСы URL-адресов могут содержать несколько параметров, перечисленных в любом порядке. Параметры разделяются с помощью амперсанда (&) и пар "имя-значение" по знаку равенства (=).

Понимание различных компонентов строки доступа к URL-адресу важно для эффективной отправки команд на сервер отчетов SSRS. Строка доступа по URL-адресу включает:

  • https://[rswebserviceurl]: URL-адрес веб-службы сервера отчетов.
  • ?: указывает начало строки запроса, содержащей параметры.
  • [pathinfo]: путь к отчету или элементу на сервере.
  • [&prefix:param=value]: один или несколько параметров с необязательными префиксами, которые настраивают отрисовку отчета или поведение.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

Описание синтаксиса

В следующем разделе приведено подробное описание некоторых параметров, используемых в строке доступа к URL-адресу. Полный список см. в справочнике параметров доступа URL.

rswebserviceurl

URL-адрес веб-службы сервера отчетов.

  • Для режима по умолчанию это URL-адрес веб-службы, настроенный для экземпляра сервера отчетов в Диспетчере конфигураций служб Reporting Services. Дополнительные сведения см. в разделе "Настройка URL-адресов сервера отчетов" (Диспетчер конфигурации сервера отчетов).

    Рассмотрим пример.

    https://myrshost/reportserver
https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE

  • Для интегрированного режима SharePoint это URL-адрес прокси-сервера служб Reporting Services на сайте SharePoint, интегрированном со службами Reporting Services.

    Рассмотрим пример.

    https://myspsite/subsite/_vti_bin/reportserver

    Подсказка

    Важно, чтобы URL-адрес включал _vti_bin синтаксис прокси-сервера для маршрутизации запроса через SharePoint и HTTP-прокси служб Reporting Services. Прокси-сервер добавляет некоторый контекст в HTTP-запрос, контекст, необходимый для обеспечения правильного выполнения отчета для серверов отчетов в режиме SharePoint.

pathinfo

Имя относительного пути элемента в базе данных сервера отчетов в родном режиме или полный URL элемента в каталоге SharePoint.

Путь к элементу каталога. Для нативного режима это относительный путь элемента в базе данных сервера отчетов, начиная с косой черты (/). Рассмотрим пример.

/AdventureWorks2022/Employee_Sales_Summary_2022

Для интегрированного режима SharePoint это полный URL-адрес элемента в библиотеке SharePoint, включая расширение элемента. Рассмотрим пример.

https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl

&префикс:param=value

В строке доступа по URL-адресу добавляются параметры и соответствующие значения для настройки отрисовки или поведения отчета. Вы создаете параметры в парах name/value с помощью синтаксиса param=value, разделенного амперсандом (&).

Используйте необязательные префиксы, например rs: или rc: для целевых конкретных процессов на сервере отчетов.

Замечание

Если префикс для параметра доступа по URL-адресу не включен, параметр обрабатывается сервером отчетов в качестве параметра отчета. Параметры отчета не используют префикс параметров и чувствительны к регистру.

В следующем примере показан полный URL-адрес, как описано в этой статье:

https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008

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

  • Last updated on