Развертывание веб-части "Средство просмотра отчетов" служб SQL Server Reporting Services на сайте SharePointDeploy 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 BIPower BI Report Server ДаSharePoint 2013 и более поздние версииSharePoint 2013 & later нетSharePoint OnlineSharePoint OnlineДаСлужбы SQL Server 2016 Reporting Services и более поздние версииSQL Server 2016 Reporting Services and later ДаСервер отчетов Power BIPower BI Report Server ДаSharePoint 2013 и более поздние версииSharePoint 2013 & later нетSharePoint OnlineSharePoint Online

Веб-часть "Средство просмотра отчетов" — это настраиваемая веб-часть, которую можно использовать для просмотра отчетов служб SQL Server Reporting Services в собственном режиме на сайте SharePoint.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. Веб-часть "Средство просмотра отчетов" связана с файлами определения отчетов (RDL), которые обрабатываются сервером отчетов служб SQL Server Reporting Services или Сервером отчетов Power BI.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, размещенными на Сервере отчетов 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.

Веб-часть "Средство просмотра отчетов" представляет собой отдельный пакет решения и не связана с режимом интеграции с SharePoint для служб SQL Server Reporting Services.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 можно параллельно с существующими приложениями для устройств, совместно используемых в интегрированном режиме SharePoint в Reporting Services.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, соответственно.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 BIPower BI Report Server

Скачивание пакета решения веб-части "Средство просмотра отчетов"Download the Report Viewer web part solution package

Веб-часть "Средство просмотра отчетов" доступна в Центре загрузки Майкрософт.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"
    

    Командлет возвратит имя решения, его идентификатор, а также атрибут 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, чтобы развернуть решение в ферме.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. Это означает, что часто к сайту SharePoint можно получить доступ, введя https:// , чтобы открыть корневое семейство веб-сайтов.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.

При необходимости можно также использовать PowerShell для включения этой функции для всех сайтов с помощью командлета Enable-SPFeature.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. Это означает, что часто к сайту SharePoint можно получить доступ, введя https:// , чтобы открыть корневое семейство веб-сайтов.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

  • Ошибка при удалении служб SSRS в том случае, если настроен режим интеграции с SharePoint:Error when uninstalling SSRS if you have SharePoint integrated mode configured:

    Install-SPRSService : [A] Microsoft.ReportingServices.SharePoint.SharedService.Service.ReportingWebService cannot be cast to [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 происходит из "Microsoft.ReportingServices.SharePoint.SharedService,Version=14.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91" в контексте "Default" в расположении "C:\Windows\assembly\GAC_MSIL\Microsoft.Reporting Services.SharePoint.SharedService.dll".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 происходит из "Microsoft.ReportingServices.SharePoint.SharedService,Version=12.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91" в контексте "Default" в расположении "C:\Windows\assembly\GAC_MSIL\Microsoft.Reporting Services.SharePoint.SharedService.dll".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. Удаление служб SSRSUninstall 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. Удаление служб SSRSUninstall 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