Внедрение отчета на защищенный портал или сайт

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

    Снимок экрана: страница входа в Power BI, отображающая вход для просмотра этого диалогового окна отчета.

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

    Снимок экрана: пример отчета о продажах и маркетинге.

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

    Снимок экрана: диалоговое окно высоты и ширины se

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

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

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

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

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

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

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

Свойство Описание
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;

}

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

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

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

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

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

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

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

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

  • Классический сервер SharePoint Server не поддерживается, так как для него требуются версии Internet Explorer, предшествующие 11, или включение режима просмотра совместимости.

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

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

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

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

Дальнейшие действия