Интеграция служб Reporting Services с помощью доступа по URL-адресу — веб-приложение

  • Статья

Доступ по URL-адресу в службах Reporting Services предназначен для обеспечения доступа к отдельным отчетам через сеть. Этот тип доступа наилучшим образом подходит для интеграции средств просмотра и навигации по отчетам в пользовательских веб-приложениях. Использовать доступ по URL-адресам в веб-приложениях можно следующим образом.

  • Задавать URL-адрес конкретного сервера отчетов на веб-сайте или портале.

  • Применять метод формы POST и передавать параметры строки запроса по URL-адресу сервера отчетов с использованием полей формы.

Доступ по URL-адресу через прямую адресацию

Чтобы получить доступ к серверу отчетов или элементу базы данных сервера отчетов с помощью URL-адреса, укажите URL-адрес из веб-браузера или приложения. Можно также предусмотреть использование в URL-адресе параметров, которые могут повлиять на отображение отчета или ресурса, к которому осуществляется доступ. Конкретный сервер отчетов можно указать в URL-адресе с помощью адресной строки веб-браузера. URL-адрес можно также указать как источник объекта IFrame, входящего в состав более крупного веб-приложения или портала. Вы можете включить гиперссылки на отчеты на различных веб-страницах портала и нацелить определенный кадр для отчета или открыть новое окно браузера в процессе.

В следующем примере гиперссылка указывает на фрейм с именем «main», который может отличаться от того фрейма, в котором находится гиперссылка. Гиперссылка может входить в состав веб-портала.

<a href="https://server/reportserver?/SampleReports/Territory Sales   
Drilldown&rs:Command=Render&rc:LinkTarget=main" target="main" >  
   Click here for the Territory Sales Drilldown sample report  
</a>

В предыдущем примере параметр linkTarget сведений об устройстве передается со значением main в строке запроса URL-адреса, что гарантирует, что все гиперссылки детализации в отчете также предназначены для кадра с именем main.

Дополнительные сведения о параметрах сведений об устройстве см. в разделе Передача настроек сведений об устройстве модулям подготовки отчетов к просмотру.

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

Примечание.

Максимальная длина URL-адреса в обозревателе Internet Explorer составляет 2083 символа. Это ограничение относится к запросам по URL-адресу обоих типов, POST и GET. Тем не менее, на запрос POST не налагаются ограничения в связи с размером URL-адреса при передаче пар «имя/значение» в составе формы, поскольку они передаются в заголовке, а не в URL-адресе.

Доступ по URL-адресу с помощью метода POST формы

Если пользователь запрашивает данные с сервера отчетов по URL-адресу, то в HTTP-запросе используется метод GET. Этот запрос эквивалентен отправке формы, в которой METHOD="GET". На URL-запросы или операции передачи форм с параметром METHOD="GET" налагается ограничение, определяемое максимальным количеством символов, которые может обработать сервер или веб-браузер.

А при использовании запросов POST (с параметром METHOD="POST" и полями ввода) пары «имя/значение» передаются в заголовке, а не в URL-адресе. Таким образом, пары "имя-значение" строки запроса не являются частью URL-адреса, что позволяет предоставлять более длинные и более сложные списки параметров.

Пользователь может использовать прямой доступ для просмотра URL-адреса сервера отчетов. Пользователь может изменить строку запроса или заметить конкретный ЗАПРОС URL-адреса и параметры сервера отчетов для последующего использования.

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

<FORM id="frmRender" action="https://server/reportserver?/SampleReports/  
   Territory Sales Drilldown" method="post" target="_self">  
   <INPUT type="hidden" name="rs:Command" value="Render">   
   <INPUT type="hidden" name="rc:LinkTarget" value="main">  
   <INPUT type="hidden" name="rs:Format" value="HTML4.0">  
   <INPUT type="submit" value="Button">  
</FORM>

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

https://server/reportserver?/SampleReports/Territory Sales   
Drilldown&rs:Command=Render&rc:LinkTarget=main&rs:Format=HTML4.0

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

Интеграция служб Reporting Services в приложения
Интеграция служб Reporting Services с помощью доступа по URL-адресу
Использование URL-адреса в приложении Windows
Доступ по URL-адресу (SSRS)