Freigeben über

Power BI-Kachel-Steuerelement in Power Apps

  • Artikel

Ein Steuerelement, das eine Power BI-Kachel in einer App anzeigt.

Sie haben kein Power BI? Anmelden.

Beschreibung

Profitieren Sie von Ihrer vorhandenen Datenanalyse und -berichterstellung, indem Sie Ihre Power BI-Kachel in Ihren Apps anzeigen. Geben Sie die anzuzeigende Kachel an, indem Sie ihre Eigenschaften Workspace, Dashboard und Tile auf der Registerkarte Daten im Optionsbereich festlegen.

Hinweis

  • Power BI-Kachel-Steuerelement ist GCC High und DoD Umgebungen nicht verfügbar.
  • Power BI-Kachel-Steuerelement ist in China nicht verfügbar.
  • Informationen zu den Lizenzanforderungen beim Einbetten von Power BI-Kacheln finden Sie unter Lizenzierung .

Freigabe und Sicherheit

Wenn Sie eine App freigeben, die Power BI Inhalt enthält, müssen Sie nicht nur die App selbst sondern auch das Dashboard freigeben, aus dem die Kachel stammt. Andernfalls wird der Power BI Inhalt auch nicht für Benutzer, die die App öffnen, angezeigt. Apps, die Power BI-Inhalt enthalten, berücksichtigen die Berechtigungen für diesen Inhalt.

Leistung

Es wird nicht empfohlen, mehr als drei Power BI-Kacheln zur gleichen Zeit in einer App zu laden. Sie können den Ladungsvorgang von Kacheln und auch das Entladen steuern, indem Sie die Eigenschaft LoadPowerBIContent festlegen.

Einbettungsoptionen

Die Einbettung unterscheidet sich zwischen den Versionen der Power BI-API. Wegen des neuen Power BI-API-Authentifizierungsschemas ist Ihre Kachel möglicherweise nicht auf Mobilgeräten oder in anderen eingebetteten Szenarien (Teams oder SharePoint) zugreifbar.

Sie können die Verwendung der API-Version mithilfe der AllowNewAPI-Eigenschaft steuern. Weitere Informationen finden Sie unter Schlüsseleigenschaften.

AllowNewAPI-Eigenschaftswert Verhalten
Ja Sie können ein Dashboard, einen Bericht oder eine Kachel einbetten, indem Sie die Einbettungs-URL von Power BI nehmen und sie zumTileUrl-Wert machen.
Nein Sie können eine Dashboard-Kachel entweder einbetten, indem Sie URL einbetten nutzen und sie zum TileUrl-Wert machen, oder indem Sie die bereitgestellte grafische Oberfläche verwenden.

Hinweis

Einbettung einer Power BI-URL (z. B. in einem IFrame) wird in Power Apps für Mobilgeräte nicht unterstützt, da die Authentifizierung der Power BI-URL-Anforderung nicht vom mobilen Player verarbeitet wird.

Filtering

Die Filterung unterscheidet zwischen den Versionen der Power BI-API. Weitere Informationen finden Sie in den entsprechenden Abschnitten unten, je nachdem, wie Sie das Steuerelement konfigurieren.

Bei Verwendung der neuen API zum Aufrufen des Power BI-Service

Wenn die AllowNewAPI-Eigenschaft auf „True“ gesetzt ist, verwenden Sie eine neue API zum Aufrufen des Power BI-Service. Weitere Informationen zum Filtern eines Berichts finden Sie unter Filtern eines Berichts mithilfe von Abfragezeichenfolgenparametern in der URL.

Bei Verwendung der ursprünglichen API zum Aufrufen des Power BI-Service

Wenn die AllowNewAPI-Eigenschaft auf „False“ gesetzt ist, verwenden Sie die ursprüngliche API zum Aufrufen des Power BI-Service. In diesem Fall können Sie durch Übergeben eines einzelnen Parameters aus der App die Ergebnisse filtern, die in einer Power BI-Kachel angezeigt werden. Es werden jedoch nur Zeichenfolgenwerte und der Gleich-Operator unterstützt, und der Filter funktioniert möglicherweise nicht, wenn der Tabellenname oder der Spaltenname Leerzeichen enthält.

Ändern Sie den Wert, um einen einzelnen Filterwert zu übergeben für die TileURL Eigenschaft, die dieser Syntax folgt:

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

Fügen Sie diesem Wert diese Syntax hinzu:

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

Verwenden Sie beispielsweise einen Wert aus einem Listenfeld:

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

Der Parameter filtert einen Wert im DataSet des Berichts, aus dem die Kachel stammt. Die Filterfunktion weist jedoch die folgenden Einschränkungen auf:

  • Es kann nur ein Filter angewendet werden.
  • Nur der eq-Operator wird unterstützt.
  • Der Feldtyp muss eine Zeichenfolge sein.
  • Die Filterung ist nur bei angehefteten Visualisierungskacheln verfügbar. Es wird nicht für angeheftete Berichte unterstützt.
  • Visuelle R- und Python-Skriptelemente können nicht gefiltert werden.

Sie können berechnete Felder im Power BI Bericht verwenden, um andere Werttypen in Zeichenfolgen zu konvertieren oder mehrere Felder zu einem zu kombinieren.

Schlüsseleigenschaften

AllowNewAPI – Ob die neue API beim Aufrufen des Power BI Service verwendet wird. Wert einstellen auf True ermöglicht die Nutzung der neuen Power BI API (die in mobilen und einigen eingebetteten Szenarien nicht unterstützt wird, aber eine erweiterte Filterung ermöglicht). False wird die ursprüngliche API verwenden. Der Standardwert ist False.

Dashboard - Das Power BI-Dashboard, aus dem die Kachel stammt.

LoadPowerBIContent - Wenn True gilt, wird der Power BI-Inhalt geladen und angezeigt. Wenn diese Einstellung auf False festgelegt ist, wird der Power BI Inhalt entladen, wodurch der Arbeitsspeicher freigeben und die Leistung optimiert wird.

PowerBIInteractions – Wenn auf True festgelegt, kann mit dem Power BI Inhalt interagiert werden, aber das Power Apps OnSelect Ereignis wird nicht ausgelöst. Wenn Sie Falsch festlegen, kann mit der Kachel nicht interagiert werden, aber das Ereignis Power Apps OnSelect wird ausgelöst, wenn die Kachel ausgewählt wird.

Tile - Der Name der Power BI-Kachel, die angezeigt werden soll.

Workspace - Der Power BI-Arbeitsbereich, aus dem die Kachel stammt.

Zusätzliche Eigenschaften

BorderColor - Die Farbe des Rahmens eines Steuerelements.

BorderStyle - Legt fest, ob der Rahmen eines Steuerelements Durgehend, Gestrichelt, Gepunktet oder Keine ist.

BorderThickness - Die Linienstärke des Rahmens eines Steuerelements.

DisplayMode - Legt fest, ob das Steuerelement Benutzereingaben zulässt (Bearbeiten), ob nur Daten angezeigt werden (Anzeigen) oder ob das Steuerelement deaktiviert ist (Deaktiviert).

Height - Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.

OnSelect – Auszuführende Aktionen, wenn der Benutzer ein Steuerelement auswählt. Standardmäßig wird der Power BI-Bericht geöffnet, der der Kachel zugeordnet ist.

TileUrl - Die URL, mit der die Kachel vom Power BI-Dienst angefordert wird. Informationen zum Hinzufügen von Abfragezeichenfolgenfiltern zu Ihrer URL finden Sie im obigen Abschnitt Filterung.

Visible - Gibt an, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.

Width - Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand seines übergeordneten Containers (Bildschirm —wenn kein übergeordneter Container).

Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (screen —wenn kein übergeordneter Container).

Beispiel

  1. Öffnen Sie auf der Registerkarte Einfügen das Menü Diagramme, und fügen Sie anschließend das Steuerelement Power BI-Kachel hinzu.

    Möchten Sie wissen, wie Sie ein Steuerelement hinzufügen und konfigurieren?

  2. Wählen Sie auf der Registerkarte Daten im Optionsbereich für die Einstellung Workspace auf Mein Arbeitsbereich.

  3. Wählen Sie in der Liste der Dashboards ein Dashboard aus, und wählen Sie eine Kacheln in der Liste der Kacheln aus.

    Das Steuerelement rendert die Power BI Kachel.

Richtlinien für Barrierefreiheit

Die Power BI-Kachel ist einfach ein Container für Power BI Inhalt. Weitere Informationen zu Inhalt, auf den zugegriffen werden kann, finden Sie unter Power BI Barrierefreiheit-Tips.

Wenn der Power BI-Inhalt über keinen Titel verfügt, fügen Sie ggf. mithilfe des Steuerelements Beschriftung einen Titel hinzu, damit Bildschirm-Leser unterstützt werden. Sie können die Bezeichnung unmittelbar vor der Power BI Kachel platzieren.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).