Erstellen einer App, die mit einem semantischen Modell verbunden ist

Verwenden Sie die Daten-App-Vorlage, wenn Sie Daten in Fabric Apps analysieren und visualisieren möchten. Diese Vorlage enthält eine Reihe von wiederverwendbaren Grundtypen und Agent-Funktionen, die die Generierung von Datenkonnektivität, KI-unterstützten Analysen und Visualisierungen vereinfachen.

Standardmäßig enthalten mit der Vorlage erstellte Apps:

• Fabric-Authentifizierung und Konnektivität zu den semantischen Modellen
• Hochwertigere DAX-Generierung (Data Analysis Expressions)
• Unternehmensfähige visuelle Komponenten für analytische Anwendungen

Warum sollte die Daten-App-Vorlage verwendet werden?

Ohne diese integrierten Funktionen müsste ein KI-Agent Authentifizierung, DAX-Generierung und Visualisierungsdesign in jeder Sitzung von Grund auf neu lösen. Dies führt zu:

• Weitere Fehler und fehlerhafte oder leere Visuelle Elemente
• Inkonsistentes Diagrammverhalten
• Unnötige DAX-Abfragen während der Entwicklung und Laufzeit

Das Direkte Codieren dieser Muster in die Vorlage verbessert die Zuverlässigkeit, erzeugt einheitlichere visuelle Elemente, die an bewährten Methoden für die Berichterstellung ausgerichtet sind, und reduziert den Abfrageaufwand.

Voraussetzungen

• Zugriff auf Fabric.
• Ein Fabric Arbeitsbereich, in dem Sie Über Mitwirkende- oder Administratorberechtigungen verfügen.
• Die in Ihrem Mandanten aktivierte Fabric-App-Workload. Weitere Informationen finden Sie unter Enable Fabric App in den Mandantenadministratoreinstellungen.
• Die Mandanteneinstellung für die REST-API „Abfragen ausführen“ des semantischen Modells ist aktiviert. Daten-Apps verwenden die EXECUTE DAX-Abfrageabfrage-API , um semantische Modelle abzufragen. Navigieren Sie im Fabric Admin-Portal zu Integrationseinstellungen, und aktivieren Sie die REST-API-Einstellung des Semantischen Modells zum Ausführen von Abfragen.
• Erstellen und Lesen von Berechtigungen für das semantische Modell, mit dem Sie eine Verbindung herstellen möchten.
• Ein semantisches Modell, das in einer Fabric- oder Power BI Kapazität gehostet wird.

Erste Schritte

So erstellen Sie eine Mit Fabric Daten verbundene App mithilfe der Daten-App-Vorlage:

1. Führen Sie die Schritte 1 bis 3 in Create your first Fabric app aus, um in Ihrem Arbeitsbereich eine neue Fabric-App zu erstellen.

2. Derzeit ist die Rayfin CLI die unterstützte Methode zum Erstellen von Apps mithilfe der Daten-App-Vorlage. Verwenden Sie den folgenden Befehl, um zu beginnen.

   npm create @microsoft/rayfin@latest -- "<appitemname>" --template dataapp --workspace <workspacename>
   

3. Öffnen Sie Ihren Codierungs-Agent, und fügen Sie die Eingabeaufforderung ein.

   Es wird eine der folgenden Optionen empfohlen:

   • Öffnen von VS Code und Öffnen des Copilot Bereichs durch Klicken auf das Copilot-Chatsymbol auf der rechten Seite des Suchfelds am oberen Rand des VS-Codefensters
   • Öffnen sie ein Terminal und geben Sie copilot ein, und drücken Sie dann die EINGABETASTE.

   Beide Optionen öffnen GitHub Copilot, nur in verschiedenen Schnittstellen (Chat und Terminal). Verwenden Sie je nachdem, was Sie bevorzugen!

   

4. Fordern Sie Copilot auf, Ihre App zu erstellen.

   Nachdem Sie den oben stehenden Prompt übermittelt haben, erstellt Copilot das Grundgerüst Ihrer App für Sie und fragt Sie, welche Änderungen oder Aktualisierungen Sie an Ihrer App vornehmen möchten.

   Hier können Sie die App erläutern, die Sie erstellen und mit einem semantischen Modell verbinden möchten. Verwenden Sie einen Freigabelink für das Modell, um anzugeben, welches Modell Sie verwenden möchten (der Link enthält die Arbeitsbereichs-ID und Modell-ID).

   Zum Beispiel: „Verwenden Sie mein Verkaufsmodell unter https://app.powerbi.com/groups/workspace-id/modeling/model-id/modelView, um eine Anwendung zur Rechnungsstellung zu erstellen.“

5. Stellen Sie Ihre App bereit.

   Wenn Sie bereit sind, Ihre App bereitzustellen, teilen Sie Copilot mit dem Befehl npx rayfin up mit, sie für Fabric bereitzustellen.

Integrierte Funktionen

Die folgenden Funktionen stellen die Bereiche dar, in die wir in wiederverwendbare Grundtypen, integrierte Integrationen und agentfähige Workflows investiert haben, um die Entwicklung reibungsloser zu gestalten.

Features außerhalb dieser Liste können weiterhin implementiert werden, da Fabric Apps Standardwebanwendungen sind, die mit Code erstellt wurden, aber möglicherweise mehr Iterationen oder benutzerdefiniertes Engineering erfordern.

Authentifizierung und Semantikmodellkonnektivität

Wenn Sie Copilot anweisen, Ihre App mit einem semantischen Modell zu verbinden, funktioniert es einfach — Sie geben einen Freigabelink aus dem Power BI-Dienst an, und die Vorlage übernimmt den Rest.

Hinter den Kulissen erfordert die Authentifizierung im Fabric-Portal einen bestimmten Token-Handshake, der für einen Agent jedes Mal schwer zu erstellen ist. Die Vorlage codiert diesen gesamten Fluss, sodass Copilot die Authentifizierung überhaupt nicht lösen muss – es stellt einfach eine Verbindung zu Ihren Daten dar.

Solange Benutzer über die gleichen Build- und Leseberechtigungen verfügen, die sie zum Abfragen des Modells in Power BI benötigen, ruft die App Livedaten automatisch ohne Anmeldebildschirm oder manuelle Konfiguration ab.

Visuelle Elemente

Die Vorlage enthält leistungsstarke interaktive Funktionen wie die integrierte Kreuzhervorhebung. Die folgenden visuellen Elemente weisen vorkonfigurierte Grundtypen in der Daten-App-Vorlage auf:

• Balkendiagramme (vertikal und horizontal, gruppiert, gestapelt)

• Liniendiagramme (mit optionalen Markierungen)

• Flächendiagramme

• Punktdiagramme

• Torten- und Donutdiagramme

• Heatmaps

• Blasendiagramme

• Wasserfalldiagramme

• Karten mit Einzelwerten (KPI-Hervorhebungen)

• Mehrschichtige/zusammengesetzte Visuelle Elemente (z. B. Balken mit Datenbeschriftungen, Liniendiagramme mit zwei Achsen)

Sie können natürlich immer noch Copilot bitten, andere visuelle Elemente zu generieren, es kann nur mehr Iterationen erfordern, um Ihre Ziele zu erreichen. Die Liste der vorkonfigurierten visuellen Elemente sollte im Laufe der Zeit wachsen.

Datengitterfunktionen

Die Vorlage enthält auch eine integrierte Datenrasterkomponente zum Anzeigen tabellarischer Daten. Wir haben die folgenden Features vorkonfiguriert, um reibungslos zu funktionieren.

• Spaltenüberschriften, die automatisch von semantischen Modellmetadaten abgeleitet werden

• Zahlen- und Datumsformatierung, die pro Spalte über Formatzeichenfolgen angewendet wird

• Sortieren

• Scrollbare Zeilen mit Überlaufverwaltung

• Unterstützung für helles und dunkles Design

• Benutzerdefinierte Zellrenderer für erweiterte Szenarien, einschließlich:

  • Datenbalken (Fortschrittsbalken-Visualisierung für numerische Werte)

  • Boolesche Indikatoren (Häkchen/Kreuzsymbole)

  • Klickbare URLs

  • Bildzellen mit Lightbox-Überlagerung

  • Zellen mit mehreren Feldern (z. B. Kombinieren von Namen und Rolle in einer Spalte)

Auch in diesem Fall können Sie Copilot weiterhin bitten, andere Funktionen für Datenraster zu generieren; möglicherweise sind dafür nur mehr Iterationen erforderlich, um Ihre Ziele zu erreichen. Wir werden diese Liste der Funktionen im Laufe der Zeit hinzufügen.

Designmanagement

Damit Ihre App Ihrem spezifischen Aussehen und Verhalten entspricht, teilen Sie einfach Ihre Branding- oder Formatierungsanforderungen mit Copilot und können diese Updates ganz einfach vornehmen.

Wenn Sie Copilot anweisen, Formatierungsaktualisierungen vorzunehmen , z. B. "machen Sie es dunkelblau mit abgerundeten Ecken" oder "verwenden Sie eine moderne serifenlose Schriftart" – aktualisiert sie eine zentrale Formatvorlagendatei, und diese Änderungen werden automatisch an jeden Teil der App fließen: Karten, Schaltflächen, Diagramme, Datenraster und QuickInfos.

Dieser zentralisierte Ansatz bedeutet, dass der Agent nicht jede Komponente einzeln neu formatieren muss, wodurch die nicht übereinstimmenden Farben, inkonsistenten Schriftarten und fehlerhaften Layouts vermieden werden, die in der Regel auftreten, wenn ein Agent Elemente stückweise formatiert.

Formatzeichenfolgen

Wenn Sie Copilot anweisen, Einnahmen als Währung anzuzeigen oder Prozentsätze in einem Diagramm anzuzeigen, definiert sie die Formatierung einmal pro Spalte, und die Vorlage wendet sie automatisch überall an, wo diese Spalte angezeigt wird – Diagrammachsen, QuickInfos, Datenbeschriftungen und Datenrasterzellen.

Ohne dies müsste der Agent Zahlen in jedem Visual separat formatieren, was zu Inkonsistenzen führt (z. B. 1.500,50 $ in einem Diagramm und 1500,5 in einem anderen) oder dazu, dass Formatierungen ganz ausbleiben.

Die Vorlage stellt sicher, dass 1500,5 immer als 1.500,50 $ und 0,25 immer als 25%angezeigt wird , konsistent über die gesamte App hinweg.

Playwright-Browserüberprüfung

Bevor Sie Ihre App veröffentlichen, haben wir einen Schritt erstellt, in dem der Agent sie in einem echten Browser öffnet und überprüft, ob alles richtig aussieht – ähnlich wie Sie einen Bericht manuell in der Vorschau anzeigen, aber mithilfe der Playwright-Browserüberprüfung automatisiert.

Der Agent überprüft Folgendes:

• Visuelle Elemente werden korrekt gerendert
• Diagramme werden weder abgeschnitten noch zusammengedrückt
• Text ist lesbar
• Im Hintergrund sind keine Fehler vorhanden.

Dadurch werden Layout- und Renderingprobleme frühzeitig erfasst, bevor Die Benutzer sie sehen.

Bekannte Einschränkungen

Derzeit können Fabric Apps, die mit semantischen Modellen verbunden sind, nicht im eigenen Browserfenster außerhalb des Fabric Portals geöffnet werden. Wenn Sie die Schaltfläche " Öffnen " auswählen, tritt ein Fehler in visuellen Abfragen auf.

Dies ist eine temporäre Einschränkung und wird in einer zukünftigen Version behoben.

Verwandte Inhalte

• Was ist Fabric Apps?
• Erstellen Sie Ihre erste App
• Ausführen der DAX-Abfrage-API