Развертывание модуля подготовки отчетов
После того как модуль подготовки отчетов служб Reporting Services был написан и скомпилирован в библиотеку .NET Framework, необходимо сделать его видимым для сервера отчетов и конструктора отчетов. Это можно сделать, скопировав модуль в подходящий каталог и добавив записи в подходящие файлы конфигурации служб Reporting Services.
Настройка элемента модуля подготовки отчетов в файле
После того как модуль подготовки отчетов был скомпилирован в DLL-библиотеку, следует добавить запись в файл rsreportserver.config, расположенный в папке «C:\Program Files\Microsoft SQL Server\MSRS10.<InstanceName>\Reporting Services\ReportServer\Bin» (если при установке был выбран каталог по умолчанию). Родительским элементом является <Render>. В элементе Render находятся элементы Extension для каждого модуля подготовки отчетов. Элемент Extension содержит два атрибута — Name и Type.
В следующей таблице описываются атрибуты элемента Extension модулей подготовки отчетов.
Атрибут |
Описание |
|---|---|
Name |
Уникальное имя модуля, например «EXCEL» для модуля подготовки отчетов Microsoft Excel. Длина атрибута Name не должна превышать 255 символов. Имя должно быть уникальным среди всех элементов, вложенных в элемент Extensions файла конфигурации. Если присутствует повторяющееся имя, сервер отчетов возвращает ошибку. |
Type |
Список с разделителями-запятыми, содержащий полное пространство имен и имя сборки. |
Visible |
Значение false показывает, что модуль подготовки отчетов не должен быть видимым в пользовательских интерфейсах. Если атрибут не указан, по умолчанию используется значение true. |
LogAllExecutionRequests |
Значение false показывает, что запись регистрируется только для первого выполнения отчета в сеансе. Если атрибут не указан, по умолчанию используется значение true. Например, этот параметр показывает, нужно ли регистрировать запись только для первой страницы, которая готовится к просмотру в составе отчета (значение false), или нужно создавать запись для каждой страницы, которая готовится к просмотру в составе отчета (значение true). |
Дополнительные сведения о файле RSReportServer.config см. в разделе Файл конфигурации RSReportServer.
Развертывание модуля на сервере отчетов
Сервер отчетов использует модули подготовки отчетов для экспорта отчетов в других форматах. Сборка модуля подготовки отчетов развертывается на сервере отчетов как закрытая сборка. Нужно также внести запись в файл конфигурации сервера отчетов rsreportserver.config.
Развертывание сборки
Скопируйте сборку из промежуточной папки в каталог bin сервера отчетов, на котором будет использоваться модуль подготовки отчетов. По умолчанию каталог Bin сервера отчетов имеет имя «C:\Program Files\Microsoft SQL Server\MSRS10.<InstanceName>\Reporting Services\ReportServer\Bin».
Скопировав файл сборки, откройте файл rsreportserver.config. Файл rsreportserver.config также расположен в каталоге bin сервера отчетов. Необходимо создать запись в файле конфигурации для файла сборки модуля. Файл можно открыть с помощью среды Microsoft Visual Studio .NET или простого текстового редактора (такого как Блокнот).
Дополнительные сведения см. в разделе Файл конфигурации RSReportServer.
Найдите в файле Rsreportserver.config элемент Render. Запись для созданного модуля должна находиться в следующем разделе файла:
<Extensions> <Render> <Your extension configuration information goes here> </Render> </Extensions>Добавьте запись для модуля подготовки отчетов. В новую запись должен входить элемент со значениями параметров Name и Type. Запись может выглядеть, например, следующим образом:
<Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />Значение атрибута Name является уникальным именем модуля подготовки отчетов. Значением атрибута Type является список с разделителями-запятыми, который содержит запись для полного пространства имен класса IRenderingExtension, за которым следует имя сборки (без расширения DLL в имени файла). По умолчанию модули подготовки отчетов являются видимыми. Чтобы скрыть модуль от пользовательских интерфейсов, таких как диспетчер отчетов, добавьте атрибут Visible к элементу Extension и задайте для него значение false.
Проверка развертывания
Проверить, успешно ли был развернут модуль подготовки отчетов на сервере отчетов, можно с помощью метода веб-службы ListExtensions. Можно также открыть диспетчер отчетов и убедиться, что модуль включен в список доступных типов экспорта отчета.