Проектирование отчетов с разбивкой на страницы служб Reporting Services с помощью конструктор отчетов (SSRS)

  • Статья

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

Конструктор отчетов — это функция SQL Server Data Tools (SSDT)среды Microsoft Visual Studio для создания решений бизнес-аналитики. SQL Server Data Tools (SSDT) не входит в состав SQL Server. Скачать SQL Server Data Tools.

Преимущества проектов отчетов

Проекты отчетов используются как контейнеры для определений отчетов и ресурсов. Используйте проекты для:

  • хранения отчетов и связанных с ними элементов в одном контейнере;

  • локальной проверки решений отчетности, включая отчеты и связанные с ними элементы;

  • совместного развертывания взаимосвязанных элементов. Используйте свойства и настройки проекта для развертывания в различных средах;

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

Используйте сведения в этой статье для разработки отчетов с разбивкой на страницы и связанных элементов для одного проекта отчетов в решении SQL Server Data Tools (SSDT). Дополнительные сведения о решениях и нескольких проектах в SSDT см. в статье Службы Reporting Services в SQL Server Data Tools (SSDT).

общие источники данных;

Используйте средства SQL Server Data Tools для определения и развертывания общих источников данных для решения отчетов. Общие источники данных могут развертываться независимо от других элементов проекта с помощью свойств OverwriteDataSources и TargetDataSourceFolder . Дополнительные сведения см. в разделе Задание свойства развертывания (службы Reporting Services).

В конструкторе отчетов источники данных, используемые в отчете, можно задать в области данных отчета и в обозревателе решений. Дополнительные сведения см. в статье Report Data Pane. Вы не можете использовать sql Server Data Tools для открытия источников данных, опубликованных на сервере отчетов или сайте SharePoint, но не включенных в решение SQL Server Data Tools. Для этого используйте среду разработки построителя отчетов (службы SSRS).

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

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

Общие наборы данных

Используйте средства SQL Server Data Tools для определения и развертывания общих наборов данных для решения отчетов. Общие наборы данных могут развертываться независимо от других элементов проекта с помощью свойств OverwriteDatasets и TargetDatasetFolder . Дополнительные сведения см. в разделе Задание свойства развертывания (службы Reporting Services).

В конструкторе отчетов общие наборы данных, используемые в отчете, можно задать в области данных отчета и в обозревателе решений. Дополнительные сведения см. в статье Report Data Pane. Вы не можете использовать sql Server Data Tools для открытия опубликованных наборов данных непосредственно с сервера отчетов или сайта SharePoint. Для этого используйте среду разработки построителя отчетов (службы SSRS) в режиме общего набора данных.

SQL Server Data Tools — это клиентское средство. Можно использовать конструкторы запросов для локального создания и проверки результатов запросов в режиме предварительного просмотра. После развертывания можно управлять общими наборами данных независимо от общих источников данных и отчетов, от которых они зависят. Дополнительные сведения см. в разделе Внедренные и общие наборы данных отчета (построитель отчетов и службы SSRS) и Средства проектирования запросов (службы SSRS) и Управление общими наборами данных.

Отчеты, разбитые на страницы

Отчеты с разбивкой на страницы — это файлы, хранимые в проекте отчета. Отчеты могут использоваться в качестве изолированных отчетов, вложенных отчетов или целей для детализации данных основных отчетов. Отчеты могут разворачиваться независимо от других элементов проекта с помощью свойства TargetReportFolder и других свойств. Дополнительные сведения см. в разделе Задание свойства развертывания (службы Reporting Services).

Примечание.

При публикации на сервере отчетов в режиме SharePoint некоторые функции решений для отчетов можно тестировать в проекте конструктора отчетов. В ссылках на отчеты, вложенные отчеты и детализированные отчеты должны использоваться полные URL-адреса, которые можно проверить только после развертывания проекта отчета. Дополнительные сведения см. в разделе Примеры URL-адресов для элементов опубликованного отчета на сервере отчетов в режиме SharePoint (службы SSRS).

Добавить отчет в проект можно следующими способами:

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

  • Добавить новый проект мастера отчетов. Отчет создается шаг за шагом согласно инструкциям. Мастер отчетов разбивает процесс определения данных и разработку проекта отчета на последовательность шагов, формируя готовый отчет. Можно добавить стили, чтобы настроить мастер для вашей организации. Дополнительные сведения см. в разделе Добавление в проект отчета нового или существующего отчета (службы SSRS).

  • Добавить новый элемент типа "Отчет". Пустой отчет открывается в конструкторе отчетов.

  • Добавить существующий элемент. Существующее определение отчета (RDL-файл) открывается в конструкторе отчетов. Открытие отчета или проекта из более ранней версии служб Reporting Services может автоматически обновить проект до текущей версии и отчета до текущей схемы. Дополнительные сведения см. в разделе Upgrade Reports.

  • Импорт отчета 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, поместите их в пользовательский элемент. Пользовательские модули отрисовки могут считывать настраиваемый элемент. Но модули отрисовки, предоставляемые службами Reporting Services, игнорируют элемент. Например, можно использовать элемент Custom для сохранения комментариев в отчете.

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

Элементы отчета

Примечание.

Части отчетов устарели для всех выпусков служб SQL Server Reporting Services, начиная с SQL Server Reporting Services 2019 и всех выпусков Сервер отчетов Power BI начиная с Сервер отчетов Power BI сентября 2022 года.

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

Элементы отчета могут разворачиваться независимо от других элементов проекта с помощью свойства TargetReportPartFolder и других свойств. Дополнительные сведения см. в разделе Задание свойства развертывания (службы Reporting Services).

Ресурсы

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

Макет отчета с разбивкой на страницы

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

Предварительный просмотр отчета с разбивкой на страницы

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

Примечание.

При осуществлении предварительного просмотра отчета данные для отчета кэшируются в файл на локальном компьютере. При повторном просмотре того же отчета с помощью одного запроса, параметров и учетных данных конструктор отчетов извлекает кэшированную копию, а не повторно запускает запрос. Файл данных сохраняется в том же каталоге, что <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 отображаются как ошибки; в противном случае они сообщаются как предупреждения.

В следующей таблице перечислены уровни ошибок.

Уровень ошибки Description
0 Наиболее серьезные и неизбежные проблемы, препятствующие просмотру и развертыванию отчетов.
1 Серьезные проблемы сборки, которые коренным образом изменяют макет отчета.
2 Менее серьезные проблемы сборки, которые незначительно изменяют макет отчета.
3 Незначительные проблемы сборки, которые оказывают минимальное, практически незаметное влияние на макет отчета.
4 Используется только для публикации предупреждений.

При попытке предварительного просмотра или развертывания отчета, содержащего элементы отчета, новые в SQL Server 2016 (13.x) Reporting Services или более поздней версии (SSRS), эти элементы отчета можно удалить из отчета. По умолчанию свойство ErrorLevel конфигурации установлено в значение 2, что приведет к ошибке сборки отчета при удалении карты. Однако если изменить значение свойства ErrorLevel на 0 или 1, то карта будет удалена, будет выдано предупреждение, но процесс сборки продолжится.

Связанный контент

Скачивание SQL Server Data Tools
Службы Reporting Services в SQL Server Data Tools (SSDT)
Средства разработки запросов
Поддержка развертывания и версий в SQL Server Data Tools

Есть еще вопросы? Посетите форум служб Reporting Services.