배달 확장 프로그램 배포

  • 아티클

배달 확장 프로그램은 XML 구성 파일 형식으로 구성 정보를 제공합니다. XML 파일은 배달 확장 프로그램에 대해 정의된 XML 스키마를 준수합니다. 배달 확장 프로그램은 구성 파일을 설정하고 수정하기 위한 인프라를 제공합니다.

배달 확장 프로그램이 교체되거나 업그레이드되면 배달 확장자를 참조하는 모든 구독이 유효하지 기본.

Reporting Services 배달 확장 프로그램이 Microsoft .NET Framework 라이브러리로 작성 및 컴파일되면 해당 디렉터리에 확장을 복사하고 보고서 서버에서 찾을 수 있도록 해당 Reporting Services 구성 파일에 항목을 추가해야 합니다.

구성 파일 확장 프로그램 요소

보고서 서버에 배포하는 배달 확장 프로그램은 구성 파일에서 확장 요소로 입력해야 합니다. 보고서 서버에 대한 구성 파일은 RSReportServer.config입니다.

다음 표에서는 배달 확장 프로그램의 Extension 요소에 대한 특성을 설명합니다.

attribute Description
이름 확장 프로그램의 고유한 이름(예: 전자 메일 배달 확장 프로그램의 경우 "보고서 서버 전자 메일" 또는 파일 공유 배달 확장 프로그램의 경우 "Report Server FileShare")입니다. Name 특성의 최대 길이는 255자입니다. 이름은 구성 파일의 Extension 요소에 있는 모든 항목 중에서 고유해야 합니다. 중복된 이름이 있으면 보고서 서버에서 오류를 반환합니다.
Type 어셈블리 이름과 함께 정규화된 네임스페이스를 포함하는 쉼표로 구분된 목록입니다.
Visible false 값은 배달 확장 프로그램이 사용자 인터페이스에 표시되지 않아야 했음을 나타냅니다. 특성이 포함되지 않은 경우 기본값은 true입니다.

RSReportServer.config 파일에 대한 자세한 내용은 Reporting Services 구성 파일을 참조 하세요.

보고서 서버에 확장 배포

보고서 서버는 알림 또는 보고서를 처리하고 배달하기 위해 배달 확장 프로그램을 사용합니다. 배달 확장 프로그램 어셈블리를 프라이빗 어셈블리 형태로 보고서 서버에 배포해야 합니다. 또한 보고서 서버 구성 파일 RSReportServer.config에서 항목을 만들어야 합니다.

보고서 서버에 배달 확장 프로그램 어셈블리 배포

  1. 준비 위치에서 배달 확장자를 사용하려는 보고서 서버의 bin 디렉터리로 어셈블리를 복사합니다. 보고서 서버 bin 디렉터리의 기본 위치는 %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServer\bin.

    Important

    기존 배달 확장 프로그램 어셈블리를 덮어쓰려는 경우 업데이트된 어셈블리를 복사하기 전에 먼저 보고서 서버 서비스를 중지해야 합니다. 어셈블리 복사가 완료된 후 서비스를 다시 시작합니다.

  2. 어셈블리 파일이 복사된 후 RSReportServer.config 파일을 엽니다. RSReportServer.config 파일은 디렉터리에 있습니다 %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServer . 구성 파일에서 배달 확장 프로그램 어셈블리 파일에 대한 항목을 만들어야 합니다. Microsoft Visual Studio 또는 메모장 같은 간단한 텍스트 편집기를 사용하여 구성 파일을 열 수 있습니다.

  3. RSReportServer.config 파일에서 Delivery 요소를 찾습니다. 새로 만든 배달 확장 프로그램에 대한 항목은 다음 위치에서 수행해야 합니다.

    <Extensions>  
   <Delivery>  
      <Your extension configuration information goes here>  
   </Delivery>  
</Extensions>

  4. 배달 확장 프로그램에 대한 항목을 추가합니다. 항목에는 Name 및 Type에 대한 값이 있는 Extension 요소가 포함되어야 하며 다음과 같이 표시될 수 있습니다.

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

    Name 값은 배달 확장 프로그램의 고유한 이름입니다. Type 값은 인터페이스를 구현 IDeliveryExtension 하는 클래스의 정규화된 네임스페이스에 대한 항목과 어셈블리 이름(.dll 파일 확장명 제외)을 포함하는 쉼표로 구분된 목록입니다. 기본적으로 배달 확장 프로그램이 표시됩니다. 웹 포털과 같은 사용자 인터페이스에서 확장을 숨기려면 확장 요소에 Visible 특성을 추가하고 false로 설정합니다.

  5. 마지막으로 배달 확장 프로그램에 대한 FullTrust 권한을 부여하는 사용자 지정 어셈블리에 대한 코드 그룹을 추가합니다. 기본적으로 %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServer에 있는 rssrvpolicy.config 파일에 코드 그룹을 추가하여 이 단계를 수행합니다. 코드 그룹은 다음 예제와 같이 표시될 수 있습니다.

    <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 멤버 자격은 배달 확장 프로그램에 대해 선택할 수 있는 많은 멤버 자격 조건 중 하나일 뿐입니다. SSRS의 코드 액세스 보안에 대한 자세한 내용은 보안 개발(Reporting Services)을 참조 하세요.

배포 확인

웹 서비스 ListExtensions 방법을 사용하여 배달 확장 프로그램이 보고서 서버에 성공적으로 배포되었는지 확인할 수 있습니다. 웹 포털을 열고 확장 프로그램이 구독에 대해 사용 가능한 배달 확장 프로그램 목록에 포함되어 있는지 확인할 수도 있습니다. 웹 포털 및 구독에 대한 자세한 내용은 구독 및 배달(Reporting Services)을 참조하세요.

관련 콘텐츠