Поделиться через

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

  • Статья

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

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

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

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

Сервер отчетов обрабатывает параметры, содержащиеся в URL-запросах на сервер отчетов. Как сервер отчетов обрабатывает запросы URL-адресов, зависит от параметров, префиксов параметров и типов элементов, включенных в URL-адрес. URL-адреса сервера отчетов соответствуют рекомендациям по форматированию URL-адресов, предлагаемым совместным стандартом W3C/IETF консорциума 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-адрес веб-службы сервера отчетов, настроенный в Configuration Manager служб 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

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