Добавление отчета или панели мониторинга Power BI на веб-страницу на портале

Статья
03/15/2023

Примечание

Начиная с октября 2022 г. порталы Power Apps называются Power Pages.
Эта тема относится к устаревшим возможностям. Актуальную информацию см. в документации по Microsoft Power Pages.

Совет

Эта статья объясняет, как добавить отчет Power BI или панель мониторинга с помощью Liquid-тега powerbi. Чтобы добавить Компонент Power BI на веб-страницу в вашем портале, используя студию порталов, перейдите Добавить компонент Power BI для веб-страницы с использованием студии порталов.

Чтобы добавить отчет или панель мониторинга Power BI на веб-страницу портала, используйте тег Liquid powerbi. Используйте тег powerbi в поле Копия на веб-странице или в поле Источник в веб-шаблоне.

Если вы добавляете отчет или панель мониторинга Power BI, созданную в новой рабочей области в Power BI, необходимо указать тип проверки подлинности powerbiembedded в Liquid-теге powerbi.

Примечание

Если вы указали Microsoft Entra ID в качестве типа аутентификации в Liquid-теге powerbi, необходимо предоставить доступ к нему требуемым пользователям,прежде чем добавлять защищенный отчет или панель мониторинга Power BI на веб-страницу на портале. Дополнительные сведения: Предоставление общего доступа к рабочей области Power BI и предоставление панели мониторинга и отчета Power BI.
powerbiembedded поддерживает панели мониторинга и отчеты Power BI, которые подключаются к службам Azure Analysis Services. Вы также можете использовать свойство customdata в Liquid-коде для передачи значения для свойства CustomData.
Отчеты Power BI с разбивкой по страницам не поддерживаются.

Например:

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

Чтобы узнать о том, как получить путь панели мониторинга и идентификатор плитки панели мониторинга, обратитесь к разделам далее в этой статье.

Использование панели мониторинга или отчета, подключаемого к службам Azure Analysis Services

Вы можете добавить Liquid-тег powerbi с помощью панели мониторинга или отчета, который подключается к службам Azure Analysis Services.

Чтобы добавить панель мониторинга или отчет, подключаемый к Azure Analysis Services, используйте параметр CustomData в строке подключения.

Например:

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/<GroupID>/reports/<ReportID>" roles:"<roles associated with report>" customdata:"<customdata>" %}

Необязательный тег customdata может быть настроен как строка или сгенерирован динамически на основе атрибута объекта, используя точку (".") или квадратные скобки ("[]"), чтобы отделить объект и атрибут, между двумя парами фигурных скобок.

Примеры:

customdata: {{ object.attribute }}
customdata: {{ object[attribute] }}

Поскольку тег customdata возвращает строку, может возникнуть необходимость преобразовать эту строку в целое число в запросе DAX.

Важно!

Порталы не поддерживают панель мониторинга или отчет Power BI, подключающийся к службам Azure Analysis Services, который использует шлюз данных для подключения к локальному источнику данных.
Версия портала должна быть 9.3.4.x или позже для работы этой функции.

Службы Azure Analysis Services и Roles (RLS)

Тег roles не является обязательным для отчетов и панелей мониторинга, основанных на службах Azure Analysis Services. При он не используется, роль по умолчанию будет ролью, назначенной приложению в Azure Analysis Services.

Однако этот тег может потребоваться для того, чтобы указать определенную роль (или роли) из нескольких доступных ролей, а также может потребоваться при использовании безопасности на уровне строки.

Роли содержатся в базе данных Azure Analysis Services, а не в самом отчете, в отличие от других типов отчетов Power BI.

Не предоставление никаких ролей в коде Liquid.

Если роль в коде Liquid не указана, роль Azure Analysis Services будет определяться ролями, к которые приложение имеет доступ, и будет фильтровать результаты на основе указанных пользовательских данных по отношению к запросу DAX в ролях. То есть, все доступные роли будут сочетать свои доступы, но будут по-прежнему фильтроваться, если предоставленные пользовательские данные релевантные. Этот сценарий чаще всего будет иметь место для отчетов Azure Analysis Services или панелей мониторинга с одной плиткой.
Предоставление ролей в коде Liquid.

Роли Azure Analysis Services могут быть предоставлены в коде Liquid, подобно ролям RLS. Использование этих ролей может потребоваться, если при наличии нескольких ролей вы хотите использовать для страницы конкретные роли. При использовании любых ролей в строке подключения указание роли Azure Analysis Services является обязательным. Например, панели мониторинга с несколькими плитками, которые используют плитки Azure Analysis Services с плитками RLS.

При использовании плиток Azure Analysis Services в панели мониторинга применяются следующие соображения:
- Если плитка Azure Analysis Services используется в панели мониторинга с другими плитками, требующими ролей, роль Azure Analysis Services должна быть добавлена в список ролей.
- Можно использовать несколько плиток из разных источников Azure Analysis Services со своими собственными ролями, но пользовательские данные должны быть одинаковыми для каждой их них, и в коде Liquid нельзя использовать несколько пользовательских значений данных. Тег customdata и параметр customdata для EffectiveIdentity принимают только строковое значение.

Получение пути к панели мониторинга или отчету

Войдите в Power BI.
Откройте панель мониторинга или отчет, который требуется встроить на портал.
Скопируйте URL-адрес из адресной строки.

Плитка "Получить ИД панели мониторинга"

Войдите в Power BI.
Откройте панель мониторинга, из которой требуется встроить плитку на портал.
Наведите указатель мыши на плитку, выберите Дополнительные параметры и нажмите Открыть в режиме фокуса.
Скопируйте ИД плитки из URL-адреса в адресной строке. ИД плитки — это значение после /tiles/.

Как использовать библиотеку JavaScript powerbi-client на порталах

Библиотеку JavaScript powerbi-client можно использовать для встраивания на портал отчетов или панелей мониторинга Power BI Embedded. Для получения дополнительной информации о библиотеке JavaScript powerbi-client см. в разделе Википедия по JavaScript в Power BI.

Ниже приведен пример кода JavaScript для обновления настроек отчета или обработки событий. Этот образец отключает панель фильтров, отключает навигацию по страницам и включает событие dataSelected.

Важно!

Используйте библиотеку JavaScript powerbi-client, чтобы отключить или включить панель фильтров. Однако, если вы хотите ограничить доступ к данным или настроить безопасность, используйте Безопасность на уровне строк (RLS) с Power BI. Отключение панели фильтров не ограничивает доступ к данным, и ее можно повторно включить с помощью кода библиотеки JavaScript.
Библиотека JavaScript powerbi-client поддерживается только для потока PowerBI Embedded.

$(document).ready(function () {
    var embedContainer = $(".powerbi")[0];
    if (embedContainer) {
        var report = powerbi.get(embedContainer);
        report.on("loaded", function () {
            report.updateSettings({
                panes: {
                    filters: {
                        visible: false
                    },
                    pageNavigation: {
                        visible: false
                    }
                }
            }).catch(function (errors) {
                console.log(errors);
            });
        })
    }
});

Чтобы добавить пользовательский JavaScript на веб-страницу:

Откройте приложение Управление порталом.
Выберите Веб-страницы на левой панели.
Выберите веб-страницу, содержащую отчет или панель мониторинга Power BI.
Выберите вкладку Расширенный.
Скопируйте и вставьте JavaScript в раздел Пользовательский код JavaScript.
Выберите Сохранить и закрыть.

Теперь давайте рассмотрим пример операций JavaScript и различные варианты.

Получите ссылку на встроенный отчет HTML

Получите ссылку на встроенный отчет HTML.

var embedContainer = $(".powerbi")[0];

Дополнительная информация: Получите ссылку на существующий Power BI компонент с учетом содержащего элемента

Получите ссылку на встроенный отчет HTML

var report = powerbi.get(embedContainer);

Работа с панелями Power BI

Вы можете использовать настройки для панелей для работы с панелями Power BI на веб-странице порталов. Например, можно использовать настройки фильтров, чтобы скрыть или показать панели, или работать с настройками навигации по странице.

Ниже приведен пример для удаления панели фильтров:

report.updateSettings({
            panes: {
                filters :{
                    visible: false
                }
            }
        }).catch(function (errors) {
            console.log(errors);
        });

Ниже приведен пример для работы как с навигацией по страницам, так и с фильтрами:

report.updateSettings({
            panes: {
                filters :{
                    visible: false
                },
                pageNavigation:{
                    visible: false
                }
            }
        }).catch(function (errors) {
            console.log(errors);
        });

Дополнительная информация: Обновление настроек и Встраивание конфигурации — параметры

Обработка событий

Встроенный компонент может генерировать события после вызова завершения выполненной команды. Например, ниже приведен образец для события dataSelected.

//Report.off removes a given event listener if it exists
    report.off("dataSelected");
//Report.on will add an event list
    report.on('dataSelected', function(event){
        console.log('Event - dataSelected:');
        console.log(event.detail);
    })

Дополнительная информация: Обработка событий

См. также

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).

Поделиться через

Добавление отчета или панели мониторинга Power BI на веб-страницу на портале

Использование панели мониторинга или отчета, подключаемого к службам Azure Analysis Services

Службы Azure Analysis Services и Roles (RLS)

Получение пути к панели мониторинга или отчету

Плитка "Получить ИД панели мониторинга"

Как использовать библиотеку JavaScript powerbi-client на порталах

Получите ссылку на встроенный отчет HTML

Получите ссылку на встроенный отчет HTML

Работа с панелями Power BI

Обработка событий

См. также

Дополнительные ресурсы