Сегодняшний пост будет посвящен использованию отчетов, созданных с помощью Microsoft SQL Server Reporting Services (MS SSSRS), в портальных решениях под управлением MS SharePoint 2010. Более подробно я расскажу о вариантах работы с отчетами без сервера отчетов.

Режим работы сервера отчетов

Начну с небольшого вступления, описав режимы работы сервера отчетов:

• стандартный - сервер отчетов работает сам по себе. В SharePoint эти отчеты можно просматривать с помощью соответствующих веб-частей. Учетные данные для доступа к отчетам задаются в центре администрирования;
• интеграция с SharePoint 2010 - сервер отчетов хранит все свои данные в библиотеках документов SharePoint;

В случае интеграции сервера отчетов с SharePoint придется включить сервер, на котором работает MS SSRS в ферму SharePoint, что потребует наличия установленного SharePoint. При этом не стоит забывать, что в ферму SharePoint можно включать ТОЛЬКО ОДИНАКОВЫЕ РЕДАКЦИИ SHAREPOINT. Подробнее можно почитать на MSDN.

SQL Server 2012

С выходом SQL Server 2012 режим интеграции сервера отчетов с SharePoint кардинально изменился. Теперь сервер отчетов в режиме интеграции работает как общая служба-приложение. Следовательно, поддается конфигурации через центр администрирования SharePoint, масштабированию, работе с Claim-based аутентификации и прочему. Подробнее здесь.

Отчеты без сервера отчетов

Отчеты можно использовать и при отсутствии сервера отчетов. Здесь есть два варианта.

Report Builder

Первый способ заключается в использовании построителя отчетов (Report Builder) для создания отчетов. В дальнейшем эти отчеты можно хранить в библиотеке документов на портале и там же просматривать. Вот небольшой step-by-step:

Запускаем Report Builder и создаем новый источник данных. В типе соединения мы выбираем "Microsoft SharePoint List". Строкой подключение в этом случае будет просто URL-адрес сайта, из списков которого мы будем получать данные:

Источников данных в одном отчете может быть много. Теперь нам необходимо создать набор данных (DataSet). Здесь Report Builder более чем дружелюбен: он отображает информацию о списках и библиотеках документов на указанном в источнике данных сайте. Нам достаточно просто отметить те поля, которые нас интересуют:

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

Фильтр - это ерунда по сравнению с вот такой особенностью Report Builder'а: Данные можно выбирать только из корневой папки списка/библиотеки. Если очень надо обойти это ограничение, то можно работать со списками SharePoint через веб-сервисы, куда передавать CAML-запрос с фильтром по папке. В Report Builder'е обойти это не удастся. Я был уверен, что в новой версии построителя Microsoft исправит этот недочет, но я ошибался. Я пользовался версией 11.0.2100.60 (SQL Server 2012):

Недостатков в таком случае много. Например подписка на отчет и вызов редактора отчета через контекстное меню элемента в таком случае не работают. К тому же при просмотре отчета SharePoint попросит указать учетные записи для каждого источника данных (DataSource).

ReportViewer и объектная модель

Второй способ заключается в использовании ReportViewer'а - контрола, позволяющего отображать отчеты на формах. Так как мы будем отображать отчеты без использования сервера отчетов, то использовать мы будем LocalReport, а в качестве источника данных будет выступать объектная модель.

Для начала добавим новый отчет в наш проект

Далее создадим новые источник данных (DataSource) и набор данных (DataSet). В разделе Data Source нажимаем кнопку New... для создания нового источника данных

В качестве типа источника данных выбираем Object

Указываем класс, который будет выступать источником данных. В моем примере я выбрал класс Employee

Теперь наш отчет обеспечен данными

Поля из модели данных можно использовать при построение самого отчета

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

Отчет готов. Теперь его надо отобразить на странице. Можно делать это программно:

1. // Путь к файлу отчета
2. var reportPath = SPUtility.GetGenericSetupPath(
3. @"template\layouts\ZhukBlogLinqExamples\Reports\") + @"\AllEmployees.rdlc";
4. // Содаем новый экземпляр ReportViewer'а
5. var reportViewer = new ReportViewer
6.                         {
7.                             Width = new Unit("100%")
8.                         };
9. reportViewer.LocalReport.DisplayName = "Employees";
10. reportViewer.LocalReport.ReportPath = reportPath;
11.  
12. // Данные для отчета будем получать с помощью репозитория
13. var repository = new EmployeeRepository(true);
14. var items = repository.GetEntityCollection();
15. // Создаем новый ситочник данных
16. var ds = new ReportDataSource("EmployeeDataSet", items);
17. reportViewer.LocalReport.DataSources.Add(ds);
18. // Добавляем ReportViewer на страницу
19. Controls.Add(reportViewer);

Декларативно это будет выглядеть примерно вот так:

1. <asp:ObjectDataSource ID="ReportDS" runat="server"
2.      TypeName="EmployeeRepository, $SharePoint.Project.AssemblyFullName$"
3.      SelectMethod="GetEntityCollection">
4. </asp:ObjectDataSource>
5. <rsweb:ReportViewer ID="EmpReportViewer" runat="server" Width="100%" Height="100%">
6.     <LocalReport DisplayName="Список сотрудников" ReportPath="[...]\AllEmployees.rdlc">
7.         <DataSources>
8.             <rsweb:ReportDataSource DataSourceId="ReportDS" Name="EmployeeDataSet" />
9.         </DataSources>
10.     </LocalReport>
11. </rsweb:ReportViewer>

Генерация документа из отчета

Чтобы программно получить отчет, экспортированный в какой-либо формат, поддерживаемый ReportViewer'ом, можно использовать вот такой код:

1. var report = reportViewer.LocalReport;
2. var bytes = report.Render("IMAGE");

Метод Render здесь возвращает массив байтов, что крайне удобно для дальнейшего сохранения результата в библиотеке документов SharePoint. В параметре указывается желаемый формат данных. Получить список этих форматов можно, вызвав метод LocalReport.ListRenderingExtensions(). В моем случае были доступны следующие форматы:

• Excel - Microsoft Excel 2003;
• EXCELOPNEXML - Microsoft Excel 2007/2010;
• IMAGE - TIFF-файл;
• PDF - Adobe Portable Document Format;
• Word - Mcirosoft Word;
• WORDOPENXML - Microsoft Word 2007/2010;

Производительность

При построение отчетов MS SQL Reporting с использованием объектной модели в качестве источника данных надо помнить о том, что перед рендерингом очередного элемента произойдет неявное получение значений ВСЕХ свойств объекта. Т.е. lazy-load свойства со сложной логикой внутри в отчетах использовать надо очень аккуратно. Чтобы убрать "лишние" свойства из набора данных, придется открыть файл отчета в XML-редакторе и отредактировать раздел Fields. Содержимое файла-отчета выглядит примерно следующим образом (частично):

1. <?xml version="1.0" encoding="utf-8"?>
2. <Report
3. xmlns:rd="http://schemas.microsoft.com/SQLServer/reporting/reportdesigner"
4. xmlns="http://schemas.microsoft.com/sqlserver/reporting/2008/01/reportdefinition">
5.   <DataSources>
6.     <DataSource Name="ZhukBlogLinqExamplesModel">
7.       <ConnectionProperties>
8.         <DataProvider>System.Data.DataSet</DataProvider>
9.         <ConnectString>/* Local Connection */</ConnectString>
10.       </ConnectionProperties>
11.       <rd:DataSourceID>7a010698-afb4-4648-ac51-2701e2a975c4</rd:DataSourceID>
12.     </DataSource>
13.   </DataSources>
14.   <DataSets>
15.     <DataSet Name="EmployeeDataSet">
16.       <Fields>
17.         <Field Name="AccessLevel">
18.           <DataField>AccessLevel</DataField>
19.           <rd:TypeName>System.Int32</rd:TypeName>
20.         </Field>
21.         <!-- ... -->
22.       </Fields>
23.       <Query>
24.         <DataSourceName>ZhukBlogLinqExamplesModel</DataSourceName>
25.         <CommandText>/* Local Query */</CommandText>
26.       </Query>
27.       <rd:DataSetInfo>
28.         <rd:DataSetName>ZhukBlogLinqExamples.Model</rd:DataSetName>
29.         <rd:TableName>Employee</rd:TableName>
30.         <rd:ObjectDataSourceType>ZhukBlogLinqExamples.Model.Employee,...
31. </rd:ObjectDataSourceType>
32.       </rd:DataSetInfo>
33.     </DataSet>
34.   </DataSets>
35.   <!-- ... -->
36. </Report>

Вот и все на сегодня. Надеюсь пригодится.