렌더링 확장 프로그램 배포Deploying a Rendering Extension

작성 하 고 컴파일된 후 프로그램 Reporting ServicesReporting Services 보고서 렌더링 확장 프로그램에는 .NET Framework.NET Framework 라이브러리, 보고서 디자이너 및 보고서 서버에서 검색할 수 있도록 해야 합니다.After you have written and compiled your Reporting ServicesReporting Services report rendering extension into a .NET Framework.NET Framework library, you need to make it discoverable by the report server and by Report Designer. 이 작업을 수행하려면 확장 프로그램을 적절한 디렉터리에 복사하고 해당하는 Reporting ServicesReporting Services 구성 파일에 항목을 추가합니다.To do so, copy the extension to the appropriate directory and add entries to the appropriate Reporting ServicesReporting Services configuration files.

구성 파일 렌더링 확장 프로그램 요소Configuration File Rendering Extension Element

렌더링 확장 프로그램이 .DLL로 컴파일되었으면 항목을 rsreportserver.config 파일에 추가합니다.Once a rendering extension has been compiled into a .DLL, you add an entry into the rsreportserver.config file. 기본적으로 위치는 %ProgramFiles%\Microsoft SQL Server\MSRS10_50입니다. <InstanceName > services\reportserver입니다.By default, the location is %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer. 부모 요소가 <렌더링 > 합니다.The parent element is <Render>. Render 요소 아래에 각 렌더링 확장 프로그램에 대한 Extension 요소가 있습니다.Under the Render element is an Extension element for each rendering extension. Extension 요소에는 Name 및 Type의 두 가지 특성이 포함됩니다.The Extension element contains two attributes, Name and Type.

다음 표에서는 렌더링 확장 프로그램에 대한 Extension 요소의 특성을 설명합니다.The following table describes the attributes for the Extension element for rendering extensions:

AttributeAttribute DescriptionDescription
이름Name 확장 프로그램의 고유한 이름입니다.A unique name for the extension. Name 특성의 최대 길이는 255자입니다.The maximum length for the Name attribute is 255 characters. 이름은 구성 파일의 Extensions 요소 내 모든 항목에서 고유해야 합니다.The name must be unique among all entries within the Extensions element of a configuration file. 중복된 이름이 있을 경우 보고서 서버에서 오류를 반환합니다.If a duplicate name is present, the report server returns an error.
형식Type 정규화된 네임스페이스와 어셈블리 이름을 포함하는 쉼표로 구분된 목록입니다.A comma-separated list that includes the fully qualified namespace along with the name of the assembly.
VisibleVisible false 값은 렌더링 확장 프로그램이 사용자 인터페이스에 표시되지 않음을 나타냅니다.A value of false indicates that the rendering extension should not be visible in user interfaces. 이 특성이 포함되지 않을 경우 기본값은 true입니다.If the attribute is not included, the default value is true.
LogAllExecutionRequestsLogAllExecutionRequests false 값은 세션의 첫 번째 보고서 실행에 대해서만 로그 항목이 기록됨을 나타냅니다.A value of false indicates that an entry is logged for only the first report execution in a session. 이 특성이 포함되지 않을 경우 기본값은 true입니다.If the attribute is not included, the default value is true.

예를 들어 이 설정은 보고서에서 렌더링되는 첫 페이지에 대해서만 로그 항목을 기록할지( false인 경우) 또는 보고서에서 렌더링되는 각 페이지에 대해 로그 항목을 기록할지( true인 경우) 여부를 결정합니다.For example, this setting determines whether to log an entry for only the first page rendered in a report (when false) or an entry for each page rendered in the report (when true).

자세한 내용은 RsReportServer.config 구성 파일을 참조하세요.For more information, see RsReportServer.config Configuration File.

보고서 서버에 확장 프로그램 배포Deploying the Extension to the Report Server

보고서 서버에서는 보고서를 다른 형식으로 내보내기 위해 렌더링 확장 프로그램을 사용합니다.The report server uses rendering extensions to export reports to other formats. 렌더링 확장 프로그램 어셈블리를 전용 어셈블리 형태로 보고서 서버에 배포해야 합니다.You should deploy your rendering extension assembly to the report server as a private assembly. 또한 보고서 서버 구성 파일 rsreportserver.config에서 항목을 만들어야 합니다.You also need to make an entry in the report server configuration file, rsreportserver.config.

어셈블리를 배포하려면To deploy the assembly

  1. 준비 위치에서 렌더링 확장 프로그램을 사용할 보고서 서버의 bin 디렉터리로 어셈블리를 복사합니다.Copy your assembly from your staging location to the bin directory of the report server on which you want to use the rendering extension. 보고서 서버 Bin 디렉터리의 기본 위치는 %ProgramFiles%\Microsoft SQL Server\MSRS10_50입니다. <InstanceName > services\reportserver\bin입니다.The default location of the report server Bin directory is %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer\Bin.

  2. 어셈블리 파일이 복사된 후 rsreportserver.config 파일을 엽니다.After the assembly file is copied, open the rsreportserver.config file. rsreportserver.config 파일도 보고서 서버 bin 디렉터리에 있습니다.The rsreportserver.config file is also located in the report server bin directory. 구성 파일에서 확장 프로그램 어셈블리 파일에 대한 항목을 만들어야 합니다.You need to make an entry in the configuration file for your extension assembly file. 사용 하 여 파일을 열 수 Visual StudioVisual Studio 또는 간단한 텍스트 편집기입니다.You can open the file with Visual StudioVisual Studio or a simple text editor.

    자세한 내용은 RsReportServer.config 구성 파일을 참조하세요.For more information, see RsReportServer.config Configuration File.

  3. Rsreportserver.config 파일에서 Render 요소를 찾습니다.Locate the Render element in the Rsreportserver.config file. 새로 만든 확장 프로그램에 대한 항목이 다음 위치에 있어야 합니다.An entry for your newly created extension should be made in the following location:

    <Extensions>  
       <Render>  
          <extension configuration>  
       </Render>  
    </Extensions>  
    
  4. 렌더링 확장 프로그램에 대한 항목을 추가합니다.Add an entry for your rendering extension. 항목에 NameType에 대한 값이 있는 요소가 포함되어야 하며 다음과 같습니다.Your entry should include an element that has values for Name and Type, and might look like the following:

    <Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />  
    

    Name 에 대한 값은 렌더링 확장 프로그램의 고유한 이름입니다.The value for Name is the unique name of the rendering extension. 에 대 한 값 형식 의 정규화 된 네임 스페이스에 대 한 항목을 포함 하는 쉼표로 구분 된 목록에 IRenderingExtension 구현에서 사용자 어셈블리 (.dll 파일 확장명 제외)의 이름이 차례로 나옵니다.The value for Type is a comma-separated list that includes an entry for the fully qualified namespace of your IRenderingExtension implementation, followed by the name of your assembly (not including the .dll file extension). 기본적으로 렌더링 확장 프로그램은 표시됩니다.By default, rendering extensions are visible. 보고서 관리자와 같은 사용자 인터페이스에 확장 프로그램이 표시되지 않도록 숨기려면 Visible 특성을 Extension 요소에 추가하고 false로 설정합니다.To hide an extension from user interfaces, such as Report Manager, add a Visible attribute to the Extension element, and set it to false.

배포 확인Verifying the deployment

보고서 관리자를 열고 확장 프로그램이 보고서에 대해 사용 가능한 내보내기 유형 목록에 포함되어 있는지 확인할 수도 있습니다.You can also open Report Manager and verify that your extension is included in the list of available export types for a report.

관련 항목:See Also

렌더링 확장 프로그램 구현 Implementing a Rendering Extension
렌더링 확장 프로그램 개요 Rendering Extensions Overview
IRenderingExtension 인터페이스 구현 Implementing the IRenderingExtension Interface
확장에 대한 보안 고려 사항Security Considerations for Extensions