Zum Hauptinhalt springen
Dieser Guide ist für dich, wenn du Power BI- oder Fabric-Admin bist oder Admin des Langdock-Workspace. Sobald du fertig bist, muss jeder User nur noch seine eigene Verbindung hinzufügen.

Vor dem Start

Langdock fragt semantische Modelle über die Execute Queries REST API von Power BI ab. Sie funktioniert auf jeder Power BI-Stufe, auch auf Pro. Für Abfragen brauchst du keine Fabric-, Premium- oder Premium-Per-User-Kapazität. Der XMLA-Endpunkt ist optional. Du brauchst ihn für Measure-Formeln sowie für DMV-, MDX- und INFO.*-Abfragen außer INFO.VIEW.*. Für die Konfiguration brauchst du:
  • Einen Power BI- oder Fabric-Administrator für die Tenant-Einstellungen.
  • Einen Workspace-Admin oder ein Workspace-Mitglied, um Build auf semantischen Modellen zu vergeben.
  • Einen Admin des Langdock-Workspace, um die Integration zu aktivieren.
  • Einen Kapazitätsadministrator, nur wenn du XMLA aktivierst.
Schließe die tenantweite Admin-Zustimmung für Microsoft-Integrationen ab, bevor sich User verbinden. Welche Lizenz und Rolle jede Person braucht, steht unter Berechtigungen und Skalierung.

Microsoft konfigurieren

1

Tenant-Einstellung für die Abfrage-API aktivieren

Öffne im Fabric-Verwaltungsportal Mandanteneinstellungen → Integrationseinstellungen und aktiviere REST-API des semantischen Modells zum Ausführen von Abfragen. In der REST-Dokumentation von Microsoft heißt sie Dataset Execute Queries REST API. Ohne sie schlägt jede Langdock-Abfrage fehl, auf jeder Stufe. Schränkst du sie auf eine Sicherheitsgruppe ein, können nur Mitglieder dieser Gruppe über Langdock abfragen.
Mandanteneinstellung REST-API des semantischen Modells zum Ausführen von Abfragen, aktiviert und für die gesamte Organisation übernommen

REST-API des semantischen Modells zum Ausführen von Abfragen, für die gesamte Organisation aktiviert.

2

Viewer auf dem Workspace und Build auf dem Modell vergeben

Öffne im Workspace Zugriff verwalten und füge eine Microsoft Entra-Sicherheitsgruppe als Viewer hinzu. Im deutschen Portal heißt die Rolle Anzeige.
Zugriff verwalten für den Workspace Finance Pro, mit Employee Test in der Rolle Anzeige

Anzeige auf dem Workspace.

Öffne dann beim semantischen Modell Weitere Optionen → Berechtigungen verwalten und vergib derselben Gruppe Build. Workspace Viewer enthält kein Build, und ohne Build bekommen User keine Daten.
Direkter Zugriff eines semantischen Modells, mit Employee Test auf Arbeitsbereichsanzeige und Build

Build auf dem semantischen Modell.

Vergib keine Schreib- oder Weiterfreigabe-Berechtigung, und mach die Gruppe nicht zum Contributor oder höher. Abfragen brauchen nur Lesezugriff. Mit Schreibzugriff und Contributor oder höher kann man das Modell ändern und, wenn es Row-Level Security nutzt, diese umgehen. Mit Weiterfreigabe kann man das Modell weiter teilen. Siehe Workspace-Rollen und Row-Level Security.
Mehr braucht Langdock nicht, um semantische Modelle abzufragen. Mach weiter mit Integration in Langdock aktivieren, oder richte vorher XMLA ein, wenn du XMLA-basierte Aktionen brauchst.

Optional: XMLA-basierte Aktionen aktivieren

Überspring diesen Abschnitt, wenn du keine Aktionen brauchst, die XMLA erfordern. Für XMLA muss der Workspace auf Fabric-Kapazität, Power BI Premium-Kapazität oder Premium Per User liegen.
1

Tenant-XMLA aktivieren

Aktiviere unter Mandanteneinstellungen → Integrationseinstellungen die Einstellung XMLA-Endpunkte und “In Excel analysieren” bei lokalen semantischen Modellen zulassen. Sie ist standardmäßig an. Schränkst du sie auf eine Sicherheitsgruppe ein, zum Beispiel auf deine Modell-Builder, können User außerhalb dieser Gruppe XMLA-basierte Aktionen nicht nutzen.
Mandanteneinstellung XMLA-Endpunkte und In Excel analysieren bei lokalen semantischen Modellen zulassen, aktiviert und für die gesamte Organisation übernommen

XMLA-Endpunkte für die gesamte Organisation aktiviert.

2

Kapazitäts-XMLA auf Schreibgeschützt setzen

Öffne im Verwaltungsportal unter Kapazitätseinstellungen die Kapazität, die diese Workspaces hostet. Setze unter Power BI Workloads den XMLA-Endpunkt auf Schreibgeschützt. Für Premium Per User findest du die Einstellung unter Premium-Einzelbenutzerlizenz → Workloadeinstellungen für Dataset.
3

Workspaces dieser Kapazität zuweisen

Öffne in jedem Workspace Arbeitsbereichseinstellungen → Arbeitsbereichstyp, wähle Bearbeiten und weise die konfigurierte Kapazität zu.
Microsoft beschreibt diese Einstellungen unter Semantic model connectivity with the XMLA endpoint.

Integration in Langdock aktivieren

Aktiviere Power BI als Admin des Langdock-Workspace. Wie du einschränkst, welche Power BI-Aktionen genutzt werden dürfen, steht unter Aktionszugriff verwalten.

User verbinden

Bitte jeden User, Power BI in Langdock zu öffnen, Verbindung hinzufügen zu wählen und sich mit dem Microsoft-Konto anzumelden, das in deiner Viewer- und Build-Gruppe ist. Teile dazu die Anleitung in drei Schritten. Lass bei geteilten Agenten jeden User mit seiner eigenen Verbindung arbeiten. Siehe Geteilte Agenten und Workflows.

Einrichtung prüfen

Teste mit einem repräsentativen User, der Workspace Viewer und Build auf dem semantischen Modell hat, aber keine Contributor- oder Kapazitätsrolle.
  1. Stelle in Langdock eine Frage, die eine kleine Abfrage braucht, zum Beispiel den Umsatz pro Monat.
  2. Vergleiche die Zahlen mit dem, was dieser User in einem Power BI-Bericht auf demselben Modell sieht.
  3. Nutzt das Modell Row-Level Security, prüfe, ob der User nur seine eigenen Zeilen sieht.
  4. Wiederhole das mit einem User, der das Modell nicht sehen soll. Er bekommt einen Fehler statt Daten.
Berechtigungsänderungen können etwa eine Stunde brauchen, bis sie greifen. Schlägt eine Prüfung fehl, hilft dir die Fehlerbehebung.