Регистрация стандартного поставщика данных .NET Framework (службы SSRS)

Статья
06/25/2013

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

Поставщикам данных сторонней разработки не обязательно обеспечивать все функции, реализуемые модулями обработки данных служб Службы Reporting Services. Дополнительные сведения см. в разделе Источники данных, поддерживаемые службами Reporting Services (SSRS). Дополнительные сведения о расширении функций поставщика данных платформы .NET Framework см. в разделе Реализация модуля обработки данных.

Для установки и регистрации поставщиков данных необходимы учетные данные администратора.

Регистрация поставщика данных .NET Framework на сервере отчетов

Для обработки опубликованных отчетов, использующих этот поставщик данных .NET Framework на сервере отчетов, на нем необходимо установить сборку. Необходимо изменить два файла конфигурации. Регистрация поставщика данных производится в файле rsreportserver.config. Чтобы предоставить права доступа к коду сборки необходимо изменить файл rssrvpolicy.config.

Установка сборки поставщика данных на сервер отчетов

Перейдите в каталог bin по умолчанию сервера отчетов, на котором планируется использование поставщика данных .NET Framework. По умолчанию каталог bin сервера отчетов находится в «<drive>:\Program Files\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\bin».
Скопируйте сборку из промежуточной папки в каталог bin сервера отчетов. Можно также загрузить сборку в глобальный кэш сборок (GAC). Дополнительные сведения см. в разделе Работа со сборками и глобальным кэшем сборок в документации по пакету SDK платформы .NET Framework на веб-узле MSDN.

Регистрация сборки поставщика данных на сервере отчетов

Создайте резервную копию файла RSReportServer.config в папке ReportServer, в которую вложен каталог bin.
Откройте RSReportServer.config. Файл конфигурации можно открыть с помощью Visual Studio или воспользоваться простым текстовым редактором (таким, как Блокнот).
Найдите в файле RSReportServer.config элемент Data. Элемент для поставщика данных .NET Framework необходимо создать в месте, указанном ниже.
```
<Extensions>
   <Data>
      <Extension Your data provider configuration information goes here />
   </Data>
</Extensions>
```

Добавьте элемент для поставщика данных .NET Framework.

Атрибут	Описание
Name	Уникальное имя поставщика данных, например MyNETDataProvider. Длина атрибута Name не должна превышать 255 символов. Имя должно быть уникальным среди всех элементов, вложенных в элемент Extension файла конфигурации. Указываемое здесь значение выводится в раскрывающемся списке типов источников данных при создании нового источника данных.
Type	Список с разделителями-запятыми, включающий полное имя пространства имен для класса, реализующего интерфейс IDbConnection, а затем имя сборки поставщика .NET Framework (без расширения DLL).

Name

Уникальное имя поставщика данных, например MyNETDataProvider. Длина атрибута Name не должна превышать 255 символов. Имя должно быть уникальным среди всех элементов, вложенных в элемент Extension файла конфигурации. Указываемое здесь значение выводится в раскрывающемся списке типов источников данных при создании нового источника данных.

Type

Список с разделителями-запятыми, включающий полное имя пространства имен для класса, реализующего интерфейс IDbConnection, а затем имя сборки поставщика .NET Framework (без расширения DLL).

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

<Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" />

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

<Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>

Настройка групповой политики кода для поставщика данных .NET

Создайте резервную копию файла rssrvpolicy.config в папке ReportServer, в которую вложен каталог bin.
Откройте rssrvpolicy.config. Файл конфигурации можно открыть с помощью Visual Studio или воспользоваться простым текстовым редактором (таким, как Блокнот).
Найдите в файле rssrvpolicy.config элемент CodeGroup.

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

<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="ThisDataProviderCodeGroup"
   Description="Code group for the .NET data provider">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url=
"C:\Program Files\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\bin\DataProviderAssembly.dll"
       />
</CodeGroup>

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

Проверка развертывания и регистрация

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

Регистрация поставщика данных .NET Framework на клиенте конструктора отчетов

Для разработки отчетов, которые используют в качестве источника данных поставщик данных .NET Framework, необходимо установить сборку на клиентский компьютер, на котором запускается конструктор отчетов. Необходимо изменить два файла конфигурации. Измените файл RSReportDesigner.config для регистрации поставщика данных как источника данных и использования обычного конструктора запросов. Чтобы предоставить права доступа к коду сборки, измените файл RSPreviewPolicy.config.

Установка сборки поставщика данных на клиенте конструктора отчетов

Перейдите в каталог по умолчанию PrivateAssemblies на клиенте конструктора отчетов, на котором будет использоваться поставщик данных .NET Framework. По умолчанию каталог PrivateAssemblies расположен в папке <drive>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.
Скопируйте сборку из промежуточной папки в каталог PrivateAssemblies клиента конструктора отчетов. Можно также загрузить сборку в глобальный кэш сборок (GAC). Дополнительные сведения см. в разделе Работа со сборками и глобальным кэшем сборок в документации по пакету SDK платформы .NET Framework на веб-узле MSDN.

Регистрация сборки поставщика данных на клиенте конструктора отчетов

Создайте резервную копию файла RSReportDesigner.config в каталоге PrivateAssemblies.
Откройте файл RSReportDesigner.config с помощью среды Visual Studio или простого текстового редактора (например, Блокнота).
Найдите в файле RSReportDesigner.config элемент Data. Элемент для поставщика данных необходимо создать в месте, указанном ниже.
```
<Extensions>
   <Data>
      <Extension Your data provider configuration information goes here />
   </Data>
</Extensions>
```

Добавьте элемент для поставщика данных.

Атрибут	Описание
Name	Уникальное имя поставщика данных, например MyNETDataProvider. Длина атрибута Name не должна превышать 255 символов. Имя должно быть уникальным среди всех элементов, вложенных в элемент Extension файла конфигурации. Указанное здесь значение отображается в раскрывающемся списке типов источников данных при создании нового источника данных.
Type	Список с разделителями-запятыми, включающий полное имя пространства имен для класса, реализующего интерфейс IDbConnection, а затем имя сборки поставщика .NET Framework (без расширения DLL).

Name

Уникальное имя поставщика данных, например MyNETDataProvider. Длина атрибута Name не должна превышать 255 символов. Имя должно быть уникальным среди всех элементов, вложенных в элемент Extension файла конфигурации. Указанное здесь значение отображается в раскрывающемся списке типов источников данных при создании нового источника данных.

Type

Например, для DLL-файла, развертываемого в каталоге PrivateAssemblies Visual Studio, новый элемент может выглядеть следующим образом.

<Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" />

Если сборка загружена в глобальный кэш сборок, необходимо задать свойства строгого имени. Например:

<Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>

Найдите в файле RSReportDesigner.config элемент Designer. Элемент для поставщика данных .NET Framework необходимо создать в месте, указанном ниже.
```
<Extensions>
   <Designer>
      <Your data provider configuration information goes here>
   </Designer>
</Extensions>
```
Добавьте в файл RSReportDesigner.config после элемента Designer следующий элемент. Атрибут Name необходимо заменить именем, которое указывалось в предыдущих элементах.
```
<Extension Name="MyNETDataProvider" Type="Microsoft.ReportingServices.QueryDesigners.GenericQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
```

Настройка групповой политики кода для поставщика данных .NET на клиенте конструктора отчетов

Создайте резервную копию файла RSPreviewPolicy.config в каталоге PrivateAssemblies.
Откройте файл RSPreviewPolicy.config с помощью среды Visual Studio или простого текстового редактора (например Блокнота).
Найдите в файле RSPreviewPolicy.config элемент CodeGroup.

Добавьте группу кода для сборки поставщика данных .NET Framework, предоставляющую разрешение FullTrust, как показано ниже.

<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="ThisDataProviderCodeGroup"
   Description="Code group for the .NET data provider">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url=
" C:\Program Files\Microsoft Visual Studio 9\Common7\IDE\PrivateAssemblies\DataProviderAssembly.dll"
       />
</CodeGroup>

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

Проверка развертывания и регистрации на клиенте конструктора отчетов

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

Замечания о платформе

На 64-разрядной (x64) платформе среда SQL Server Data Tools (SSDT) выполняется в 32-разрядном режиме WOW. При разработке отчетов на платформе x64, для обеспечения их просмотра на клиенте конструктора отчетов необходимо установить 32-разрядную версию поставщика данных. Если отчет публикуется в той же системе, необходимо установить поставщики данных x64 для просмотра отчетов с помощью диспетчера отчетов.

Среда SQL Server Data Tools (SSDT) не поддерживается платформами на базе Itanium.

Модули обработки данных, установленные в службах Службы Reporting Services, должны быть скомпилированы для каждой из платформ и установлены в соответствующие каталоги. Если регистрируется пользовательский или стандартный поставщик данных .NET Framework, то он должен быть скомпилирован для целевой платформы и установлен в соответствующий каталог. При работе на 32-разрядной платформе поставщик данных должен быть скомпилирован для 32-разрядной платформы, а при работе на 64-разрядной платформе — для 64-разрядной платформы. 32-разрядный поставщик данных с 64-разрядными интерфейсами на 64-разрядной платформе использовать нельзя. Сведения о работоспособности на установленной платформе поставщика данных сторонней разработки см. в документации по этому программному обеспечению. Дополнительные сведения о поставщиках данных и поддержке платформ см. в разделе Источники данных, поддерживаемые службами Reporting Services (SSRS).

См. также

Основные понятия

Настройка и администрирование сервера отчетов (режим SharePoint служб Reporting Services)

Файлы конфигурации (службы Reporting Services)

Управление доступом для кода в службах Reporting Services

Другие ресурсы

Реализация модуля обработки данных

Share via