Создание параметров отчета и настройка свойств параметров отчета

Добавления: 17 июля 2006 г.

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

Для работы с параметрами до публикации отчета используйте диалоговое окно «Параметры отчета» конструктора отчетов. Дополнительные сведения см. в разделе Как добавить, редактировать или удалить параметр отчета (конструктор отчетов).

После публикации отчета можно изменить свойства параметров отчета в диспетчере отчетов или в среде SQL Server Management Studio. Дополнительные сведения об изменении свойств параметров см. в разделе Установка параметров для опубликованного отчета.

Параметры отчета

Хотя для параметров запроса параметры отчета создаются автоматически, они никогда не удаляются автоматически при удалении параметров запроса.

Чтобы открыть диалоговое окно «Свойства отчета», переключитесь на представление «Данные» или «Макет» в конструкторе отчетов, в меню Отчет выберите пункт Свойства отчета. В левой области появится список параметров отчета. Выберите параметр, который хотите изменить.

Имя и тип данных

Имена для параметра необходимы и должны быть уникальными в пределах отчета. Тип данных параметра по умолчанию установлен как String. Можно выбрать другой тип данных в раскрывающемся списке. Если параметр отчета основан на параметре запроса, удостоверьтесь, что тип данных параметра отчета соответствует типу данных параметра запроса. Службы Reporting Services не обнаруживают типы данных параметра запроса, таким образом, корректировать тип данных нужно самостоятельно.

Имена должны соответствовать по символам и регистрам стандартам общей спецификации для языков программирования (CLS). Дополнительные сведения по общей спецификации для языков программирования см. на веб-узле https://msdn.microsoft.com.

Запрос

В опубликованном отчете параметры обычно являются текстовыми полями в области ввода параметра в верхней части отчета. Строка приглашения определяет метку, которая идентифицирует параметр в области ввода. Приглашение может быть именем параметра или указанием пользователю, например: «Год» или «Выберите год». Если поле приглашения оставлено пустым и значение параметра по умолчанию определено, используется это значение, и поле ввода для параметра не будет отображено, когда пользователь выполнит отчет. Если поле запроса оставлено пустым и нет определенного значения параметра по умолчанию, отчет не может быть выполнен. Если нежелательно запрашивать у пользователя значения параметров, пометьте параметр как скрытый или внутренний.

Скрытые и внутренние параметры

Можно определить свойства, управляющие видимостью параметра в опубликованном отчете. Установка параметров Скрытый и Внутренний обеспечивает различные уровни видимости. Можно скрыть параметр в области ввода параметра опубликованного отчета, установить значения для него в URL-адресе отчета или в определении подписки. Если параметр отмечен как только внутренний, он не будет показан нигде, кроме как в определении отчета.

Однозначные и многозначные параметры

Можно определить многозначный параметр, выбрав Многозначный в диалоговом окне Параметры отчета. Если этот флажок не установлен, параметр является однозначным. Выбор флажка Многозначный добавляет флажки к допустимым значениям в раскрывающемся списке параметра в опубликованном отчете. Пользователи могут отметить нужные значения (например, в образце отчета «Сравнение причин покупки» пользователи могут выбрать несколько продуктов для просмотра объединенных данных о продажах этих продуктов).

Определяя допустимые значения, можно предоставить статический список строк или использовать запрос для получения допустимых значений из источника данных. Многозначный параметр должен включать по крайней мере одно значение. Значения NULL не разрешены. Параметр «Выделить все» создается автоматически и показывается только тогда, когда имеется более одного значения.

Примечание.
Не выбирайте параметр Выделить все в SQL Server 2005, если в качестве источника данных используются службы Analysis Services. Параметр Выделить все может ухудшить производительность системы при обработке запроса многомерных выражений. Если необходимо выбрать все значения, выберите взамен элемент списка Все.

Разрешить пустые значения

Если при создании списка допустимых значений желательно разрешить использовать значение <Пустой>, необходимо включить его в список допустимых значений.

Разрешить неопределенные значения

Вариант «Разрешить неопределенные значения» применяется для однозначных параметров. Нельзя выбрать это значение для многозначных параметров. Выбор варианта Разрешить неопределенные значения тем самым разрешает параметру принимать неопределенное значение. По умолчанию многие языки запросов не возвращают неопределенные значения в результирующем наборе.

Допустимые значения

Когда указывается параметр отчета, нужно задать значения, которые могут использоваться с отчетом. Их называют допустимыми значениями или правильными значениями. Список допустимых значений содержит набор пар «значение-метка». Когда отчет запущен, пользователь видит метку. Когда пользователь выбирает метку, соответствующее значение используется как значение параметра. Допустимые значения могут быть заранее определены как статический список или выражение, или они могут быть получены из набора данных.

• Незапрашиваемый список — статический список пар «значение-метка». Весь список содержится в определении параметра отчета. Каждые значение и метка могут быть статическими значениями или могут быть сформированы на основе выражения.
• Запрашиваемый список заставляет сервер отчетов получать ряд значений и меток из набора данных при выполнении отчета. Когда определяется запрашиваемый список доступных значений, нужно выбрать набор данных, поля, используемые для значений, и поля, используемые для меток.

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

Значение по умолчанию

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

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

Значение по умолчанию можно и не указывать. При этом нужно указать строку запроса.

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

См. также

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

Учебник. Добавление параметров в простой табличный отчет
Учебник. Дополнительные возможности использования параметров
Работа с параметрами в службах Reporting Services
Параметры отчета (конструктор отчетов)

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

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