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

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

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

Внимание

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

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

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

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

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

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

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

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

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

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

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

<iframe width="1080" height="760" src="https://app.powerbi.com/reportEmbed?reportId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb&autoAuth=true" frameborder="0" allowFullScreen="true"></iframe>

В этом примере aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb представляет уникальный идентификатор отчета (GUID). Замените это значение на фактический идентификатор вашего отчета, который можно найти в диалоговом окне кода внедрения, выбрав Внедрить отчет>.

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

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

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

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

Чтобы просмотреть встроенный отчет, каждому пользователю требуется лицензия Power BI Pro или Premium Per User (PPU), если только и отчет, и его семантическая модель не размещены на емкости Power BI Premium или Fabric F64 или выше.

Бесплатные пользователи получают запрос на обновление лицензии, если отчет или ее семантическая модель не хранятся в соответствующей емкости. Назначьте пользователю с правами просмотра лицензию Pro или PPU либо переместите оба элемента в соответствующую требованиям емкость.

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

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

Свойство Описание
ИмяСтраницы Используйте параметр строки запроса pageName , чтобы задать открытую страницу отчета. Найдите это значение в конце URL-адреса отчета при просмотре отчета в служба Power BI, как показано далее в этой статье.
Фильтры URL-адресов Используйте фильтры URL в URL-адресе внедрения, который вы получаете в интерфейсе Power BI, чтобы фильтровать встроенное содержимое. Используя этот метод, вы можете создавать low-code интеграции, имея лишь базовые знания HTML и JavaScript.

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

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

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

    https://app.powerbi.com/groups/me/reports/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/ReportSection2
    

    В этом примере:

    • me указывает, что отчет находится в вашей личной рабочей области (или замените идентификатором рабочей области для общей рабочей области)
    • aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb представляет идентификатор отчета (замените фактическим идентификатором отчета)
    • ReportSection2 — имя страницы
  2. Добавьте свойство pageName и его значение в конец URL-адреса.

    https://app.powerbi.com/reportEmbed?reportId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb&autoAuth=true&pageName=ReportSection2
    

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

}
https://app.powerbi.com/reportEmbed?reportId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb&autoAuth=true&pageName=ReportSection&$filter=Industries/Industry eq 'Energy'

В этом примере:

  • reportId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb — уникальный идентификатор отчета (замените фактическим идентификатором отчета)
  • autoAuth=true — включает автоматическую проверку подлинности
  • pageName=ReportSection — Открывает определенную страницу
  • $filter=Industries/Industry eq 'Energy' — Фильтры для отображения только данных энергетической отрасли

Внимание

Фильтры URL-адресов не являются функцией безопасности и не следует использовать для ограничения доступа к конфиденциальным данным. Пользователи могут изменять или удалять параметры URL-адреса для просмотра нефильтрованных данных или данных с различными фильтрами. Фильтры URL-адресов предназначены только для удобства и начальной настройки представления. Чтобы правильно защитить данные и ограничить доступ пользователей на основе удостоверений или разрешений, используйте безопасность на уровне строк (RLS) или безопасность на уровне объектов (OLS) в модели данных.

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

Включение Copilot в безопасных внедренных отчетах

Вы можете активировать Copilot для безопасных веб-отчетов или встроенных отчетов портала, установив флажок "Включить Copilot" в диалоговом окне внедренных отчетов. Для использования этой функции требуется включённый параметр Copilot на уровне клиента, а также либо Power BI Premium, либо оплачиваемая емкость Fabric в вашей рабочей области. При включении пользователи могут взаимодействовать напрямую с Copilot в внедренных отчетах.

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

    Снимок экрана: выбор меню

  2. Установите флажок "Включить Copilot ".

    Снимок экрана: диалоговое окно вставки с опцией «Включить Copilot».   

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

  • Безопасные сценарии внедрения поддерживают отчеты с разбивкой на страницы, а также поддерживают отчеты с разбивкой на страницы с параметрами URL-адреса. Для получения дополнительной информации см. Передача параметра отчета в URL-адресе для постраничного отчета в Power BI.
  • Параметр безопасной вставки доступен для отчетов, которые вы публикуете в службе Power BI.
  • Чтобы разместить безопасно внедренное содержимое, необходимо использовать HTTPS для страницы верхнего уровня. Служба Power BI не поддерживает использование незащищенной страницы размещения для доступа к безопасно встроенному содержимому.
  • Вам необходимо войти в отчет при открытии нового окна браузера или вкладки.
  • Для проверки подлинности необходимо включить всплывающие окна.
  • Если вам раньше удавалось получать доступ к отчетам, но теперь возникают проблемы, очистите кеш браузера.
  • Для некоторых браузеров требуется обновить страницу после входа, особенно при использовании режимов InPrivate или Incognito.
  • При использовании неподдерживаемых версий браузера могут возникнуть проблемы. Список поддерживаемых браузеров Power BI см. в статье "Поддерживаемые браузеры для Power BI".
  • Если ваш веб-сайт задает заголовок same-originCross-Origin-Opener-Policy (COOP), вы не сможете войти, чтобы просмотреть встроенное содержимое, поскольку MSAL не поддерживает этот заголовок. Вместо этого выберите restrict-properties (для браузеров на основе Chromium) или same-origin-allow-popups. В качестве альтернативы, если вы не можете изменить политику Cross-Origin-Opener-Policy, дайте прямую ссылку на встроенный URL-адрес вместо встраивания его в iframe.
  • Служба Power BI не поддерживает классический SharePoint Server, так как для него требуется Internet Explorer версии ниже 11 или включение режима совместимости.
  • Чтобы обеспечить единый вход, используйте опцию Embed in SharePoint Online или создайте пользовательскую интеграцию с помощью метода встраивания user-owns-data.
  • Возможности автоматической проверки подлинности, предоставляемые параметром внедрения , не работают с API JavaScript Power BI. Они блокируются во встроенном клиентском пакете SDK для PBI, начиная с версии 2.10.4. Для API JavaScript Power BI используйте метод встраивания user-owns-data.
  • Возможности автоматической проверки подлинности не работают при их внедрении в приложения, в том числе в мобильных и классических приложениях.
  • Параметры в Microsoft Entra определяют срок действия токена аутентификации. Когда срок действия маркера проверки подлинности истекает, пользователь должен снова войти, чтобы получить обновленный маркер проверки подлинности. Время существования по умолчанию составляет один час, но в организации может быть меньше или больше. Вы не можете автоматически обновить маркер в этом сценарии.
  • Служба Power BI не поддерживает гостевые учетные записи Azure B2B, и пункт Внедрить отчет> не отображается.
  • Если щелкнуть правой кнопкой мыши по визуальному элементу в защищенном внедренном отчете, визуальное меню будет отличаться от стандартного контекстного меню в незащищенном внедренном отчете и предлагать меньше вариантов.