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

Ссылка на параметр доступа по URL-адресу

  • Статья

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

Важное примечаниеВажно!

Важно, чтобы URL-адрес содержал синтаксис прокси _vti_bin для отправки запроса с помощью центра администрирования SharePoint и прокси-сервера HTTP Службы Reporting Services. Прокси-сервер добавляет в HTTP-запрос контекст, необходимый для обеспечения правильного выполнения отчета для серверов отчетов в режиме интеграции с SharePoint. Примеры см. в разделе Доступ к элементам сервера отчетов с использованием URL-адреса.

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

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

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

Параметр

Действие

Toolbar

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

Важное примечаниеВажно!

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

Parameters

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

Пример в режиме Native.

http://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

Пример в режиме SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed

Zoom

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

Пример в режиме Native.

http://myrshost/reportserver?/Sales&rc:Zoom=Page Width

Пример в режиме SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width

Section

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

Пример в режиме Native для отображения второй страницы отчета.

http://myrshost/reportserver?/Sales&rc:Section=2

Пример в режиме SharePoint для отображения второй страницы отчета.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2

FindString

Поиск в отчете определенного текста.

Пример в режиме Native.

http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400

Пример в режиме SharePoint.

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. См. приведенный выше пример.

FallbackPage

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

GetImage

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

Icon

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

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=GetChildren

    Пример в режиме SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren

  • Render Отображает указанный отчет.

    Пример в режиме Native.

    http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

    Пример в режиме SharePoint.

    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=GetDataSourceContents

    Пример в режиме SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents

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

    Пример в режиме Native.

    http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

    Пример в режиме SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents

  • GetComponentDefinition Выводит XML-определение, связанное с элементом опубликованного отчета. Чтобы использовать это значение, необходимо иметь разрешение Чтение содержимого на элемент опубликованного отчета.

Format

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

Например, чтобы получить копию отчета в формате PDF прямо с сервера отчетов, работающего в режиме Native.

http://myrshost/ReportServer?/myreport&rs:Format=PDF

Пример в режиме SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF

ParameterLanguage

Определяет язык передаваемых в 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

Snapshot

Подготовка к просмотру отчета основывается на моментальном снимке журнала отчета. Дополнительные сведения см. в разделе Обработка моментального снимка журнала отчета с использованием доступа по 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-адреса. Если сервер отчетов настроен так, что в нем не используются куки-файлы, то первый же запрос, в котором не указан идентификатор сеанса, завершится перенаправлением с идентификатором сеанса. Дополнительные сведения о сеансах сервера отчетов см. в разделе Определение состояния выполнения.

ClearSession

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

ResetSession

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

ShowHideToggle

Отображает или скрывает раздел отчета. Для переключения отображения раздела укажите положительное целое число.

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

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

Параметр

Действие

Toolbar

Управляет отображением панели инструментов веб-части средства просмотра отчетов. По умолчанию устанавливается значение 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: Отобразить область запроса параметров.

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

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

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

Например, в режиме SharePoint, чтобы свернуть область запроса параметров.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed

DocMapMode

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

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

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

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

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

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. 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: команда Подписаться в меню Действия.

  11. 1024 (0x400: команда Создать предупреждение об изменении данных в меню Действия

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

Например, в режиме SharePoint для отображения только кнопки Назад, элементов управления поиском текста, элементов управления навигацией на странице и кнопки Обновить.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

См. также

Основные понятия

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