Запуск параметризованного отчета

Изменения: 17 июля 2006 г.

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

Примечание.

Какие именно параметры используются в отчете, определяет его автор. После публикации отчета можно изменить некоторые свойства параметров, которые определяют то, какие значения будут в нем использоваться и каким образом производится их получение. Дополнительные сведения о создании параметров см. в разделе Работа с параметрами в службах Reporting Services. Дополнительные сведения об управлении параметрами см. в разделе Установка параметров для опубликованного отчета.

Сохранение и запрос значений параметров.

Чтобы получить значение параметра во время выполнения, можно сохранить значение по умолчанию вместе с отчетом либо запросить у пользователя его ввод или выбор. Хранение значения параметра в составе отчета полезно в том случае, если отчет всегда выполняется с заданным значением. Например, если у регионального офиса имеется выделенный веб-узел, то можно разместить на нем региональный отчет о продажах, в котором всегда используется один и тот же код региона.

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

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

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

Задать свойства параметра опубликованного отчета (включая значения по умолчанию) можно при помощи диспетчера отчетов или среды SQL Server Management Studio. Дополнительные сведения см. в разделах Создание параметров отчета и настройка свойств параметров отчета и Настройка параметров подписки.

Указание параметров в URL-адресе отчета

Еще одним способом запуска параметризованного отчета является запуск через URL-адрес, закодировав параметры в пары «имя=значение» и разделив их символом амперсанда (&).

Параметры, имеющие значение NULL, используют специальный синтаксис: в качестве значения NULL необходимо указать isnull. Если для параметра указано значение NULL, то все остальные указанные для этого параметра значения не учитываются. Следующий пример иллюстрирует использование констант и значений NULL в качестве параметров:

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder&region=west&sales:isnull=true

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

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&region=east&region=west

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

Параметры типа Float должны включать десятичный разделитель, согласно языковому стандарту сервера.

Параметры типа DateTime должны указываться в формате ГГГГ-ММ-ДДТЧЧ:ММ:СС, согласно стандарту 8601 Международной организации стандартизации (ISO). Дополнительные сведения о передаче параметров через URL-адрес см. в разделе Using URL Access Parameters.

Журнал изменений

Версия	Журнал
17 июля 2006 г.	Новое содержимое Ссылки на измененную или новую информацию.

См. также

Задачи

Как открывать и закрывать отчеты (диспетчер отчетов)
Как открыть и закрыть отчет (среда Management Studio)

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

Установка параметров для опубликованного отчета
Параметризованные отчеты
Просмотр отчетов
Поиск и просмотр отчетов в диспетчере отчетов

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

Управление опубликованными отчетами и работа с ними

Справка и поддержка

Получение помощи по SQL Server 2005