Развертывание модуля подготовки отчетов

Статья
06/13/2017

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

Настройка элемента модуля подготовки отчетов в файле

После компиляции модуля подготовки отчетов в формат .DLL в файл rsreportserver.config добавляется запись. По умолчанию этот файл находится в папке %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<имя_экземпляра>\Reporting Services\ReportServer. Родительским элементом является <Render>. В элементе Render находятся элементы Extension для каждого модуля подготовки отчетов. Элемент Extension содержит два атрибута — Name и Type.

В следующей таблице описаны атрибуты элемента Extension для модулей подготовки отчетов:

attribute	Описание
Имя	Уникальное имя элемента Extension. Длина атрибута Name не должна превышать 255 символов. Имя должно быть уникальным среди всех элементов, вложенных в элемент Extensions файла конфигурации. Если присутствует повторяющееся имя, сервер отчетов возвращает ошибку.
Тип	Список с разделителями-запятыми, содержащий полное пространство имен и имя сборки.
Visible	Значение `false` показывает, что модуль подготовки отчетов не должен быть видим в пользовательских интерфейсах. Если атрибут не указан, по умолчанию используется значение `true`.
LogAllExecutionRequests	Значение `false` показывает, что запись регистрируется только для первого выполнения отчета в сеансе. Если атрибут не указан, по умолчанию используется значение `true`. Например, этот параметр показывает, нужно ли регистрировать запись только для первой страницы, которая готовится к просмотру в составе отчета (значение `false`), или нужно создавать запись для каждой страницы, которая готовится к просмотру в составе отчета (значение `true`).

Дополнительные сведения см. в статье RSReportServer Configuration File.

Развертывание модуля на сервере отчетов

Сервер отчетов использует модули подготовки отчетов для экспорта отчетов в других форматах. Сборка модуля подготовки отчетов развертывается на сервере отчетов как закрытая сборка. Нужно также внести запись в файл конфигурации сервера отчетов rsreportserver.config.

Развертывание сборки

Скопируйте сборку из промежуточной папки в каталог bin сервера отчетов, на котором будет использоваться модуль подготовки отчетов. По умолчанию каталог bin сервера отчетов располагается в %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<имя_экземпляра>\Reporting Services\ReportServer\Bin.
Скопировав файл сборки, откройте файл rsreportserver.config. Файл rsreportserver.config также расположен в каталоге bin сервера отчетов. Необходимо создать запись в файле конфигурации для файла сборки модуля. Файл можно открыть с помощью среды Visual Studio или воспользоваться простым текстовым редактором.

Дополнительные сведения см. в статье RSReportServer Configuration File.
В файле Rsreportserver.config найдите элемент Render . Запись для созданного модуля должна находиться в следующем разделе файла:
```
<Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>  
```
Добавьте запись для модуля подготовки отчетов. В новую запись должен входить элемент, для которого заданы параметры Name и Type, например
```
<Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />  
```
Значение атрибута Name является уникальным именем модуля подготовки отчетов. Значение атрибута Type — это список с разделителями-запятыми, который содержит запись пространства имен с полным именем реализации IRenderingExtension, за которым следует имя сборки (без расширения DLL в имени файла). По умолчанию модули подготовки отчетов являются видимыми. Чтобы скрыть расширение от пользовательских интерфейсов, таких как диспетчер отчетов, добавьте атрибут Visible в Extension элемент и присвойте ему значение false.

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

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

См. также:

Реализация модуля подготовки отчетов
Общие сведения о модулях подготовки отчетов
Реализация интерфейса IRenderingExtension
Рекомендации по обеспечению безопасности для модулей

Поделиться через