SharePoint 사이트에 SQL Server Reporting Services 보고서 뷰어 웹 파트 배포Deploy the SQL Server Reporting Services Report Viewer web part on a SharePoint site

적용 대상:APPLIES TO: ✔ SQL Server 2016 Reporting Services 이상✔ SQL Server 2016 Reporting Services and later ✔ Power BI Report Server✔ Power BI Report Server ✔ SharePoint 2013 이상✔ SharePoint 2013 & later ❌ SharePoint Online❌ SharePoint Online✔ SQL Server 2016 Reporting Services 이상✔ SQL Server 2016 Reporting Services and later ✔ Power BI Report Server✔ Power BI Report Server ✔ SharePoint 2013 이상✔ SharePoint 2013 & later ❌ SharePoint Online❌ SharePoint Online

보고서 뷰어 웹 파트는 SharePoint 사이트 내에서 SQL Server Reporting Services(기본 모드) 보고서를 보는 데 사용할 수 있는 사용자 지정 웹 파트입니다.The Report Viewer web part is a custom web part that can be used to view SQL Server Reporting Services (native mode) reports within your SharePoint site. 웹 파트를 사용하여 보고서 서버에서 보고서를 보고, 탐색하고, 인쇄하고, 내보낼 수 있습니다.You can use the web part to view, navigate, print, and export reports on a report server. 보고서 뷰어 웹 파트는 SQL Server Reporting Services 보고서 서버 또는 Power BI Report Server에서 처리하는 보고서 정의 파일(.rdl)과 연결됩니다.The Report Viewer web part is associated with report definition (.rdl) files that are processed by a SQL Server Reporting Services report server or a Power BI Report Server. 이 보고서 뷰어 웹 파트는 Power BI Report Server에서 호스트되는 Power BI 보고서와 함께 사용할 수 없습니다.This Report Viewer web part cannot be used with Power BI reports hosted in Power BI Report Server.

다음 지침을 사용하여 SharePoint Server 2013, SharePoint Server 2016 또는 SharePoint Server 2019 환경에 보고서 뷰어 웹 파트를 추가하는 솔루션 패키지를 수동으로 배포할 수 있습니다.Use the following instructions to manually deploy the solution package that add the Report Viewer web part to a SharePoint Server 2013, SharePoint Server 2016, or SharePoint Server 2019 environment. 솔루션을 배포하는 것은 웹 파트를 구성하기 위한 필수 단계입니다.Deploying the solution is a required step for configuring the web part.

보고서 뷰어 웹 파트는 독립 실행형 솔루션 패키지이며 SQL Server Reporting Services에 대한 SharePoint 통합 모드로 연결되어 있지 않습니다.The Report Viewer web part is a standalone solution package and is not associated with SharePoint integrated mode for SQL Server Reporting Services.

요구 사항Requirements

重要

버전 “15.X.X.X”로 시작하면 ReportViewerWebPart를 기존 Reporting Services SharePoint 통합 모드 공유 서비스 애플리케이션과 나란히 설치할 수 있습니다.Starting with version "15.X.X.X" you can install the ReportViewerWebPart side by side with your existing Reporting Services SharePoint integrated mode shared service applications. 이 .wsp 솔루션 업데이트를 통해 새 파일과 이전 솔루션은 취소하고 Uninstall-SPSolution 및 Install-SPSolution cmdlet을 각각 사용하여 새 .wsp를 다시 배포해야 합니다.With this update of the .wsp solution we introduced new files and the previous solution must be retracted and the new .wsp redeployed by using the Uninstall-SPSolution and Install-SPSolution cmdlets, respectively.

SharePoint Server 버전 지원:Support SharePoint Server versions:

  • SharePoint Server 2019SharePoint Server 2019
  • SharePoint Server 2016SharePoint Server 2016
  • SharePoint Server 2013SharePoint Server 2013

Reporting Services 버전 지원:Support Reporting Services versions:

  • SQL Server 2008 Reporting Services(기본 모드) 이상SQL Server 2008 Reporting Services (Native mode) and later.
  • Power BI Report ServerPower BI Report Server

보고서 뷰어 웹 파트 솔루션 패키지 다운로드Download the Report Viewer web part solution package

보고서 뷰어 웹 파트는 Microsoft 다운로드 센터에서 제공됩니다.The Report Viewer web part is available on the Microsoft Download Center.

보고서 뷰어 웹 파트 솔루션 패키지 다운로드Download Report Viewer web part solution package

팜 솔루션 배포Deploy the farm solution

이 섹션은 SharePoint 팜에 솔루션 패키지를 배포하는 방법을 보여 줍니다.This section shows you how to deploy the solution package to your SharePoint farm. 이 태스크는 한 번만 수행해야 합니다.This task only needs to be performed once.

  1. SharePoint 서버에서 관리자 권한으로 실행 옵션을 사용하여 SharePoint 관리 셸을 엽니다.On a SharePoint server, open a SharePoint Management Shell using the Run as Administrator option.

  2. Add-SPSolution을 실행하여 팜 솔루션을 추가합니다.Run Add-SPSolution to add the farm solution.

    Add-SPSolution -LiteralPath "{path to file}\ReportViewerWebPart.wsp"
    

    이 cmdlet을 실행하면 솔루션의 이름, 솔루션 ID 및 Deployed=False가 반환됩니다.The cmdlet returns the name of the solution, its solution ID, and Deployed=False. 다음 단계에서는 솔루션을 배포합니다.In the next step, you will deploy the solution.

  3. Install-SPSolution cmdlet을 실행하여 팜 솔루션을 배포합니다.Run the Install-SPSolution cmdlet to deploy the farm solution.

    SharePoint 2013SharePoint 2013

    Install-SPSolution -Identity ReportViewerWebPart.wsp -CompatibilityLevel "14,15" -GACDeployment -WebApplication {URL to web application}
    

    SharePoint Server 2016 및 2019SharePoint Server 2016 and 2019

    Install-SPSolution -Identity ReportViewerWebPart.wsp -GACDeployment -WebApplication {URL to web application}
    

기능 활성화Activate feature

  1. SharePoint 사이트의 왼쪽 위에서 기어 아이콘을 선택하고 사이트 설정 을 선택합니다.In your SharePoint site, select the gear icon in the upper left and select Site Settings.

    기어 아이콘에서 사이트 설정.

    기본적으로 SharePoint 웹 애플리케이션은 포트 80을 통해 액세스됩니다.By default, SharePoint web applications are accessed through port 80. 즉, 루트 사이트 모음을 열기 위해 종종 https:// 를 입력하여 SharePoint 사이트에 액세스할 수 있습니다.This means that you can often access a SharePoint site by entering https:// to open the root site collection.

  2. 사이트 컬렉션 관리 에서 사이트 컬렉션 기능 을 선택합니다.In Site Collection Administration, select Site collection features.

  3. 보고서 뷰어 웹 파트 기능을 찾을 때까지 페이지를 아래로 스크롤합니다.Scroll down the page until you find the Report Viewer web part Feature.

  4. 활성화 를 선택합니다.Select Activate.

    보고서 뷰어 웹 파트 기능 활성화

  5. 각 사이트를 열고 사이트 작업을 클릭하여 추가 사이트 모음에 대해 위 단계를 반복합니다.Repeat for additional site collections by opening each site and clicking Site Actions.

필요에 따라 Enable-SPFeature cmdlet을 사용하여 모든 사이트에서 이 기능을 활성화하는 데 PowerShell을 사용할 수도 있습니다.Optionally, you can also use PowerShell to enable this feature on all sites using the Enable-SPFeature cmdlet.

Get-SPWebApplication "<web application url>" | Get-SPSite -Limit ALL | 
        ForEach-Object {
            Write-Host "Enabling feature for $($_.URL)"
            Enable-SPFeature -identity "ReportViewerWebPart" -URL $_.URL -ErrorAction Continue
        }

솔루션 제거Remove the solution

SharePoint 중앙 관리에서 솔루션 취소 기능을 제공하기는 하지만 설치 또는 패치 배포 문제를 체계적으로 해결하는 경우가 아니면 ReportViewerWebPart.wsp 파일을 취소할 필요가 없습니다.Although SharePoint Central Administration provides solution retraction, you do not need to retract the ReportViewerWebPart.wsp file unless you are systematically troubleshooting an installation or patch deployment problem.

  1. SharePoint 중앙 관리의 시스템 설정 에서 팜 솔루션 관리 를 선택합니다.In SharePoint Central Administration, in System Settings, select Manage farm solutions.

  2. ReportViewerWebPart.wsp 를 선택합니다.Select ReportViewerWebPart.wsp.

  3. 솔루션 취소를 선택합니다.Select Retract Solution.

사이트 설정에서 웹 파트 제거Remove the web part from Site settings

솔루션을 제거해도 SharePoint 사이트 내의 웹 파트 목록에서 보고서 뷰어 웹 파트는 제거되지 않습니다.Retracting the solution does not remove the Report Viewer web part from the list of web parts within your SharePoint site. 보고서 뷰어 웹 파트를 제거하려면 다음을 수행합니다.To remove the Report Viewer web part, do the following.

  1. SharePoint 사이트의 왼쪽 위에서 기어 아이콘을 선택하고 사이트 설정 을 선택합니다.In your SharePoint site, select the gear icon in the upper left and select Site Settings.

    기어 아이콘에서 사이트 설정.

    기본적으로 SharePoint 웹 애플리케이션은 포트 80을 통해 액세스됩니다.By default, SharePoint web applications are accessed through port 80. 즉, 루트 사이트 모음을 열기 위해 종종 https:// 를 입력하여 SharePoint 사이트에 액세스할 수 있습니다.This means that you can often access a SharePoint site by entering https:// to open the root site collection.

  2. 웹 디자이너 갤러리 아래에서 웹 파트 를 선택합니다.Under Web Designer Galleries, select web parts.

  3. ReportViewerNativeMode.dwp 옆의 편집 아이콘 을 선택합니다.Select the edit icon next to ReportViewerNativeMode.dwp. 결과의 첫 페이지에 표시되지 않을 수 있습니다.It may not be listed on the first page of results.

  4. 항목 삭제 를 선택합니다.Select Delete Item.

    보고서 뷰어 기본 모드 웹 파트 편집 및 삭제

웹 파트 삭제는 PowerShell을 사용하여 시도될 수 있지만 직접 명령이 없습니다.Deletion of the web part can be attempted by using PowerShell, but there is not a direct command for it. 스크립트 예제는 웹 파트 갤러리에서 웹 파트를 삭제하는 방법을 참조하세요.For a script example, see How to delete web parts from the web part Gallery.

지원되는 언어Supported languages

웹 파트에 지원되는 언어는 다음과 같습니다.The following languages are supported with the web part:

  • 영어(en)English (en)
  • 독일어(de)German (de)
  • 스페인어(sp)Spanish (sp)
  • 프랑스어(fr)French (fr)
  • 이탈리아어(it)Italian (it)
  • 일본어(ja)Japanese (ja)
  • 한국어(ko)Korean (ko)
  • 포르투갈어(pt)Portuguese (pt)
  • 러시아어(ru)Russian (ru)
  • 중국어(간체 - zh-HANS 및 zh-CHS)Chinese (Simplified - zh-HANS and zh-CHS)
  • 중국어(번체 - zh-HANT 및 zh-CHT)Chinese (Traditional - zh-HANT and zh-CHT)

문제 해결Troubleshoot

  • SharePoint 통합 모드가 구성된 경우, SSRS를 제거할 때 오류가 발생합니다.Error when uninstalling SSRS if you have SharePoint integrated mode configured:

    Install-SPRSService : [A] Microsoft.ReportingServices.SharePoint.SharedService.Service.ReportingWebService는 [B]Microsoft.ReportingServices.SharePoint.SharedService.Service.ReportingWebService로 캐스팅할 수 없습니다.Install-SPRSService : [A] Microsoft.ReportingServices.SharePoint.SharedService.Service.ReportingWebService cannot be cast to [B]Microsoft.ReportingServices.SharePoint.SharedService.Service.ReportingWebService. A 형식은 'C:\Windows\assembly\GAC_MSIL\Microsoft.Reporting Services.SharePoint.SharedService.dll' 위치의 ‘기본값’ 컨텍스트에 있는 'Microsoft.ReportingServices.SharePoint.SharedService,Version=14.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91'에서 발생합니다.Type A originates from 'Microsoft.ReportingServices.SharePoint.SharedService,Version=14.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91' in the context 'Default' at location 'C:\Windows\assembly\GAC_MSIL\Microsoft.Reporting Services.SharePoint.SharedService.dll'. B 형식은 'C:\Windows\assembly\GAC_MSIL\Microsoft.Reporting Services.SharePoint.SharedService.dll' 위치의 ‘기본값’ 컨텍스트에 있는 'Microsoft.ReportingServices.SharePoint.SharedService,Version=12.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91'에서 발생합니다.Type B originates from 'Microsoft.ReportingServices.SharePoint.SharedService,Version=12.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91' in the context 'Default' at location 'C:\Windows\assembly\GAC_MSIL\Microsoft.Reporting Services.SharePoint.SharedService.dll'.

    해결 방법:Solution:

    1. 보고서 뷰어 웹 파트 제거Remove the Report Viewer web part
    2. SSRS 제거Uninstall SSRS
    3. 보고서 뷰어 웹 파트 다시 설치Reinstall the Report Viewer web part
  • SharePoint 통합 모드가 구성된 경우, SharePoint를 업그레이드하려고 할 때 오류가 발생합니다.Error when trying to upgrade SharePoint if you have SharePoint integrated mode configured:

    파일 또는 어셈블리 'Microsoft.ReportingServices.Alerting.ServiceContract, Version=14.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91' 또는 해당 종속성 중 하나를 로드할 수 없습니다.Could not load file or assembly 'Microsoft.ReportingServices.Alerting.ServiceContract, Version=14.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91' or one of its dependencies. 시스템은 지정된 파일을 찾을 수 없습니다.The system cannot find the file specified. 00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000

    해결 방법:Solution:

    1. 보고서 뷰어 웹 파트 제거Remove the Report Viewer web part
    2. SSRS 제거Uninstall SSRS
    3. 보고서 뷰어 웹 파트 다시 설치Reinstall the Report Viewer web part

다음 단계Next steps

보고서 뷰어 웹 파트를 배포 및 활성화한 후 SharePoint 페이지에 웹 파트를 추가할 수 있습니다.After the Report Viewer web part has been deployed and activated, you can add the web part to a SharePoint page. 자세한 내용은 SharePoint 페이지에 보고서 뷰어 웹 파트 추가를 참조하세요.For more information, see Add Report Viewer web part to a SharePoint page.

추가 질문이 있으신가요?More questions? Reporting Services 포럼에서 질문하기Try asking the Reporting Services forum