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

  • Статья

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

Для настройки внешнего вида отчетов можно использовать следующие параметры как часть URL-адреса. В этом разделе перечислены часто используемые параметры. Параметры не учитывают регистр символов и начинаются с префикса параметра rs:, если направлены на сервер отчетов, и с префикса параметра rc:, если направлены к средству просмотра HTML-страниц. Также можно указать параметры, относящиеся к определенным устройствам или модулям подготовки отчетов. Дополнительные сведения о параметрах, определяемых устройствами, см. в разделе Задание настроек сведений об устройстве в URL-адресе.

Команды средства просмотра HTML-страниц

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

Параметр

Действие

Toolbar

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

Parameters

Показывает или скрывает область параметров на панели инструментов. Если установить этот параметр в значение true, отображается область параметров на панели инструментов. Если установить этот параметр в значение false, область параметров не отображается и пользователь не может управлять ее отображением. Если установить этот параметр в значение Collapsed, область параметров не отображается, но может быть сделана видимой или скрыта конечным пользователем. По умолчанию этот параметр имеет значение true.

Zoom

Устанавливает значение масштаба отчета в виде целого числа процентов или строковой константы. Допустимые строковые значения включают Page Width и Whole Page. Этот параметр не учитывается версиями Microsoft Internet Explorer, предшествующими Internet Explorer 5.0, и всеми веб-обозревателями, отличными от Майкрософт. По умолчанию этот параметр имеет значение 100.

Section

Указывает, какую страницу отчета отобразить. Если указать значение, превышающее число страниц в отчете, выводится последняя страница. Любое значение меньше 0 приводит к показу страницы 1 отчета. По умолчанию этот параметр имеет значение 1.

StartFind

Указывает последний раздел поиска. По умолчанию этот параметр имеет значение последней страницы отчета.

EndFind

Указывает номер последней страницы, используемой при поиске. Например, значение 5 показывает, что последней страницей, на которой осуществляется поиск, является страница 5. Значением по умолчанию является номер текущей страницы. Этот параметр используется совместно с параметром StartFind.

FallbackPage

Указывает номер отображаемой страницы, если поиск или выбор схемы документа завершился неудачно. Значением по умолчанию является номер текущей страницы.

GetImage

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

Icon

Возвращает значок определенного модуля подготовки отчетов.

Stylesheet

Указывает таблицу стилей, применяемую к средству просмотра HTML-страниц.

Можно передать дополнительные параметры в URL-адресе, чтобы направить выходные данные для подготовки к просмотру в формате HTML. Дополнительные сведения см. в разделе Параметры сведений об устройстве HTML.

Команды серверу отчетов

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

Параметр

Действие

Command

Указывает последний раздел поиска. По умолчанию этот параметр имеет значение последней страницы отчета.

Format

Указывает формат, в котором необходимо подготовить отчет к просмотру. Обычно это одно из значений: HTML3.2, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML и NULL. Дополнительные сведения см. в разделе Определение формата подготовки к просмотру в URL-адресе.

ParameterLanguage

Определяет язык передаваемых в URL-адресе параметров независимо от языка веб-обозревателя. Значение по умолчанию — язык веб-обозревателя. Значением может быть значение культуры, например en-us или de-de.

Snapshot

Готовит отчет к просмотру на основе моментального снимка журнала отчета. Дополнительные сведения см. в разделе Подготовка к просмотру моментальных снимков журнала отчетов с помощью доступа по URL-адресу.

PersistStream

Готовит отчет к просмотру в виде одиночного постоянного потока. С помощью этого параметра модуль подготовки изображений передает готовый к просмотру отчет фрагментами. После использования этого параметра в строке доступа по URL-адресу используйте ту же строку, но замените параметр PersistStream на параметр GetNextStream, чтобы получить следующий фрагмент постоянного потока. Через некоторое время эта команда URL-адреса вернет поток из 0 байт, что указывает на конец постоянного потока. По умолчанию устанавливается значение false.

GetNextStream

Возвращает следующий фрагмент постоянного потока, доступ к которому выполняется с помощью параметра PersistStream. Дополнительные сведения см. в описании PersistStream. По умолчанию устанавливается значение false.

Команды веб-части средства просмотра отчетов

В следующей таблице содержится описание новых зарезервированных имен параметров отчета SQL Server 2008, используемых для задания веб-части средства просмотра отчетов в случае, когда службы Reporting Services интегрированы со службами Windows SharePoint Services (WSS) 3.0 или со службами MicrosoftOffice SharePoint Server (MOSS) 2007. Эти имена параметров имеют префикс rv:. Веб-часть средства просмотра отчетов также принимает параметр rs:ParameterLanguage.

Параметр

Действие

Toolbar

Управляет отображением панели инструментов веб-части средства просмотра отчетов. По умолчанию устанавливается значение Full. Может принимать следующие значения:

  • Full: отображать панель инструментов полностью.

  • Navigation: отображать на панели инструментов только разбиение на страницы.

  • None: не отображать панель инструментов.

HeaderArea

Управляет отображением заголовка веб-части средства просмотра отчетов. По умолчанию устанавливается значение Full. Может принимать следующие значения:

  • Full: отображать заголовок полностью.

  • BreadCrumbsOnly: отображать в заголовке только элементы иерархической навигации, чтобы информировать пользователей о расположении в пределах приложения.

  • None: не отображать заголовок.

DocMapAreaWidth

Управляет шириной (в пикселях) области параметров в веб-части средства просмотра отчетов. Значение по умолчанию совпадает со значением по умолчанию для веб-части средства просмотра отчетов. Значением должно быть неотрицательное целое число.

AsyncRender

Определяет режим подготовки отчета к просмотру — синхронно или асинхронно. По умолчанию устанавливается значение true, которое указывает, что отчет должен быть подготовлен к просмотру асинхронно. Значение должно быть логическим (true или false).

Примеры

В следующем примере панель инструментов средства просмотра HTML-страниц скрывается с помощью присваивания параметру rc:Toolbar значения false:

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Toolbar=false

В следующем примере передается жестко заданный параметр и поле ввода для пользовательских параметров скрывается:

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Parameters=false&Year=2002

В следующем примере используется параметр rc:Zoom для установки свойства масштаба отчета в значение Page Width:

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Zoom=Page Width

В следующем примере переключается видимость раздела 13 отчета:

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:ShowHideToggle=13