Erste Schritte mit dem Power Pages Plugin für GitHub Copilot CLI und Claude Code

Das Power Pages-Plug-In für GitHub Copilot CLI und Claude Code bietet einen KI-unterstützten Workflow zum Erstellen, Bereitstellen und Verwalten moderner single-Page-Anwendung (SPA) Websites auf Power Pages. Statt Projekte manuell aufzusetzen, Standard-API-Code zu schreiben und Berechtigungen zu konfigurieren, beschreiben Sie in natürlicher Sprache, was Sie erreichen möchten, und das Plug-In übernimmt die Implementierung.

Das Plug-In unterstützt den vollständigen Lebenszyklus der Websiteentwicklung durch konversationelle Fähigkeiten. Erstellen Sie eine Website aus einer kuratierten SPA-Vorlage, oder erstellen Sie sie von Grund auf neu, passen Sie sie an, richten Sie Dataverse-Datenmodelle ein, und konfigurieren Sie die Authentifizierung. Die Vorlagenerstellung ist sowohl in GitHub Copilot CLI als auch in Claude Code über /create-site verfügbar.

Important

  • Ein generativer KI-Codierungs-Agent, z. B. GitHub Copilot CLI oder Claude Code, verwendet die Fähigkeiten und Workflows dieses Plug-Ins, um Power Pages spezifische Aufgaben auszuführen.
  • Code und Konfiguration, der vom KI-Codierungs-Agent generiert wird, kann ungenau sein. Überprüfen, testen und validieren Sie alle generierten Inhalte, bevor Sie sie genehmigen oder bereitstellen. Überprüfen Sie die Agent-Vorschläge immer, bevor Sie sie genehmigen.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über die erforderliche Software und berechtigungen verfügen.

Softwareanforderungen

Bestandteil Mindestversion Mehr Informationen
Node.js 18.0 oder höher Node.jsherunterladen
Power Platform-CLI (PAC CLI) 2.6.3 oder höher (erforderlich für Serverlogik) Installieren der PAC CLI
Azure CLI Neueste Azure CLI installieren
GitHub Copilot CLI oder Claude Code Neueste GitHub Copilot CLI oder Claude Code
Visual Studio Code- und Power Platform Tools-Erweiterung (optional) Neueste Herunterladen von VS Code und Installieren von Power Platform Tools

Außerdem benötigen Sie:

  • Eine Power Platform-Umgebung mit aktivierter Power Pages.
  • Eine authentifizierte PAC CLI-Sitzung, die mit Ihrer Zielumgebung verbunden ist. Führen Sie pac auth create aus, wenn Sie noch keine Verbindung hergestellt haben.
  • Eine Azure CLI-Sitzung, die bei demselben Mandanten angemeldet ist. Führen Sie az login --allow-no-subscriptions aus, um sich zu authentifizieren.

Authentifizierung überprüfen:

Überprüfen Sie, ob Sie mithilfe des pac auth list Befehls authentifiziert sind.

pac auth list           # Should show authenticated profile

Wenn Sie nicht authentifiziert sind, führen Sie den folgenden Befehl aus:

pac auth create --environment <Instance url>        # Authenticate to Power Platform

Tip

Um die Instanz-URL abzurufen, wechseln Sie zu Power Pages Start, wählen Sie das Symbol Settings in der oberen rechten Ecke aus, und wählen Sie dann Sessiondetails aus.

Installieren des Plug-Ins

Installieren Sie das Power Pages-Plug-In aus dem Marketplace. Wenn Sie GitHub Copilot CLI verwenden, finden Sie in der Copilot CLI-Erweiterungsdokumentation entsprechende Installationsschritte. Die folgenden Befehle verwenden Claude Code-Syntax.

Führen Sie das Installationsprogramm aus, um alle Plug-Ins mit aktivierter AutoUpdate-Funktion einzurichten:

Windows (PowerShell):

iwr https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js -OutFile install.js; node install.js; del install.js

macOS/Linux/Windows (cmd):

curl -fsSL https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js | node

Das Installationsprogramm läuft automatisch:

  • Installiert die pac CLI, wenn sie noch nicht installiert ist.
  • Erkennt verfügbare Tools wie Claude Code und GitHub Copilot CLI.
  • Registriert den Plugin-Marketplace und installiert alle aufgeführten Plug-Ins.
  • Aktiviert autoUpdate, sodass Plug-Ins auf dem neuesten Stand bleiben.

Starten Sie nach der Installation Claude Code oder die GitHub Copilot CLI neu, um auf die Funktionen des Plug-Ins als Slash-Kommandos in Ihrer Agent-Session zuzugreifen.

Installation aus dem Marketplace

  1. Öffnen Sie Claude Code in Ihrem Terminal.

  2. Fügen Sie den Microsoft Marketplace hinzu:

    /plugin marketplace add microsoft/power-platform-skills

  3. Installieren Sie das Power Pages-Plug-In:

    /plugin install power-pages@power-platform-skills

Starten Sie nach der Installation des Plug-Ins Claude Code oder GitHub Copilot CLI neu, um auf die Fähigkeiten des Plug-Ins als Schrägstrichbefehle in Ihrer Agent-Sitzung zuzugreifen.

Tip

Um automatisch Updates für den Marketplace und die Fähigkeiten zu erhalten, aktivieren Sie die automatische Aktualisierung. Verwenden Sie den /plugin Befehl, wechseln Sie zu Marketplaces, wählen Sie den Marketplace aus, und aktivieren Sie die automatische Aktualisierung.

Übersicht über Fähigkeiten

Das Plug-In bietet Fähigkeiten, die den vollständigen Lebenszyklus einer Power Pages-Website abdecken. Rufen Sie jede Fähigkeit im Dialog auf, entweder über einen Slash-Befehl oder indem Sie beschreiben, was Sie tun möchten.

Qualifikation Befehl Was es tut
Website erstellen /create-site Erstellt und aktiviert eine Website aus einer kuratierten SPA-Vorlage oder erstellt eine Website ganz neu, setzt Ihre Designvorgaben um und erstellt Seiten und Komponenten.
Website bereitstellen /deploy-site Erstellt das Projekt und lädt es mithilfe der PAC CLI in Power Pages hoch.
Website aktivieren /activate-site Stellt einen Websitedatensatz bereit und weist eine öffentliche URL zu.
Einrichten des Datenmodells /setup-datamodel Erstellt Dataverse-Tabellen, Spalten und Beziehungen
Hinzufügen von Beispieldaten (optional) /add-sample-data Auffüllt Dataverse-Tabellen mit realistischen Testdatensätzen
Integrieren der Web-API /integrate-webapi Generiert typierten API-Clientcode, -Dienste und -Tabellenberechtigungen.
Hinzufügen von KI-Zusammenfassungen /add-ai-webapi Integriert die generativen KI-Zusammenfassungs-APIs (Suchzusammenfassung und Datenzusammenfassung) in Ihre Seiten. Generiert einen typisierten Zusammenfassungsdienst mit Verarbeitung von Antifälschungstoken, frameworkspezifischen Wrappern, verdrahteten Aufrufstellen und den passenden Summarization-Websiteeinstellungen.
Authentifizierung einrichten /setup-auth Fügt die Anmelde-, Abmelde- und rollenbasierte Zugriffssteuerung hinzu. Unterstützt Microsoft Entra ID, Microsoft Entra External ID, OpenID Connect, SAML 2.0, WS-Federation, Microsoft-Konto, Facebook, Google und lokale Benutzernamen- und Kennwortauthentifizierung, einschließlich Konfigurationen mit mehreren Anbietern
Erstellen Sie Web-Rollen /create-webroles Generiert Webrollen-YAML-Dateien für die Verwaltung des Benutzerzugriffs
Hinzufügen von Serverlogik /add-server-logic Generiert sichere serverseitige JavaScript-Endpunkte für Validierung, externe API-Aufrufe, geheime Verwaltung und Datenvorgänge
Hinzufügen eines Cloudflusses /add-cloud-flow Integriert vorhandene Power Automate Cloudflüsse in Ihre Website für Genehmigungsworkflows, Benachrichtigungen und geplante Automatisierung
Integrieren von Back-End /integrate-backend Analysiert Ihren Prototyp, bestimmt den richtigen Ansatz (Web-API, Serverlogik oder Cloudfluss) für jedes Feature und koordiniert die vollständige Buildsequenz.
Lokalisierung hinzufügen /add-localization Fügt eine mehrsprachige SPA-UI-Lokalisierung für React, Vue und Angular hinzu oder erweitert sie mit Übersetzungsressourcen, einer Sprachauswahl und Links-nach-rechts- und Rechts-nach-links-Layoutprüfungen.
SEO hinzufügen /add-seo Generiert robots.txt, sitemap.xmlund Metatags
Sicherheitsüberprüfung ausführen /security-review Koordiniert die fokussierten Sicherheitskompetenzen und konsolidiert jede Suche in einen einzelnen HTML-Bericht. Umfasst Code, Abhängigkeiten, den Scan der bereitgestellten Website, Browser-Header, die Firewall für Webanwendungen, Tabellenberechtigungen und die Konfiguration der Authentifizierung
Quellcode überprüfen /scan-code Führt statische Analysen und Abhängigkeitsscans für lokale Quelldateien aus. Zeigt Ergebnisse in Codemustern, anfälligen Paketen, hartcodierten geheimen Schlüsseln und Lizenzproblemen an
Bereitgestellte Website scannen /scan-site Startet eine serverseitige Sicherheitsüberprüfung auf der Livewebsite, ruft den neuesten Bericht ab und gruppiert Ergebnisse nach Schweregrad.
Verwalten von Browsersicherheitsheadern /manage-headers Überprüft und konfiguriert die HTTP-Sicherheitsheader, die eine Website an Browser sendet – Content-Security-Policy, Frame- und Clickjacking-Schutz, Cross-Origin-Freigabe, Cookieverhalten und verwandte Website-Einstellungen
Verwalten der Webanwendungsfirewall /manage-firewall Überprüft und konfiguriert die Webanwendungsfirewall (WAF) auf einem Produktionsstandort: Ermöglicht schutz, fügt IP-Blöcke, Länderblöcke, Pfadblöcke und Ratelimits hinzu oder entfernt sie.
Berechtigungen für Audit-Tabellen /audit-permissions Überprüft vorhandene Tabellenberechtigungen für Websitecode und Dataverse-Metadaten; erstellt einen NACH Schweregrad gruppierten HTML-Bericht mit vorgeschlagenen Fixes.
Planen der Bereitstellung /plan-alm Erkennt den Projektstatus, sammelt Ihre Promotionsstrategie, rendert einen visuellen Plan und koordiniert die anderen Alm-Fähigkeiten (Application Lifecycle Management) in der richtigen Reihenfolge.
Lösung erstellen /setup-solution Erstellt einen Herausgeber und eine Lösung, fügt Power Pages-Komponenten hinzu, klassifiziert Websiteeinstellungen und schlägt Umgebungsvariablen und Azure Key Vault-Geheimnisse vor.
Pipeline-Host einrichten /ensure-pipelines-host Stellt eine Hostumgebung für Power Platform Pipelines bereit oder erkennt sie.
Einrichten der Pipeline /setup-pipeline Registriert eine Pipelinedefinition in Dataverse und bindet heraufstufende Phasen an Zielumgebungen.
Bereitstellen über die Pipeline /deploy-pipeline Löst die Bereitstellung einer Pipeline für eine Zielphase mit phasenspezifischen Überschreibungen von Umgebungsvariablen aus
Umgebung zur Erzwingung der Verknüpfung /force-link-environment Zuweisen einer Zielumgebung zu einem neuen Power Platform Pipelines-Host, wenn ein Hostkonflikt die Bereitstellung blockiert
Lösung exportieren /export-solution Exportiert die Lösung als verwaltete oder nicht verwaltete ZIP-Datei mit einer Vollständigkeitsprüfung vor dem Export.
Lösung importieren /import-solution Importiert eine Lösungs-ZIP in eine Zielumgebung (phasenweise oder direkt)
Testwebsite /test-site Überprüft eine bereitgestellte Website mit einem browserbasierten Test: Seitendurchforstung, rollenbasierte Zugriffsprüfungen und Web-API-Überprüfung
Bereitstellung diagnostizieren /diagnose-deployment Vergleicht Bereitstellungsfehler mit einem Katalog bekannter Fehler und schlägt eine Lösung vor.

Typischer Workflow

Ein allgemeiner End-to-End-Workflow folgt dieser Sequenz:

  1. /create-site : Beginnen Sie mit einer kuratierten SPA-Vorlage oder einem Grundgerüst und entwerfen und erstellen Sie Seiten.
  2. /deploy-site : In Ihre Power Pages-Umgebung hochladen.
  3. /activate-site : Richten Sie eine öffentliche URL ein.
  4. /setup-datamodel : Erstellen von Dataverse-Tabellen.
  5. /add-sample-data : Tabellen mit Testdatensätzen füllen.
  6. /integrate-webapi : Generieren Sie API-Clientcode, und konfigurieren Sie Berechtigungen.
  7. /create-webroles : Definieren von Zugriffsrollen.
  8. /setup-auth : Anmeldung, Abmeldung und rollenbasierte Benutzeroberfläche hinzufügen.
  9. /add-server-logic : Hinzufügen sicherer serverseitiger Endpunkte.
  10. /add-cloud-flow: Integrieren Sie vorhandene Power Automate Flows.
  11. /add-seo : Suchmaschinenoptimierung hinzufügen.
  12. /deploy-site : Letzte Änderungen live schalten.
  13. /security-review : Führen Sie eine End-to-End-Sicherheitsüberprüfung aus, bevor Sie in Produktion gehen.
  14. /plan-alm : Stufen Sie Ihre Website in Test- und Produktionsumgebungen hoch.

Tip

  • Der Vorlagenpfad /create-site umfasst den anfänglichen Upload und die Aktivierung. Nachdem die Vorlagenwebsite live ist, überspringen Sie die Schritte 2 und 3, und fügen Sie nur die benötigten Funktionen hinzu. Führen Sie /deploy-site aus, wenn Sie bereit sind, lokale Anpassungen zu veröffentlichen.
  • Sie müssen dieser genauen Reihenfolge nicht folgen. Jede Fähigkeit überprüft ihre eigenen Voraussetzungen und teilt Ihnen mit, ob etwas fehlt. Sie können z. B. /setup-auth vor /integrate-webapi ausführen, wenn Ihre Website zuerst eine Authentifizierung benötigt.
  • Wenn Sie nicht sicher sind, welcher Ansatz für jedes Feature verwendet werden soll, führen Sie /integrate-backend anstelle der Schritte 4 bis 10 einzeln aus. Es analysiert Ihren Prototyp, bestimmt, ob jedes Feature Web-API, Serverlogik oder einen Cloudfluss benötigt, und koordiniert die Fähigkeiten in der richtigen Reihenfolge.
  • Um KI-generierte Such- und Datensatzzusammenfassungen hinzuzufügen, führen Sie /add-ai-webapi nach /integrate-webapi aus. Dabei werden die Tabellenberechtigungen und Website-Einstellungen wiederverwendet, die von /integrate-webapi konfiguriert werden. Führen Sie den Vorgang daher erst aus, sobald Ihre Web-API-Integration eingerichtet ist.
  • Führen Sie /add-localization vor der endgültigen Bereitstellung aus, um Ihrer SPA-Benutzeroberfläche Sprachen hinzuzufügen. Sie können einer vorhandenen lokalisierten Website auch Sprachen hinzufügen oder die Lokalisierungskonfiguration reparieren.

Erstellen Ihrer Power Pages-Website

In dieser exemplarischen Vorgehensweise wird der vollständige Lebenszyklus des Erstellens einer Power Pages-Website mit dem Plug-In vom Gerüst über die Bereitstellung behandelt. Jeder Schritt beschreibt, was Sie sagen und was das Plug-In als Reaktion tut.

Schritt 1: Erstellen Ihrer Website

Beschreiben Sie die gewünschte Website in natürlicher Sprache: wofür sie bestimmt ist, für welche Seiten sie benötigt werden, und alle Entwurfseinstellungen wie Farbschema, Layoutstil oder Schriftarten. Führen Sie /create-site aus, oder beschreiben Sie einfach Ihre Website, und das Plugin erkennt die Absicht.

Das Plug-In überprüft den neuesten veröffentlichten Vorlagenkatalog und schlägt Vorlagen vor, die Ihren Anforderungen entsprechen. Sie können eine Vorschau von übereinstimmenden Vorlagen anzeigen, alle verfügbaren SPA-Vorlagen durchsuchen oder Von Grund auf neu beginnen auswählen.

Website aus einer Vorlage erstellen

Verwenden Sie eine Vorlage, um mit einer verpackten Website und den unterstützenden Dataverse-Lösungen zu beginnen, anstatt jede Seite von Grund auf neu zu generieren. Geben Sie beispielsweise diese Anforderung in GitHub Copilot CLI oder Claude Code ein:

/create-site Create a citizen services site from a Power Pages SPA template.
I need service requests, request tracking, a city service map, and knowledge articles.

Das Plug-In führt Sie durch die folgenden Schritte:

  1. Öffnet einen schreibgeschützten Browserkatalog mit Vorlagenbeschreibungen, Vorschaubildern und verfügbaren Frameworkvarianten. Wählen Sie die Vorlage und das Framework im Terminal und nicht in der Galerie aus. Wenn eine Vorlage über mehrere Varianten verfügt, wählen Sie aus den für diese Vorlage verfügbaren Frameworks aus.
  2. Fragt, wo das lokale Projekt erstellt werden soll. Wählen Sie ein neues Verzeichnis oder ein leeres vorhandenes Verzeichnis aus.
  3. Fordert Sie auf, die Ziel-Power Platform-Umgebung zu bestätigen. Es überprüft, ob PAC CLI und Azure CLI denselben Mandanten verwenden, prüft erforderliche Dataverse-Sprachen und überprüft, ob die Umgebung JavaScript-Anhänge zulässt. Wenn .js Anlagen blockiert sind, wird um Erlaubnis gebeten, bevor nur js aus der Liste der blockierten Erweiterungen entfernt wird.
  4. Fordert Sie auf, die Installation der ausgewählten Vorlage zu genehmigen. Die Installation importiert erforderliche nicht verwaltete Unterstützungslösungen, klont den verpackten Websitecode in Ihr lokales Verzeichnis, installiert Abhängigkeiten, führt den Build des Projekts aus und lädt eine neue Code-Website hoch.
  5. Wendet Vorlagen-Seeddaten an, wenn verfügbar, und meldet das Ergebnis. Seed-Data-Fehler blockieren keine Websiteerstellung oder -aktivierung.
  6. Aktiviert die neue Website über /activate-site, wo Sie aufgefordert werden, eine Unterdomäne auszuwählen und die Aktivierung zu bestätigen. Eine Browserstatusseite verfolgt den Installationsfortschritt und leitet bei erfolgreicher Aktivierung zur Livewebsite weiter. Es kann einige Minuten dauern, bis die Website geladen ist, während sich DNS-Änderungen verbreiten.
  7. Zeigt die Live-URL und den lokalen Projektpfad an und fragt dann, ob Sie das Projekt anpassen möchten. Überprüfen Sie den vorgeschlagenen Anpassungsplan, bevor Sie Änderungen genehmigen. Lokale Anpassungen werden nicht automatisch erneut bereitgestellt; führen Sie /deploy-site aus, wenn Sie bereit sind, sie zu veröffentlichen.

Note

Der aktuelle veröffentlichte Vorlagenkatalog umfasst 311 Portal, eine React SPA für Bürgerdienstanfragen, Anforderungsverfolgung, Karten zu städtischen Diensten, Wissensartikel und 311 Kontaktflüsse. In der Zielumgebung ist Englisch (Dataverse Language ID 1033) erforderlich. Vorlagenverfügbarkeit und Frameworkvarianten können sich mit neuen Versionen ändern. Der Vorlagenkatalog enthält derzeit nur SPA-Vorlagen, nicht herkömmliche Power Pages Vorlagen.

Important

Die Installation der Vorlage verändert Ihre Umgebung. Überprüfen Sie die Zielumgebung und nicht verwaltete unterstützende Lösungen, bevor Sie die Installation genehmigen. Wenn eine unterstützende Lösung bereits auf derselben oder einer neueren Version installiert ist, überspringt das Plug-In den Import und verwendet sie für die neue Website. Wenn die Vorlage eine neuere Lösungsversion enthält, fordert das Plug-In vor dem Aktualisieren eine Bestätigung an.

Wenn der Katalog nicht verfügbar ist oder keine unterstützten SPA-Vorlagen enthält, teilt Ihnen das Plug-in mit und fährt mit der Neuerstellung von Grund auf fort. Wenn erforderliche Dataverse-Sprachen fehlen, wird die Vorlageninstallation vor dem Importieren von Lösungen angehalten. Sie können von Grund auf neu beginnen oder abbrechen. Wenn der Lösungsimport oder die Websiteerstellung fehlschlägt, überprüfen Sie den gemeldeten Fehler, bevor Sie den Vorgang wiederholen, von Grund auf neu beginnen oder beenden. Frühere Importe, teilweise nicht verwaltete Importe, lokale Dateien oder ein teilweiser Websiteupload bleiben möglicherweise erhalten; Durch das Wechseln von Pfaden werden sie nicht automatisch entfernt.

Website von Grund auf neu erstellen

Wählen Sie „Von Grund auf beginnen“ aus, um den vorhandenen Gerüstworkflow zu verwenden, anstatt eine kuratierte Vorlage zu installieren. Das Plug-In fordert Sie auf, ein Framework (React, Vue, Angular oder Astro) und einen Projektspeicherort zu wählen, und dann:

  1. Erstellt ein Gerüst für das Projekt aus den Startdateien des Frameworks und wendet den Websitenamen, die Farben und Designtoken an.
  2. Installiert Abhängigkeiten, startet einen Entwicklungsserver und öffnet eine Live-Browservorschau.
  3. Erstellt jede von Ihnen angeforderte Seite, Komponente und Route mit den entsprechenden Bildern.
  4. Erstellt Git-Commits bei wichtigen Meilensteinen, sodass Sie über einen integrierten Rollbackverlauf verfügen.

Fahren Sie mit den Schritten 2 und 3 fort, um eine von Grund auf erstellte Website bereitzustellen und zu aktivieren.

Schritt 2: Bereitstellen Ihrer Website

Führen Sie den Befehl /deploy-site aus, um Ihre Website auf Power Pages hochzuladen. Das Plug-In:

  1. Überprüft, ob PAC CLI installiert ist und Ihre Authentifizierungssitzung aktiv ist.
  2. Bestätigt die Zielumgebung mit Ihnen, bevor Sie fortfahren.
  3. Führt einen Produktionsbuild aus und lädt die kompilierte Ausgabe hoch.
  4. Erstellt ein Bereitstellungsartefakte-Verzeichnis, wenn noch keines vorhanden ist.

Note

Wenn Ihre Umgebung bestimmte Dateianhänge blockiert, erkennt das Plugin das Problem und gibt Anweisungen zur Behebung.

Schritt 3: Aktivieren Ihrer Website

Führen Sie /activate-site aus, um die Website öffentlich zugänglich zu machen. Das Plug-In:

  1. Schlägt eine Unterdomäne basierend auf Ihrem Websitenamen vor und ermöglicht es Ihnen, sie anzupassen.
  2. Stellt einen Websitedatensatz über die Power Platform-API bereit.
  3. Führt kontinuierlich Abrufe durch, bis die Website live ist, und gibt die öffentliche URL zurück.

An diesem Punkt haben Sie eine Arbeitswebsite unter einer öffentlichen URL. Die verbleibenden Schritte fügen Daten, Authentifizierung und SEO hinzu. Überspringen Sie alle Schritte, die nicht für Ihre Website gelten.

Schritt 4: Einrichten des Datenmodells

Führen Sie /setup-datamodel aus, um die Dataverse-Tabellen zu erstellen, die Ihre Website benötigt. Wenn Sie bereits über ein ER-Diagramm oder ein bestimmtes Schema verfügen, stellen Sie es direkt bereit, anstatt dass der Agent Ihren Code analysiert.

Das Plug-In spawns einen Data Model Architect-Agent , der:

  1. Analysiert den Code Ihrer Website, um zu bestimmen, welche Daten die Seiten und Komponenten benötigen.
  2. Fragt Ihre Dataverse-Umgebung nach vorhandenen Tabellen ab, um Duplikate zu vermeiden.
  3. Schlägt ein Datenmodell mit Tabellen, Spalten, Datentypen und Beziehungen vor, die als ER-Diagramm visualisiert werden.

Sie überprüfen und genehmigen den Vorschlag. Das Plug-In erstellt erst dann etwas, wenn Sie dies bestätigen. Nach der Genehmigung erstellt das Plug-In die Tabellen und Spalten über API-Aufrufe und speichert eine Manifestdatei, die die Schritte 5 und 6 verwenden.

Schritt 5: Hinzufügen von Beispieldaten (optional)

Führen Sie /add-sample-data aus, um Ihre Tabellen mit Testdatensätzen zu füllen. Für diesen Schritt ist das Datenmodell aus Schritt 4 erforderlich.

Das Plug-In führt die folgenden Aktionen aus:

  1. Liest das Manifest, um Ihre Tabellen, Spalten und Beziehungen zu verstehen.
  2. Generiert kontextbezogene geeignete Werte für jeden Spaltentyp, z. B. realistische E-Mails, plausible Datumsangaben und formatierte Währungsbeträge.
  3. Fügt Datensätze in Abhängigkeitsreihenfolge (übergeordnete Tabellen vor untergeordneten Tabellen) ein und aktualisiert Authentifizierungstoken während Masseneinfügungen automatisch.

Schritt 6: Integration in die Dataverse-Web-API

Führen Sie den Befehl aus /integrate-webapi , um simulierte Daten durch Live-Dataverse-Abfragen zu ersetzen. Für diesen Schritt ist das Datenmodell aus Schritt 4 erforderlich.

Das Plug-In führt die folgenden Aktionen aus:

  1. Durchsucht Ihre Codebasis nach Komponenten, die Mock-Daten, Platzhalter-Fetch-Aufrufe oder hartcodierte Arrays verwenden. Sie ordnet diese Komponenten Ihren Dataverse-Tabellen zu.
  2. Spawns einen Web-API-Integrations-Agent für jede Tabelle, die folgendes generiert:
    • Ein freigegebener API-Client mit Anti-Fälschungstokenverwaltung und Wiederholungslogik.
    • TypeScript-Entitätstypen und Domänen-Mappings.
    • Eine CRUD-Dienstebene.
    • Frameworkspezifische Muster, z. B. React-Hooks, Vue-Kompositables oder Angular-Dienste.
  3. Spawns einen Permissions Architect-Agent, der Tabellenberechtigungen und Websiteeinstellungen vorschlägt.

Sie überprüfen und genehmigen den Berechtigungsvorschlag. Das Plug-In erstellt erst dann Konfigurationsdateien, wenn Sie dies bestätigen.

Hinzufügen von KI-generierten Zusammenfassungen (optional)

Führen Sie /add-ai-webapi aus, um generative KI-Zusammenfassungen in Ihre Web-API-Integration einzubinden. Die Fähigkeit verbindet zwei Vorschauzusammenfassungs-APIs mit Ihren Datensatzdetail- und Listenseiten:

  • Suchzusammenfassungs-API: Gibt eine KI-komprimierte Zusammenfassung der Suchergebnisse mit Zitaten zurück.
  • Datenzusammenfassungs-API: Gibt eine Zusammenfassung auf Datensatz- oder Listenebene für eine Dataverse-Tabelle zurück.

Dieser Schritt basiert auf dem Datenmodell aus Schritt 4 und der Web-API-Integration aus Schritt 6. Das Plug-In führt die folgenden Aktionen aus:

  1. Überprüft Ihren Code nach Zusammenfassungsintegrationspunkten und bestätigt die Zielseiten, Tabellen und welche APIs verwendet werden sollen.
  2. Delegiert alle fehlenden Web-API-Voraussetzungen – Tabellenberechtigungen, Spaltenlisten und Webrollen – an /integrate-webapi und /create-webroles, sodass es für Berechtigungen eine einzige maßgebliche Quelle gibt.
  3. Erzeugt einen KI-Web-API-Integration-Agent, der einen typisierten Zusammenfassungsdienst (aiSummaryService.ts) mit Behandlung von Antifälschungstoken, frameworkspezifische Wrapper (React-Hooks, Vue-Composables oder Angular-Dienste) sowie verdrahtete Aufrufstellen auf den Zielseiten generiert.
  4. Erzeugt einen KI-Web-API-Einstellungsarchitekt-Agent, der die Summarization-Websiteeinstellungen für Prompts und Inhaltsbeschränkungen erstellt.

Sie überprüfen und genehmigen die Vorschläge. Das Plug-In generiert erst Code oder erstellt Einstellungen, wenn Sie dies bestätigen.

Note

Die Zusammenfassungs-APIs befinden sich in der Vorschauversion und setzen voraus, dass administrative Steuerelemente und Steuerelemente auf Websiteebene aktiviert sind. Wenn Zusammenfassungen nach der Bereitstellung nicht angezeigt werden, vergewissern Sie sich, dass das Feature über die relevanten Websiteeinstellungen und Administratorsteuerelemente aktiviert ist. Weitere Informationen finden Sie unter Übersicht über die API zur Datenzusammenfassung und Power Pages-Suche mit generativer KI.

Schritt 7: Erstellen von Webrollen

Führen Sie /create-webroles aus, um Benutzerzugriffsrollen zu definieren. Das Plug-In:

  1. Fragt Ihre Umgebung nach vorhandenen Webrollen ab, um Duplikate zu vermeiden.
  2. Generiert Rollendefinitionen mit eindeutigen Bezeichnern.
  3. Erzwingt, dass jede Website über höchstens eine anonyme Rolle und eine authentifizierte Rolle verfügt.

Schritt 8: Einrichten der Authentifizierung

Führen Sie diesen Befehl /setup-auth aus, um Die Anmelde-, Abmelde- und rollenbasierte Zugriffssteuerung für Ihre Website hinzuzufügen. Das Plug-In unterstützt die folgenden Identitätsanbieter, und Sie können einen oder mehrere Anbieter gleichzeitig konfigurieren.

Provider Am besten geeignet für:
Microsoft Entra External ID (empfohlen für kundenorientierte Websites) Öffentliche Websites und Kundenportale mit Self-Service-Registrierung.
Microsoft Entra ID Interne Mitarbeiterportale oder Business-to-Business-Partnerwebsites (B2B). Power Pages konfiguriert automatisch den übergeordneten Mandanten der Website, sodass Sie keine Mandanteninformationen eingeben müssen.
Microsoft, Facebook, Google Anmeldung über soziale Netzwerke für Verbraucher.
Lokale Authentifizierung Anmeldung mit Benutzername und Kennwort. Nicht empfohlen und wird nur konfiguriert, wenn Sie sie explizit anfordern.

Weitere Informationen zu unterstützten Anbietern, einschließlich Protokollen und Konfigurationsüberlegungen, finden Sie unter Overview of authentication in Power Pages.

Das Plug-In:

  1. Analysiert Ihre Website (Zweck, Seiten, Zielgruppe) und schlägt einen sinnvollen Standardwert vor. Das Plug-In schlägt z. B. Microsoft Entra External ID mit offener Registrierung für eine kundenorientierte Website vor oder Microsoft Entra ID mit einladungsgeschützter Registrierung für ein internes Portal. Sie akzeptieren die Empfehlung oder wählen Ihre eigenen Anbieter aus.
  2. Führt Sie für jeden Anbieter durch alle erforderlichen Schritte im Admin Center des Identitätsanbieters, z. B. Erstellen von Mandanten, Registrieren von Apps, Erstellen von Benutzerflows sowie Erfassen von Client-IDs und Umleitungs-URIs. Das Plug-In überprüft jeden Wert, den Sie in die Unterhaltung einfügen, und berechnet den genauen Umleitungs-URI für Ihre Website, sodass der in die App-Registrierung eingefügte Wert mit dem Wert übereinstimmt, der in Websiteeinstellungen geschrieben wurde.
  3. Fragt, wie Benutzerprofildaten vom Identitätsanbieter in den Dataverse-Kontaktdatensatz (Claimszuordnung) fließen sollen, ob bei jeder Anmeldung oder nur bei der ersten Anmeldung synchronisiert werden soll und ob externe Anmeldungen automatisch per E-Mail mit vorhandenen Kontakten verknüpft werden sollen.
  4. Generiert den Authentifizierungsdienst, Typdeklarationen, rollenbasierte Autorisierungsdienstprogramme (hasRole, RequireAuth, RequireRole), einen Keepalive-Hook für Sitzungen, der verhindert, dass SPA-Sitzungen unbemerkt ablaufen, sowie eine in Ihr Websitelayout integrierte UI-Komponente für An- und Abmeldung. Das Plug-In verwendet die Muster Ihres Frameworks überall, z. B. React-Hooks, Vue-Kompositables, Angular-Dienste oder Astro-Komponenten.
  5. Wenn mehrere Anbieter konfiguriert sind, wird eine /login-Seite generiert, die in Ihrem ausgewählten Layout gerendert wird: horizontale Zeile, vertikaler Stapel, primäres Spotlight oder Registerkartenformat.
  6. Schreibt die übereinstimmenden Websiteeinstellungen unter .powerpages-site/site-settings/ für jeden Anbieter, den Registrierungsmodus, die Zuordnung von Ansprüchen und die optionale Funktion.

Das Plug-In konfiguriert auch die folgenden optionalen Features, wenn Sie sie aktivieren:

  • Allgemeine Geschäftsbedingungen: Eine /termsSPA-Seite, die Benutzer vor Abschluss der Anmeldung akzeptieren müssen, sowie die entsprechende Websiteeinstellung und Inhaltsausschnitte.
  • Benutzerprofilseite: Eine /user-profile SPA-Seite, auf der angemeldete Benutzer ihre Kontaktinformationen über die Power Pages Web-API bearbeiten.
  • Verbundabmeldung: Meldet den Benutzer bei der Abmeldung von der Website auch beim Identitätsanbieter ab, für Szenarien mit gemeinsam genutzten Geräten oder regulierte Szenarien.

Tip

Wenn Sie einer vorhandenen Website einen zweiten Identitätsanbieter hinzufügen möchten, führen Sie den Vorgang erneut aus /setup-auth . Das Plug-In erkennt, was bereits konfiguriert ist, und bietet an, einen neuen Anbieter hinzuzufügen, ohne die vorhandenen zu überschreiben. Dieser Ansatz ist nützlich für inkrementelle Szenarien, z. B. beginnend mit Microsoft Entra External ID und späteren Hinzufügen von Google für die Anmeldung für soziale Netzwerke.

Note

Clientseitige Autorisierung (RequireAuth, RequireRole, hasRole) ist nur für die Benutzererfahrung vorgesehen. Sie steuert, was der Benutzer sieht. Serverseitige Tabellenberechtigungen, die durch /integrate-webapi konfiguriert werden, gewährleisten tatsächliche Sicherheit.

Schritt 9: Hinzufügen von Serverlogik

Führen Sie /add-server-logic aus, um Ihrer Website sichere serverseitige Endpunkte hinzuzufügen. Verwenden Sie Serverlogik , wenn Ihre Website Logik benötigt, die nicht im Browser ausgeführt werden kann, z. B. externe API-Aufrufe, serverseitige Validierung, geheime Verwaltung oder entitätsübergreifende Datenvorgänge.

Important

Für die Serverlogikunterstützung ist PAC CLI, Version 2.6.3 oder höher, erforderlich. Verwenden Sie das Schnellinstallationsskript , um auf die neueste Version zu aktualisieren.

Beschreiben Sie, was Sie in einfacher Sprache benötigen, und das Plug-In:

  1. Spawns einen Server Logic Architect-Agent , der Ihren Anwendungsfall analysiert und die Komplexität klassifiziert.
  2. Schlägt einen Endpunktentwurf, eine Sicherheitskonfiguration und alle erforderlichen Tabellenberechtigungen für Ihre Überprüfung vor.
  3. Der serverseitige JavaScript-Endpunkt bei /_api/serverlogics/<name> wird nach der Genehmigung generiert.
  4. Erstellt einen typierten clientseitigen Dienst, um den Endpunkt aus Ihren Komponenten aufzurufen.
  5. Aktualisiert Ihre Komponenten, um den neuen Dienst aufzurufen.
  6. Konfiguriert Webrollenzuweisungen und Tabellenberechtigungen für den Endpunkt.

Sie überprüfen und genehmigen den Vorschlag. Es wird kein Code generiert, bis Sie dies bestätigen.

Häufige Anwendungsfälle:

  • Stellen Sie eine Verbindung mit externen Diensten her. Rufen Sie REST-APIs, Azure Functions oder Dienste von Drittanbietern auf, ohne Anmeldeinformationen freizugeben. (Lernprogramm: Interagieren mit externen Diensten)
  • Durchführen sicherer Datenvorgänge. Abfragen, Aktualisieren oder Löschen von Dataverse-Datensätzen mit konsistenter serverseitiger Überprüfung. (Lernprogramm: Interagieren mit Dataverse-Tabellen)
  • Führen Sie benutzerdefinierte Logik aus. Aggregieren von Daten über Tabellen hinweg, Erzwingen von Geschäftsregeln oder Berechnen abgeleiteter Werte vor dem Zurückgeben von Ergebnissen an den Client.
  • Verwalten Sie geheime Schlüssel serverseitig. Speichern Sie Anmeldeinformationen und API-Schlüssel auf dem Server, niemals im Clientcode. (Tutorial: Interagieren mit Microsoft Graph und SharePoint)

Note

Führen Sie /add-server-logic einmal pro Anwendungsfall aus. Wenn Ihre Website z. B. sowohl einen Inventarüberprüfungsendpunkt als auch einen globalen Suchendpunkt benötigt, führen Sie die Fähigkeit zweimal aus.

Schritt 10: Integrieren von Cloudflüssen

Führen Sie /add-cloud-flow aus, um vorhandene Power Automate Cloudflüsse in Ihre Website zu integrieren. Diese Fähigkeit verbindet Ihre Power Pages Website mit Flüssen, die Sie bereits in Power Automate erstellt haben. Es erstellt keine neuen Cloudflüsse.

Das Plug-In:

  1. Registriert den vorhandenen Cloudfluss bei Ihrer Website.
  2. Generiert clientseitigen Code, um den Flow von Ihren Seiten auszulösen.
  3. Behandelt den Status asynchroner Workflows und Callback-Muster.
  4. Verknüpft den Datenaustausch zwischen der Seite und dem Datenfluss.

Verwenden Sie /add-cloud-flow für Genehmigungsworkflows, E-Mail-Benachrichtigungen, geplante Aufträge und ereignisgesteuerte Automatisierung, die von Power Automate besser behandelt werden als von serverseitigen Endpunkten.

Alternative: Verwenden Sie /integrate-backend, um die Diensteebene vollständig zu planen.

Wenn Sie nicht sicher sind, welche Features Web-API, Serverlogik oder einen Cloud-Workflow benötigen, führen Sie stattdessen /integrate-backend aus, anstatt die Schritte 4 bis 10 manuell durchzuführen. Diese Fähigkeit fungiert als Orchestrator, der:

  1. Analysiert Ihren Prototyp, um alle Features zu identifizieren, die eine Dienstebene benötigen.
  2. Klassifiziert jedes Feature in den richtigen Ansatz: Web-API für Standard-CRUD, Serverlogik für serverseitige Validierung und externe APIs oder Cloudfluss für Genehmigungsworkflows und Automatisierung.
  3. Schlägt einen sequenzierten Ausführungsplan mit allen Fähigkeiten, Abhängigkeiten und Konfigurationen vor.
  4. Nachdem Sie dies genehmigt haben, orchestriert das System die Fähigkeiten in der richtigen Reihenfolge.

Der Plan ist dauerhaft, resumierbar und bearbeitbar. Halten Sie nach jedem Schritt an, um den generierten Code zu überprüfen oder die Website zu testen, und setzen Sie dort fort, wo Sie aufgehört haben, indem Sie /integrate-backend erneut ausführen.

Schritt 11: Hinzufügen von SEO

Führen Sie die Ausführung /add-seo aus, um Ihre Website für Suchmaschinen zu optimieren. Das Plug-In:

  1. Ermittelt Routen aus der Routerkonfiguration Ihres Frameworks.
  2. Generiert Suchmaschinendirektiven und eine Sitemap für alle ermittelten Routen.
  3. Fügt Meta-Tags hinzu: Viewport-, Zeichensatz-, Beschreibungs-, Open Graph-, Twitter Card- und Favicon-Verweise.

Lokalisierung hinzufügen (optional)

Führen Sie /add-localization in GitHub Copilot CLI oder Claude Code aus, um Ihrer SPA-Benutzeroberfläche Sprachen hinzuzufügen. Beispiele:

/add-localization Add French (fr-FR) and Arabic (ar-SA) to my site.
Preserve the existing default language and add a language selector.

Verwenden Sie ein vorhandenes Power Pages Codewebsite-Projekt mit powerpages.config.json. Der Skill unterstützt derzeit den Runtime-Sprachwechsel in React, Vue und Angular. Astro-Lokalisierung und Angular static/build-time lokalisierung sind vorübergehend nicht verfügbar.

Das Plug-In:

  1. Erkennt Ihr Framework und die vorhandene Lokalisierung. Sie können Sprachen hinzufügen oder das Setup reparieren oder neu konfigurieren. Beim Hinzufügen von Sprachen behält es das vorhandene Paket, das Standard-Gebietsschema und nicht leere Übersetzungen bei.
  2. Überprüft Sprachtags im BCP-47-Format, wie fr-FR und ar-SA, und bestätigt die Standard-Locale bei Bedarf. Für ein neues Setup empfiehlt es framework-geeignete Lokalisierungstools und ermöglicht Ihnen die Auswahl von vom Agent generierten Übersetzungen oder leeren Übersetzungswerten für den manuellen Abschluss.
  3. Öffnet einen HTML-Implementierungsplan zur Überprüfung. Genehmigen Sie die Planung im Terminal, bevor das Plug-In Pakete installiert oder Websiteimplementierungsdateien ändert.
  4. Extrahiert für Benutzer sichtbare Zeichenfolgen in Übersetzungsressourcen, einschließlich Navigations-, Überprüfungsmeldungen, Barrierefreiheitsbezeichnungen und Seitenmetadaten. Sie fügt eine Sprachauswahl, eine Ausweichsprache für die Standardsprache sowie Einstellungen für Dokumentsprache und Textrichtung hinzu.
  5. Überprüft Lokalisierungsressourcen, erstellt das Projekt und überprüft Sprachwechsel, Texterweiterung und Layouts von links nach rechts und von rechts nach links im Browser. Locales mit Blockierungsproblemen bleiben solange nicht verfügbar, bis diese Probleme behoben wurden.
  6. Stellt die Ergebnisse für Ihre Überprüfung dar. Nach einer eigenständigen Ausführung bietet sie "Jetzt bereitstellen" oder "Vorerst überspringen" an. Die Bereitstellung erfolgt nur, wenn Sie sie auswählen; andernfalls führen Sie /deploy-site später aus.

Important

KI-generierte Übersetzungen können Fehler enthalten. Überprüfen Sie sie vor der Veröffentlichung. Übersetzungen werden während der Erstellung generiert und in Ihrem Projekt gespeichert; der Skill fügt keinen Laufzeitübersetzungsdienst oder Anmeldeinformationen hinzu.

Note

Diese Fähigkeit lokalisiert nur die SPA-Benutzeroberfläche. Es aktiviert keine Sprachen in Ihrer Dataverse-Umgebung oder übersetzt Dataverse-Datensätze. Die clientseitige Lokalisierung erfüllt die erforderlichen Dataverse-Sprachvoraussetzungen einer Vorlage nicht.

Schritt 12: Bereitstellen der endgültigen Website

Wenn Sie optionale Schritte ausführen, führen Sie /deploy-site erneut aus, um die Änderungen live zu übertragen. Das Plug-In führt einen Produktionsbuild aus und lädt die Website zusammen mit allen Bereitstellungsartefakten (Tabellenberechtigungen, Websiteeinstellungen, Webrollen, Serverlogikdateien) in Ihre Power Pages Umgebung hoch.

Schritt 13: Ausführen einer Sicherheitsüberprüfung

Führen Sie /security-review aus, um vor dem Produktionsstart eine End-to-End-Sicherheitsprüfung Ihrer Website durchzuführen. Die Fertigkeit koordiniert die spezialisierten Sicherheitsfunktionen und konsolidiert jeden Befund in einem einzigen HTML-Bericht unter docs/security-review-<timestamp>.html.

Das Plug-In stellt eine einfache Frage zu Ihrem Ziel und wählt den passenden Satz von fokussierten Fähigkeiten aus:

Zielsetzung Was überprüft wird
Code und Konfiguration Quellcode, Abhängigkeiten, Tabellenberechtigungen und Authentifizierungskonfiguration. Funktioniert nur für lokale Dateien – keine Bereitstellung erforderlich.
Releasebereitschaft (empfohlen) Vollständige Überprüfung vor der Veröffentlichung. Führt jede gezielte Fähigkeit aus: Code und Abhängigkeiten, Scan der bereitgestellten Website, Browser-Sicherheitsheader, Web Application Firewall, Tabellenberechtigungen und Authentifizierung.
Bereitgestellte Website Nur live bereitgestellter Websitescan. Nützlich für die laufende Überwachung einer veröffentlichten Website.

Nachdem Sie bestätigt haben, führt das Plug-In parallel die passenden fokussierten Fähigkeiten aus und schreibt ihre Ergebnisse in einen einzelnen Bericht:

  • /scan-code: Führt statische Analysen (opengrep) und Abhängigkeitsscans (Trivy) für lokale Quelldateien aus. Surfaces-Codemuster, anfällige Pakete, hartcodierte geheime Schlüssel und Lizenzprobleme. Wenn eines der Tools nicht installiert ist, bietet die Fähigkeit eine manuelle Codeüberprüfung als Fallback.
  • /scan-site: Startet eine serverseitige Sicherheitsüberprüfung für die Livewebsite und ruft den neuesten Bericht ab. Die Scandauer hängt von der Websitegröße ab – kleine Websites werden in Minuten beendet, große Websites können Stunden dauern. Die Ergebnisse werden nach Schweregrad gruppiert. Erfordert eine bereitgestellte Website.
  • /manage-headers: Überprüft die HTTP-Sicherheitsheader, die unter .powerpages-site/site-settings/: Inhaltssicherheitsrichtlinie, X-Frame-Optionen, CORS, Cookie SameSite und zugehörige Einstellungen konfiguriert sind. Identifiziert fehlende oder schwache Werte und schlägt empfohlene Standardwerte vor.
  • /manage-firewall: Überprüft die Webanwendungsfirewall (WAF) für die Produktionswebsite, einschließlich des Status verwalteter Regeln und benutzerdefinierter Regeln (IP-Blockierungen, Länderblockierungen, Pfadblockierungen, Ratenbegrenzungen). Nur auf Produktionsstandorten in unterstützten Regionen verfügbar; die Fähigkeit erkennt und meldet Berechtigungsprobleme.
  • /audit-permissions: Gleicht vorhandene Tabellenberechtigungen mit Websitecode und Dataverse-Metadaten ab. Erkennt fehlende Berechtigungen, übermäßig weit gefasste Rollen, ungenutzte Berechtigungen und Probleme mit dem YAML-Schema.

Der konsolidierte Bericht gruppiert Erkenntnisse nach Abschnitten, öffnet sich in Ihrem Standardbrowser und enthält Hinweise zur Behebung in klarer, verständlicher Sprache. Im Chat bietet das Plugin dann an, Sie durch die Korrekturen zu führen – wählen Sie ein Ergebnis aus, und das Plugin ruft interaktiv die passende spezialisierte Funktion auf, um die Änderung umzusetzen.

Note

Die Sicherheitsüberprüfung wendet niemals änderungen automatisch an. Jede gezielte Fähigkeit wird während des konsolidierten Durchlaufs im schreibgeschützten Prüfmodus ausgeführt. Um einen Fix anzuwenden, ruft das Plug-In die passende Fähigkeit interaktiv auf, nachdem Sie die Aktion ausgewählt haben.

Tip

Sie können auch jede fokussierte Fähigkeit selbst ausführen:

  • Führen Sie /scan-code während der Entwicklung aus, um Probleme auf Codeebene frühzeitig abzufangen.
  • Führen Sie die Ausführung /manage-headers aus, um einen bestimmten Fehler bei der Inhaltssicherheitsrichtlinie zu beheben oder CORS einzurichten.
  • Führen Sie diesen /manage-firewall Befehl aus, um auf der Anmeldeseite einen Satzgrenzwert hinzuzufügen oder den Datenverkehr nach Land zu blockieren.
  • Führen Sie die Ausführung /audit-permissions nach dem Ändern von Tabellenberechtigungen aus, um zu überprüfen, ob sie dem Websitecode entsprechen.
  • Führen Sie /security-review mit dem Ziel Bereitgestellte Website erneut aus, um eine Produktivwebsite über einen längeren Zeitraum zu überwachen.

Überprüfen Ihrer Website

Nachdem Sie die Fähigkeiten abgeschlossen haben, überprüfen Sie, ob Ihre Power Pages-Website ordnungsgemäß funktioniert.

  1. Wechseln Sie zu Power Pages.
  2. Suchen Sie Ihre Website in der Liste " Aktive Websites ".
  3. Zeigen Sie eine Vorschau Ihrer Website auf dem Desktop mithilfe der Option "Vorschau " an.
  4. Testen Sie die Funktionalität.

Bewerben Sie Ihre Website in allen Umgebungen

Nachdem Ihre Website in Ihrer Entwicklungsumgebung arbeitet, verwenden Sie die Fähigkeiten der Anwendungslebenszyklusverwaltung (Application Lifecycle Management, ALM), um sie für Test- und Produktionsumgebungen zu bewerben. Das Plug-In packt Ihre Website als Power Platform-Lösung, identifiziert Werte, die in verschiedenen Umgebungen variieren, und stellt die Lösung über Power Platform Pipelines oder über manuellen Export und Import bereit.

Um die ALM-Fähigkeiten zu nutzen, benötigen Sie auch mindestens eine Ziel-Power Platform-Umgebung (Test, Produktion oder beides). Um den optionalen Azure Key Vault-Flow für Geheimnisse zu verwenden, benötigen Sie auch die Berechtigung zum Erstellen eines Schlüsseltresors in Ihrem Azure-Abonnement.

Bereitstellung planen

Führen Sie /plan-alm aus, um zu starten. /plan-alm ist der Einstiegspunkt für ALM und orchestriert die anderen ALM-Fähigkeiten, sodass Sie sie in der Regel nicht direkt ausführen. Das Plug-In:

  1. Erkennt den aktuellen Status Ihrer Projekt-, Lösungs- und Zielumgebungen.
  2. Fragt nach Ihrer Promotionsstrategie (Power Platform Pipelines oder manuellen Export und Import), den Zielphasen und allen anzuwendenden Einschränkungen.
  3. Generiert einen visuellen Plan, in docs/alm-plan.html dem jede Aktion angezeigt wird, die er ausführen möchte.
  4. Wartet auf Ihre Genehmigung, bevor Sie nachgeschaltete Fähigkeiten ausführen.

Der Plan wird dauerhaft auf dem Datenträger gespeichert, sodass jede nachgelagerte Fähigkeit aus demselben gespeicherten Plan liest und in denselben gespeicherten Plan schreibt. Wenn eine Phase fehlschlägt, führen Sie /plan-alm erneut aus; der Vorgang wird dann an der Stelle fortgesetzt, an der er gestoppt hat.

Erstellen der Lösung

Führen Sie die Ausführung /setup-solution aus, um Ihre Website als Power Platform-Lösung zu verpacken. Das Plug-In:

  1. Erstellt einen Publisher und eine Lösung und fügt dann Ihre Power Pages-Komponenten hinzu: die Website, Webrollen, Endpunkte für Serverlogik, Registrierungen von Cloud-Flows und Einstellungen für OAuth-Anbieter.
  2. Klassifiziert jede Websiteeinstellung nach Vertraulichkeit und schlägt Umgebungsvariablen für Werte vor, die sich in verschiedenen Umgebungen unterscheiden.
  3. Bietet die Bereitstellung eines Azure Key Vault und das Speichern von Anmeldeinformationswerten wie Verbindungszeichenfolgen und API-Schlüsseln darin an.
  4. Wird im Synchronisierungsmodus ausgeführt, wenn eine Lösung bereits für Ihre Website vorhanden ist, um Komponenten abzugleichen, ohne eine neue Lösung zu erstellen.

Sie überprüfen und genehmigen den Vorschlag. Das Plug-In erstellt erst dann eine Konfiguration, wenn Sie dies bestätigen.

Tip

Wenn Ihre Lösung zu groß oder zu stark verwoben ist, um zuverlässig bereitgestellt zu werden, empfiehlt das Plugin eine Aufteilung und schlägt vor, wo sie vorgenommen werden sollte. Bestätigen Sie die Aufteilung, bevor die Änderungen wirksam werden.

Bereitstellen mit Power Platform-Pipelines

Wenn Sie Power Platform Pipelines als Ihre Promotionsstrategie ausgewählt haben, führt das Plug-In die folgenden Fähigkeiten aus:

  1. /ensure-pipelines-host stellt eine Hostumgebung für Power Platform-Pipelines bereit oder erkennt sie. Die Fähigkeit wählt die niedrigste Kostenoption für Ihren Mandanten aus: einen kostenlosen Plattformhost, die Pipelines-App in einer vorhandenen Umgebung oder einen benutzerdefinierten Host.
  2. /setup-pipeline registriert eine Pipelinedefinition in Dataverse, konfiguriert die ausgewählten Phasen und bindet jede Phase an eine Zielumgebung.
  3. /deploy-pipeline löst eine Bereitstellung für eine Phase aus, wendet phasenspezifische Überschreibungen von Umgebungsvariablen über deploymentSettings.json an und protokolliert den Status in einem Bereitstellungsprotokoll.

Wenn eine Bereitstellung fehlschlägt, weil die Zielumgebung bereits mit einem anderen Power Platform Pipelines-Host verknüpft ist, kann das Plug-In /force-link-environment ausführen, um sie neu zuzuweisen. Die Aktion erfordert Ihre ausdrückliche Zustimmung und ist umkehrbar.

Bereitstellen mit manuellem Export und Import

Wenn Sie den manuellen Pfad auswählen, wird das Plug-In ausgeführt:

  1. /export-solution um die Lösung als verwaltete oder nicht verwaltete ZIP-Datei mit einer Vollständigkeitsprüfung vor dem Export zu exportieren.
  2. /import-solution zum Importieren der ZIP-Datei in die Zielumgebung, entweder stufenweise, um Abhängigkeiten zuerst zu überprüfen, oder direkt.

Aktivieren und Überprüfen der bereitgestellten Website

Nach einer erfolgreichen Bereitstellung in der Zielumgebung das Plugin:

  1. Führt /activate-site aus, um die öffentliche URL in der Zielumgebung bereitzustellen.
  2. Führt /test-site aus, um die Bereitstellung zu überprüfen. Das Plugin verwendet einen Browser, um repräsentative Seiten zu durchsuchen, rollenbasierte Zugriffskontrollen auszuführen, Aufrufe an /_api/ zu überprüfen und Antwortstrukturen von /_api/serverlogics/-Endpunkten zu erfassen. Die Fähigkeit meldet das Ergebnis als PASS, WARNINGS oder FAIL, wobei die Details zu jeder Prüfung im Plan verlinkt sind.

Wenn ein Schritt fehlschlägt, führt das Plugin /diagnose-deployment aus. Die Fähigkeit stimmt mit dem Fehler mit einem Katalog bekannter Bereitstellungsfehler überein, z. B. einem veralteten Manifest, fehlenden Abhängigkeiten, Hostkonflikten, blockiertem JavaScript oder abgelaufener Authentifizierung und schlägt eine konkrete Lösung vor. Das Plug-In wendet niemals einen Fix ohne Ihre Zustimmung an.

Note

Jede ALM-Fähigkeit liest und schreibt Artefakte vom bzw. auf den Datenträger: das Lösungsmanifest, die Plandaten, das Pipelineprotokoll, das Bereitstellungsprotokoll und die Testergebnisse. Die Orchestrierung ist resumierbar und auditierbar. Um zu sehen, was in jedem Schritt passiert ist, überprüfen Sie die Artefakte.

Tipps und bewährte Methoden

Die folgenden Tipps unterstützen Sie dabei, das Plugin und den KI-Codierungsagenten optimal zu nutzen, wenn Sie Power Pages-Websites erstellen.

Überwachen der Terminalausgabe auf fehlende Tools bei der ersten Ausführung

Das Plug-In bietet die Fähigkeiten und Workflows, aber der KI-Codierungs-Agent - GitHub Copilot CLI oder Claude Code - führt die tatsächlichen Befehle auf Ihrem Computer aus. Wenn Sie diese Tools zum ersten Mal verwenden, beobachten Sie die Terminalausgabe genau. Der KI-Codierungs-Agent führt Befehle und Skripts hinter den Kulissen aus, und einige dieser Befehle sind von Tools abhängig, die möglicherweise nicht auf Ihrem Computer installiert sind. Wenn ein Schritt fehlschlägt, zeigt die Terminalausgabe in der Regel an, welches Tool oder welcher Befehl nicht gefunden werden konnte.

Wenn ein Fehler wie command not found oder is not recognizedangezeigt wird, installieren Sie das fehlende Tool, und lösen Sie den Workflow erneut aus. Der KI-Codierungs-Agent setzt dort fort, wo er aufgehört hat, sobald das Tool verfügbar ist.

Agentenvorschläge vor der Genehmigung überprüfen

Der KI-Codierungs-Agent stellt Vorschläge vor, z. B. aus dem Data Model Architect und Permissions Architect, bevor änderungen vorgenommen werden. Vom KI-Programmieragenten generierter Code und Konfigurationen können ungenau sein. Prüfen, testen und validieren Sie daher jeden Vorschlag und den gesamten generierten Code, bevor Sie ihn freigeben oder bereitstellen.

  • Datenmodellvorschläge: Überprüfen Sie, ob Tabellennamen, Spaltentypen und Beziehungen Ihren Geschäftsanforderungen entsprechen. Es ist einfacher, einen Vorschlag anzupassen, als Spalten umzubenennen, nachdem daten bereits eingefügt wurden.
  • Berechtigungsvorschläge: Stellen Sie sicher, dass jede Rolle die richtige Zugriffsebene (Erstellen, Lesen, Aktualisieren, Löschen) für jede Tabelle aufweist. Übermäßig zulässige Tabellenberechtigungen sind ein häufiges Sicherheitsrisiko.
  • Generierter Code: Lesen Sie den generierten Code, und testen Sie die Website lokal, bevor Sie sie bereitstellen. KI-generierter Code kann Fehler oder Sicherheitsprobleme enthalten.

Direktes Einfügen von Fehlern mit Kontext

Wenn ein Fehler auftritt, kopieren Sie die vollständige Fehlerausgabe, unabhängig davon, ob es sich um einen Buildfehler, einen Bereitstellungsfehler oder eine Laufzeitausnahme im Browser handelt. Fügen Sie es zusammen mit einer kurzen Beschreibung dessen ein, was Sie gerade gemacht haben. Je mehr Kontext Sie bereitstellen, desto schneller ist die Lösung.

Beispiel: Buildfehler

I ran npm run build and got this error. Fix it.

error TS2339: Property 'jobTitle' does not exist on type 'JobPosting'.

  src/components/JobCard.tsx:24:31
    24   <Text>{posting.jobTitle}</Text>

Tip

Schließen Sie den Dateinamen, den Befehl ein, den Sie ausgeführt haben, und was sie erwartet haben. Das Plug-In verwendet diesen Kontext, um das Problem zu finden und eine gezielte Lösung anzuwenden, anstatt zu erraten.

Web-API-Fehler mit der vollständigen Anforderungs-URL teilen

Ein häufiges Problem nach der Bereitstellung ist ein 403 Fehler aus der Power Pages-Web-API, wenn eine Spalte nicht für den API-Zugriff aktiviert ist. Wenn dieser Fehler auftritt, fügen Sie die vollständige API-URL und die vollständige JSON-Fehlerantwort ein. Die Fehlermeldung informiert Sie genau, welche Tabelle und Spalte behoben werden muss, und das Plug-In kann die Tabellenberechtigung YAML und Websiteeinstellungen für Sie aktualisieren.

Beispiel: Spalte für Web-API nicht aktiviert (403)

I'm getting a 403 error when the documents page loads. Here's the API call and the response. Fix the issue so this API works.

URL:
https://my-site.powerappsportals.com/_api/crd50_documents?$select=crd50_documentid,crd50_name,crd50_documentcategory,crd50_filetype,crd50_filesize,crd50_updateddate,crd50_description,_crd50_propertyid_value

Response:
{
  "error": {
    "code": "90040101",
    "message": "Attribute _crd50_propertyid_value in table crd50_document is not enabled for Web Api.",
    "innererror": {
      "code": "90040101",
      "message": "Attribute _crd50_propertyid_value in table crd50_document is not enabled for Web Api.",
      "type": "AttributePermissionIsMissing"
    }
  }
}

Dieser Fehler (AttributePermissionIsMissing) bedeutet, dass die Nachschlagespalte _crd50_propertyid_value in der Dataverse-Tabelle vorhanden ist, aber nicht in der Tabellenberechtigungskonfiguration für die Web-API aufgeführt ist. Das Plugin behebt diesen Fehler, indem es die fehlende Spalte zur Tabellenberechtigung YAML in .powerpages-site/table-permissions/ hinzufügt und erneut bereitstellt.

Note

Die Power Pages-Web-API erfordert, dass jede Spalte, die von einem API-Aufruf zurückgegeben wird, explizit in der Tabellenberechtigung aufgeführt wird. Sucheigenschaften (mit dem Präfix _ und dem Suffix _value) können leicht übersehen werden, da sich ihr API-Name vom logischen Namen der Spalte in Dataverse unterscheidet. Wenn Sie AttributePermissionIsMissing sehen, fügen Sie die Spalte immer zu den Tabellenberechtigungen hinzu. Ändern Sie die API-Abfrage nicht.

Seien Sie spezifisch in Bezug darauf, was Sie möchten.

Vage Anfragen führen zu vagen Ergebnissen. Teilen Sie dem Plug-In genau mit, was Sie benötigen, einschließlich Layouteinstellungen, Datenfeldern und Verhalten.

Statt Testen
Eine Seite für Jobs erstellen Erstellen Sie eine Seite mit einer Jobliste, einer Suchleiste oben, Filterchips für Standort und Abteilung sowie einem Kartennetz, das den Titel, das Unternehmen, den Gehaltsbereich und das Veröffentlichungsdatum für jede Stelle anzeigt.
Das Styling korrigieren "Die Auftragskarten stapeln sich vertikal auf dem Desktop. Sie sollten in einem 3-Spalten-Raster mit einem Abstand von 16px auf Bildschirmen ab einer Breite von 768px angezeigt werden“
"Hinzufügen einiger Daten" Hinzufügen von 20 Beispielstellenanzeigen in vier Abteilungen (Engineering, Marketing, Vertrieb, Personalwesen) mit realistischen Titeln, Gehaltsbereichen zwischen 60.000–180.000 $ und veröffentlichten Datumsangaben in den letzten 30 Tagen.
"Einrichten der API" "Verbinden Sie die JobListings-Komponente mit der cr_jobposting Dataverse-Tabelle. Ersetzen Sie das hartcodierte Array durch einen echten API-Aufruf, der Titel, Abteilung, Gehalt und Veröffentlichungsdatum abruft"
"Anmeldung hinzufügen" „Richte die Anmeldung mit Microsoft Entra External ID mit offener Registrierung sowie Google als zweitem Anbieter ein. Zeigen Sie sie als horizontale Zeile auf der Anmeldeseite an."

Verwenden von Screenshots für visuelle Probleme

Wenn die Website im Browser nicht richtig angezeigt wird, erstellen Sie einen Screenshot, fügen Sie ihn direkt in die Unterhaltung ein oder geben Sie einen Dateipfad an. Der visuelle Kontext hilft beim Identifizieren von Layout-, Abstands- und Formatierungsproblemen, die in Text schwer zu beschreiben sind.

The header overlaps the hero section on mobile. Here's a screenshot:

[paste screenshot or provide path to screenshot file]

Fix the header so it doesn't overlap. It should be a fixed header with the content starting below it.

Iterieren in kleinen Schritten

Anstatt eine ganze Website in einer Eingabeaufforderung zu beschreiben, erstellen Sie inkrementell. Beginnen Sie mit der Struktur und dem Layout, und fügen Sie dann gleichzeitig Features hinzu. Dieser Ansatz bietet Ihnen die Möglichkeit, jeden Schritt zu überprüfen und Kurskorrekturen vorzunehmen.

Step 1: /create-site → Get the basic scaffold and layout right
Step 2: "Add a hero section to the home page with a search bar"
Step 3: "Add a job listings page with filter and sort"
Step 4: "Add a job detail page that shows full description"
Step 5: /setup-datamodel → Create tables now that you know the data shape
Step 6: /integrate-webapi → Wire up real data

Tip

Überprüfen Sie nach jedem Schritt die Browservorschau. Wenn etwas nicht richtig ist, beheben Sie es, bevor Sie fortfahren. Es ist einfacher, Probleme in einer Komponente zu beheben, als Probleme auf einer ganzen Website aufzuheben.

Anfordern einer Erklärung vor der Genehmigung

Wenn Sie sich über eine vorgeschlagene Änderung nicht sicher sind, insbesondere bei Berechtigungen, Datenmodelländerungen oder Authentifizierungskonfigurationen, bitten Sie das Plug-In, zu erläutern, was es tun plant und warum, bevor Sie die Genehmigung erteilen.

Before you create the table permissions, explain what access each role will have and why. I want to understand the security implications.

Führen Sie Fähigkeiten unabhängig aus, um eine Wiederherstellung nach Problemen durchzuführen

Wenn eine Fähigkeit auf halbem Weg fehlschlägt, müssen Sie nicht von vorne anfangen. Jede Fähigkeit läuft unabhängig und kann dort weiterholen, wo sie aufgehört hat. Wenn /integrate-webapi beispielsweise bei der dritten Tabelle fehlschlägt, können Sie den Vorgang erneut ausführen, und es erkennt die bereits abgeschlossene Arbeit.

/integrate-webapi failed while processing the cr_applications table. Here's the error: [paste error]. Resume the integration from where it stopped.

Verwandte Inhalte

  • Zuletzt aktualisiert um