Элемент управления плиткой Power BI в Power Apps

Элемент управления, показывающий плитку Power BI внутри приложения.

У вас нет Power BI? Зарегистрируйтесь.

Description

Воспользуйтесь преимуществами существующего анализа данных и отчетов, отображая плитки Power BI в приложениях . Укажите плитку, которую вы хотите отобразить, задав свойства рабочей области, панели мониторинга и плитки на вкладке "Данные " панели параметров.

Замечание

  • Элемент управления плиткой Power BI не поддерживается в некоторых средах GCC High и DoD .
  • Элемент управления плиткой Power BI недоступен в Китае.
  • Требования к лицензированию при внедрении плитки Power BI см. в разделе "Лицензирование".

Общий доступ и безопасность

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

Performance

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

Параметры внедрения

Внедрение отличается от версий API Power BI. Из-за новой схемы проверки подлинности API Power BI плитка может быть недоступна на мобильных устройствах или в других внедренных сценариях (Teams или SharePoint).

Вы можете управлять использованием версии API с помощью свойства AllowNewAPI . Дополнительные сведения см. в разделе "Свойства ключа".

Значение свойства AllowNewAPI Поведение
True Вы можете внедрить панель мониторинга, отчет или плитку, принимая URL-адрес внедрения из Power BI и делая его значением TileUrl .
Неправда Вы можете внедрить плитку панели мониторинга по URL-адресу внедрения и сделать ее значение TileUrl или с помощью графического интерфейса.

Замечание

Внедрение URL-адреса Power BI (например, в IFrame) не поддерживается на мобильных устройствах Power Apps, так как проверка подлинности запроса URL-адреса Power BI не обрабатывается мобильным проигрывателем.

Filtering

Фильтрация отличается от версий API Power BI. Ознакомьтесь с соответствующими разделами ниже в зависимости от способа настройки элемента управления.

При использовании нового API для вызова службы Power BI

Если для свойства AllowNewAPI задано значение True, вы используете новый API для вызова службы Power BI. Дополнительные сведения см. в разделе "Фильтрация отчета" с помощью параметров строки запроса в URL-адресе.

При использовании исходного API для вызова службы Power BI

Если для свойства AllowNewAPI задано значение False, вы используете исходный API для вызова службы Power BI. В этом случае, передав один параметр из приложения, можно отфильтровать результаты, отображаемые на плитке Power BI. Однако поддерживаются только строковые значения и оператор равенства, а фильтр может не работать, если имя таблицы или имя столбца содержит пробелы.

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

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

К этому значению добавьте следующий синтаксис:

&$filter=<TableName>/<ColumnName> eq '<Value>'

Например, используя значение из поля списка:

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

Параметр отфильтрует значение в наборе данных отчета, где происходит плитка. Однако функция фильтрации имеет следующие ограничения:

  • Можно применить только один фильтр.
  • eq Поддерживается только оператор.
  • Тип поля должен быть строкой.
  • Фильтрация доступна только на закрепленных плитках визуализации. Он не поддерживается для закрепленных отчетов.
  • Визуальные элементы скрипта R и Python не могут быть отфильтрованы.

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

Ключевые свойства

AllowNewAPI — следует ли использовать новый API при вызове службы Power BI. При задании значения True можно использовать новый API Power BI (который не поддерживается в мобильных и некоторых внедренных сценариях, но позволяет использовать более расширенные фильтры). False будет использовать исходный API. Значение по умолчанию — false.

Панель мониторинга — панель мониторинга Power BI, из которой поступает плитка.

LoadPowerBIContent — если задано значение True, содержимое Power BI загружается и отображается. Если задано значение False, содержимое Power BI выгружается, что освобождает память и оптимизирует производительность.

PowerBIInteractions — если задано значение True, содержимое Power BI может взаимодействовать с ним, но событие Power Apps OnSelect не активируется. Если задано значение False, плитка не может взаимодействовать с ней, но событие Power Apps OnSelect активируется при выборе плитки.

Плитка — имя плитки Power BI, которую вы хотите отобразить.

Рабочая область — рабочая область Power BI, из которой поступает плитка.

Дополнительные свойства

BorderColor — цвет границы элемента управления.

BorderStyle — является ли граница элемента управления твердым, дефишированным, dotted или None.

BorderThickness — толщина границы элемента управления.

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

Высота — расстояние между верхними и нижними краями элемента управления.

OnSelect — действия для выполнения, когда пользователь выбирает элемент управления. По умолчанию откроется отчет Power BI, связанный с плиткой.

TileUrl — URL-адрес, по которому плитка запрашивается из службы Power BI. Чтобы добавить фильтрацию строки запроса в URL-адрес, см. приведенный выше раздел фильтрации .

Видимый — отображается ли элемент управления или скрыт.

Ширина — расстояние между левыми и правыми краями элемента управления.

X — расстояние между левым краем элемента управления и левым краем родительского контейнера (экран, если родительский контейнер отсутствует).

Y — расстояние между верхним краем элемента управления и верхним краем родительского контейнера (экран, если родительский контейнер отсутствует).

Example

  1. На вкладке "Вставка " откройте меню "Диаграммы " и добавьте элемент управления плиткой Power BI .

    Не знаю, как добавить и настроить элемент управления?

  2. На вкладке "Данные " панели параметров выберите "Моя рабочая область " для параметра " Рабочая область".

  3. Выберите панель мониторинга в списке панелей мониторинга и выберите плитку в списке плиток.

    Элемент управления отображает плитку Power BI.

Руководство по настройке специальных возможностей

Плитка Power BI — это просто контейнер для содержимого Power BI. Узнайте, как создать доступное содержимое с помощью этих советов по специальным возможностям Power BI.

Если содержимое Power BI не имеет названия, попробуйте добавить заголовок с помощью элемента управления Label для поддержки средств чтения с экрана. Метку можно разместить непосредственно перед плиткой Power BI.