Использование доступа по URL-адресу в веб-приложении

Статья
05/08/2013

Доступ по 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-адреса в обозревателе 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 в приложения

Использование доступа по URL-адресу в приложении Windows

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

Другие ресурсы

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

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