RSReportServer.Config에서 렌더링 확장 프로그램 매개 변수 사용자 지정

  • 아티클

RSReportServer 구성 파일에서 렌더링 확장 프로그램 매개 변수를 지정하여 Reporting Services 보고서 서버에서 실행되는 보고서의 기본 보고서 렌더링 동작을 재정의할 수 있습니다. 렌더링 확장 프로그램 매개 변수를 수정하여 다음 목표를 달성할 수 있습니다.

  • 보고서 도구 모음의 내보내기 목록에 렌더링 확장명 이름이 표시되는 방식을 변경하거나(예: "웹 보관"을 "MHTML"로 변경) 이름을 다른 언어로 지역화합니다.

  • 같은 렌더링 확장 프로그램의 여러 인스턴스를 만들어 각기 다른 보고서 표시 옵션(예: 이미지 렌더링 확장 프로그램의 세로 및 가로 모드 버전)을 지원합니다.

  • 다른 값을 사용하도록 기본 렌더링 확장 프로그램 매개 변수를 변경합니다(예: 이미지 렌더링 확장 프로그램은 TIFF를 기본 출력 형식으로 사용합니다. 대신 EMF를 사용하도록 확장 매개 변수를 수정할 수 있음).

렌더링 확장 프로그램 매개 변수를 변경하면 보고서 서버의 렌더링 작업에만 영향을 줍니다. 보고서 디자이너 보고서 미리 보기에서는 렌더링 확장 프로그램 설정을 재정의할 수 없습니다.

구성 파일에서 렌더링 확장 프로그램 매개 변수를 지정하면 렌더링 확장 프로그램에 전역적으로 영향을 줍니다. 구성 파일의 설정은 특정 렌더링 확장 프로그램이 사용될 때마다 기본값 대신 사용됩니다. 특정 보고서 또는 렌더링 작업에 대한 렌더링 확장 프로그램 매개 변수를 설정하려면 메서드를 사용 Render 하거나 보고서 URL에 디바이스 정보 설정을 지정하여 디바이스 정보를 프로그래밍 방식으로 지정해야 합니다. 렌더링 작업에 대한 디바이스 정보 설정을 지정하고 디바이스 정보 설정의 전체 목록을 보는 방법에 대한 자세한 내용은 렌더링 확장 프로그램에 디바이스 정보 설정 전달을 참조 하세요.

RSReportServer.config 찾기 및 수정

보고서 출력 형식에 대한 구성 설정은 RSReportServer.config 파일에서 렌더링 확장 매개 변수로 지정됩니다. 구성 파일에서 렌더링 확장 프로그램 매개 변수를 지정하려면 렌더링 매개 변수를 설정하는 XML 구조를 정의하는 방법을 알고 있어야 합니다. 수정할 수 있는 두 가지 XML 구조체가 있습니다.

  • OverrideNames 요소는 렌더링 확장 프로그램의 표시 이름과 언어를 정의합니다.

  • DeviceInfo XML 구조는 렌더링 확장 프로그램에서 사용하는 디바이스 정보 설정을 정의합니다. 대부분의 렌더링 확장 프로그램 매개 변수는 디바이스 정보 설정으로 지정됩니다.

텍스트 편집기를 사용하여 파일을 수정할 수 있습니다. 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="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>

관련 콘텐츠