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

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

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

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

Настройка интерфейса внедрения с помощью параметров 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;

}

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

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

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

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

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

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

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

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

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

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

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

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

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