Ссылка на параметр доступа по URL-адресу
Для настройки внешнего вида отчетов можно использовать следующие параметры как часть URL-адреса. В этом разделе перечислены основные параметры. Параметры не учитывают регистр символов и начинаются с префикса параметра rs: , если направлены на сервер отчетов, и с префикса параметра rc: , если направлены в средство просмотра HTML-страниц. Также можно указать конкретные параметры устройств или модулей подготовки отчетов. Дополнительные сведения о параметрах, определяемых устройством, см. в разделе Указание настройки сведений об устройстве в URL-адресе.
Внимание
Важно, чтобы URL-адрес включал _vti_bin синтаксис прокси-сервера для маршрутизации запроса через SharePoint и HTTP-прокси служб Reporting Services. Прокси-сервер добавляет в HTTP-запрос контекст, необходимый для обеспечения правильного выполнения отчета для серверов отчетов в режиме интеграции с SharePoint. Примеры см. в разделе Access Report Server Items Using URL Access.
Сведения об указании параметров отчета в URL-адресе и примеры см. в разделе Pass a Report Parameter Within a URL.
Команды средства просмотра HTML-страниц (rc:)
В следующей таблице описаны параметры доступа к URL-адресам, которые префиксированы с помощью rc: и используются для просмотра HTML.
| Параметр | Описание | Values |
|---|---|---|
| Панель инструментов | Показывает или скрывает панель инструментов. ** Важно ** rc:Toolbar= false не работает для строк доступа по URL-адресу, использующих IP-адрес, а не доменное имя, для назначения отчета, размещенного на сайте SharePoint. |
Если этот параметр имеет значение false, остальные параметры не учитываются. Если этот параметр опустить, панель инструментов отображается автоматически для тех форматов подготовки к просмотру, которые ее поддерживают. По умолчанию этот параметр имеет значение true.true false |
| Параметры | Показывает или скрывает область параметров на панели инструментов.Native Пример режима:http://myrshost/reportserver?/Sales&rc:Parameters=CollapsedSharePoint Пример режима:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Если установить этот параметр в значение true, область параметров на панели инструментов отображается. Если установить этот параметр в значение false, область параметров не отображается и пользователь не может управлять ее отображением. Если установить этот параметр в значение Collapsed, область параметров не отображается, но может быть сделана видимой или скрытой конечным пользователем. Значение параметра по умолчанию — true. Допустимые значения:true false Collapsed |
| Масштабирование | Устанавливает значение масштаба отображения отчета в виде целого числа процентов или строковой константы.Native Пример режима:http://myrshost/reportserver?/Sales&rc:Zoom=Page WidthSharePoint Пример режима:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width |
Допустимые строковые значения включают Page Width и Whole Page. Этот параметр не учитывается версиями Internet Explorer, предшествующими Internet Explorer 5.0, и всеми веб-браузерами сторонних разработчиков. Значение параметра по умолчанию — 100. |
| Раздел | Указывает, какую страницу отчета отобразить.Native Пример режима для отображения страницы 2 отчета:http://myrshost/reportserver?/Sales&rc:Section=2SharePoint Пример режима для отображения страницы 2 отчета:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2 |
Применение любого значения, превышающего число страниц отчета, приводит к отображению последней страницы. Любое значение меньше 0 приводит к отображению страницы 1 отчета. Значение параметра по умолчанию — 1. |
| FindString | Поиск в отчете определенного текста.Native Пример режима:http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400SharePoint Пример режима:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400 |
|
| StartFind | Указывает последний раздел поиска.Native Пример режима, который выполняет поиск первого вхождения текста "Mountain-400" в примере отчета каталога продуктов, начиная с страницы один и заканчивая пятью страницами:https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400 |
По умолчанию этот параметр имеет значение последней страницы отчета. |
| EndFind | Указывает номер последней страницы, используемой при поиске. Например, значение 5 показывает, что последней страницей, на которой осуществляется поиск, является страница 5. Этот параметр используется совместно с параметром StartFind . См. приведенный выше пример для StartFind . |
Значением по умолчанию является номер текущей страницы. |
| РезервныйPage | Указывает номер отображаемой страницы, если поиск или выбор схемы документа завершился неудачно. | Значением по умолчанию является номер текущей страницы. |
| GetImage | Возвращает определенный значок для пользовательского интерфейса средства просмотра HTML-страниц. | |
| Значок | Возвращает значок определенного модуля подготовки отчетов. | |
| Stylesheet | Указывает таблицу стилей, применяемую к средству просмотра HTML-страниц. | |
| Параметр сведений об устройстве | Задает параметр сведений об устройстве в формате rc:tag=value, где tag содержит имя параметра сведений об устройстве, относящееся к используемому в настоящий момент модулю подготовки к просмотру (см. описание параметра Format). Например, можно использовать параметр сведений об устройстве OutputFormat , чтобы модуль подготовки отчетов IMAGE выводил отчет в формате JPEG-изображения с помощью следующих параметров в строке доступа по URL-адресу: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG. Дополнительные сведения обо всех параметрах сведений об устройстве, относящихся к расширению, см. в разделе "Параметры сведений об устройстве" для расширений подготовки отчетов (службы Reporting Services). |
Команды для сервера отчетов (rs:)
В следующей таблице описываются параметры доступа по URL-адресу, которые префиксированы с помощью rs: и используются для целевого сервера отчетов.
| Параметр | Описание |
|---|---|
| Command | Выполняет действие с элементом каталога в зависимости от типа элемента. Значение по умолчанию определяется типом элемента каталога, на который ссылается строка доступа по URL-адресу. Допустимые значения:ListChildren и GetChildren отображает содержимое папки. Элементы папки отображаются на общей странице навигации по элементам.Native Пример режима:http://myrshost/reportserver?/Sales&rs:Command=GetChildrenSharePoint Пример режима:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren |
Render Отрисовывает указанный отчет.Native Пример режима:http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderSharePoint Пример режима:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render |
|
GetSharedDatasetDefinition Отображает определение XML, связанное с общим набором данных. Определение включает свойства общего набора данных, в том числе запрос, параметры набора данных, значения по умолчанию, фильтры набора данных и такие параметры данных, как параметры сортировки и чувствительность к регистру. Чтобы использовать это значение, требуется разрешение Чтение определения отчета на общий набор данных.Native Пример режима:https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition |
|
GetDataSourceContents Отображает свойства заданного общего источника данных в формате XML. Если браузер поддерживает XML, то определение источника данных отображается при условии, что текущий пользователь прошел проверку подлинности и обладает разрешением Read Contents для источника данных.Native Пример режима:http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContentsSharePoint Пример режима:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents |
|
GetResourceContents Отрисовывает ресурс и отображает его на HTML-странице, если ресурс совместим с браузером. В противном случае будет предложено открыть или сохранить файл или ресурс на диск.Native Пример режима:http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsSharePoint Пример режима:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
|
GetComponentDefinition Отображает определение XML, связанное с опубликованным элементом отчета. Для использования этого значения необходимо иметь Read Contents разрешение на опубликованный элемент отчета. |
|
| Формат | Указывает формат, в котором необходимо подготовить отчет к просмотру. Обычные значения включают ATOM, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML. Значение по умолчанию — HTML4.0. Дополнительные сведения см. в разделе Export a Report Using URL Access.Например, чтобы получить копию отчета в формате PDF прямо с сервера отчетов, работающего в режиме Native.http://myrshost/ReportServer?/myreport&rs:Format=PDFПример в режиме SharePoint.http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF |
| ПараметрLanguage | Определяет язык передаваемых в URL-адресе параметров независимо от языка веб-браузера. Значение по умолчанию — язык веб-браузера. Значением может быть значение культуры, например en-us или de-de.Пример в режиме Native, переопределяющий язык браузера и задающий значение культуры de-DE.http://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE |
| Моментальный снимок | Подготовка к просмотру отчета основывается на моментальном снимке журнала отчета. Дополнительные сведения см. в разделе Обработка моментального снимка журнала отчета с использованием доступа по URL-адресу. Пример в режиме Native, получающий моментальный снимок журнала отчета, датированный 2003-04-07, с меткой времени 13:40:02.http://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02 |
| PersistStreams | Отчет подготавливается в отдельном постоянном потоке. Этот параметр используется модулем подготовки изображений для передачи подготовленного отчета по одному фрагменту данных за один раз. После использования этого параметра в строке доступа по URL-адресу используйте ту же строку доступа по URL-адресу с параметром GetNextStream вместо параметра PersistStreams , чтобы получить следующий фрагмент данных в постоянном потоке. В конечном счете эта URL-команда возвратит 0-байтовый поток, обозначающий конец сохраняемого потока. Значение по умолчанию — false. |
| GetNextStream | Возвращает из постоянного потока следующий фрагмент данных, к которому открывается доступ с помощью параметра PersistStreams . Дополнительные сведения см. в описании параметра PersistStreams. Значение по умолчанию — false. |
| SessionID | Определяет установленный активный сеанс между клиентским приложением и сервером отчетов. В качестве значения этого параметра задается идентификатор сеанса. Идентификатор сеанса можно задать в виде куки-файла или ввести в состав URL-адреса. Если сервер отчетов настроен так, что в нем не используются куки-файлы, то первый же запрос, в котором не указан идентификатор сеанса, завершится перенаправлением с идентификатором сеанса. Дополнительные сведения о сеансах сервера отчетов см. в разделе Identifying Execution State. |
| ClearSession | Значение true служит для сервера отчетов указанием, что отчет следует удалить из сеанса отчета. Все экземпляры отчетов, связанные с прошедшим проверку пользователем, удаляются из сеанса отчета (Экземпляр отчета определяется как один и тот же отчет выполняется несколько раз с различными значениями параметров отчета.) Значение по умолчанию — false. |
| СбросSession | Значение true указывает серверу отчетов сбросить настройки сеанса работы отчета, удалив связь сеанса отчета со всеми моментальными снимками отчета. Значение по умолчанию — false. |
| ShowHideToggle | Отображает или скрывает раздел отчета. Для переключения отображения раздела укажите положительное целое число. |
Команды веб-части средства просмотра отчетов (rv:)
В следующей таблице описываются зарезервированные имена параметров отчета SQL Server, которые используются для целевой веб-части средства просмотра отчетов, интегрированной с SharePoint. Эти имена параметров имеют префикс rv:. Веб-часть средства просмотра отчетов принимает также параметр rs:ParameterLanguage .
| Параметр | Действие |
|---|---|
| Панель инструментов | Управляет отображением панели инструментов веб-части средства просмотра отчетов. Значение по умолчанию — Full. Значения могут быть такими:Full: панель инструментов отображается полностью.Navigation: на панели инструментов отображается только разбиение на страницы.None: панель инструментов не отображается.Например, в режиме SharePoint, чтобы показать на панели инструментов только разбиение на страницы.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation |
| HeaderArea | Управляет отображением заголовка веб-части средства просмотра отчетов. Значение по умолчанию — Full. Значения могут быть такими:Full: заголовок отображается полностью.BreadCrumbsOnly: в заголовке отображаются только элементы иерархической навигации, чтобы информировать пользователей о том, где они находятся в приложении.None: заголовок не отображается.Например, в режиме SharePoint для отображения в заголовке только элементов иерархической навигации.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly |
| DocMapAreaWidth | Управляет шириной (в пикселях) области параметров в веб-части средства просмотра отчетов. Значение по умолчанию совпадает со значением по умолчанию веб-части средства просмотра отчетов. Значением должно быть неотрицательное целое число. |
| AsyncRender | Управляет тем, подготавливается ли отчет к просмотру асинхронно. По умолчанию устанавливается значение true, которое указывает, что отчет должен быть подготовлен к просмотру асинхронно. Значение должно иметь логический тип и принимать значение true или false. |
| ParamMode | Управляет отображением области запроса параметров в веб-части средства просмотра отчетов в режиме полностраничного просмотра. Значение по умолчанию — Full. Допустимые значения:Full: область запроса параметров отображается.Collapsed: область запроса параметров сворачивается.Hidden: область запроса параметров скрыта.Например, в режиме SharePoint, чтобы свернуть область запроса параметров.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed |
| DocMapMode | Управляет отображением области схемы документа в веб-части средства просмотра отчетов в режиме полностраничного просмотра. Значение по умолчанию — Full. Допустимые значения:Full: область схемы документа отображается.Collapsed: область схемы документа сворачивается.Hidden: область схемы документа скрывается. |
| DockToolBar | Управляет закреплением панели инструментов в веб-части средства просмотра отчетов у верхнего или нижнего края окна. Допустимые значения — Top и Bottom. Значение по умолчанию — Top.Например, в режиме SharePoint, чтобы закрепить панель инструментов в нижней части.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom |
| ToolBarItemsDisplayMode | Определяет отображаемые элементы панели инструментов. Значение побитового перечисления. Чтобы включить элемент панели инструментов, добавьте значение элемента к общему значению. Например, чтобы отобразить меню «Действия», укажите rv:ToolBarItemsDisplayMode=63 (или 0x3F), что равно 1+2+4+8+16+32; чтобы отобразить только элементы меню «Действия», укажите rv:ToolBarItemsDisplayMode=960 (или 0x3C0). Значение по умолчанию — -1, включающее все элементы панели инструментов. Допустимые значения:1 (0x1): кнопка Назад . 2 (0x2): элементы управления текстовым поиском. 4 (0x4): элементы управления навигацией по странице. 8 (0x8): кнопка Обновить . 16 (0x10): раскрывающийся список Масштаб . 32 (0x20): кнопка Веб-канал Atom . 64 (0x40): команда Печать в меню Действия. 128 (0x80): подменю Экспорт в меню Действия. 256 (0x100: команда Открыть в построителе отчетов в меню Действия. 512 (0x200: команда Подписка в меню Действия. 1024 (0x400: команда Новое предупреждение данных в меню Действия. Например, в SharePoint режиме отображения только кнопки "Назад ", элементов управления поиска текста, элементов управления навигацией страницы и кнопки "Обновить ".http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |