Внедрение отчета на защищенном портале или веб-сайте

С помощью параметра внедрения отчетов Power BI можно легко и безопасно внедрять отчеты на внутренних веб-порталах. Эти порталы могут быть облачными или размещенными в локальной среде, например SharePoint 2019. Внедренные отчеты учитывают все разрешения элементов и безопасность данных с помощью безопасности на уровне строк (RLS) и табличной модели analysis Services (OLS). Они предоставляют отсутствие кода, внедряемого на любой портал, который принимает URL-адрес или iframe.

Параметр внедрения поддерживает фильтры URL-адресов и параметры URL-адресов. Это позволяет интегрироваться с порталами с помощью низкокодового подхода, требующего только базовых знаний HTML и JavaScript.

Внедрение отчетов Power BI на порталы

1. Откройте отчет в служба Power BI.

2. В меню "Файл" выберите "Внедрить веб-сайт отчета>" или "Портал".

   

3. В диалоговом окне "Безопасный код внедрения" выберите значение в разделе "Ссылка", которую можно использовать для внедрения этого содержимого. Или если вы хотите использовать iframe в блоге или веб-сайте, выберите значение в формате HTML, которое можно вставить на веб-сайт.

   

4. Независимо от того, открывает ли пользователь URL-адрес отчета напрямую или один, внедренный на веб-портале, доступ к отчету требует проверки подлинности. На следующем экране отображается, если пользователь не вошел в Power BI в сеансе браузера. При выборе входа откроется новое окно браузера или вкладка. Получите их проверка для блокировщиков всплывающих окон, если они не получат запрос на вход.

   

5. После входа в отчет откроется отчет, отображающий данные и разрешающий навигацию по страницам и параметр фильтра. Только пользователи с разрешением на просмотр могут просматривать отчет в Power BI. Также применяются все правила безопасности на уровне строк (RLS ). Пользователям необходимо правильно лицензироваться. Им нужна лицензия Power BI Pro или Premium на пользователя (PPU), или содержимое должно находиться в рабочей области, которая находится в емкости Power BI Premium. Пользователи должны войти каждый раз, когда они открывают новое окно браузера. Однако после входа другие отчеты загружаются автоматически.

   

6. При использовании iframe может потребоваться изменить высоту и значения ширины , чтобы он соответствовал веб-странице портала.

   

Предоставление доступа к отчетам

Параметр внедрения не позволяет пользователям автоматически просматривать отчет. Разрешения просмотра задаются в служба Power BI.

В служба Power BI можно совместно использовать внедренные отчеты с пользователями, которым требуется доступ. Если вы используете группу Microsoft 365, вы можете перечислить пользователя в качестве члена рабочей области.

Лицензирование

Чтобы просмотреть внедренный отчет, требуется лицензия Power BI Pro или Premium на пользователя (PPU). Или содержимое должно находиться в рабочей области, которая находится в емкости Power BI Premium (EM или P SKU).

Настройка интерфейса внедрения с помощью параметров URL-адреса

Вы можете настроить взаимодействие с пользователем с помощью входных параметров URL-адреса внедрения. В предоставленном iframe можно обновить параметры URL-адреса.

Свойство	Description
pageName	Параметр строки запроса pageName можно использовать для задания открываемой страницы отчета. Это значение можно найти в конце URL-адреса отчета при просмотре отчета в служба Power BI, как показано далее в этой статье.
Фильтры URL-адресов	Фильтры URL-адресов можно использовать в URL-адресе внедрения, полученном из пользовательского интерфейса Power BI, для фильтрации содержимого внедрения. Таким образом вы можете создавать интеграции с низким кодом только с базовым интерфейсом HTML и JavaScript.

Установка открываемой страницы для внедренного отчета

Значение pageName можно найти в конце URL-адреса отчета при просмотре отчета в служба Power BI.

1. Откройте отчет из служба Power BI в веб-браузере и скопируйте URL-адрес адресной строки.

   

2. Добавьте свойство pageName и его значение в конец URL-адреса.

   

Фильтрация содержимого отчета с помощью фильтров URL-адресов

Фильтры URL-адресов можно использовать для предоставления различных представлений отчетов. Например, следующий URL-адрес фильтрует отчет для отображения данных для энергетической отрасли.

Использование сочетания фильтров pageName и URL-адресов может быть мощным. Вы можете создавать интерфейсы с помощью базового HTML-кода и JavaScript.

Например, вот кнопка, которую можно добавить на HTML-страницу:

<button class="textLarge" onclick='show("ReportSection", "Energy");' style="display: inline-block;">Show Energy</button>

При выборе кнопка вызывает функцию для обновления iframe с обновленным URL-адресом, который включает фильтр энергетической отрасли.

function show(pageName, filterValue)

{

var newUrl = baseUrl + "&pageName=" + pageName;

if(null != filterValue && "" != filterValue)

{

newUrl += "&$filter=Industries/Industry eq '" + filterValue + "'";

}

//Assumes there's an iFrame on the page with id="iFrame"

var report = document.getElementById("iFrame")

report.src = newUrl;

}

Вы можете добавить столько кнопок, сколько вы хотите создать пользовательский интерфейс с низким кодом.

Рекомендации и ограничения

• Отчеты с разбивкой на страницы поддерживаются с безопасными сценариями внедрения, а отчеты с разбивкой на страницы с параметрами URL-адреса также поддерживаются. Дополнительные сведения: Передача параметра отчета в URL-адресе для отчета на страницу в Power BI.

• Параметр безопасного внедрения работает для отчетов, опубликованных в служба Power BI.

• Чтобы разместить безопасно внедренное содержимое, пользователи должны использовать HTTPS для страницы верхнего уровня. Использование незащищенной страницы узла для доступа к безопасно внедренным содержимому не поддерживается.

• Пользователь должен войти в систему, чтобы просмотреть отчет при открытии нового окна браузера.

• Для проверки подлинности пользователям необходимо включить всплывающие окна.

• Если пользователи успешно получили доступ к отчетам в прошлом, но теперь сталкиваются с проблемами, они должны очистить кэш браузера.

• Для некоторых браузеров требуется обновить страницу после входа, особенно при использовании режимов InPrivate или Incognito.

• При использовании неподдерживаемых версий браузера могут возникнуть проблемы. Список поддерживаемых браузеров Power BI см. в статье "Поддерживаемые браузеры для Power BI".

• Если веб-сайт задает заголовок Cross-Origin-Opener-Policy (COOP) на "тот же источник", вы не можете войти в систему, чтобы просмотреть внедренное содержимое, так как MSAL не поддерживает этот заголовок. Вместо этого выберите "ограничить свойства" (для браузеров на основе Chromium) или "одно и то же происхождение-allow-popups". Кроме того, если вы не можете изменить политику cross-Origin-Opener-Policy, свяжите с внедренным URL-адресом напрямую, а не внедряя его в iframe.

• Классический Сервер SharePoint Server не поддерживается, так как для него требуются версии Обозреватель в Интернете до 11 или включение режима просмотра совместимости.

• Чтобы обеспечить единый вход, используйте параметр Внедрения в SharePoint Online или создайте пользовательскую интеграцию с помощью метода внедрения пользовательских данных .

• Возможности автоматической проверки подлинности, предоставляемые параметром внедрения , не работают с API JavaScript Power BI. Они блокируются в встроенном пакете SDK для PBI, начиная с версии 2.10.4. Для API JavaScript Power BI используйте метод внедрения пользовательских данных .

• Возможности автоматической проверки подлинности не работают при их внедрении в приложения, в том числе в мобильных и классических приложениях.

• Время существования маркера проверки подлинности контролируется на основе параметров Microsoft Entra. После истечения срока действия маркера проверки подлинности пользователю потребуется снова войти, чтобы получить обновленный маркер проверки подлинности. Время существования по умолчанию составляет один час, но в организации может быть меньше или больше. Вы не можете автоматически обновить маркер в этом сценарии.

Связанный контент

• Способы предоставления общего доступа к работе в Power BI
• Фильтрация отчета с помощью параметров строки запроса в URL-адресе
• Embed with report web part in SharePoint Online (Внедрение отчетов в SharePoint Online с помощью соответствующей веб-части)
• Publish to web from Power BI (Публикация в Интернете из Power BI)