RSReportServer.Config의 렌더링 확장 프로그램 매개 변수 사용자 지정Customize Rendering Extension Parameters in RSReportServer.Config

RSReportServer 구성 파일에서 렌더링 확장 프로그램 매개 변수를 지정하여 Reporting ServicesReporting Services 보고서 서버에서 실행되는 보고서의 기본 보고서 렌더링 동작을 재정의할 수 있습니다.You can specify rendering extension parameters in the RSReportServer configuration file to override default report rendering behavior for reports that run on a Reporting ServicesReporting Services report server. 다음과 같은 목적으로 렌더링 확장 프로그램 매개 변수를 수정할 수 있습니다.You can modify rendering extension parameters to achieve the following objectives:

  • 보고서 도구 모음의 내보내기 목록에 렌더링 확장 프로그램 이름이 표시되는 방식을 변경하거나(예: "웹 보관 파일"을 "MHTML"로 변경) 이 이름을 기본 언어로 지역화합니다.Change how the rendering extension name appears in the Export list of the report toolbar (for example, to change "Web archive" to "MHTML"), or localize the name to a different language.

  • 같은 렌더링 확장 프로그램의 여러 인스턴스를 만들어 각기 다른 보고서 표시 옵션(예: 이미지 렌더링 확장 프로그램의 세로 및 가로 모드 버전)을 지원합니다.Create multiple instances of the same rendering extension to support different report presentation options (for example, a portrait and landscape mode version of the Image rendering extension).

  • 기본 렌더링 확장 프로그램 매개 변수를 다른 값으로 변경합니다. 예를 들어 이미지 렌더링 확장 프로그램에서 TIFF를 기본 출력 형식으로 사용하는 경우 EMF를 대신 사용하도록 확장 프로그램 매개 변수를 수정할 수 있습니다.Change the default rendering extension parameters to use different values (for example, the Image rendering extension uses TIFF as the default output format; you can modify the extension parameters to use EMF instead).

    렌더링 확장 프로그램 매개 변수를 변경하면 보고서 서버의 렌더링 작업에만 영향이 미칩니다.Changing the rendering extension parameters only affects rendering operations on the report server. 보고서 디자이너의 보고서 미리 보기에서는 렌더링 확장 프로그램 설정을 재정의할 수 없습니다.You cannot override rendering extension settings in report preview in Report Designer.

    구성 파일에서 렌더링 확장 프로그램 매개 변수를 지정하면 렌더링 확장 프로그램에 전체적으로 영향이 미칩니다.Specifying rendering extension parameters in the configuration files affects rendering extensions globally. 특정 렌더링 확장 프로그램을 사용하는 경우 구성 파일의 설정이 기본값 대신 사용됩니다.The settings in the configuration files are used in place of default values whenever a particular rendering extension is used. 특정 보고서 또는 렌더링 작업에 대한 렌더링 확장 프로그램 매개 변수를 설정하려면 Render 메서드를 사용하여 프로그래밍 방식으로 또는 보고서 URL에 장치 정보 설정을 지정하여 장치 정보를 지정해야 합니다.If you want to set rendering extension parameters for a specific report or render operation, you must specify device information programmatically using the Render method or by specifying device information settings on a report URL. 렌더링 작업에 대한 장치 정보 설정을 지정하고 전체 장치 정보 설정 목록을 보는 방법에 대한 자세한 내용은 장치 정보 설정을 렌더링 확장 프로그램에 전달을 참조하세요.For more information about specifying device information settings for a render operation, and to view the complete list of device information settings, see Passing Device Information Settings to Rendering Extensions.

RSReportServer.config 찾기 및 수정Finding and Modifying RSReportServer.config

보고서 출력 형식에 대한 구성 설정은 RSReportServer.config 파일에서 렌더링 확장 프로그램 매개 변수로 지정됩니다.Configuration settings for report output formats are specified as rendering extension parameters in the RSReportServer.config file. 구성 파일에서 렌더링 확장 프로그램 매개 변수를 지정하려면 렌더링 매개 변수를 설정하는 XML 구조의 정의 방법을 알고 있어야 합니다.To specify rendering extension parameters in the configuration files, you must know how to define the XML structures that set rendering parameters. 다음 두 가지 XML 구조를 수정할 수 있습니다.There are two XML structures that you can modify:

  • OverrideNames 요소는 렌더링 확장 프로그램의 표시 이름과 언어를 정의합니다.The OverrideNames element defines the display name and language of the rendering extension.

  • DeviceInfo XML 구조는 렌더링 확장 프로그램에서 사용하는 장치 정보 설정을 정의합니다.The DeviceInfo XML structure defines the device information settings that are used by a rendering extension. 대부분의 렌더링 확장 프로그램 매개 변수는 장치 정보 설정으로 지정됩니다.Most rendering extension parameters are specified as device information settings.

    이 파일은 텍스트 편집기를 사용하여 수정할 수 있습니다.You can use a text editor to modify the file. RSReportServer.config 파일은 \Reporting Services\Report Server\Bin 폴더에 있습니다.The RSReportServer.config file can be found in the \Reporting Services\Report Server\Bin folder. 구성 파일을 수정 하는 방법에 대 한 자세한 내용은 참조 Reporting Services 구성 파일 수정 ( RSreportserver.config ) .For more information about modifying configuration files, see Modify a Reporting Services Configuration File (RSreportserver.config).

표시 이름 변경Changing the Display Name

렌더링 확장 프로그램의 표시 이름은 보고서 도구 모음의 내보내기 목록에 나타납니다.The display name for a rendering extension appears in the Export list of the report toolbar. 기본 표시 이름의 예로는 웹 보관 파일, TIFF 파일 및 Acrobat(PDF) 파일이 있습니다.Examples of default display names include Web archive, TIFF file, and Acrobat (PDF) file. 구성 파일에서 OverrideNames 요소를 지정하여 기본 표시 이름을 사용자 지정 값으로 바꿀 수 있습니다.You can replace the default display name with a custom value by specifying the OverrideNames element in the configuration files. 또한 단일 렌더링 확장 프로그램의 인스턴스를 두 개 정의하는 경우 OverrideNames 요소를 사용하여 내보내기 목록의 각 인스턴스를 구별할 수 있습니다.In addition, if you are defining two instances of a single rendering extension, you can use the OverrideNames element to distinguish each instance in the Export list.

표시 이름은 지역화되므로 기본 표시 이름을 사용자 지정 값으로 바꿀 경우 Language 특성을 설정해야 합니다.Because display names are localized, you must set the Language attribute if you are replacing the default display name with a custom value. 그렇지 않으면 사용자가 지정한 이름이 모두 무시됩니다.Otherwise, any name that you specify will be ignored. 설정하는 언어 값은 보고서 서버 컴퓨터에 유효한 값이어야 합니다.The language value that you set must be valid for the report server computer. 예를 들어 보고서 서버가 프랑스어 운영 체제에서 실행되고 있으면 "fr-FR"을 특성 값으로 지정해야 합니다.For example, if the report server is running on a French operating system, you should specify "fr-FR" as the attribute value.

다음 예에서는 영어 버전 보고서 서버에 사용자 지정 이름을 제공하는 방법을 보여 줍니다.The following example illustrates how to provide a custom name on an English report server:

<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>  

장치 정보 설정 변경Changing Device Information Settings

보고서 서버에 이미 배포된 렌더링 확장 프로그램에서 사용하는 기본 장치 정보 설정을 수정하려면 DeviceInfo XML 구조를 구성 파일에 입력해야 합니다.To modify default device information settings that are used by a rendering extension that is already deployed on your report server, you must type the DeviceInfo XML structure into the configuration files. 각 렌더링 확장 프로그램은 해당 확장 프로그램에 고유한 장치 정보 설정을 지원합니다.Every rendering extension supports device information settings that are unique to that extension. 장치 정보 설정의 전체 목록을 보려면 장치 정보 설정을 렌더링 확장 프로그램에 전달을 참조하세요.To view the complete list of device information settings, see Passing Device Information Settings to Rendering Extensions.

다음 예에서는 이미지 렌더링 확장 프로그램의 기본 설정을 수정하는 XML 구조와 구문을 보여 줍니다.The following example provides an illustration of the XML structure and syntax that modifies the default settings of the Image rendering extension:

<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>  

렌더링 확장 프로그램에 대해 여러 개의 항목 구성Configuring Multiple Entries for a Rendering Extension

같은 렌더링 확장 프로그램의 인스턴스를 여러 개 만들어 각기 다른 보고서 표시 옵션을 지원할 수 있습니다.You can create multiple instances of the same rendering extension to support different report presentation options. 정의한 인스턴스마다 여러 매개 변수 값 조합을 가질 수 있습니다.Each instance that you define can have a different combination of parameter values. 기존 렌더링 확장 프로그램의 새 인스턴스를 정의할 때는 다음을 수행해야 합니다.When defining new instances of an existing rendering extension, be sure to do the following:

  • 확장 프로그램에 고유 이름을 지정합니다.Specify a unique name for the extension.

    인스턴스마다 Name 특성에 대한 고유 값이 있어야 합니다.Each instance must have a unique value for the Name attribute. 다음 예에서는 "IMAGE (EMF Landscape)" 및 "IMAGE (EMF Portrait)"라는 이름을 사용하여 두 인스턴스를 구별합니다.The following example uses the names "IMAGE (EMF Landscape)" and "IMAGE (EMF Portrait)" to distinguish between the two instances.

    이미 배포된 렌더링 확장 프로그램의 이름을 변경하는 경우에는 주의하십시오.Use caution when changing the name of a rendering extension that is already deployed. 프로그래밍 방식으로 렌더링 확장 프로그램을 지정하는 개발자는 이 확장 프로그램 이름을 사용하여 특정 렌더링 작업에 사용할 인스턴스를 식별합니다.Developers who specify rendering extensions programmatically use the extension name to identify which instance to use for a particular render operation. 보고서 서버에서 사용자 지정 Reporting ServicesReporting Services 응용 프로그램을 실행하고 있는 경우 개발자는 사용자가 기존 확장 프로그램 이름을 수정하거나 새 확장 프로그램 이름을 추가할 경우 이를 알고 있어야 합니다.If you are running custom Reporting ServicesReporting Services applications on your report server, make sure that the developer knows if you modify an existing extension name or add a new one.

  • 사용자가 각 출력 형식의 차이를 이해할 수 있도록 고유한 표시 이름을 지정합니다.Specify a unique display name so that users can understand the differences for each output format.

    같은 확장 프로그램의 여러 버전을 구성하는 경우에는 OverrideNames에 값을 제공하여 각 버전에 고유한 이름을 지정할 수 있습니다.If you are configuring multiple versions of the same extension, you can give each version a unique name by providing a value for OverrideNames. 그렇지 않으면 확장 프로그램의 모든 버전이 보고서 도구 모음의 내보내기 옵션 목록에 같은 이름으로 나타납니다.Otherwise, all versions of the extension will appear to have the same name in the Export options list on the report toolbar.

    다음 예에서는 TIFF 출력을 생성하는 기본 이미지 렌더링 확장 프로그램을 사용하여 보고서를 세로 모드에서 EMF를 출력하고 동시에 두 번째 인스턴스에서는 가로 모드에서 EMF로 출력하는 방법을 보여 줍니다.The following example illustrates how to use the default Image rendering extension (which produces TIFF output) to output EMF in Portrait mode alongside a second instance that outputs reports in EMF in Landscape mode. 각 확장 프로그램 이름은 고유합니다.Notice that each extension name is unique. 이 예를 테스트하려면 표시/숨기기 옵션, 행렬 또는 드릴스루 링크와 같은 대화형 기능이 포함되지 않은 보고서를 선택하십시오. 대화형 기능은 이미지 렌더링 확장 프로그램에서 작동하지 않습니다.When testing this example, remember to choose reports that do not contain interactive features such as show/hide options, matrices, or drillthrough links (interactive features do not work in the Image rendering extension):

<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>  

관련 항목:See Also

RsReportServer.config 구성 파일 RsReportServer.config Configuration File
RSReportDesigner 구성 파일 RSReportDesigner Configuration File
CSV 장치 정보 설정 CSV Device Information Settings
Excel 장치 정보 설정 Excel Device Information Settings
HTML 장치 정보 설정 HTML Device Information Settings
이미지 장치 정보 설정 Image Device Information Settings
MHTML 장치 정보 설정 MHTML Device Information Settings
PDF 장치 정보 설정 PDF Device Information Settings
XML 장치 정보 설정XML Device Information Settings