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

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

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

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

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

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

    Website or portal option

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

    Embed option dialog box

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

    Sign in to view this report

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

    Embed report

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

    Set height and width

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

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

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

    Report section

  2. Добавьте в URL-адрес параметр pageName.

    Append pageName

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

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

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

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

  • Защищенное внедрение работает только для отчетов, опубликованных в службе Power BI.

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

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

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

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

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

  • Возможность автоматической аутентификации, предоставляемая параметром Внедрение, не работает с API JavaScript для Power BI. При работе с API JavaScript для Power BI следует использовать метод внедрения данные принадлежат пользователю.

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

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