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

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

  • Статья

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

Нет Power BI? Зарегистрируйтесь.

Описание

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

Примечание

  • Элемент управления «Плитка Power BI» недоступен в средах GCC High и DoD.
  • Элемент управления Плитка Power BI недоступен в Китае.
  • Для лицензионных требований при встраивании плитки Power BI, см Лицензирование.

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

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

Производительность

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

Варианты встраивания

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

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

Значение свойства AllowNewAPI Поведение
Истина Вы можете встроить информационную панель, отчет или плитку, выбрав Встроить URL в Power BI и сделав это значением TileUrl.
Ложь Вы можете встроить плитку панели мониторинга, выбрав Встроить URL и сделав это значением TileUrl или с помощью графического интерфейса.

Примечание

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

Фильтрация

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

При использовании нового 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.

Dashboard — панель мониторинга Power BI, на которую ссылается плитка.

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

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

Tile — имя плитки Power BI, которую нужно отобразить.

Workspace — рабочая область Power BI, на которую ссылается плитка.

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

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

BorderStyle  — стиль границы элемента управления: Solid, Dashed, Dotted или None.

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

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

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

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

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

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

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

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

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

Пример

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

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

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

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

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

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

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

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

Примечание

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

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