Разработка отчетов с использованием конструктора отчетов (SSRS)
Для создания полнофункциональных отчетов и систем отчетности служб Службы Reporting Services используется конструктор отчетов. Конструктор отчетов — это графический интерфейс, с помощью которого можно задавать источники данных, наборы данных, запросы, позиции макета отчета для областей данных и полей, а также такие интерактивные возможности, как параметры и наборы отчетов, которые работают совместно.
Преимущества для проектов
Используйте проекты для:
хранения отчетов и связанных с ними элементов в одном контейнере;
локальной проверки решений отчетности, включая отчеты и связанные с ними элементы;
совместного развертывания взаимосвязанных элементов. Используйте свойства и настройки проекта для развертывания в различных средах;
сохраняйте набор мастер-копий для отчетов и связанных с ними элементов. После развертывания опубликованные отчеты могут быть случайно изменены.
Используйте этот раздел для проектирования отчетов и связанных с ними элементов для одного проекта отчета в решении среды SQL Server Data Tools (SSDT). Дополнительные сведения о программах и нескольких проектах в среде SQL Server Data Tools (SSDT) см. в разделе Службы Reporting Services в SQL Server Data Tools (SSRS).
В данной статье
Общие источники данных
Общие наборы данных
Отчеты
Элементы отчета
Ресурсы
Макет отчета
Предварительный просмотр
Сохранение и развертывание
Проверка отчета и уровни ошибок
Общие источники данных
С помощью SQL Server Data Tools можно определять и развертывать общие источники данных для системы отчетности. Общие источники данных могут развертываться независимо от других элементов проекта с помощью свойств OverwriteDataSources и TargetDataSourceFolder. Дополнительные сведения см. в разделе Задание свойства развертывания (службы Reporting Services).
В конструкторе отчетов источники данных, используемые в отчете, можно задать в области данных отчета и в обозревателе решений. Дополнительные сведения см. в разделе Область данных отчета. В среде SQL Server Data Tools нельзя открывать источники данных, опубликованные на сервере отчетов или на сайте SharePoint, но не включенные в решение SQL Server Data Tools. Для этого используется Построитель отчетов (SSRS).
SQL Server Data Tools — это клиентское средство. Проверить решение отчетности можно локально на своем компьютере, развернуть его в тестовой среде для проверки серверного решения, а затем развернуть в производственной среде. После развертывания проверьте, что для среды сервера отчетов заданы модули обработки источников данных и учетные данные для обращения к источникам данных. Управлять свойствами для различных развертываний поможет диспетчер конфигурации. Дополнительные сведения см. в разделе Службы Reporting Services в SQL Server Data Tools (SSRS).
Дополнительные сведения см. в разделе Подключения к данным, источники данных и сроки подключения (службы SSRS).
В начало
Общие наборы данных
Используйте SQL Server Data Tools для определения и развертывания общих наборов данных для системы отчетности. Общие наборы данных могут развертываться независимо от других элементов проекта с помощью свойств OverwriteDatasets и TargetDatasetFolder. Дополнительные сведения см. в разделе Задание свойства развертывания (службы Reporting Services).
В конструкторе отчетов общие наборы данных, используемые в отчете, можно задать в области данных отчета и в обозревателе решений. Дополнительные сведения см. в разделе Область данных отчета. В среде SQL Server Data Tools нельзя открывать опубликованные наборы данных непосредственно с сервера отчетов или сайта SharePoint. Используйте для этого Построитель отчетов (SSRS) в режиме общего набора данных.
SQL Server Data Tools — это клиентское средство. Можно использовать конструкторы запросов для локального создания и проверки результатов запросов в режиме предварительного просмотра. После развертывания можно управлять общими наборами данных независимо от общих источников данных и отчетов, от которых они зависят. Дополнительные сведения см. в разделах Внедренные и общие наборы данных отчета (построитель отчетов и службы SSRS), Средства проектирования запросов в конструкторе отчетов SQL Server Data Tools (SSRS) и Управление общими наборами данных.
В начало
Отчеты
Отчеты представляют собой файлы, хранимые в проекте отчета. Отчеты могут использоваться в качестве изолированных отчетов, вложенных отчетов или целей для детализации данных основных отчетов. Отчеты могут разворачиваться независимо от других элементов проекта с помощью свойства TargetReportFolder и других свойств. Дополнительные сведения см. в разделе Задание свойства развертывания (службы Reporting Services).
Примечание |
---|
Если отчет публикуется на сервере отчетов в режиме SharePoint, некоторые функции системы отчетности невозможно проверить в проекте конструктора отчетов. В ссылках на отчеты, вложенные отчеты и детализированные отчеты должны использоваться полные URL-адреса, которые можно проверить только после развертывания проекта отчета. Дополнительные сведения см. в разделе Примеры URL-адресов для элементов опубликованного отчета на сервере отчетов в режиме SharePoint (SSRS). |
Добавить отчет в проект можно следующими способами:
Добавить новый проект отчета. По умолчанию пустой отчет открывается в конструкторе отчетов. Дополнительные сведения см. в разделе Добавление в проект отчета новый или существующий отчет (службы SSRS).
Добавить новый проект мастера отчетов. Отчет создается шаг за шагом согласно инструкциям. Мастер отчетов разбивает процесс определения данных и разработку проекта отчета на последовательность шагов, формируя готовый отчет. Можно добавить стили, чтобы настроить мастер для вашей организации. Дополнительные сведения см. в разделе Добавление в проект отчета новый или существующий отчет (службы SSRS).
Добавить новый элемент типа «Отчет». Пустой отчет открывается в конструкторе отчетов.
Добавить существующий элемент. Существующее определение отчета (RDL-файл) открывается в конструкторе отчетов. При открытии отчета или проекта из более ранней версии служб Службы Reporting Services проект может автоматически обновиться до текущей версии, а отчет — до текущей схемы. Дополнительные сведения см. в разделе Обновление отчетов.
Импортировать отчет Microsoft Access. Импорт всех отчетов из базы данных Access (MDB, ACCDB) или файла проекта (ADP). Конструктор отчетов преобразует каждый отчет из файла базы данных или файла проекта в формат языка определения отчетов (RDL) и сохраняет их в указанном проекте отчета. Не все функции отчета Access передаются в файл определения отчета (RDL). Дополнительные сведения см. в разделах Импорт отчетов из базы данных Microsoft Access (службы Reporting Services) и Поддерживаемые функции отчетов Access (службы SSRS).
Примечание Чтобы использовать функцию импорта, необходимо, чтобы на компьютере, на котором установлен конструктор отчетов, был установлен Access 2002 или более поздняя версия. При импорте отчетов должен быть доступен источник данных для отчетов Access.
Работа непосредственно в RDL. Если отчет создается в конструкторе отчетов, он сохраняется в формате XML как RDL-файл. Этот файл можно изменять с помощью конструктора отчетов, текстового редактора или любого другого средства, позволяющего изменять XML-файлы.
При изменении источника определения отчета в конструкторе отчетов работа ведется в текущей схеме RDL для версии SQL Server, из которой устанавливались средства разработки. При построении проекта версия схемы может измениться в зависимости от свойств развертывания. Дополнительные сведения см. в разделе Развертывание и поддержка версий в SQL Server Data Tools (SSRS).
Прямое изменение RDL-файла может привести к тому, что отчет нельзя будет ни запустить, ни опубликовать на сервере отчетов. Как и в любом другом XML-файле, убедитесь, что специальные символы, используемые внутри элементов, правильно закодированы. Сервер отчетов при публикации отчета использует эту схему для проверки содержащегося в RDL-файле XML-кода.
Чтобы включить элементы, не являющиеся частью схемы RDL, поместите их в элемент Custom. Элемент Custom может считываться пользовательскими модулями подготовки отчетов, но игнорируется модулями подготовки отчетов, полученными из служб Службы Reporting Services. Например, можно использовать элемент Custom для сохранения комментариев в отчете.
Дополнительные сведения см. в разделе Язык определения отчетов (SSRS).
В начало
Элементы отчета
В конструкторе отчетов можно создавать таблицы, графики и другие элементы отчетов в проекте, а также публиковать их в виде элементов отчета на сервере отчетов или сайте SharePoint, интегрированном с сервером отчетов, для дальнейшего использования в других отчетах. Дополнительные сведения см. в разделе Части отчетов в конструкторе отчетов (SSRS).
Элементы отчета могут разворачиваться независимо от других элементов проекта с помощью свойства TargetReportPartFolder и других свойств. Дополнительные сведения см. в разделе Задание свойства развертывания (службы Reporting Services).
В начало
Ресурсы
Можно добавить в проект файлы, которые связаны с отчетом, но не обрабатываются сервером отчетов. Например, можно добавить изображения или файлы фигур ESRI для пространственных данных. Дополнительные сведения см. в разделе Ресурсы.
В начало
Макет отчета
Чтобы создать макет отчета, перетащите элементы отчета и данные отчета с панели элементов в область конструктора и расположите их в нужном порядке. Чтобы добавить данные в отчет, перетащите поля набора данных в элементы в области конструктора. Чтобы объединить данные в группы в области данных табликса, перетащите поля набора данных на панель группировки. Поскольку средства разработки отчетов — это, в основном, средства создания определений отчетов, подход к проектированию отчетов в построителе отчетов и в конструкторе отчетов примерно один и тот же.
В начало
Предварительный просмотр
Используйте Предварительный просмотр для проверки данных отчета и его макета. Во время предварительного просмотра отчета процессор отчетов проверяет схему определения отчета и синтаксис выражений и отображает возможные проблемы в окне Выходные данные.
Примечание |
---|
При осуществлении предварительного просмотра отчета данные для отчета кэшируются в файл на локальном компьютере. При повторном просмотре того же отчета (с использованием того же запроса, параметров и учетных данных) конструктор отчетов получает кэшированную копию вместо того, чтобы заново выполнять запрос. Файл данных сохраняется под именем <reportname>.rdl.data в том же каталоге, что и файл определения отчета. Этот файл не удаляется, когда конструктор отчетов закрывается. |
Просмотреть отчет можно следующими способами:
Предварительный просмотр. Перейдите на вкладку Предварительный просмотр. Отчет выполняется локально с теми же возможностями обработки отчета и подготовки к просмотру, что и на сервере отчетов. Отчет отображается как интерактивное изображение; можно выбирать параметры, щелкать ссылки, просматривать схему документа, разворачивать и сворачивать скрытые области отчета. Также можно экспортировать отчет в любой из установленных форматов подготовки к просмотру.
Автономный предварительный просмотр. Выполнение локального отчета в браузере. Используя конфигурацию отладки, этот режим также можно использовать для отладки своих пользовательских сборок. Существует три способа выполнить проект в режиме отладки:
В меню Отладка выберите команду Начать.
На стандартной панели инструментов среды Visual Studio нажмите кнопку Пуск.
Нажмите клавишу F5.
Если используется конфигурация проекта, которая строит отчет, но не развертывает его, отчет, указанный в свойстве StartItem текущей конфигурации, открывается в отдельном окне предварительного просмотра.
Примечание Прежде чем использовать режим отладки, необходимо задать начальный элемент. В обозревателе решений щелкните правой кнопкой мыши проект отчета, выберите Свойства, а затем в поле StartItem выберите имя отчета, который нужно показать.
Для предварительного просмотра конкретного отчета, не являющегося стартовым элементом проекта, выберите конфигурацию, которая строит отчет, но не развертывает его, например DebugLocal, щелкните правой кнопкой мыши отчет и выберите команду Выполнить. Необходимо выбрать конфигурацию, которая не развертывает отчет; в противном случае отчет будет опубликован на сервере отчетов вместо того, чтобы отобразиться локально в окне предварительного просмотра.
Предварительный просмотр.
Когда отчет просматривается на вкладке «Предварительный просмотр» или в окне предварительного просмотра, он выглядит так, как если бы он был создан модулем подготовки отчетов в формате HTML. Отчет не является HTML-страницей, но его макет и разбиение на страницы подобны выходному формату HTML.
Вместо этого отчет можно просмотреть в таком виде, как если бы он был напечатан, путем переключения в режим просмотра печати. Щелкните значок Предварительный просмотр на панели инструментов предварительного просмотра. Отчет отобразится в таком виде, как если бы он был напечатан на бумаге. Этот режим просмотра похож на результат работы модуля подготовки отчетов в формате PDF и формате изображения. Предварительный просмотр не является изображением или PDF-файлом, но макет отчета и его разбиение на страницы подобны выходному результату в этих форматах. Можно выбрать размер изображения отчета, например, задать ширину страницы.
Предварительный просмотр позволяет выявить многие проблемы, которые могли бы возникнуть при печати отчета. Распространенные проблемы подготовки отчета включают:
Лишние пустые страницы, потому отчет слишком большой по ширине и не умещается на бумаге заданного размера.
Лишние пустые страницы, потому что отчет содержит матрицу, которая динамически расширяется за пределы ширины бумаги, заданной для отчета.
Разрывы страниц между группами не работают, как предполагалось.
Верхние и нижние колонтитулы не отображаются, как предполагалось.
Необходимо изменить макет отчета, чтобы отчет лучше читался в напечатанном виде.
В начало
Сохранение и развертывание
В конструкторе отчетов можно сохранить отчеты и другие файлы проекта локально, а также развернуть их на сервере отчетов или сайте SharePoint. Общие источники данных, общие наборы данных, отчеты, ресурсы отчетов и элементы отчетов могут разворачиваться независимо друг от друга или все вместе в зависимости от заданных свойств развертывания проекта. Дополнительные сведения см. в разделе Свойства настройки и развертывания.
Важно понимать, что при проектировании отчета в конструкторе отчетов используется схема определения отчета, которая поддерживается текущей версией служб Службы Reporting Services в среде SQL Server Data Tools (SSDT). Когда задаются свойства развертывания проекта для конкретного сервера отчетов или SharePoint, а затем сохраняется отчет, конструктор отчетов сохраняет определение отчета в папку построения в схеме, которая соответствует версии на целевом сервере отчетов. Чтобы создать отчеты, которые можно будет публиковать на сервере отчетов более низкого уровня, конструктор отчетов удаляет элементы отчета, которых нет в целевой схеме. Это происходит автоматически и без запроса на подтверждение. Когда это происходит, исходное определение отчета сохраняется в папке проекта. Измененное определение отчета, которое развертывается, находится в папке построения.
Примечание |
---|
Для отладки выражений и выявления ошибок развертывания следует использовать определение отчета в папке построения. Не используйте Просмотр исходного кода. Окно Просмотр исходного кода показывает источник определения отчета из папки проекта. |
Дополнительные сведения см. в разделе Развертывание и поддержка версий в SQL Server Data Tools (SSRS).
Локальное сохранение отчета
При работе с отчетом или другими элементами проекта в конструкторе отчетов файлы сохраняются на локальном компьютере или в общей папке на другом компьютере, к которому имеется есть доступ.
Если используется программное обеспечение управления версиями, то при сохранении отчеты могут возвращаться на сервер системы управления версиями. Дополнительные сведения см. в разделе Система управления версиями.
Развертывание или публикация
Из среды SQL Server Data Tools вы можете развернуть отчеты или другие элементы проекта на несколько версий серверов отчетов служб Службы Reporting Services. Используйте конфигурации проектов, чтобы управлять обновлением определений отчетов до версий схем, совместимых с целевыми серверами отчетов. Конфигурация проекта включает такие свойства, как целевой сервер отчетов, папка, где процесс построения временно сохраняет определения отчетов для предварительного просмотра и развертывания, и уровни ошибок. Дополнительные сведения см. в разделах Свойства настройки и развертывания и Задание свойства развертывания (службы Reporting Services).
Экспорт отчета в другой формат файла
Отчеты можно экспортировать во множество разных форматов, которые могут влиять на макет отчета и на работу некоторых интерактивных функций. Дополнительные сведения о проектировании отчетов для различных форматов вывода см. в разделе Экспорт отчетов (построитель отчетов и службы SSRS).
В начало
Проверка отчета и уровни ошибок
Отчеты проверяются перед предварительным просмотром и во время развертывания. При создании отчетов можно столкнуться со следующими проблемами сборки. Отчет может содержать строки, например выражения или запросы, которые несовместимы с версией служб Службы Reporting Services, указанной в конфигурации проекта.
Воспользуйтесь для управления предупреждениями и ошибками, полученными во время построения, свойством ErrorLevel. Значение свойства ErrorLevel может находиться в диапазоне от 0 до 4 включительно. Значение определяет, какие из проблем сборки помечаются как ошибки, а какие — как предупреждения. Значение по умолчанию равно 2. Предупреждения и ошибки выводятся в среде SQL Server Data Tools (SSDT) в окне Выходные данные.
Проблемы со степенью серьезности, которая меньше значения ErrorLevel или равна ему, выводятся как ошибки. В противном случае они помечаются как предупреждения.
В следующей таблице перечислены уровни ошибок.
Уровень ошибки |
Описание |
---|---|
0 |
Наиболее серьезные и неизбежные проблемы, препятствующие просмотру и развертыванию отчетов. |
1 |
Серьезные проблемы сборки, которые коренным образом изменяют макет отчета. |
2 |
Менее серьезные проблемы сборки, которые незначительно изменяют макет отчета. |
3 |
Незначительные проблемы сборки, которые оказывают минимальное, практически незаметное влияние на макет отчета. |
4 |
Используется только для публикации предупреждений. |
При попытке просмотра или развертывания отчета, содержащего элементы, появившиеся в версии SQL Server 2008 R2, например карты и гистограммы, эти элементы могут быть удалены из него. По умолчанию свойство ErrorLevel конфигурации установлено в значение 2, что приведет к ошибке сборки отчета при удалении карты. Однако если изменить значение свойства ErrorLevel на 0 или 1, то карта будет удалена, будет выдано предупреждение, но процесс сборки продолжится.
В начало
См. также
Основные понятия
Службы Reporting Services в SQL Server Data Tools (SSRS)
Средства проектирования запросов в конструкторе отчетов SQL Server Data Tools (SSRS)
Развертывание и поддержка версий в SQL Server Data Tools (SSRS)