Настройка параметров расширения рендеринга в RSReportServer.Config

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

  • Измените, как имя модуля отрисовки отображается в списке экспорта панели инструментов отчета (например, чтобы изменить "Веб-архив" на "MHTML") или локализовать имя на другом языке.

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

  • Измените параметры расширения рендеринга по умолчанию, чтобы использовать различные значения (например, расширение рендеринга изображений использует TIFF в качестве формата выходных данных по умолчанию; вместо этого можно изменить параметры расширения, чтобы использовать EMF).

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

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

Поиск и изменение RSReportServer.config

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

  • Элемент OverrideNames определяет отображаемое имя и язык модуля отрисовки.

  • Структура DeviceInfo XML определяет параметры сведений об устройстве, используемые модулем отрисовки. Большинство параметров расширения визуализации указываются как настройки информации о устройстве.

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

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

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

Так как отображаемые имена локализованы, необходимо задать Language атрибут, если вы заменяете отображаемое имя по умолчанию пользовательским значением. В противном случае любое указанное имя будет игнорироваться. Заданное значение языка должно быть допустимым для компьютера сервера отчетов. Например, если сервер отчетов работает в французской операционной системе, необходимо указать "fr-FR" в качестве значения атрибута.

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

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

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

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

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

<Render>  
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">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 Альбомный)" и "IMAGE (EMF Книжный)", чтобы различать два экземпляра.

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

  • Укажите уникальное отображаемое имя, чтобы пользователи могли понять различия для каждого выходного формата.

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

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

<Render>  
    <Extension Name="IMAGE (EMF Landscape)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">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="en-US">EMF in Portait Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>11in</PageHeight>  
                <PageWidth>8.5in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

См. также

Файл конфигурации RSReportServer
Файл конфигурации RSReportDesigner
Параметры сведений об устройстве CSV
Параметры сведений об устройстве Excel
Настройки информации об устройстве HTML
Параметры сведений об устройстве изображения
Параметры сведений об устройстве MHTML
Сведения о параметрах устройства PDF
Параметры сведений об устройстве XML

  • Last updated on