배달 확장 프로그램 배포Deploying a Delivery Extension

배달 확장 프로그램은 XML 구성 파일 형식으로 구성 정보를 제공합니다.Delivery extensions supply their configuration information in the form of an XML configuration file. XML 파일은 배달 확장 프로그램에 대해 정의된 XML 스키마를 따릅니다.The XML file conforms to the XML schema defined for delivery extensions. 배달 확장 프로그램은 구성 파일을 설정하고 수정하기 위한 인프라를 제공합니다.Delivery extensions provide infrastructure for setting and modifying the configuration file.

배달 확장 프로그램이 교체되거나 업그레이드되어도 배달 확장 프로그램을 참조하는 모든 구독은 유효합니다.If a delivery extension is replaced or upgraded, all subscriptions that reference the delivery extension remain valid.

작성 하 고 컴파일된 후 프로그램 Reporting ServicesReporting Services 배달 확장 프로그램을는 MicrosoftMicrosoft .NET Framework.NET Framework 라이브러리 확장 적절 한 디렉터리에 복사 하 고 적절 한 항목을 추가 Reporting ServicesReporting Services 구성 파일을 보고서 서버에서 찾을 수 있도록 합니다.After you have written and compiled your Reporting ServicesReporting Services delivery extension into a MicrosoftMicrosoft .NET Framework.NET Framework library, you must copy the extension to the appropriate directory and add an entry to the appropriate Reporting ServicesReporting Services configuration file so the report server can locate it.

구성 파일 확장 프로그램 요소Configuration-File Extension Element

보고서 서버에 배포 하는 배달 확장 프로그램으로 입력 해야 확장 구성 파일에 있는 요소입니다.Delivery extensions that you deploy to the report server need to be entered as Extension elements in the configuration file. 보고서 서버에 대한 구성 파일은 RSReportServer.config입니다.The configuration file for the report server is RSReportServer.config.

다음 표에서 설명에 대 한 특성은 확장 배달 확장 프로그램에 대 한 요소입니다.The following table describes the attributes for the Extension element for delivery extensions.

AttributeAttribute DescriptionDescription
이름Name 확장 프로그램에 대한 고유한 이름으로서 예를 들면 전자 메일 배달 확장 프로그램의 경우 "Report Server E-Mail", 파일 공유 배달 확장 프로그램의 경우 "Report Server FileShare" 등입니다.A unique name for the extension (for example, "Report Server E-Mail" for the e-mail delivery extension or "Report Server FileShare" for the file share delivery extension). Name 특성의 최대 길이는 255자입니다.The maximum length for the Name attribute is 255 characters. 이름은 구성 파일의 Extension 요소에 있는 모든 항목 중에서 고유해야 합니다.The name must be unique among all entries within the Extension 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 delivery extension should not be visible in user interfaces. 이 특성이 포함되지 않을 경우 기본값은 true입니다.If the attribute is not included, the default value is true.

RSReportServer.config 파일에 대 한 자세한 내용은 참조 Reporting Services Configuration Files합니다.For more information about the RSReportServer.config file, see Reporting Services Configuration Files.

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

보고서 서버에서는 알림이나 보고서의 처리 및 배달을 위해 배달 확장 프로그램을 사용합니다.The report server uses delivery extensions for processing and delivering notifications or reports. 배달 확장 프로그램 어셈블리를 전용 어셈블리 형태로 보고서 서버에 배포해야 합니다.You should deploy your delivery 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 a deliver extension assembly to a report server

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

    중요

    기존 배달 확장 프로그램 어셈블리를 덮어쓰려는 경우 업데이트된 어셈블리를 복사하기 전에 먼저 보고서 서버 서비스를 중지해야 합니다.If you are attempting to overwrite an existing delivery extension assembly, you must first stop the Report Server service before copying the updated assembly. 어셈블리 복사가 완료된 후 서비스를 다시 시작합니다.Restart your service after the assembly is through copying.

  2. 어셈블리 파일이 복사된 후 RSReportServer.config 파일을 엽니다.After the assembly file is copied, open the RSReportServer.config file. RSReportServer.config 파일은 %ProgramFiles%\Microsoft SQL Server\MSRS13에에서 있습니다. <InstanceName > services\reportserver 디렉터리입니다.The RSReportServer.config file is located in the %ProgramFiles%\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer directory. 구성 파일에서 배달 확장 프로그램 어셈블리 파일에 대한 항목을 만들어야 합니다.You need to make an entry in the configuration file for your delivery extension assembly file. 구성 파일을 열면 MicrosoftMicrosoft Visual StudioVisual Studio 또는 메모장과 같은 간단한 텍스트 편집기입니다.You can open the configuration file with MicrosoftMicrosoft Visual StudioVisual Studio or a simple text editor, such as Notepad.

  3. 찾을 배달 RSReportServer.config 파일의 요소입니다.Locate the Delivery element in the RSReportServer.config file. 새로 만든 배달 확장 프로그램에 대한 항목이 다음 위치에 있어야 합니다.An entry for your newly created delivery extension should be made in the following location:

    <Extensions>  
       <Delivery>  
          <Your extension configuration information goes here>  
       </Delivery>  
    </Extensions>  
    
  4. 배달 확장 프로그램에 대한 항목을 추가합니다.Add an entry for your delivery extension. 입력 한 내용을 포함 되어야는 확장 에 대 한 값이 있는 요소 이름형식, 하며 다음과 같습니다.Your entry should include an Extension element with values for Name and Type, and might look like the following:

    <Extension Name="My Delivery Extension Name" Type="CompanyName.ExtensionName.MyDeliveryExtensionClass, AssemblyName" />  
    

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

  5. 마지막으로, 권한을 부여 하는 사용자 지정 어셈블리에 대 한 코드 그룹을 추가 FullTrust 배달 확장 프로그램에 대 한 권한이 있습니다.Finally, add a code group for your custom assembly that grants FullTrust permission for your delivery extension. 기본적으로 %ProgramFiles%\Microsoft SQL Server\MSRS13에에서 rssrvpolicy.config 파일에 코드 그룹을 추가 하 여이 작업을 수행 합니다. <InstanceName > services\reportserver입니다.You do this by adding the code group to the rssrvpolicy.config file located by default in %ProgramFiles%\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer. 코드 그룹은 다음과 같습니다.Your code group might look like the following:

    <CodeGroup class="UnionCodeGroup"  
       version="1"  
       PermissionSetName="FullTrust"  
       Name="MyExtensionCodeGroup"  
       Description="Code group for my delivery extension">  
          <IMembershipCondition class="UrlMembershipCondition"  
             version="1"  
             Url="C:\Program Files\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer\bin\MyExtensionAssembly.dll"  
           />  
    </CodeGroup>  
    

    URL 멤버 자격은 배달 확장 프로그램에 대해 선택할 수 있는 많은 멤버 자격 조건 중 하나일 뿐입니다.URL membership is only one of many membership conditions you might choose for your delivery extension. 코드 액세스 보안에 대 한 자세한 내용은 SSRSSSRS를 참조 하세요. 개발 ( 보안 Reporting services)For more information about code access security in SSRSSSRS, see.Secure Development (Reporting Services)

배포 확인Verifying the Deployment

웹 서비스 ListExtensions 메서드를 사용하여 배달 확장 프로그램이 보고서 서버에 성공적으로 배포되었는지 여부를 확인할 수 있습니다.You can verify whether your delivery extension was deployed successfully to the report server by using the Web service ListExtensions method. 웹 포털을 열고 확장 프로그램이 구독에 대 한 사용 가능한 배달 확장 프로그램 목록에 포함 되어 있는지 확인 하십시오. 수도 있습니다.You can also open the web portal and verify that your extension is included in the list of available delivery extensions for a subscription. 웹 포털 및 구독에 대 한 자세한 내용은 참조 구독 및 배달 ( Reporting services) .For more information about the web portal and subscriptions, see Subscriptions and Delivery (Reporting Services).

관련 항목:See Also

배달 확장 프로그램 구현 Implementing a Delivery Extension
Reporting Services 확장 프로그램 라이브러리Reporting Services Extension Library