Kom i gang med Power Pages-plug-in'en til GitHub Copilot kommandolinjegrænsefladen og Claude Code

Power Pages-plug-in'en til GitHub Copilot CLI og Claude Code indeholder en AI-assisteret arbejdsproces til oprettelse, udrulning og administration af moderne single-page-program (SPA) websteder på Power Pages. I stedet for manuelt at stilladsere projekter, skrive API-kode til standardskabeloner og konfigurere tilladelser, beskrive, hvad du vil have på naturligt sprog, og plug-in'en håndterer implementeringen.

Plug-in'en understøtter hele livscyklussen for webstedsudvikling via samtalefærdigheder, lige fra stilladser til installation af et nyt websted, konfiguration af Dataverse-datamodeller og konfiguration af godkendelse.

Vigtigt!

  • En generativ AI-kodeagent, f.eks. GitHub Copilot CLI eller Claude Code, bruger dette plugins færdigheder og arbejdsprocesser til at udføre Power Pages-specifikke opgaver.
  • Kode og konfiguration, der genereres af AI-kodeagenten, kan være unøjagtige. Gennemse, test og valider alt genereret indhold, før du godkender eller installerer det. Gennemse altid agentforslag, før du godkender dem.

Forudsætninger

Før du begynder, skal du kontrollere, at du har den nødvendige software og de nødvendige tilladelser.

Softwarekrav

Komponent Minimumsversion Flere oplysninger
Node.js 18.0 eller nyere Download Node.js
Power Platform CLI (PAC CLI) 2.6.3 eller nyere (kræves til serverlogik) Installér PAC CLI
Azure CLI Latest Installér Azure CLI
GitHub Copilot CLI eller Claude Code Latest GitHub Copilot CLI eller Claude Code
udvidelse af Visual Studio Code og Power Platform Tools (valgfrit) Latest Download VS Code, og installér Power Platform Tools

Du skal også bruge:

  • Et Power Platform-miljø med Power Pages aktiveret.
  • En godkendt PAC CLI-session, der er forbundet til dit destinationsmiljø. Kør pac auth create , hvis du ikke har oprettet forbindelse endnu.
  • En Azure CLI-session logget ind på samme tenant. Kør az login --allow-no-subscriptions for at godkende.

Bekræft godkendelse:

Kontrollér, at du er godkendt ved hjælp pac auth list af kommandoen .

pac auth list           # Should show authenticated profile

Hvis du ikke er godkendt, skal du køre denne kommando:

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

Tips

Hvis du vil hente URL-adressen til forekomsten, skal du gå til Power Pages startside, vælge ikonet Indstillinger i øverste højre hjørne og derefter vælge Session-oplysninger.

Installér plug-in'en

Installér Power Pages-plug-in'en fra markedspladsen. Hvis du bruger GitHub Copilot CLI, kan du finde tilsvarende installationstrin i dokumentationen til CLI-udvidelser til Copilot . Følgende kommandoer bruger syntaksen Claude Code.

Kør installationsprogrammet for at konfigurere alle plug-ins med automatiske opdateringer aktiveret:

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

Installationsprogrammet automatisk:

  • Installerer kommandolinjegrænsefladen pac , hvis den ikke allerede er installeret.
  • Registrerer tilgængelige værktøjer, f.eks. Claude Code og GitHub Copilot CLI.
  • Registrerer markedspladsen for plug-in'en og installerer alle de angivne plug-ins.
  • Aktiverer automatiske opdateringer, så plug-ins forbliver opdaterede.

Efter installationen skal du genstarte Claude Code eller GitHub Copilot kommandolinjegrænsefladen for at få adgang til plug-in'ens færdigheder som skråstregskommandoer i din agentsession.

Installér fra marketplace

  1. Åbn Claude Code i din terminal.

  2. Tilføj markedspladsen for Microsoft:

    /plugin marketplace add microsoft/power-platform-skills

  3. Installér Power Pages-plug-in'en:

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

Når du har installeret plug-in'en, skal du genstarte Claude Code eller GitHub Copilot kommandolinjegrænsefladen for at få adgang til plug-in'ens færdigheder som skråstregskommandoer i din agentsession.

Tips

Hvis du automatisk vil modtage opdateringer til markedspladsen og færdigheder, skal du slå automatisk opdatering til. Brug kommandoen /plugin , gå til Marketplaces, vælg markedspladsen, og slå automatisk opdatering til.

Oversigt over færdigheder

Plug-in'en indeholder færdigheder, der dækker hele livscyklussen for et Power Pages-websted. Aktivér hver færdighed på en samtalebaseret måde, enten med en skråstregskommando eller ved at beskrive, hvad du vil gøre.

Færdighed Kommando Hvad den gør
Oprette websted /create-site Stilladser et websted, anvender din designretning og bygger sider og komponenter
Installér websted /deploy-site Bygger projektet og uploader det til Power Pages ved hjælp af PAC CLI
Aktivér websted /activate-site Klargør en webstedspost og tildeler en offentlig URL-adresse
Konfigurer datamodel /setup-datamodel Opretter Dataverse-tabeller, -kolonner og -relationer
Tilføj eksempeldata (valgfrit) /add-sample-data Udfylder Dataverse-tabeller med realistiske testposter
Integrer web-API /integrate-webapi Genererer typed API-klientkode, tjenester og tabeltilladelser
Tilføj AI-oversigter /add-ai-webapi Integrerer de generative API'er til ai-opsummering (søgeoversigt og dataopsummering) på dine sider. Genererer en typebestemt oversigtstjeneste med håndtering af anti-forfalskningstoken, strukturspecifikke indpakninger, kabelforbundne opkaldswebsteder og de tilsvarende Summarization-indstillinger for websted
Konfigurer godkendelse /setup-auth Tilføjer log på, log af og rollebaseret adgangskontrol. Understøtter Microsoft Entra ID, Microsoft Entra eksternt id, OpenID Connect, SAML 2.0, WS-Federation, Microsoft-konto, Facebook, Google og lokal godkendelse af brugernavn og adgangskode, herunder konfigurationer af flere udbydere
Opret webroller /create-webroles Genererer webrolle-YAML-filer til administration af brugeradgang
Tilføj serverlogik /add-server-logic Genererer sikre JavaScript-slutpunkter på serversiden til validering, eksterne API-kald, hemmelig administration og datahandlinger
Tilføj cloudflow /add-cloud-flow Integrerer eksisterende Power Automate cloudflows på dit websted til godkendelsesarbejdsprocesser, meddelelser og planlagt automatisering
Integrer backend /integrate-backend Analyserer din prototype, bestemmer den rigtige tilgang (web-API, serverlogik eller cloudflow) for hver funktion og organiserer den komplette buildsekvens
Tilføj SEO /add-seo Genererer robots.txt, sitemap.xmlog metakoder
Kør sikkerhedsgennemsyn /security-review Orkestrerer de fokuserede sikkerhedsfærdigheder og konsoliderer alle fund i en enkelt HTML-rapport. Dækker kode, afhængigheder, udrullet webstedsscanning, browserheadere, firewall for webprogram, tabeltilladelser og godkendelseskonfiguration
Scan kildekode /scan-code Kører statisk analyse og afhængighedsscanning på lokale kildefiler. viser resultater på tværs af kodemønstre, sårbare pakker, hardcodede hemmeligheder og licensproblemer
Scan udrullet websted /scan-site Starter en sikkerhedsscanning på serversiden mod det dynamiske websted, henter den seneste rapport og grupperer resultaterne efter alvorsgrad
Administrer browsersikkerhedsheadere /manage-headers Undersøger og konfigurerer http-sikkerhedsheadere, som et websted sender til browsere – Indholdssikkerhedspolitik, beskyttelse med ramme- og klikbeskyttelse, deling på tværs af oprindelser, cookiefunktionsmåde og relaterede indstillinger for websted
Administrer webapplikationsfirewall /manage-firewall Undersøger og konfigurerer WAF (Web Application Firewall) på et produktionswebsted: aktiverer beskyttelse, tilføjer eller fjerner IP-blokke, landeblokke, stiblokke og hastighedsgrænser
Tilladelser til overvågningstabel /audit-permissions Overvåger eksisterende tabeltilladelser i forhold til webstedskode og Dataverse-metadata. opretter en HTML-rapport grupperet efter alvorsgrad med foreslåede rettelser
Planlagt udrulning /plan-alm Registrerer projekttilstand, indsamler din kampagnestrategi, gengiver en visuel plan og orkestrerer de andre ALM-færdigheder (Application Lifecycle Management) i den rigtige rækkefølge
Forfatterløsning /setup-solution Opretter en udgiver og en løsning, tilføjer Power Pages komponenter, klassificerer webstedsindstillinger og foreslår miljøvariabler og Azure Key Vault hemmeligheder
Konfigurer pipelinevært /ensure-pipelines-host Klargør eller registrerer et værtsmiljø for Power Platform Pipelines
Konfigurer pipeline /setup-pipeline Registrerer en pipelinedefinition i Dataverse og binder hævningsfaser til destinationsmiljøer
Udrul via pipeline /deploy-pipeline Udløser en udrulning af en pipeline for en destinationsfase med tilsidesættelser af miljøvariablen pr. fase
Gennemtving sammenkædet miljø /force-link-environment Tildeler et destinationsmiljø til en ny vært for Power Platform Pipelines, når en værtskonflikt blokerer udrulningen
Eksportér løsning /export-solution Eksporterer løsningen som en administreret eller ikke-administreret zip med en fuldstændighedskontrol før eksport
Importløsning /import-solution Importerer en løsnings-zipfil til et målmiljø, midlertidigt eller direkte
Testsite /test-site Bekræfter et installeret websted med en browserbaseret test: gennemsøgning af sider, rollebaseret adgangskontrol og web-API-bekræftelse
Diagnosticer udrulning /diagnose-deployment Matcher installationsfejl i forhold til et katalog over kendte fejl og foreslår en rettelse

Typisk arbejdsgang

En almindelig arbejdsproces fra slutpunkt til slutpunkt følger denne sekvens:

  1. /create-site : Opret grundstruktur, design og udvikl sider
  2. /deploy-site : Overfør til dit Power Pages miljø
  3. /activate-site : Konfigurer en offentlig URL-adresse
  4. /setup-datamodel : Opret dataverse-tabeller
  5. /add-sample-data : Udfyld tabeller med testposter
  6. /integrate-webapi : Generér API-klientkode, og konfigurer tilladelser
  7. /create-webroles : Definér adgangsroller
  8. /setup-auth : Tilføj logon, logud og rollebaseret brugergrænseflade
  9. /add-server-logic : Tilføj sikre slutpunkter på serversiden
  10. /add-cloud-flow: Integrer eksisterende Power Automate flow
  11. /add-seo : Søgemaskineoptimering
  12. /deploy-site : Send de endelige ændringer live
  13. /security-review : Kør en gennemgang af sikkerheden fra ende til anden, før du går i produktion
  14. /plan-alm : Overfør dit website til test- og produktionsmiljøer

Tips

  • Du behøver ikke at følge denne nøjagtige rækkefølge. Hver færdighed kontrollerer sine egne forudsætninger og fortæller dig, om der mangler noget. Du kan f.eks. køre /setup-auth før /integrate-webapi , hvis dit websted skal godkendes først.
  • Hvis du ikke er sikker på, hvilken tilgang du skal bruge til hver funktion, skal du køre /integrate-backend i stedet for trin 4 til 10 enkeltvist. Den analyserer din prototype, bestemmer, om hver funktion har brug for web-API, serverlogik eller et cloudflow, og orkestrerer færdighederne i den korrekte rækkefølge.
  • Hvis du vil tilføje AI-genererede søge- og postoversigter, skal du køre /add-ai-webapi efter /integrate-webapi. Den genbruger de tabeltilladelser og webstedsindstillinger, der /integrate-webapi er konfigureret, så kør den, når web-API-integrationen er på plads.

Opret dit Power Pages-websted

Denne gennemgang dækker hele livscyklussen for oprettelse af et Power Pages-websted med plug-in'en lige fra stilladser til udrulning. Hvert trin beskriver, hvad du siger, og hvad plug-in'en gør som svar.

Trin 1: Opret dit websted

Beskriv det ønskede websted på et naturligt sprog: hvad det er til, hvilke sider det skal bruge, og eventuelle designindstillinger, f.eks. farveskema, layouttypografi eller skrifttyper. Kør /create-site eller beskriv blot dit websted, og plug-in'en genkender hensigten.

Hvis du ikke angiver en struktur, beder plug-in'en dig om at vælge en (React, Vue, Angular eller Astro), og derefter:

  1. Stilladser et projekt fra en skabelon og anvender dit websteds navn, farver og designtokens.
  2. Installerer afhængigheder, starter en udviklingsserver og åbner en livebrowsereksempel.
  3. Bygger hver side, komponent og rute, du har anmodet om, ud med relevante billeder.
  4. Opretter git-bekræftelser ved vigtige milepæle, så du har en indbygget oversigt over annulleringer.

Trin 2: Udrul dit websted

Kør /deploy-site for at overføre webstedet til Power Pages. Plug-in'en:

  1. Bekræfter, at PAC CLI er installeret, og at godkendelsessessionen er aktiv.
  2. Bekræfter destinationsmiljøet med dig, før du fortsætter.
  3. Kører et produktionsbuild og uploader det kompilerede output.
  4. Opretter en mappe med udrulningsartefakter, hvis der ikke allerede findes en.

Bemærkning

Hvis dit miljø blokerer visse vedhæftede filer, registrerer plug-in'en problemet og indeholder instruktioner til at løse det.

Trin 3: Aktivér dit websted

Kør /activate-site for at gøre webstedet offentligt tilgængeligt. Plug-in'en:

  1. Foreslår et underdomæne, der er baseret på navnet på dit websted, og giver dig mulighed for at tilpasse det.
  2. Klargør en webstedspost via Power Platform-API'en.
  3. Poller, indtil webstedet er live og returnerer den offentlige URL-adresse.

På dette tidspunkt har du et arbejdswebsted på en offentlig URL-adresse. De resterende trin tilføjer data, godkendelse og SEO. Spring alle trin over, der ikke gælder for dit websted.

Trin 4: Konfigurer din datamodel

Kør /setup-datamodel for at oprette de Dataverse-tabeller, dit websted skal bruge. Hvis du allerede har et ER-diagram eller et bestemt skema, skal du angive det direkte i stedet for at få agenten til at analysere din kode.

Plug-in'en opretter en datamodelarkitektagent , der:

  1. Analyserer koden for dit websted for at bestemme, hvilke data siderne og komponenterne kræver.
  2. Forespørger dit Dataverse-miljø om eksisterende tabeller for at undgå dubletter.
  3. Foreslår en datamodel med tabeller, kolonner, datatyper og relationer, der er visualiseret som et ER-diagram.

Du gennemser og godkender forslaget. Plug-in'en opretter ikke noget, før du har bekræftet det. Efter godkendelse opretter plug-in'en tabellerne og kolonnerne via API-kald og gemmer en manifestfil, som trin 5 og 6 bruger.

Trin 5: Tilføj eksempeldata (valgfrit)

Kør /add-sample-data for at udfylde tabellerne med testposter. Dette trin kræver datamodellen fra trin 4.

Plug-in'en udfører følgende handlinger:

  1. Læser manifestet for at forstå tabeller, kolonner og relationer.
  2. Genererer kontekstafhængige relevante værdier for hver kolonnetype, f.eks. realistiske mails, plausible datoer og formaterede valutabeløb.
  3. Indsætter poster i afhængighedsrækkefølgen (overordnede tabeller før underordnede tabeller) og opdaterer automatisk godkendelsestokens under masseindsætninger.

Trin 6: Integrer med Dataverse Web-API'en

Kør /integrate-webapi for at erstatte modeldata med dynamiske Dataverse-forespørgsler. Dette trin kræver datamodellen fra trin 4.

Plug-in'en udfører følgende handlinger:

  1. Scanner din kodebase for komponenter, der bruger modeldata, kald til hentning af pladsholdere eller hardcodede matrixer. Det knytter disse komponenter til dine Dataverse-tabeller.
  2. Opretter en web-API-integrationsagent for hver tabel, der genererer:
    • En delt API-klient med administration af anti-forfalskningstoken og logik for nyt forsøg.
    • TypeScript-objekttyper og domænemapper.
    • Et CRUD-tjenestelag.
    • Strukturspecifikke mønstre, f.eks. React-kroge, Vue-komposabler eller Angular-tjenester.
  3. Opretter en agent til tilladelsesarkitekt , der foreslår tabeltilladelser og indstillinger for websted.

Du gennemser og godkender tilladelsesforslaget. Plug-in'en opretter ingen konfigurationsfiler, før du har bekræftet det.

Tilføj AI-genererede oversigter (valgfrit)

Kør /add-ai-webapi til laggenerative AI-oversigter oven på din web-API-integration. Færdigheden forbinder to API'er til forhåndsvisningsopsummering med dine postdetaljesider og listsider:

  • API til søgeoversigt: Returnerer en AI-komprimeret oversigt over søgeresultater med citater.
  • API til dataopsummering: Returnerer en oversigt pr. post eller indsigt på listeniveau for en Dataverse-tabel.

Dette trin bygger på datamodellen fra trin 4 og web-API-integration fra trin 6. Plug-in'en udfører følgende handlinger:

  1. Scanner din kode for oversigtsintegrationspunkter og bekræfter, hvilke destinationssider, tabeller og hvilke API'er der skal bruges.
  2. Uddelegerer eventuelle manglende web-API-forudsætninger – tabeltilladelser, kolonnelister og webroller – til /integrate-webapi og /create-webroles, så der er en enkelt kilde til sandhed for tilladelser.
  3. Opretter en AI Web API-integrationsagent , der genererer en typed oversigtstjeneste (aiSummaryService.ts) med håndtering af anti-forfalskningstoken, framework-specifikke wrappers (React-kroge, Vue-composables eller Angular-tjenester) og kabelforbundne opkaldswebsteder på destinationssiderne.
  4. Opretter en arkitektagent til ai-web-API-indstillinger , der opretter Summarization webstedsindstillingerne for prompter og indholdsgrænser.

Du gennemser og godkender forslagene. Plug-in'en genererer ikke kode eller opretter indstillinger, før du har bekræftet det.

Bemærkning

Opsummerings-API'erne er som prøveversion og afhænger af, at administrative kontrolelementer og kontrolelementer på webstedsniveau er slået til. Hvis der ikke vises oversigter efter installationen, skal du bekræfte, at funktionen er aktiveret via de relevante webstedsindstillinger og administratorkontrolelementer. Du kan finde flere oplysninger i Dataopsummerings-API-oversigt og Power Pages søg med generativ AI.

Trin 7: Opret webroller

Kør /create-webroles for at definere brugeradgangsroller. Plug-in'en:

  1. Forespørger dit miljø om eksisterende webroller for at undgå dubletter.
  2. Genererer rolledefinitioner med entydige id'er.
  3. Gennemtvinger, at hvert websted højst har én anonym rolle og én godkendt rolle.

Trin 8: Konfigurer godkendelse

Kør /setup-auth for at tilføje logon, log af og rollebaseret adgangskontrol til dit websted. Plug-in'en understøtter følgende identitetsudbydere, og du kan konfigurere en eller flere på samme tid.

Udbyder Bedst til
Microsoft Entra eksternt id (anbefales til kundeorienterede websteder) Offentlige websteder og kundeportaler med tilmelding via selvbetjening.
Microsoft Entra ID Interne medarbejderportaler eller B2B-partnerwebsteder (business-to-business). Power Pages konfigurerer automatisk webstedets overordnede lejer, så du ikke behøver at angive lejeroplysninger.
Microsoft, Facebook, Google Socialt login for forbrugere.
Lokal godkendelse Log på med brugernavn og adgangskode. Anbefales ikke og konfigureres kun, når du udtrykkeligt anmoder om det.

Du kan få flere oplysninger om understøttede providere, herunder protokoller og konfigurationsovervejelser, under Overvisning af godkendelse i Power Pages.

Plug-in'en:

  1. Analyserer dit websted (formål, sider, målgruppe) og foreslår en fornuftig standardindstilling. Plug-in'en foreslår f.eks. Microsoft Entra eksternt id med åben registrering for et kundeorienteret websted eller Microsoft Entra ID med tilmelding kun med invitation til en intern portal. Du accepterer anbefalingen eller vælger dine egne udbydere.
  2. For hver udbyder gennemgår du alle nødvendige trin i identitetsudbyderens administration, f.eks. oprettelse af lejere, registrering af apps, oprettelse af brugerflows og hentning af klient-id'er og omdirigerings-URI'er. Plug-in'en validerer hver værdi, du indsætter tilbage i samtalen, og beregner den nøjagtige omdirigerings-URI for dit websted, så den værdi, der indsættes i appregistreringen, svarer til den værdi, der er skrevet i indstillingerne for webstedet.
  3. Spørger, hvordan brugerprofildata skal overføres fra identitetsudbyderen til Dataverse-kontaktposten (kravstilknytning), om der skal synkroniseres på hver enkelt logon eller kun første logon, og om eksterne logons automatisk skal knyttes til eksisterende kontakter via mail.
  4. Genererer godkendelsestjenesten, typeerklæringer, rollebaserede godkendelsesværktøjer (hasRole, RequireAuth, RequireRole), en sessions keepalive hook, der forhindrer, at SPA-sessioner udløber uovervåget, og en komponent til logon/logon af brugergrænsefladen, der er integreret med webstedets layout. Plug-in'en bruger strukturens mønstre overalt, f.eks. React-kroge, Vue-komposabler, Angular-tjenester eller Astro-komponenter.
  5. Når mere end én udbyder er konfigureret, genereres en /login side, der gengives i det valgte layout: vandret række, lodret stak, primær spotlight eller faneinddelt.
  6. Skriver de tilsvarende webstedsindstillinger under .powerpages-site/site-settings/ for hver udbyder, registreringstilstand, kravtilknytning og valgfri funktion.

Plug-in'en konfigurerer også følgende valgfrie funktioner, når du slår dem til:

  • Vilkår og betingelser: En /terms SPA-side, som brugerne skal acceptere, før de fuldfører logon, samt den tilsvarende webstedsindstilling og indholdsstykker.
  • Brugerprofilside: En /user-profile SPA-side, hvor brugere, der er logget på, redigerer deres kontaktoplysninger via web-API'en til Power Pages.
  • Logon via organisationsnetværk: Logger også brugeren af identitetsudbyderen, når vedkommende logger af webstedet, til delte enheder eller regulerede scenarier.

Tips

Hvis du vil føje endnu en identitetsudbyder til et eksisterende websted, skal du køre /setup-auth igen. Plug-in'en registrerer, hvad der allerede er konfigureret, og tilbyder at tilføje en ny udbyder uden at overskrive de eksisterende. Denne fremgangsmåde er nyttig til trinvise scenarier, f.eks. start med Microsoft Entra eksternt id og senere tilføjelse af Google til social logon.

Bemærkning

Godkendelse på klientsiden (RequireAuth, RequireRole, hasRole) er kun til brugeroplevelse. Den styrer, hvad brugeren ser. Tabeltilladelser på serversiden, konfigureret af /integrate-webapi, gennemtvinger reel sikkerhed.

Trin 9: Tilføj serverlogik

Kør /add-server-logic for at føje sikre slutpunkter på serversiden til dit websted. Brug serverlogik , når dit websted har brug for logik, der ikke kan køre i browseren, f.eks. eksterne API-kald, validering på serversiden, administration af hemmelighed eller datahandlinger på tværs af enheder.

Vigtigt!

Understøttelse af serverlogik kræver PAC CLI version 2.6.3 eller nyere. Brug scriptet til hurtig installation til at opdatere til den nyeste version.

Beskriv, hvad du har brug for i almindeligt sprog, og plug-in'en:

  1. Opretter en Server Logic Architect-agent , der analyserer din use case og klassificerer dens kompleksitet.
  2. Foreslår et slutpunktsdesign, en sikkerhedskonfiguration og eventuelle påkrævede tabeltilladelser til din anmeldelse.
  3. Når du har godkendt, genereres JavaScript-slutpunktet på serversiden på /_api/serverlogics/<name>.
  4. Opretter en indtastet tjeneste på klientsiden for at aktivere slutpunktet fra dine komponenter.
  5. Opdaterer dine komponenter for at kalde den nye tjeneste.
  6. Konfigurerer webrolletildelinger og tabeltilladelser for slutpunktet.

Du gennemser og godkender forslaget. Der genereres ingen kode, før du bekræfter.

Almindelige use cases:

  • Opret forbindelse til eksterne tjenester. Kald REST API'er, Azure Functions eller tredjepartstjenester uden at vise legitimationsoplysninger. (Selvstudium: interager med eksterne tjenester)
  • Udfør sikre datahandlinger. Forespørg om, opdater eller slet Dataverse-poster med konsekvent validering på serversiden. (Selvstudium: interager med Dataverse-tabeller)
  • Kør brugerdefineret logik. Aggregere data på tværs af tabeller, gennemtvinge forretningsregler eller beregne afledte værdier, før du returnerer resultater til klienten.
  • Administrer hemmeligheder på serversiden. Gem legitimationsoplysninger og API-nøgler på serveren, aldrig i klientkoden. (Tutorial: Interager med Microsoft Graph og SharePoint)

Bemærkning

Kør /add-server-logic én gang pr. brugssag. Hvis dit websted f.eks. har brug for både et slutpunkt for lagervalidering og et globalt søgeslutpunkt, skal du køre færdigheden to gange.

Trin 10: Integrere cloudflows

Kør /add-cloud-flow for at integrere eksisterende Power Automate cloudflows på dit websted. Denne færdighed forbinder dit Power Pages websted med flow, som du allerede har oprettet i Power Automate. Det opretter ikke nye cloudflows.

Plug-in'en:

  1. Registrerer det eksisterende cloudflow på dit websted.
  2. Genererer kode på klientsiden for at udløse flowet fra dine sider.
  3. Håndterer asynkrone arbejdsprocestilstands- og tilbagekaldsmønstre.
  4. Overfører dataudveksling mellem siden og flowet.

Brug /add-cloud-flow til godkendelsesarbejdsprocesser, mailmeddelelser, planlagte job og hændelsesbaseret automatisering, der håndteres bedre af Power Automate end af slutpunkter på serversiden.

Alternativt: Brug /integrate-backend til at planlægge det fulde tjenestelag

Hvis du ikke er sikker på, hvilke funktioner der skal bruge web-API, serverlogik eller et cloudflow, skal du køre /integrate-backend i stedet for manuelt at køre trin 4 til 10. Denne færdighed fungerer som en orchestrator, der:

  1. Analyserer din prototype for at identificere alle funktioner, der har brug for et tjenestelag.
  2. Klassificerer hver funktion i den rigtige tilgang: Web-API til STANDARD CRUD, Server Logic til validering på serversiden og eksterne API'er eller cloudflow til godkendelsesarbejdsprocesser og automatisering.
  3. Foreslår en sekvenseret udførelsesplan med alle færdigheder, afhængigheder og konfigurationer.
  4. Når du har godkendt, organiseres færdighederne i den korrekte rækkefølge.

Planen er vedvarende, genoptages og kan redigeres. Stop efter et trin for at gennemse genereret kode eller teste webstedet, og fortsæt, hvor du slap, ved at køre /integrate-backend igen.

Trin 11: Tilføj SEO

Kør /add-seo for at optimere dit websted til søgemaskiner. Plug-in'en:

  1. Finder ruter fra din frameworks routerkonfiguration.
  2. Genererer søgemaskinedirektiver og en oversigt over websteder for alle fundne ruter.
  3. Tilføjer metakoder: visningsport, tegnsæt, beskrivelse, Open Graph, Twitter Card og faviconreferencer.

Trin 12: Udrul det endelige websted

Hvis du udfører valgfrie trin, skal du køre /deploy-site igen for at sende ændringerne live. Plug-in'en kører et produktionsbuild og overfører webstedet sammen med alle udrulningsartefakter (tabeltilladelser, webstedsindstillinger, webroller, serverlogikfiler) til dit Power Pages miljø.

Trin 13: Kør en sikkerhedsgennemgang

Kør /security-review for at udføre en sikkerhedsgennemgang fra ende til anden af dit websted, før du går i produktion. Færdighederne orkestrerer de fokuserede sikkerhedsfærdigheder og konsoliderer alle fund i en enkelt HTML-rapport på docs/security-review-<timestamp>.html.

Plugin stiller et almindeligt sprogspørgsmål om dit mål og vælger det matchende sæt af fokuserede færdigheder:

Mål Hvad der kontrolleres
Kode og konfiguration Kildekode, afhængigheder, tabeltilladelser og godkendelseskonfiguration. Fungerer kun på lokale filer – der kræves ingen installation.
Udgivelsesparathed (anbefales) Fuld gennemgang før publicering. Kører alle fokuserede færdigheder: kode og afhængigheder, udrullet webstedsscanning, browsersikkerhedsheadere, firewall til webprogrammer, tabeltilladelser og godkendelse.
Installeret websted Kun direkte udrullet webstedsscanning. Nyttig til løbende overvågning af et publiceret websted.

Når du har bekræftet, kører plug-in'en de matchende fokuserede færdigheder parallelt og skriver deres resultater til en enkelt rapport:

  • /scan-code: Kører statisk analyse (opengrep) og afhængighedsscanning (trivy) på lokale kildefiler. Viser kodemønstre, sårbare pakker, hardcodede hemmeligheder og licensproblemer. Hvis et af værktøjerne ikke er installeret, tilbyder færdigheden en manuel kodegennemgang som reserve.
  • /scan-site: Starter en sikkerhedsscanning på serversiden mod det dynamiske websted og henter den seneste rapport. Scanningens varighed afhænger af webstedets størrelse – små websteder afsluttes på få minutter, store websteder kan tage timer. Resultaterne er grupperet efter alvorsgrad. Kræver et installeret websted.
  • /manage-headers: Undersøger de HTTP-sikkerhedsheadere, der er konfigureret under .powerpages-site/site-settings/: Content Security Policy, X-Frame-Options, CORS, cookie SameSite og relaterede indstillinger. Identificerer manglende eller svage værdier og foreslår anbefalede standarder.
  • /manage-firewall: Undersøger WAF (Web Application Firewall) for produktionswebstedet, herunder tilstands- og brugerdefinerede regler for administrerede regler (IP-blokke, landeblokke, stiblokke, hastighedsgrænser). Kun tilgængelig på produktionsanlæg i understøttede områder. færdigheden registrerer og rapporterer berettigelsesproblemer.
  • /audit-permissions: Overvåger eksisterende tabeltilladelser i forhold til webstedskode og Dataverse-metadata. Viser manglende tilladelser, alt for tilladte roller, ubrugte tilladelser og PROBLEMER med YAML-skemaer.

Den konsoliderede rapport grupperer resultater efter sektion, åbnes i din standardbrowser og indeholder vejledning til afhjælpning i almindeligt sprog. Fra chatten tilbyder plug-in'en derefter at gennemgå rettelser – vælg en søgning, og plug-in'en aktiverer den matchende fokuserede færdighed interaktivt for at anvende ændringen.

Bemærkning

Sikkerhedsgennemgangen anvender aldrig ændringer automatisk. Hver fokuseret færdighed kører i skrivebeskyttet korrekturtilstand under den konsoliderede kørsel. Hvis du vil anvende en rettelse, aktiverer plug-in'en den tilsvarende færdighed interaktivt, når du har vælge handlingen.

Tips

Du kan også køre alle fokuserede færdigheder på egen hånd:

  • Kør /scan-code under udvikling for at registrere problemer på kodeniveau tidligt.
  • Kør /manage-headers for at rette en bestemt fejl i indholdssikkerhedspolitikken eller konfigurere CORS.
  • Kør /manage-firewall for at tilføje en hastighedsgrænse på logonsiden eller blokere trafik efter land.
  • Kør /audit-permissions efter ændring af tabeltilladelser for at bekræfte, at de stadig stemmer overens med webstedskoden.
  • Kør igen /security-review med målet Udrullet websted for at overvåge et produktionswebsted over tid.

Bekræft dit websted

Når du har fuldført dine færdigheder, skal du kontrollere, at dit Power Pages-websted fungerer korrekt.

  1. Gå til Power Pages.
  2. Find dit websted på listen Aktive websteder .
  3. Få vist et eksempel på dit websted på skrivebordet ved hjælp af indstillingen Eksempel .
  4. Test funktionaliteten.

Fremhæv dit websted på tværs af miljøer

Når dit websted fungerer i dit udviklingsmiljø, kan du bruge ALM-færdigheder (Application Lifecycle Management) til at markedsføre det til test- og produktionsmiljøer. Plug-in'en pakker dit websted som en Power Platform-løsning, identificerer værdier, der varierer på tværs af miljøer, og udruller løsningen via Power Platform Pipelines eller via manuel eksport og import.

Hvis du vil bruge ALM-færdighederne, skal du også have mindst ét målmiljø for Power Platform (test, produktion eller begge dele). Hvis du vil bruge det valgfrie Azure Key Vault flow til hemmeligheder, skal du også have tilladelse til at oprette en key vault i dit Azure-abonnement.

Planlæg udrulningen

Kør /plan-alm for at starte. /plan-alm er indgangspunktet for ALM og organiserer de andre ALM-færdigheder, så du kører dem normalt ikke direkte. Plug-in'en:

  1. Registrerer den aktuelle tilstand for dit projekt, din løsning og dine destinationsmiljøer.
  2. Spørger om din kampagnestrategi (Power Platform Pipelines eller manuel eksport og import), destinationsfaserne og eventuelle begrænsninger, der skal anvendes.
  3. Genererer en visualiseringsplan på docs/alm-plan.html , der viser hver handling, den har til hensigt at udføre.
  4. Venter på din godkendelse, før der køres nogen efterfølgende færdighed.

Planen fortsætter til disken, så hver downstream-færdighed læser fra og skriver til den samme permanente plan. Hvis en fase mislykkes, skal du køre /plan-alm igen, og den fortsætter, hvor den stoppede.

Opret løsningen

Kør /setup-solution for at pakke dit websted som en Power Platform-løsning. Plug-in'en:

  1. Opretter en udgiver og en løsning og tilføjer derefter dine Power Pages komponenter: webstedet, webroller, slutpunkter for serverlogik, registreringer af cloudflow og OAuth-udbyderindstillinger.
  2. Klassificerer hver webstedsindstilling efter følsomhed og foreslår miljøvariabler for værdier, der varierer på tværs af miljøer.
  3. Tilbyder at klargøre en Azure Key Vault og gemme værdier af legitimationsoplysninger, f.eks. forbindelsesstrenge og API-nøgler, i den.
  4. Kører i synkroniseringstilstand, når der allerede findes en løsning for dit websted, for at afstemme komponenter uden at oprette en ny løsning.

Du gennemser og godkender forslaget. Plug-in'en opretter ingen konfiguration, før du har bekræftet det.

Tips

Hvis din løsning er for stor eller viklet til at blive udrullet pålideligt, anbefaler plug-in'en en opdeling og foreslår, hvor den skal opdeles. Bekræft opdelingen, før ændringerne gælder.

Udrul med Power Platform-pipelines

Hvis du vælger Power Platform Pipelines som din kampagnestrategi, kører plug-in'en disse færdigheder:

  1. /ensure-pipelines-host klargør eller registrerer et værtsmiljø for Power Platform Pipelines. Kompetencen vælger den laveste prisindstilling, der er tilgængelig for din lejer: en gratis platformvært, pipelineappen i et eksisterende miljø eller en brugerdefineret vært.
  2. /setup-pipeline registrerer en pipelinedefinition i Dataverse, konfigurerer de valgte faser og binder hver fase til et destinationsmiljø.
  3. /deploy-pipeline udløser en udrulning for en fase, anvender tilsidesættelser af miljøvariabler pr. fase via deploymentSettings.json og sporer tilstanden i en udrulningslog.

Hvis en installation mislykkes, fordi destinationsmiljøet allerede er knyttet til en anden Vært for Power Platform Pipelines, kan plug-in'en køre /force-link-environment for at tildele den igen. Handlingen kræver dit eksplicitte samtykke og kan fortrydes.

Udrul med manuel eksport og import

Hvis du vælger den manuelle sti, kører plug-in'en:

  1. /export-solution til at eksportere løsningen som en administreret eller ikke-administreret ZIP med en fuldstændighedskontrol før eksport.
  2. /import-solution for at importere ZIP-filen til målmiljøet, enten trinvist for først at kontrollere afhængighederne eller direkte.

Aktivér og valider det udrullede websted

Efter en vellykket udrulning i målmiljøet vil pluginet:

  1. Kører /activate-site for at klargøre den offentlige URL-adresse i destinationsmiljøet.
  2. Kører /test-site for at bekræfte installationen. Plug-in'en bruger en browser til at gennemsøge repræsentative sider, køre rollebaseret adgangskontrol, bekræfte /_api/ kald og hente svarfigurer fra /_api/serverlogics/ slutpunkter. Kompetencen rapporterer resultatet som PASS, WARNINGSeller FAIL, hvor detaljer pr. kontrol er sammenkædet fra planen.

Hvis et trin mislykkes, kører /diagnose-deploymentplug-in'en . Færdigheden matcher fejlen i et katalog over kendte installationsfejl, f.eks. et forældet manifest, manglende afhængigheder, værtskonflikter, blokeret JavaScript eller udløbet godkendelse, og foreslår en konkret løsning. Plug-in'en anvender aldrig en rettelse uden dit samtykke.

Bemærkning

Alle ALM-færdigheder læser fra og skriver til artefakter på disken: løsningsmanifestet, planlæg data, pipeline ledger, udrulningsbog og testresultater. Orkestrering kan genoptages og overvåges. Hvis du vil se, hvad der skete på et hvilket som helst trin, skal du undersøge artefakterne.

Tip og bedste praksis

Følgende tip hjælper dig med at få mest ud af plug-in'en og AI-kodeagenten, når du bygger Power Pages-websteder.

Overvåg terminaloutput for manglende værktøjer ved første kørsel

Plug-in'en leverer færdigheder og arbejdsprocesser, men AI-kodeagenten – GitHub Copilot CLI eller Claude Code – udfører de faktiske kommandoer på din maskine. Når du bruger disse værktøjer for første gang, skal du se terminaloutputtet nøje. AI-kodeagenten kører kommandoer og scripts i baggrunden, og nogle af disse kommandoer afhænger af værktøjer, der muligvis ikke er installeret på computeren. Hvis et trin mislykkes, viser terminaloutputtet normalt, hvilket værktøj eller hvilken kommando det ikke kunne finde.

Hvis du får vist en fejl som command not found eller is not recognized, skal du installere det manglende værktøj og udløse arbejdsprocessen igen. AI-kodeagenten fortsætter, hvor den slap, når værktøjet er tilgængeligt.

Gennemse agentforslag, før du godkender

AI-kodningsagenten præsenterer forslag, f.eks. dem fra datamodelarkitekten og tilladelsesarkitekten, før den foretager ændringer. Kode og konfiguration, der genereres af AI-kodeagenten, kan være unøjagtige, så gennemse, test og valider alle forslag og al genereret kode, før du godkender eller installerer den.

  • Forslag til datamodeller: Kontrollér, at tabelnavne, kolonnetyper og relationer stemmer overens med dine forretningskrav. Det er nemmere at justere et forslag end at omdøbe kolonner, når der allerede er indsat data.
  • Forslag til tilladelser: Kontrollér, at hver rolle har det korrekte adgangsniveau (opret, læs, opdater, slet) for hver tabel. Overdrevent permissive tabelrettigheder er en almindelig sikkerhedsrisiko.
  • Genereret kode: Læs den genererede kode, og test webstedet lokalt, før du udruller. Ai-genereret kode kan indeholde fejl eller sikkerhedsproblemer.

Indsæt fejl direkte med kontekst

Når noget mislykkes, skal du kopiere det fulde fejloutput, uanset om det er en buildfejl, en installationsfejl eller en kørselsundtagelse i browseren. Indsæt den sammen med en kort beskrivelse af, hvad du gjorde. Jo mere kontekst du angiver, jo hurtigere er rettelsen.

Eksempel: Oprettelsesfejl

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>

Tips

Medtag filnavnet, den kommando, du kørte, og hvad du forventede ville ske. Plug-in'en bruger denne kontekst til at finde problemet og anvende en målrettet rettelse i stedet for at gætte.

Del web-API-fejl med den fulde URL-adresse til anmodningen

Et almindeligt problem efter installation er en 403 fejl fra Power Pages Web-API, når en kolonne ikke er aktiveret til API-adgang. Når du støder på denne fejl, skal du indsætte hele API-URL-adressen og det komplette JSON-fejlsvar. Fejlmeddelelsen fortæller dig præcis, hvilken tabel og kolonne der skal rettes, og plug-in'en kan opdatere indstillingerne for YAML for tabeltilladelser og websted for dig.

Eksempel: Kolonnen er ikke aktiveret for Web-API (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"
    }
  }
}

Denne fejl (AttributePermissionIsMissing) betyder, at opslagskolonnen _crd50_propertyid_value findes i tabellen Dataverse, men ikke er angivet i konfigurationen af tabeltilladelser for web-API'en. Plug-in'en løser denne fejl ved at føje den manglende kolonne til tabeltilladelsen YAML i .powerpages-site/table-permissions/ og geninstallere den.

Bemærkning

Web-API'en til Power Pages kræver, at alle kolonner, der returneres af et API-kald, angives eksplicit i tabeltilladelsen. Opslagsegenskaber (præfikset med _ og suffikset med _value) er nemme at gå glip af, fordi deres API-navn adskiller sig fra kolonnens logiske navn i Dataverse. Når du ser AttributePermissionIsMissing, skal du altid føje kolonnen til tabeltilladelsen. Rediger ikke API-forespørgslen.

Vær specifik om, hvad du vil have

Vage anmodninger giver vage resultater. Fortæl plug-in'en præcis, hvad du har brug for, herunder layoutindstillinger, datafelter og funktionsmåde.

I stedet for Prøv
Opret en side til jobs "Opret en joblisteside med en søgelinje øverst, filtrer chips for placering og afdeling og et kortgitter med titel, firma, løninterval og en postet dato for hvert job"
"Ret formateringen" "Jobkortene stables lodret på skrivebordet. Få dem vist i et gitter med tre kolonner med et mellemrum på 16 pixel på skærme, der er bredere end 768px"
"Tilføj nogle data" "Tilføj 20 eksempeljobopslag på tværs af fire afdelinger (Engineering, Marketing, Sales, HR) med realistiske titler, lønintervaller mellem $60k-$180k og posterede datoer inden for de seneste 30 dage"
"Konfigurer API'en" "Forbind komponenten JobListings til tabellen cr_jobposting Dataverse. Erstat den hardcodede matrix med et rigtigt API-kald, der henter titel, afdeling, løn og postet dato"
"Tilføj logon" "Konfigurer Microsoft Entra eksternt id logon med åben registrering samt Google som endnu en udbyder. Vis dem som en vandret række på logonsiden."

Brug skærmbilleder til visuelle problemer

Når webstedet ikke ser direkte ud i browseren, kan du tage et skærmbillede og indsætte det direkte i samtalen eller angive en filsti. Visuel kontekst hjælper med at identificere problemer med layout, afstand og formatering, der er svære at beskrive i tekst.

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.

Gentage i små trin

I stedet for at beskrive et helt websted i én prompt skal du oprette trinvist. Start med strukturen og layoutet, og tilføj derefter funktioner én ad gangen. Denne fremgangsmåde giver dig mulighed for at gennemse og kursusrette på hvert trin.

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

Tips

Efter hvert trin skal du kontrollere browserforhåndsvisningen. Hvis noget ikke er rigtigt, skal du rette det, før du går videre. Det er nemmere at løse problemer i én komponent end at løse problemer på tværs af et helt websted.

Bed om en forklaring, før du godkender

Når du er usikker på en foreslået ændring, især for tilladelser, ændringer af datamodeller eller godkendelseskonfiguration, skal du bede plug-in'en om at forklare, hvad den planlægger to do og hvorfor, før den godkendes.

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

Kør færdigheder uafhængigt for at komme sig efter problemer

Hvis en færdighed mislykkes, behøver du ikke at starte forfra. Hver færdighed kører uafhængigt af hinanden og kan fortsætte, hvor den slap. Hvis /integrate-webapi det f.eks. mislykkes i den tredje tabel, kan du køre den igen og registrere det arbejde, der allerede er fuldført.

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

Relateret indhold

  • Last updated on