Sprache
Deutsch

Veröffentlichung und Einbettung einrichten

Wenn Sie eine Karte veröffentlichen, damit sie außerhalb von Fabric angezeigt werden kann, liest der öffentliche eingebettete Viewer die eingefrorenen, veröffentlichten Dateien aus Ihrem OneLake. Dazu verwendet er einen eigenen Icon Map-Einbettungsdienstprinzipal (Tekantis.IconMap-Embed): eine schreibgeschützte Identität ohne eigene API-Berechtigungen.

Sie gewähren diesem Dienstprinzipal keinen Zugriff auf Ihren Arbeitsbereich. Beim Veröffentlichen werden Ihre veröffentlichten Karten in ein Lakehouse in Ihrem Arbeitsbereich geschrieben, und der Einbettungsdienstprinzipal erhält eine schreibgeschützte OneLake-Datenzugriffsrolle nur für dieses Lakehouse: automatisch, unter Ihrer eigenen Identität, als Teil der Veröffentlichung. Das Ergebnis: Der Einbettungsdienst kann lesen, was Sie veröffentlichen, und sonst nichts, ohne Schreibzugriff auf Ihren Arbeitsbereich.

Schließen Sie zuerst die Mandanteneinstellungen für die Veröffentlichung ab. Für die meisten Karten ist danach nichts weiter zu tun: veröffentlichen, und es funktioniert.

Was automatisch geschieht

Beim ersten Veröffentlichen in einem Arbeitsbereich erstellt Icon Map ein Lakehouse namens IconMap_Published für veröffentlichte Karten und fügt den Einbettungsdienstprinzipal einer schreibgeschützten Datenzugriffsrolle (IconMapEmbedReaders) darauf hinzu. Jede weitere Veröffentlichung verwendet beides wieder. Dafür ist keine Administratoraktion nötig, sofern der veröffentlichende Benutzer im Arbeitsbereich Elemente erstellen und den OneLake-Datenzugriff verwalten kann (ein Mitglied oder Administrator des Arbeitsbereichs kann das).

Große Raster-Tilesets (PMTiles/COG) werden nicht kopiert: Sie werden direkt aus ihrem eigenen Lakehouse gelesen, damit sie aktuell bleiben. Beim Veröffentlichen erhält der Einbettungsdienstprinzipal auf dieselbe Weise auch Lesezugriff auf diese Quell-Lakehouses.

Wenn jemand anderes handeln muss

Freigegebene Ebenen aus Organisationskatalogen. Wenn Ihre Karte Rasterebenen aus einem Organisationskatalog verwendet, dessen Lakehouse Sie nicht verwalten, können Sie dem Einbettungsdienstprinzipal dort keinen Lesezugriff gewähren. Das übernimmt einmal der Besitzer des Katalogs: Er weist Tekantis.IconMap-Embed eine schreibgeschützte Datenzugriffsrolle im Lakehouse des Katalogs zu, und danach funktioniert jede Karte, die diesen Katalog verwendet. Wenn das noch nicht geschehen ist, zeigt das Dialogfeld zum Veröffentlichen an, welche Ebene betroffen ist; der Rest der Karte wird trotzdem veröffentlicht.

Eingeschränkte Arbeitsbereiche. Wenn Ihre Organisation Benutzern nicht erlaubt, Elemente zu erstellen, kann ein Administrator das Lakehouse IconMap_Published vorab erstellen und dem Einbettungsdienstprinzipal einmal Lesezugriff darauf gewähren; Autoren veröffentlichen dann dorthin. In beiden Fällen ist die Berechtigung schreibgeschützt, niemals die Rolle Mitwirkender im Arbeitsbereich.

Zusätzliche Berechtigungen für Karten mit Livedaten

Eine Veröffentlichung als Momentaufnahme braucht nichts weiter. Wenn eine veröffentlichte Karte Live-Daten bereitstellt, muss der Einbettungsdienstprinzipal auch diese Abfragequellen erreichen:

  • Eventhouse / KQL: Weisen Sie dem Dienstprinzipal die Rolle Betrachter für die konkrete KQL-Datenbank zu (Eventhouse → Datenbank → Berechtigungen verwalten).
  • Power BI-Semantikmodelle: Aktivieren Sie Dienstprinzipale können Power BI-APIs verwenden (in den Mandanteneinstellungen).
  • Lakehouse / Warehouse: keine zusätzliche Berechtigung nötig; die oben genannte schreibgeschützte Datenzugriffsrolle deckt das Lesen der Delta-Tabellen ab.

Überprüfen

Veröffentlichen Sie eine Testkarte, öffnen Sie den Einbettungslink und prüfen Sie, ob sie lädt. Wenn eine Rasterebene fehlt, suchen Sie im Dialogfeld zum Veröffentlichen nach einer Warnung zur Katalogeinbettung (siehe oben). Wenn die ganze Karte „this map needs to be re-published“ anzeigt, veröffentlichen Sie sie erneut aus dem aktuellen Editor. Veröffentlichte Links können jederzeit in der Veröffentlichungsverwaltung widerrufen werden.

Nächste Schritte