Внедрение отчета на защищенный портал или сайт
С помощью параметра Внедрение для отчетов Power BI вы можете легко и безопасно внедрять отчеты на внутренние веб-порталы. Эти порталы могут быть облачными или локальными, например SharePoint 2019. Внедренные отчеты учитывают все разрешения элементов и безопасность данных благодаря безопасности на уровне строк (RLS) и безопасности на уровне объектов табличной модели Analysis Services (OLS). Они не обеспечивают внедрение кода в любой портал, который принимает URL-адрес или IFrame.
Действие Внедрение поддерживает фильтры URL-адресов и параметры URL-адресов. Это позволяет интегрироваться с порталами, используя подход с низким уровнем кода, который требует только базовых знаний HTML и JavaScript.
Внедрение отчетов Power BI на порталы
Откройте отчет в службе Power BI.
В меню Файл выберите Внедрить отчет>Веб-сайт или портал.
В диалоговом окне Безопасный код внедрения выберите значение в разделе Вот ссылка, которую можно использовать для внедрения этого содержимого. Если вы хотите использовать IFrame в блоге или на веб-сайте, выберите значение в разделе HTML, которое можно вставить на веб-сайт.
Независимо от того, открывает ли пользователь URL-адрес отчета напрямую или внедрен на веб-портале, для доступа к отчету требуется проверка подлинности. Следующий экран отображается, если пользователь не вошел в Power BI в своем сеансе браузера. При нажатии кнопки Войти откроется новое окно или вкладка браузера. Если не отображается запрос на вход, нужно проверить, не блокируются ли всплывающие окна.
После того, как пользователь выполнит вход, открывается отчет с данными и средствами для навигации между страницами и настройки фильтров. Только пользователи с разрешением на просмотр могут просматривать отчет в Power BI. Применяются также все правила безопасности на уровне строк (RLS). Наконец, пользователю требуются надлежащие права: Им требуется лицензия Power BI Pro или Premium на пользователя (PPU). Кроме того, отчет должен находиться в рабочей области, которая находится в Power BI Premium емкости. Пользователь должен выполнять вход каждый раз, когда открывает новое окно браузера. Однако после входа другие отчеты загружаются автоматически.
При использовании IFrame может потребоваться изменить значения высоты и ширины , чтобы они помещались на веб-странице портала.
Предоставление доступа к отчетам
Параметр Внедрение не предоставляет пользователям автоматических прав на просмотр отчета. Разрешения на просмотр задаются в службе 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.
Откройте в браузере отчет, размещенный в службе Power BI, и скопируйте URL-адрес из адресной строки.
Добавьте свойство 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.
Пользователь должен выполнить вход для просмотра отчета каждый раз, когда открывает новое окно браузера.
Некоторые браузеры требуют обновления страницы после входа, особенно при использовании режимов 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. По истечении срока действия маркера проверки подлинности пользователю потребуется снова войти в систему, чтобы получить обновленный маркер проверки подлинности. Время существования по умолчанию составляет один час, но в вашей организации оно может быть короче или дольше. В этом сценарии невозможно автоматически обновить маркер.