Поделиться через


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

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

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

Внимание

Из-за текущих обновлений системы безопасности Chromium параметр внедрения больше не работает точно так же, как он использовался, и пользователям может потребоваться выполнить проверку подлинности более одного раза. Для решения этой проблемы рекомендуется создать собственное решение Power BI Embedded.

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

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

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

    Снимок экрана: отчет о внедрении, выбранный в меню

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

    Снимок экрана: диалоговое окно

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

    Снимок экрана: страница входа в 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-адреса.

    Снимок экрана: добавление параметра pageName к URL-адресу с выделенным значением pageName=ReportSection 2.

Фильтрация содержимого отчета с помощью фильтров 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;

}

Снимок экрана: Фильтр с фильтром $ равен отрасли косой черты отрасли e q Energy.

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

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

  • Отчеты с разбивкой на страницы поддерживаются с безопасными сценариями внедрения, а отчеты с разбивкой на страницы с параметрами 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. После истечения срока действия маркера проверки подлинности пользователю потребуется снова войти, чтобы получить обновленный маркер проверки подлинности. Время существования по умолчанию составляет один час, но в организации может быть меньше или больше. Вы не можете автоматически обновить маркер в этом сценарии.