Настройка параметров модулей подготовки отчетов в RSReportServer.Config

Статья
10/01/2013

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

Изменение имени модуля подготовки отчетов в списке «Экспорт» панели инструментов отчета (например, чтобы заменить «Веб-архив» на «MHTML») или отображение этого имени на другом языке.
Создание нескольких экземпляров одного модуля подготовки отчетов для обеспечения различных вариантов представления отчета (например, варианты модуля подготовки изображений портретной и альбомной ориентации).
Изменение параметров по умолчанию модуля подготовки отчетов на другие значения (например, в модуле подготовки изображений в качестве формата вывода по умолчанию используется TIFF; параметры можно изменить таким образом, чтобы вместо этого использовался формат EMF).

Изменение параметров модуля подготовки отчетов влияет только на операции подготовки к просмотру на сервере отчетов. Невозможно изменить настройки модуля подготовки отчетов, используемые для предварительного просмотра отчета в конструкторе отчетов.

Указание параметров модуля подготовки отчетов в файлах конфигурации влияет на все модули подготовки к просмотру. Настройки в файлах конфигурации используются вместо значений по умолчанию всегда, когда применяется определенный модуль подготовки к просмотру. Если требуется задать параметры модуля подготовки отчетов для определенного отчета или операции подготовки к просмотру, следует указать сведения об устройстве программно с помощью метода Render или указав настройки сведений об устройстве в URL-адресе отчета.

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

Список модулей подготовки отчетов к просмотру, которые имеются в службах Службы Reporting Services, см. в разделе Расширения (SSRS).

Поиск и изменение файла RSReportServer.config

Параметры конфигурации форматов вывода для отчета указывается в виде параметров модуля подготовки отчетов в файле конфигурации RSReportServer.config. Чтобы указать в файлах конфигурации параметры модуля подготовки отчетов, необходимо знать, как определить XML-структуры, задающие параметры подготовки к просмотру. Существует две XML-структуры, которые можно изменять.

Элемент OverrideNames задает отображаемые имя и язык модуля подготовки отчетов.
XML-структура DeviceInfo определяет настройки сведений об устройстве, используемых модулем подготовки отчетов. Большинство параметров модуля подготовки отчетов определены как настройки сведений об устройстве.

Для изменения этого файла можно использовать текстовый редактор. Файл RSReportServer.config находится в папке \Reporting Services\Report Server\Bin. Дополнительные сведения об изменении файлов конфигурации см. в разделе Изменение файла конфигурации служб Reporting Services (RSreportserver.config).

Изменение отображаемого имени

Отображаемое имя модуля подготовки отчетов указывается в списке «Экспорт» панели инструментов отчета. Среди примеров отображаемых имен по умолчанию есть веб-архив, TIFF-файл и файл Acrobat (PDF-файл). Отображаемое имя по умолчанию можно заменить произвольным значением, указав в файлах конфигурации элемент OverrideNames. Кроме того, если пользователь определяет два экземпляра одного модуля подготовки отчетов, элемент OverrideNames можно использовать, чтобы различать эти экземпляры в списке «Экспорт».

Поскольку отображаемые имена локализованы, при замене отображаемого имени по умолчанию пользовательским значением следует установить атрибут Language. Иначе любое указанное имя не будет обрабатываться. Указанное значение языка должно быть допустимым для компьютера, на котором выполняется сервер отчетов. Например, если сервер отчетов выполняется под управлением французской операционной системы, в качестве значения атрибута следует указать «fr-FR».

В следующем примере показано, как задать пользовательское имя на сервере отчетов английской версии.

<Extension Name="XML" Type="Microsoft.ReportingServices.Rendering.DataRenderer.XmlDataReport,Microsoft.ReportingServices.DataRendering">
   <OverrideNames>
     <Name Language="ru-RU">My Custom Display Name for XML Rendering</Name>
   </OverrideNames>
</Extension>

Изменение настроек сведений об устройстве

Чтобы изменить настройки сведений об устройстве, используемые по умолчанию уже развернутым на сервере отчетов модулем подготовки отчетов, следует ввести в файлы конфигурации XML-структуру DeviceInfo. Для каждого модуля подготовки к просмотру существуют уникальные для него настройки сведений об устройстве. Полный список настроек сведений об устройствах см. в разделе Передача настроек сведений об устройстве модулям подготовки отчетов к просмотру.

В следующем примере показано, как выглядит структура и синтаксис XML-кода, изменяющего значения по умолчанию для модуля подготовки изображений:

<Render>
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">
        <OverrideNames>
            <Name Language="ru-RU">Image (EMF)</Name>
        </OverrideNames>
        <Configuration>
            <DeviceInfo>
                <ColorDepth>32</ColorDepth>
                <DpiX>300</DpiX>
                <DpiY>300</DpiY>
                <OutputFormat>EMF</OutputFormat>
            </DeviceInfo>
        </Configuration>
    </Extension>
</Render>

Настройка нескольких записей для модуля подготовки к просмотру

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

Указать уникальное имя для модуля.

Каждый экземпляр должен иметь уникальное значение атрибута Name. В следующем примере для того, чтобы экземпляры можно было различить, им присвоены имена «IMAGE (EMF Landscape)» и «IMAGE (EMF Portrait)».

Соблюдайте осторожность при изменении имени уже развернутого модуля подготовки отчетов. Разработчики, указывающие модули подготовки отчетов программно, используют имена модулей, чтобы обозначить, какой экземпляр нужен для определенной операции подготовки к просмотру. Если на сервере отчетов работают пользовательские приложения служб Службы Reporting Services, убедитесь, что разработчику известно об изменениях, вносимых в существующие имена модулей, или о добавлении нового имени.
Укажите такое уникальное отображаемое имя, чтобы пользователи могли понять, каковы различия между любыми форматами вывода.

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

В следующем образце показано, как добиться, чтобы используемый по умолчанию модуль подготовки к просмотру изображений (осуществляющий вывод в формате TIFF) выводил отчет в формате EMF в портретной ориентации наряду со вторым экземпляром, выводящим отчеты в формате EMF в альбомной ориентации. Обратите внимание, что каждое имя модуля уникально. Помните, что при тестировании этого образца следует выбирать отчеты, не содержащие таких интерактивных возможностей, как скрытие/отображение параметров, матрицы или ссылки на детализированные отчеты (в модуле подготовки к просмотру изображений интерактивные возможности не работают):

<Render>
    <Extension Name="IMAGE (EMF Landscape)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">
        <OverrideNames>
            <Name Language="ru-RU">EMF in Landscape Mode</Name>
        </OverrideNames>
        <Configuration>
            <DeviceInfo>
                <OutputFormat>EMF</OutputFormat>
                <PageHeight>8.5in</PageHeight>
                <PageWidth>11in</PageWidth>
            </DeviceInfo>
        </Configuration>
    </Extension>
    <Extension Name="IMAGE (EMF Portrait)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">
        <OverrideNames>
            <Name Language="ru-RU">EMF in Portait Mode</Name>
        </OverrideNames>
        <Configuration>
            <DeviceInfo>
                <OutputFormat>EMF</OutputFormat>
                <PageHeight>11in</PageHeight>
                <PageWidth>8.5in</PageWidth>
            </DeviceInfo>
        </Configuration>
    </Extension>
</Render>