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

  • Статья

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

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

ПримечаниеПримечание

Какие именно параметры используются в отчете, определяет его автор. После публикации отчета можно изменить некоторые свойства параметров, которые определяют то, какие значения будут в нем использоваться и каким образом производится их получение. Дополнительные сведения о создании параметров см. в разделе Параметры (построитель отчетов версии 3.0 и службы SSRS). Дополнительные сведения об управлении параметрами см. в разделе Настройка свойств параметров для опубликованного отчета.

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

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

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

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

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

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

Указание параметров в 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-адрес см. в разделе Параметры доступа по URL-адресу.