Статья
09/28/2010

Создание параметров отчета и настройка свойств параметров отчета (построитель отчетов 2.0)

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

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

После публикации отчета можно изменить свойства параметров отчета в диспетчере отчетов или среде SQL ServerManagement Studio.

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

Параметры отчета автоматически создаются для параметров запроса при сохранении запроса набора данных; можно также создать параметры отчета вручную. После создания параметра отчета может понадобиться настроить принятые по умолчанию значения свойств параметров, чтобы получить желаемую функциональность. Например, может понадобиться изменить тип данных, создать набор данных для списка доступных значений, создать набор данных для значений по умолчанию, указать, допустимы ли пустые значения или значения NULL.

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

Чтобы создать или изменить параметр отчета, щелкните правой кнопкой мыши узел «Параметры» в области «Данные» и откройте диалоговое окно Свойства параметра отчета.

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

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

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

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

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

Запрос

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

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

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

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

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

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

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

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

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

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

Разрешить значения NULL

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

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

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

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

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

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

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

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

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

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

См. также

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