Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein Steuerelement, das eine Power BI-Kachel in einer App anzeigt.
Sie verfügen nicht über Power BI? Registrieren Sie sich.
Description
Nutzen Sie Ihre vorhandene Datenanalyse und Berichterstellung, indem Sie Ihre Power BI-Kacheln in Ihren Apps anzeigen. Geben Sie die Kachel an, die angezeigt werden soll, indem Sie die Eigenschaften "Arbeitsbereich", "Dashboard" und "Kachel " auf der Registerkarte " Daten " des Optionsbereichs festlegen.
Hinweis
- Power BI-Kachelsteuerelemente werden in einigen GCC High- und DoD-Umgebungen nicht unterstützt.
- Power BI-Kachelsteuerelement ist in China nicht verfügbar.
- Informationen zu Lizenzierungsanforderungen beim Einbetten einer Power BI-Kachel finden Sie unter "Lizenzierung".
Freigabe und Sicherheit
Wenn Sie eine App freigeben, die Power BI-Inhalte enthält, müssen Sie nicht nur die App selbst, sondern auch das Dashboard freigeben, aus dem die Kachel stammt. Andernfalls werden die Power BI-Inhalte nicht einmal für Benutzer angezeigt, die die App öffnen. Apps, die Power BI-Inhalte enthalten, respektieren die Berechtigungen für diese Inhalte.
Leistung
Es wird nicht empfohlen, mehr als drei Power BI-Kacheln gleichzeitig in einer App zu laden. Sie können das Laden und Entladen der Kachel steuern, indem Sie die LoadPowerBIContent-Eigenschaft festlegen.
Einbettungsoptionen
Das Einbetten unterscheidet sich zwischen Versionen der Power BI-API. Aufgrund des neuen Power BI-API-Authentifizierungsschemas ist Ihre Kachel möglicherweise nicht auf mobilgeräte oder in anderen eingebetteten Szenarien (Teams oder SharePoint) zugänglich.
Sie können die Verwendung der API-Version mithilfe der AllowNewAPI-Eigenschaft steuern. Weitere Informationen finden Sie unter Schlüsseleigenschaften.
| AllowNewAPI-Eigenschaftswert | Verhalten |
|---|---|
| Richtig | Sie können ein Dashboard, einen Bericht oder eine Kachel einbetten, indem Sie die Einbettungs-URL aus Power BI verwenden und ihn zum TileUrl-Wert machen. |
| Falsch | Sie können eine Dashboardkachel entweder durch Einbetten der URL einbetten und als TileUrl-Wert festlegen oder die bereitgestellte grafische Benutzeroberfläche verwenden. |
Hinweis
Das Einbetten einer Power BI-URL (z. B. in einem IFrame) wird in Power Apps mobile nicht unterstützt, da die Authentifizierung der Power BI-URL-Anforderung nicht vom mobilen Player verarbeitet wird.
Filterung
Die Filterung unterscheidet sich zwischen den Versionen der Power BI-API. In den folgenden Abschnitten finden Sie je nach Konfiguration des Steuerelements die entsprechenden Abschnitte.
Bei Verwendung der neuen API zum Aufrufen des Power BI-Diensts
Wenn die AllowNewAPI-Eigenschaft auf "True" festgelegt ist, verwenden Sie eine neue API, um den Power BI-Dienst aufzurufen. Weitere Informationen finden Sie unter Filtern eines Berichts mithilfe von Abfragezeichenfolgenparametern in der URL.
Bei Verwendung der ursprünglichen API zum Aufrufen des Power BI-Diensts
Wenn die AllowNewAPI-Eigenschaft auf "False" festgelegt ist, verwenden Sie die ursprüngliche API, um den Power BI-Dienst aufzurufen. 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 Gleichheitsoperator unterstützt, und der Filter funktioniert möglicherweise nicht, wenn der Tabellenname oder der Spaltenname Leerzeichen enthält.
Um einen einzelnen Filterwert zu übergeben, ändern Sie den Wert der TileURL-Eigenschaft , die auf diese Syntax folgt:
"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"
Fügen Sie an diesen Wert die folgende Syntax an:
&$filter=<TableName>/<ColumnName> eq '<Value>'
Beispiel: Verwenden eines Werts aus einem Listenfeld:
"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"
Der Parameter filtert einen Wert im Dataset des Berichts, in dem die Kachel stammt. Das Filterfeature hat jedoch die folgenden Einschränkungen:
- Es kann nur ein Filter angewendet werden.
- Nur der
eqOperator wird unterstützt. - Der Feldtyp muss eine Zeichenfolge sein.
- Filterung ist nur für angeheftete Visualisierungskacheln verfügbar. Es wird für angeheftete Berichte nicht unterstützt.
- Visuelle Elemente des R- und Python-Skripts 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 in eins zu kombinieren.
Schlüsseleigenschaften
AllowNewAPI – Gibt an, ob beim Aufrufen des Power BI-Diensts die neue API verwendet werden soll. Wenn Sie den Wert auf "True " festlegen, wird die Verwendung der neuen Power BI-API (die in mobilen und einigen eingebetteten Szenarien nicht unterstützt wird, ermöglicht jedoch eine erweiterte Filterung). False verwendet die ursprüngliche API. Der Standardwert ist "false".
Dashboard – Das Power BI-Dashboard, aus dem die Kachel stammt.
LoadPowerBIContent – Wenn dieser Wert auf "True" festgelegt ist, wird der Power BI-Inhalt geladen und angezeigt. Bei Festlegung auf "False" wird der Power BI-Inhalt entladen, der Arbeitsspeicher freigibt und die Leistung optimiert.
PowerBIInteractions – Wenn dieser Wert auf "True" festgelegt ist, kann der Power BI-Inhalt interagiert werden, aber das Power Apps OnSelect-Ereignis wird nicht ausgelöst. Bei Festlegung auf "False" kann die Kachel nicht mit der Kachel interagieren, aber das Power Apps OnSelect-Ereignis wird ausgelöst, wenn die Kachel ausgewählt ist.
Kachel – Der Name der Power BI-Kachel, die Sie anzeigen möchten.
Arbeitsbereich – Der Power BI-Arbeitsbereich, aus dem die Kachel stammt.
Zusätzliche Eigenschaften
BorderColor – Die Farbe des Rahmens eines Steuerelements.
BorderStyle – Gibt an, ob der Rahmen eines Steuerelements einfarbig, gestrichelt, gepunktet oder None ist.
BorderThickness – Die Stärke des Rahmens eines Steuerelements.
DisplayMode – Ob das Steuerelement Benutzereingaben (Bearbeiten) zulässt, zeigt nur Daten (Ansicht) an oder ist deaktiviert (deaktiviert).
Höhe – Der Abstand zwischen den oberen und unteren Rändern eines Steuerelements.
OnSelect – Aktionen, die ausgeführt werden sollen, wenn der Benutzer ein Steuerelement auswählt. Standardmäßig wird der Power BI-Bericht geöffnet, der der Kachel zugeordnet ist.
TileUrl – Die URL, über die die Kachel vom Power BI-Dienst angefordert wird. Informationen zum Hinzufügen von Abfragezeichenfolgenfiltern zu Ihrer URL finden Sie oben im Abschnitt zum Filtern .
Sichtbar – Ob ein Steuerelement angezeigt oder ausgeblendet ist.
Width – Der Abstand zwischen den linken und rechten Rändern eines Steuerelements.
X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (Bildschirm, wenn kein übergeordneter Container).
Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (Bildschirm, wenn kein übergeordneter Container).
Example
Öffnen Sie auf der Registerkarte "Einfügen " das Menü "Diagramme ", und fügen Sie dann ein Power BI-Kachelsteuerelement hinzu.
Sie wissen nicht, wie Sie ein Steuerelement hinzufügen und konfigurieren können?
Wählen Sie auf der Registerkarte " Daten " des Optionsbereichs "Mein Arbeitsbereich" für die Einstellung " Arbeitsbereich " aus.
Wählen Sie ein Dashboard in der Liste der Dashboards aus, und wählen Sie dann eine Kachel in der Liste der Kacheln aus.
Das Steuerelement rendert die Power BI-Kachel.
Richtlinien für Eingabehilfen
Die Power BI-Kachel ist einfach ein Container für Power BI-Inhalte. Erfahren Sie, wie Sie barrierefreie Inhalte mit diesen Power BI-Tipps zur Barrierefreiheit erstellen.
Wenn der Power BI-Inhalt keinen Titel hat, sollten Sie eine Überschrift mithilfe eines Bezeichnungssteuerelements hinzufügen, um Sprachausgaben zu unterstützen. Sie können die Beschriftung unmittelbar vor der Power BI-Kachel positionieren.