Статья
04/01/2012

Параметры (построитель отчетов версии 3.0 и службы SSRS)

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

Параметры отчета можно создать следующими способами.

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

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

На панели инструментов средства просмотра отчетов каждый параметр отображается так, чтобы пользователь мог задавать значения в интерактивном режиме. На следующем рисунке показана область параметров для отчета со следующими параметрами: @StartDate, @EndDate, @Subcategory и @ShowAllRows.

Параметры на панели инструментов в средстве просмотра отчетов

Панель параметров. На панели инструментов средства просмотра отчетов отображаются запросы и значения по умолчанию для всех параметров. Макет параметров на панели инструментов форматируется автоматически. Порядок определяется порядком отображения параметров на панели «Данные отчета».
**Параметры @StartDate и @EndDate.** Параметр @StartDate имеет тип данных DateTime. Рядом с текстовым полем отображается запрос на ввод начальной даты (Start Date). Чтобы изменить дату, введите новую дату в текстовом поле или используйте элемент управления «календарь».

Параметр @EndDate отображается рядом с параметром @StartDate.
**Параметр @Subcategory.** Параметр @Subcategory представляет собой тип данных Text. Поскольку для @Subcategory имеется список доступных значений, допустимые значения отображаются в раскрывающемся списке. Необходимо выбрать значения в этом списке. Поскольку параметр @Subcategory является многозначным, отображается параметр Выбрать все, с помощью которого можно выбрать или очистить все значения в списке.
**Параметр @ShowAllRows.** Параметр @ShowAllRows представляет собой тип данных Boolean. Воспользуйтесь переключателями, чтобы выбрать значение True или False.
Показать или скрыть область параметров. На панели инструментов средства просмотра отчетов щелкните эту стрелку, чтобы отобразить или скрыть панель параметров.
Кнопка «Параметры». В области предварительного просмотра построителя отчетов на ленте нажмите кнопку Параметры, чтобы отобразить или скрыть панель параметров.
Кнопка «Просмотреть отчет». На панели инструментов средства просмотра отчетов нажмите кнопку Просмотреть отчет, чтобы запустить отчет после ввода значений параметров. Если для всех параметров заданы по умолчанию, то отчет запускается автоматически при первом просмотре.

Дополнительные сведения об использовании параметров см. в разделе Учебник: добавление параметра к отчету (построитель отчетов 3.0), Учебник. Добавление параметров в отчет (SSRS) или Образцы отчетов (построитель отчетов 3.0 и службы SSRS)

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

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

Примечание
В построителе отчетов и в конструкторе отчетов среды Business Intelligence Development Studio можно создавать и изменять определения отчета (RDL). В каждой среде разработки существуют различные способы создания, открытия и сохранения отчетов и связанных элементов. Дополнительные сведения см. в разделе Разработка отчетов в построителе отчетов и конструкторе отчетов 3.0 (SSRS) на веб-сайте microsoft.com.

В построителе отчетов и в конструкторе отчетов среды Business Intelligence Development Studio можно создавать и изменять определения отчета (RDL). В каждой среде разработки существуют различные способы создания, открытия и сохранения отчетов и связанных элементов. Дополнительные сведения см. в разделе Разработка отчетов в построителе отчетов и конструкторе отчетов 3.0 (SSRS) на веб-сайте microsoft.com.

В данной статье

Распространенные варианты применения параметров

Типы параметров

Работа с параметрами отчета

Работа с параметрами набора данных

Каскадные параметры

Передача параметров детализированным и вложенным отчетам

Управление параметрами на сервере отчетов или сайте SharePoint

В этом разделе

См. также

Распространенные варианты применения параметров

Ниже перечислены некоторые из самых распространенных способов применения параметров:

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

Значок стрелки, используемый со ссылкой «В начало» В начало

Типы параметров

Отчеты содержат два типа параметров: параметры набора данных и параметры отчета.

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

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

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

Чаще всего используются именно параметры отчета.

Значок стрелки, используемый со ссылкой «В начало» В начало

Работа с параметрами отчета

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

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

Свойство	Описание
Имя	Введите имя параметра с учетом регистра. Имя должно начинаться с буквы, состоять из букв, цифр и символов подчеркивания (_), а также не иметь пробелов. Для параметров, формируемых автоматически, имя соответствует параметру запроса в запросе набора данных. По умолчанию для создаваемых вручную параметров используются имена типа ReportParameter1.
Подсказка	Текст, отображаемый рядом с параметром на панели инструментов средства просмотра отчетов.
Тип данных	Параметр отчета должен иметь один из следующих типов данных: Text, Integer, Float, DateTime, Boolean. Тип данных определяет способ отображения параметра отчета на панели инструментов средства просмотра отчетов. Тип данных также может иметь значение при написании выражений, содержащих ссылку на параметр.
Разрешить пустое значение	Установите этот параметр, если значение параметра может быть пустой строкой или пустым значением. Если при указании допустимых значений параметра необходимо также разрешить ввод пустого значения, то пустое значение необходимо явно включить в число задаваемых. При выборе данного параметра пустое значение не включается автоматически в перечень доступных значений.
Разрешить значение NULL	Выберите этот параметр, если значением параметра может быть NULL. Если при указании допустимых значений параметра необходимо также разрешить ввод значения NULL, то значение NULL необходимо явно включить в число задаваемых. При выборе данного параметра значение NULL не включается автоматически в перечень доступных значений.
Разрешить несколько значений	Укажите доступные значения, чтобы создать раскрывающийся список, в котором пользователи смогут выбирать значения. Это оптимальный вариант, позволяющий обеспечить включение в запрос набора данных только допустимых значений. Выберите этот параметр, если значением для параметра могут стать несколько значений, отображаемые в раскрывающемся списке. Значения NULL не разрешены. Если выбран этот параметр, в раскрывающемся списке параметров к списку доступных значений добавляются флажки. В верхней части списка имеется флажок Выбрать все. Пользователи могут устанавливать флажки для необходимых значений. При быстром изменении данных, используемых для указания значений, в отображаемом списке пользователь может увидеть не самые последние значения.
Видимость в обозревателе	Выберите этот параметр, чтобы отобразить параметр отчета в верхней части отчета при его выполнении. Этот параметр позволяет пользователям выбирать значения параметра во время выполнения.
Скрытый	Выберите этот параметр, чтобы скрыть параметр отчета в отчете. Значения параметра отчета можно задать в URL-адресе отчета, в определении подписки или на сервере отчетов при помощи диспетчера отчетов.
Внутренний	Выберите этот параметр, чтобы скрыть параметр отчета. Этот параметр отчета можно будет просмотреть только в определении отчета.
Доступные значения	При наличии у параметра заданных доступных значений, допустимые значения всегда отображаются в виде раскрывающегося списка. Например, при указании доступных значений для параметра типа DateTime на панели параметра отображается раскрывающийся список дат, а не элемент управления «календарь». Чтобы обеспечить согласование списка значений в отчете и вложенных отчетах, можно настроить параметр источника данных для использования одной транзакции во всех запросах в наборах данных, связанных с источником данных. Примечание по безопасности Во всех отчетах, содержащих параметры типа данных Text, используйте список доступных значений (также называемый списком допустимых значений) и убедитесь, что у любого пользователя, запускающего отчеты, есть разрешения только на просмотр данных отчета. Дополнительные сведения см. в разделе Безопасность (построитель отчетов 3.0).
Значения по умолчанию	Задание значений по умолчанию с помощью запроса или статического списка. При наличии у всех параметров значений по умолчанию, отчет запускается автоматически при первом просмотре.
Дополнительно	Задайте значение, указывающее, влияет ли этот параметр на данные отчета напрямую или косвенно. На сервере отчетов это значение используется для определения режимов кэша для отчетов и данных отчета. Дополнительные сведения см. в разделе Диалоговое окно «Свойства параметра отчета» — «Дополнительно» (построитель отчетов 3.0).

Значок стрелки, используемый со ссылкой «В начало» В начало

Работа с параметрами набора данных

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

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

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

Конструктор запросов, связанный с источником данных, помогает создать параметризованный запрос.

В запросах Transact-SQL различные источники данных поддерживают различный синтаксис параметров. Поддерживаются диапазоны параметров, определяемые в запросе по положению или по имени. Дополнительные сведения см. в разделах, посвященных типам внешних источников данных в Добавление данных в отчет (построитель отчетов версии 3.0 и службы SSRS). Чтобы создать параметризованный запрос, в конструкторе реляционных запросов нужно выбрать режим параметров для фильтра. Дополнительные сведения см. в разделе Пользовательский интерфейс конструктора реляционных запросов (построитель отчетов 3.0).
Для запросов, основанных на таких многомерных источниках данных, как службы Microsoft SQL Server Analysis Services, SAP NetWeaver BI или Hyperion Essbase, можно указать, следует ли создавать параметры на основе фильтра, указанного в конструкторе запросов. Дополнительные сведения см. в разделе, посвященном конструктору отчетов в Конструкторы запросов (построитель отчетов 3.0), соответствующем модулю обработки данных.

Значок стрелки, используемый со ссылкой «В начало» В начало

Каскадные параметры

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

Дополнительные сведения см. в разделе Как добавить в отчет каскадные параметры (построитель отчетов версии 3.0 и службы SSRS).

Значок стрелки, используемый со ссылкой «В начало» В начало

Передача параметров детализированным и вложенным отчетам

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

Дополнительные сведения см. в разделе Использование параметров для соединения с другими отчетами (построитель отчетов версии 3.0 и службы SSRS).

Управление параметрами на сервере отчетов или сайте SharePoint

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

**Кэшированные отчеты. **Чтобы можно было создать план обновления кэша для отчета, все параметры должны иметь значения по умолчанию. Дополнительные сведения см. в разделе Кэширование отчетов в службах Reporting Services.
**Кэшированные общие наборы данных. **Чтобы можно было создать план обновления кэша для общего набора данных, все параметры должны иметь значения по умолчанию. Дополнительные сведения см. в разделе Кэширование отчетов в службах Reporting Services.
Связанные отчеты. Можно создавать связанные отчеты с заранее заданными значениями параметров, чтобы фильтровать данные для различных целевых аудиторий. Дополнительные сведения см. в разделе Добавление, изменение и удаление связанных отчетов.
Подписки на отчет. Можно указывать значения параметров для фильтрации данных и доставки отчетов с помощью подписок. Дополнительные сведения см. в разделах Настройка параметров в подписке и Подписка и доставка (службы Reporting Services).
Доступ по URL-адресу. Значения параметров можно указывать в URL-адресе отчета. Также можно выполнять отчеты и указывать значения параметра при помощи доступа через URL-адрес. Дополнительные сведения см. в разделе Доступ по URL-адресу.