Share via


Контрола 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. Заради новата схема за удостоверяване на Power BI API, плочката може да не е достъпна на мобилни устройства или в други вградени сценарии (Teams или SharePoint).

Можете да контролирате използването на версията на API с помощта на свойството AllowNewAPI. За повече информация вижте Основни свойства.

Стойност на свойството AllowNewAPI Поведение
True Можете да вградите табло, отчет или плочка, като вземете Вграждане на URL адрес от Power BI и го използвате за стойност на TileUrl.
False Можете да вградите табло, отчет или плочка, като вземете Вграждане на URL адрес и го използвате за стойност на TileUrl, или като използвате предоставения графичен интерфейс.

Бележка

Вграждане на Power BI URL (например в iFrame) не се поддържа на Power Apps мобилен от удостоверяването на Power BI Заявката за URL адрес не се обработва от мобилния плейър.

Филтриране

Филтрирането се различава във версиите на 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. Задаване на стойността на Вярно ще позволи използването на новия Power BI API (който не се поддържа в мобилни и някои вградени сценарии, но позволява някои по-разширени филтри). Невярно ще използва оригиналния API. Стойността по подразбиране е Невярно.

Dashboard - Power BI табло, откъдето идва плочката.

LoadPowerBIContent - Когато е зададено на вярно, Power BI съдържанието се зарежда и показва. Когато е зададено на невярно, то Power BI съдържанието се разтоварва, което освобождава паметта и оптимизира работата.

PowerBIInteractions - Когато е настроено на Вярно, Power BI съдържанието може да се взаимодейства, но Power Apps OnSelect събитието няма да се задейства. Когато е настроено на Невярно, с плочката не може да се взаимодейства, но Power Apps OnSelect събитието ще се задейства, когато е избрана плочката.

Tile - Името на Power BI плочка, която искате да покажете.

Workspace - Power BI работно пространство, откъдето идва плочката.

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

BorderColor – Цветът на границата на контролата.

BorderStyle – Дали границата на контрола е солидна, с тирета, с точки или няма.

BorderThickness – Дебелината на границата на контролата.

DisplayMode – Дали контрола позволява въвеждане от потребителя (редактиране), показва само данни (изглед) или е деактивирана (Забранено).

Height - Разстоянието между горния и долния ръб на контрола.

OnSelect – Действия, които се извършват, когато потребителят избере контрола. По подразбиране, Power BI се отваря отчет, свързан с плочката.

TileUrl - URL адресът, чрез който плочката се иска от Power BI услуга. За да добавите филтриране на низ от заявки към URL адреса, вижте раздела Филтриране по-горе.

Visible - Дали се появява контрола, или е скрита.

Width - Разстоянието между левия и десния ръб на контрола.

X - Разстоянието между левия ръб на контрола и левия ръб на неговия родителски контейнер (или екрана, ако няма родителски контейнер).

Y - Разстоянието между горния ръб на контрола и горния ръб на неговия родителски контейнер (или екрана, ако няма родителски контейнер).

Пример

  1. На раздела Вмъкване отворете менюто диаграми и след това добавете контрола Power BI tile.

    Не знаете как да добавяте и конфигурирате контрола?

  2. На раздела Данни на панела с опции, изберете Моята работна област за настройката Workspace.

  3. Изберете таблото в списъка с таблата и след това изберете плочка в списъка с плочки.

    Контролът рендира Power BI плочка.

Насоки за достъпност

Power BI tileе просто контейнер за Power BI съдържание. Научете как да създавате достъпно съдържание с тях съвети за достъпност на Power BI.

Ако Power BI съдържанието няма заглавие, помислете за добавяне на заглавие с помощта на контрола Label за поддръжка на екранни четци. Можете да позиционирате етикета непосредствено преди плочка на Power BI.

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).