Power BI-Kachel-Steuerelement in Power Apps

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.

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.

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.