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

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

  • Статья

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

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

  • Отправка команд средству просмотра HTML-страниц, например, для настройки внешнего вида

  • Составление списка дочерних элементов папки каталога

  • Получение XML-определения элемента каталога

  • Подготовка определенного моментального снимка журнала отчета

  • Управление сеансами отчетов

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

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

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

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

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

  
rswebserviceurl  
?  
reportpath  
      [&prefix:param=value]...n]

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

rswebserviceurl
URL-адрес веб-службы сервера отчетов. В собственном режиме это URL-адрес веб-службы экземпляра сервера отчетов, настроенного в Reporting Services Configuration Manager (см. раздел Настройка URL-адресов сервера отчетов (SSRS Configuration Manager)). Пример.

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

При работе в режиме интеграции с Sharepoint — URL-адрес прокси-сервера Reporting Services на сайте SharePoint, интегрированном со службами Reporting Services. Пример:

http://myspsite/subsite/_vti_bin/reportserver

Совет

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

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

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

/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2

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

http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl

&
Используется для разделения пар имен и значений в параметрах URL-адреса.

prefix
Необязательный параметр. Префикс для параметра доступа по URL-адресу (например, rs: или rc:), обращающийся к определенному процессу, который выполняется на сервере отчетов.

Примечание

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

param
Имя параметра.

value
Текст URL-адреса, соответствующий значению используемого параметра.

Примечание. Список доступных параметров для доступа по URL-адресу см. в статье URL Access Parameter Reference. Примеры передачи параметров отчета в URL-адресе см. в разделе Pass a Report Parameter Within a URL.

Описания задач Ссылки
Доступ к элементам сервера отчетов, например, отчетам, общим источникам данных и ресурсам. Доступ к элементам сервера отчетов с использованием URL-адресов
Передача отчету параметров отчета. Передача параметра отчета в URL-адрес
Задание локали для параметров отчета в строке доступа по URL-адресу, определяющей уникальные для локали форматы дат, валют и т.п. Выбранный язык для параметров отчета в URL-адресе
Отправка настроек, уникальных для модуля подготовки отчетов, которые влияют на процесс подготовки. Указание настроек сведений об устройстве в URL-адресе
Экспорт отчета непосредственно в формате файла, без просмотра в браузере. Export a Report Using URL Access
Открытие отчета и переход непосредственно к месту расположения строки. Поиск отчета с использованием URL-адресов
Подготовка определенного моментального снимка журнала отчета. Обработка моментального снимка журнала отчета с помощью URL-адресов

См. также:

Передача параметра отчета в URL-адрес
Ссылка на параметр доступа по URL-адресу
Интеграция служб Reporting Services с помощью доступа по URL-адресу
Поиск, просмотр отчетов и управление ими (построитель отчетов и службы SSRS)