• Статья

Параметры доступа по URL-адресу

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

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

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

Параметр

Действие

Toolbar

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

Важное примечаниеВажно!
rc:Toolbar=false не работает для строки доступа по URL-адресу, которая использует IP-адрес вместо имени домена для отчета, размещенного на сайте SharePoint.

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-адресе параметров, независимо от языка веб-обозревателя. Значение по умолчанию — язык веб-обозревателя. Значением может быть значение культуры, например ru-ru или de-de.

Snapshot

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

PersistStreams

Отчет подготавливается в отдельном постоянном потоке. Этот параметр используется модулем подготовки изображений для передачи подготовленного отчета по одному фрагменту данных за один раз. После использования этого параметра в строке доступа по URL-адресу используйте ту же строку доступа по URL-адресу с параметром GetNextStream вместо параметра PersistStreams, чтобы получить следующий фрагмент данных в постоянном потоке. В конечном счете эта URL-команда возвратит 0-байтовый поток, обозначающий конец сохраняемого потока. Значение по умолчанию — false.

GetNextStream

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

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

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

Параметр

Действие

Toolbar

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

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

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

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

HeaderArea

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

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

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

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

DocMapAreaWidth

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

AsyncRender

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

ParamMode

Управляет отображением в полностраничном представлении области запроса параметров веб-части «Средство просмотра отчетов». Допустимые значения.

  • Full: отобразить область запроса параметров.

  • Collapsed: свернуть область запроса параметров.

  • Hidden: скрыть область запроса параметров.

По умолчанию устанавливается значение Full.

DocMapMode

Управляет отображением в полностраничном представлении области схемы документа веб-части «Средство просмотра отчетов». Допустимые значения.

  • Full: отобразить область схемы документа.

  • Collapsed: свернуть область схемы документа.

  • Hidden: скрыть область схемы документа.

По умолчанию устанавливается значение Full.

DockToolBar

Управляет фиксацией панели инструментов веб-части «Средство просмотра отчетов» сверху или снизу. Допустимые значения — Top и Bottom. Значение по умолчанию — Top.

ToolBarItemsDisplayMode

Управляет отображением элементов панели инструментов. Это побитовое значение перечисления. Чтобы добавить элемент на панель инструментов, добавьте значение элемента к итоговому значению. Например: Чтобы убрать меню «Действия», укажите rv:ToolBarItemsDisplayMode=63 (или 0x3F), где число 63 вычисляется как 1+2+4+8+16+32; чтобы оставить только элементы меню «Действия», укажите rv:ToolBarItemsDisplayMode=960 (или 0x3C0). Допустимые значения.

  1. 1 (0x1): кнопка Назад

  2. 2 (0x2): элементы управления текстовым поиском

  3. 4 (0x4): элементы управления навигацией по странице

  4. 8 (0x8): кнопка Обновить

  5. 16 (0x10): раскрывающийся список Масштаб

  6. 32 (0x20): кнопка Веб-канал Atom

  7. 64 (0x40): команда Печать в меню Действия

  8. 128 (0x80): команда Экспорт в меню Действия

  9. 256 (0x100: команда Открыть в построителе отчетов в меню Действия

  10. 512 (0x200: команда Подписаться в меню Действия

Значение по умолчанию, которое включает все элементы панели инструментов, — -1.

Примеры

В следующем примере панель инструментов средства просмотра 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