Kom i gang med plugin-modulen Power Pages for GitHub Copilot CLI og Claude Code

Plugin-modulen Power Pages for GitHub Copilot CLI og Claude Code gir en AI-assistert arbeidsflyt for oppretting, distribusjon og administrasjon av moderne nettsteder for enkeltsiders program (SPA) på Power Pages. I stedet for å bygge opp prosjekter manuelt, skrive standard API-kode og konfigurere tillatelser, kan du beskrive det du vil ha i naturlig språk, og plugin-modulen håndterer implementasjonen.

Plugin støtter hele livssyklusen for nettstedsutvikling gjennom samtaleferdigheter, fra oppsett av et nytt nettsted til dets distribusjon, oppsett av Dataverse-datamodeller og konfigurering av godkjenning.

Viktig!

  • En generativ ai-kodingsagent, for eksempel GitHub Copilot CLI eller Claude Code, bruker denne programtilleggets ferdigheter og arbeidsflyter til å fullføre Power Pages spesifikke oppgaver.
  • Kode og konfigurasjon generert av ai-kodingsagenten kan være unøyaktig. Se gjennom, test og valider alt generert innhold før du godkjenner eller distribuerer det. Se alltid gjennom agentforslag før du godkjenner dem.

Forutsetninger

Før du begynner, må du kontrollere at du har den nødvendige programvaren og tillatelsene.

Programvarekrav

Komponent Minimumsversjon Mer informasjon
Node.js 18.0 eller nyere Last ned Node.js
Power Platform CLI (PAC CLI) 2.6.3 eller nyere (kreves for serverlogikk) Installer PAC CLI
Azure CLI Latest Installer Azure CLI
GitHub Copilot CLI eller Claude Code Latest GitHub Copilot CLI eller Claude Code
Utvidelse for Visual Studio Code og Power Platform Tools (valgfritt) Latest Last ned VS Code og installer Verktøy for Power Platform

Du trenger også:

  • Et Power Platform-miljø med Power Pages aktivert.
  • En autentisert PAC CLI-økt som er koblet til ditt målmiljø. Kjør pac auth create hvis du ikke har koblet til ennå.
  • En Azure CLI-sesjon logget på samme leietaker. Kjør az login --allow-no-subscriptions for å godkjenne.

Bekreft godkjenning:

Kontroller at du er godkjent ved hjelp pac auth list av kommandoen.

pac auth list           # Should show authenticated profile

Hvis du ikke er godkjent, kjører du denne kommandoen:

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

Tips

Hvis du vil ha url-adressen for forekomsten, kan du gå til Power Pages hjem, velge Settings-ikonet øverst til høyre, og deretter velge Session-detaljer.

Installere plugin-modulen

Installer plugin-modulen Power Pages fra markedsplassen. Hvis du bruker GitHub Copilot CLI, kan du se dokumentasjonen for Copilot CLI-utvidelser for tilsvarende installasjonstrinn. Følgende kommandoer bruker Claude Code-syntaks.

Kjør installasjonsprogrammet for å konfigurere alle programtillegg med automatiske oppdateringer aktivert:

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

Installasjonsprogrammet automatisk:

  • Installerer pac CLI hvis den ikke allerede er installert.
  • Oppdager tilgjengelige verktøy, for eksempel Claude Code og GitHub Copilot CLI.
  • Registrerer plugin-markedsplassen og installerer alle oppførte plugin-moduler.
  • Aktiverer automatiske oppdateringer, slik at plugin-moduler forblir oppdaterte.

Etter installasjonen starter du Claude Code eller GitHub Copilot CLI på nytt for å få tilgang til programtilleggets ferdigheter som skråstrekkommandoer i agentøkten.

Installer fra marketplace

  1. Åpne Claude Code i terminalen.

  2. Legg til Microsoft markedsplass:

    /plugin marketplace add microsoft/power-platform-skills

  3. Installer Power Pages-pluginen:

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

Når du har installert plugin-modulen, starter du Claude Code eller GitHub Copilot CLI på nytt for å få tilgang til programtilleggets ferdigheter som skråstrekkommandoer i agentøkten.

Tips

Hvis du vil motta oppdateringer til markedsplassen og ferdigheter automatisk, aktiverer du automatisk oppdatering. /plugin Bruk kommandoen, gå til Marketplace, velg markedsplassen, og aktiver automatisk oppdatering.

Kompetanseoversikt

Plugin-modulen gir ferdigheter som dekker hele livssyklusen til et Power Pages nettsted. Aktiver hver ferdighet i en samtalestil, enten som en skråstrekkommando eller ved å beskrive hva du ønsker å gjøre.

Kompetanse Kommando Resultat
Opprett nettsted /create-site Setter opp et nettsted, følger designretningen og bygger sider og komponenter
Utrull nettsted /deploy-site Bygger prosjektet og laster det opp til Power Pages ved hjelp av PAC CLI
Aktiver område /activate-site Klargjør en nettstedsoppføring og tilordner en offentlig NETTADRESSE
Konfigurere datamodell /setup-datamodel Oppretter dataverse tabeller, kolonner og relasjoner
Legge til eksempeldata (valgfritt) /add-sample-data Fyller ut dataverse tabeller med realistiske testposter
Integrer web-API /integrate-webapi Genererer innskrevne API-klientkoder, tjenester og tabelltillatelser
Legg til ai-sammendrag /add-ai-webapi Integrerer de generative AI-sammendrags-API-ene (søkesammendrag og datasammendrag) på sidene. Genererer en skrevet sammendragstjeneste med håndtering av anti-forfalskningstoken, rammeverksspesifikke innpakninger, tilkoblede kallnettsteder og de samsvarende Summarization-nettstedsinnstillingene
Konfigurere godkjenning /setup-auth Legger til pålogging, avlogging og rollebasert tilgangskontroll. Støtter Microsoft Entra ID, Microsoft Entra ekstern ID, OpenID Connect, SAML 2.0, WS-Federation, Microsoft-konto, Facebook, Google og lokal brukernavn- og passordgodkjenning, inkludert konfigurasjoner for flere leverandører
Opprette webroller /create-webroles Genererer YAML-filer for nettrolle for administrasjon av brukertilgang
Legg til serverlogikk /add-server-logic Genererer sikre JavaScript-endepunkter på serversiden for validering, eksterne API-kall, hemmelig administrasjon og dataoperasjoner
Legg til skyflyt /add-cloud-flow Integrerer eksisterende Power Automate skyflyter på nettstedet for godkjenningsarbeidsflyter, varsler og planlagt automatisering
Integrer serverdel /integrate-backend Analyserer prototypen, bestemmer riktig tilnærming (Web API, Server Logic eller cloud flow) for hver funksjon, og orkestrerer den fullstendige byggsekvensen
Legg til SEO /add-seo Genererer robots.txt-, sitemap.xml- og metakoder
Kjør sikkerhetsgjennomgang /security-review Orkestrer de fokuserte sikkerhetsferdighetene og konsoliderer hvert funn i én enkelt HTML-rapport. Dekker kode, avhengigheter, distribusjonsområdeskanning, nettleseroverskrifter, brannmur for webprogram, tabelltillatelser og godkjenningskonfigurasjon
Skann kildekode /scan-code Kjører statisk analyse og avhengighetsskanning på lokale kildefiler. viser funn på tvers av kodemønstre, sårbare pakker, hardkodede hemmeligheter og lisensproblemer
Skanne distribuert område /scan-site Starter en sikkerhetsskanning på serversiden mot det direktesendte nettstedet, henter den nyeste rapporten og grupperer funn etter alvorsgrad
Behandle sikkerhetsoverskrifter i nettleseren /manage-headers Inspiserer og konfigurerer HTTP-sikkerhetshodene et nettsted sender til nettlesere – innholdssikkerhetspolicy, ramme- og klikkkapringbeskyttelse, deling på tvers av opprinnelse, virkemåte for informasjonskapsler og relaterte nettstedsinnstillinger
Administrer brannmur for webapplikasjoner /manage-firewall Inspiserer og konfigurerer nettprogrambrannmuren (WAF) på et produksjonsområde: aktiverer beskyttelse, legger til eller fjerner IP-blokker, landblokker, baneblokker og rentegrenser
Revider tabelltillatelser /audit-permissions Overvåker eksisterende tabelltillatelser mot områdekode og dataverse metadata. produserer en HTML-rapport gruppert etter alvorsgrad med foreslåtte løsninger
Planlagt utrulling /plan-alm Oppdager prosjekttilstand, samler inn kampanjestrategien din, gjengir en visuell plan og orkestrerer de andre alm-ferdighetene (application lifecycle management) i riktig rekkefølge
Forfatterløsning /setup-solution Oppretter en utgiver og løsning, legger til Power Pages komponenter, klassifiserer nettstedsinnstillinger og foreslår miljøvariabler og Azure Key Vault hemmeligheter
Konfigurer rørledningsvert /ensure-pipelines-host Klargjør eller oppdager et vertsmiljø for Power Platform Pipelines
Konfigurer pipeline /setup-pipeline Registrerer en pipeline-definisjon i Dataverse og knytter promoteringsfaser til målmiljøer
Rull ut gjennom rørledning /deploy-pipeline Utløser en utrulling av en pipeline for en målfase med overstyringer av miljøvariabler per fase
Force-link-miljø /force-link-environment Tilordner et målmiljø til en ny vert for Power Platform Pipelines når en vertskonflikt blokkerer distribusjon
Eksportere løsning /export-solution Eksporterer løsningen som en administrert eller uadministrert zip, med en fullstendig kontroll før eksport
Importer løsning /import-solution Importerer en løsning zip på et målmiljø, trinnvis eller direkte
Testområde /test-site Bekrefter et distribuert nettsted med en nettleserbasert test: kravlesøk på side, rollebaserte tilgangskontroller og web-API-bekreftelse
Feilsøk utrulling /diagnose-deployment Samsvarer med distribusjonsfeil mot en katalog med kjente feil og foreslår en løsning

Typisk arbeidsflyt

En vanlig ende-til-ende-arbeidsflyt følger denne sekvensen:

  1. /create-site : Rammeverk, utforming og bygging av sider
  2. /deploy-site : Last opp til Power Pages miljøet
  3. /activate-site : Konfigurere en offentlig URL-adresse
  4. /setup-datamodel : Opprett dataverse tabeller
  5. /add-sample-data : Fylle ut tabeller med testposter
  6. /integrate-webapi : Generer API-klientkode og konfigurer tillatelser
  7. /create-webroles : Definerer tilgangsroller
  8. /setup-auth : Legg til pålogging, pålogging og rollebasert brukergrensesnitt
  9. /add-server-logic : Legg til sikre endepunkter på serversiden
  10. /add-cloud-flow: Integrere eksisterende Power Automate arbeidsflyter
  11. /add-seo : Søkemotoroptimalisering
  12. /deploy-site : Sende de endelige endringene direkte
  13. /security-review : Kjør en ende-til-ende sikkerhetsgjennomgang før du går til produksjon
  14. /plan-alm : Flytt nettstedet til test- og produksjonsmiljøer

Tips

  • Du trenger ikke å følge denne rekkefølgen. Hver kompetanse kontrollerer sine egne forutsetninger og forteller deg om noe mangler. Du kan for eksempel kjøre /setup-auth før /integrate-webapi hvis nettstedet trenger godkjenning først.
  • Hvis du ikke er sikker på hvilken tilnærming du skal bruke for hver funksjon, kjører /integrate-backend du i stedet for trinn 4 til 10 enkeltvis. Den analyserer prototypen, bestemmer om hver funksjon trenger Web API, Server Logic eller en skyflyt, og orkestrerer ferdighetene i riktig rekkefølge.
  • Hvis du vil legge til ai-genererte søke- og postsammendrag, kjører /add-ai-webapi du etter /integrate-webapi. Den bruker tabelltillatelsene og nettstedsinnstillingene som /integrate-webapi konfigureres på nytt, så kjør den når web-API-integreringen er på plass.

Bygg ditt Power Pages nettsted

Denne gjennomgangen dekker hele livssyklusen til å bygge et Power Pages nettsted med plugin-modulen, fra planlegging til distribusjon. Hvert trinn beskriver hva du sier og hva plugin-modulen gjør som svar.

Trinn 1: Opprette området

Beskriv området du vil bruke på naturlig språk: hva det er for, hvilke sider det trenger, og eventuelle utformingsinnstillinger som fargevalg, oppsettstil eller skrifter. Kjør /create-site eller bare beskriv nettstedet, og plugin-modulen gjenkjenner hensikten.

Hvis du ikke angir et rammeverk, ber plugin-modulen deg om å velge en (React, Vue, Angular eller Astro), og deretter:

  1. Still inn prosjektet fra en mal og bruker områdenavn, farger og utformingstokener.
  2. Installerer avhengigheter, starter en utviklingsserver og åpner en forhåndsvisning av en direkte nettleser.
  3. Bygger ut hver side, komponent og rute du har bedt om med relevante bilder.
  4. Oppretter git-utføringer ved viktige milepæler, slik at du har innebygd tilbakerullingslogg.

Trinn 2: Distribuer nettstedet

Kjør /deploy-site for å laste opp ditt nettsted til Power Pages. Plugin-modulen:

  1. Bekrefter at PAC CLI er installert, og at godkjenningsøkten er aktiv.
  2. Bekrefter målmiljøet med deg før du fortsetter.
  3. Kjører et produksjonsbygg og laster opp kompilerte utdata.
  4. Oppretter en katalog for distribusjonsartefakter hvis en ikke allerede finnes.

Notat

Hvis miljøet blokkerer bestemte filvedlegg, oppdager plugin-modulen problemet og gir instruksjoner for å løse det.

Trinn 3: Aktivere nettstedet

Kjør /activate-site for å gjøre området offentlig tilgjengelig. Plugin-modulen:

  1. Foreslår et underdomene basert på navnet på nettstedet, og lar deg tilpasse det.
  2. Klargjør en nettstedspost gjennom API-en for Power Platform.
  3. Sjekker frem til nettstedet er publisert og returnerer den offentlige nettadressen.

På dette tidspunktet har du et fungerende område på en offentlig NETTADRESSE. De gjenværende trinnene legger til data, godkjenning og SEO. Hopp over eventuelle trinn som ikke gjelder for området.

Trinn 4: Konfigurere datamodellen

Kjør /setup-datamodel for å opprette dataverse tabeller som nettstedet trenger. Hvis du allerede har et ER-diagram eller et bestemt skjema, kan du oppgi det direkte i stedet for at agenten analyserer koden.

Plugin-modulen gyter en Data Model Architect-agent som:

  1. Analyserer nettstedets kode for å finne ut hvilke data sidene og komponentene krever.
  2. Spør dataversmiljøet for eksisterende tabeller for å unngå duplikater.
  3. Foreslår en datamodell med tabeller, kolonner, datatyper og relasjoner, visualisert som et ER-diagram.

Du ser gjennom og godkjenner forslaget. Plugin-modulen oppretter ingenting før du bekrefter. Etter godkjenning oppretter plugin-modulen tabellene og kolonnene gjennom API-kall og lagrer en manifestfil som trinn 5 og 6 bruker.

Trinn 5: Legge til eksempeldata (valgfritt)

Kjør /add-sample-data for å fylle ut tabellene med testposter. Dette trinnet krever datamodellen fra trinn 4.

Plugin-modulen utfører følgende handlinger:

  1. Leser manifestet for å forstå tabeller, kolonner og relasjoner.
  2. Genererer kontekstavhengige verdier for hver kolonnetype, for eksempel realistiske e-postmeldinger, sannsynlige datoer og formaterte valutabeløp.
  3. Setter inn poster i avhengighetsrekkefølge (overordnede tabeller før underordnede tabeller) og oppdaterer godkjenningstokener automatisk under masseinnlegg.

Trinn 6: Integrere med Dataverse Web API

Kjør /integrate-webapi for å erstatte mock-data med live Dataverse-spørringer. Dette trinnet krever datamodellen fra trinn 4.

Plugin-modulen utfører følgende handlinger:

  1. Skanner kodebasen etter komponenter som bruker mock-data, plassholderhentingsanrop eller hardkodede matriser. Den tilordner disse komponentene til Dataverse-tabellene.
  2. Gyter en web-API-integrasjonsagent for hver tabell som genererer:
    • En delt API-klient med behandling av anti-forfalskningstoken og ny forsøkslogikk.
    • TypeScript-enhetstyper og domenemappere.
    • Et CRUD-tjenestelag.
    • Rammespesifikke mønstre, for eksempel React hooks, Vue composables eller Angular-tjenester.
  3. Gyter en tillatelsesarkitektagent som foreslår tabelltillatelser og nettstedsinnstillinger.

Du ser gjennom og godkjenner tillatelsesforslaget. Plugin-modulen oppretter ingen konfigurasjonsfiler før du bekrefter.

Legg til AI-genererte sammendrag (valgfritt)

Kjør /add-ai-webapi til laggenererende AI-sammendrag oppå web-API-integreringen. Ferdigheten kobler to API-er for forhåndsvisningsoppsummering til sidene for oppføringsdetaljer og lister:

  • API for søkesammendrag: Returnerer et ai-kondensert sammendrag av søkeresultater, med sitater.
  • API for datasammendrag: Returnerer et sammendrag per post eller innsikt på listenivå for en datavers tabell.

Dette trinnet bygger på datamodellen fra trinn 4 og web-API-integrering fra trinn 6. Plugin-modulen utfører følgende handlinger:

  1. Skanner koden for sammendragsintegreringspunkter og bekrefter målsidene, tabellene og hvilke API-er som skal brukes.
  2. Delegerer eventuelle manglende web-API-forutsetninger – tabelltillatelser, kolonnelister og nettroller – til /integrate-webapi og /create-webroles, slik at det finnes én enkelt kilde til sannhet for tillatelser.
  3. Oppretter en AI Web API Integration-agent som genererer en typesikker sammendragstjeneste (aiSummaryService.ts) med håndtering av anti-forfalskningstokener, rammeverksspesifikke omslag (React-hooker, Vue-composables eller Angular-tjenester) og tilkoblede kallsteder på målsidene.
  4. Oppretter en AI Web API Settings Architect-agent som oppretter Summarization nettstedsinnstillingene for ledetekster og innholdsgrenser.

Du ser gjennom og godkjenner forslagene. Plugin-modulen genererer ikke kode eller oppretter innstillinger før du bekrefter.

Notat

Sammendrags-API-ene er i forhåndsvisning og avhenger av at kontroller på administrativt og områdenivå er aktivert. Hvis sammendrag ikke vises etter distribusjon, bekrefter du at funksjonen er aktivert gjennom de relevante nettstedsinnstillingene og administratorkontrollene. Hvis du vil ha mer informasjon, kan du se Oversikt over sammendrag av data og Power Pages søk med generativ KUNSTIG INTELLIGENS.

Trinn 7: Opprette nettroller

Kjør /create-webroles for å definere brukertilgangsroller. Plugin-modulen:

  1. Spør miljøet etter eksisterende nettroller for å forhindre duplikater.
  2. Genererer rolledefinisjoner med unike identifikatorer.
  3. Fremtvinger at hvert område har maksimalt én anonym rolle og én godkjent rolle.

Trinn 8: Konfigurere godkjenning

Kjør /setup-auth for å legge til pålogging, utlogging og rollebasert tilgangskontroll på nettstedet. Plugin-modulen støtter følgende identitetsleverandører, og du kan konfigurere én leverandør eller flere samtidig.

Leverandør Best for
Microsoft Entra ekstern ID (anbefales for kunderettede nettsteder) Offentlige nettsteder og kundeportaler med selvbetjent registrering.
Microsoft Entra ID Interne ansattportaler eller forretnings-til-bedrift(B2B)-partnerområder. Power Pages konfigurerer automatisk områdets overordnede leier, slik at du ikke trenger å angi leierinformasjon.
Microsoft, Facebook, Google Sosial pålogging for forbrukerpublikum.
Lokal godkjenning Brukernavn og passordpålogging. Anbefales ikke og konfigureres bare når du eksplisitt ber om det.

Hvis du vil ha mer informasjon om støttede leverandører, inkludert protokoller og konfigurasjonshensyn, kan du se Overview for godkjenning i Power Pages.

Plugin-modulen:

  1. Analyserer nettstedet (formål, sider, målgruppe) og foreslår en fornuftig standard. Plugin-modulen foreslår for eksempel Microsoft Entra ekstern ID med åpen registrering for et kunderettet nettsted, eller Microsoft Entra ID med invitasjonsregistrering for en intern portal. Du godtar anbefalingen eller velger dine egne leverandører.
  2. For hver leverandør veileder du deg gjennom alle nødvendige trinn i administrasjonssenteret for identitetsleverandøren, for eksempel oppretting av leiere, registrering av apper, oppretting av brukerflyter og registrering av klient-ID-er og omadressering av URIer. Plugin-modulen validerer hver verdi du limer inn igjen i samtalen, og beregner den nøyaktige omadresserings-URI-en for nettstedet, slik at verdien som limes inn i appregistreringen samsvarer med verdien som er skrevet inn i nettstedsinnstillingene.
  3. Spør hvordan brukerprofildata skal flyte fra identitetsleverandøren til den dataverse kontaktoppføringen (kravtilordning), om hver pålogging eller første pålogging skal synkroniseres, og om eksterne pålogginger skal kobles automatisk til eksisterende kontakter via e-post.
  4. Genererer godkjenningstjenesten, typedeklarasjoner, rollebaserte autorisasjonsverktøy (hasRole, RequireAuth, RequireRole), en keepalive-krok for økten som hindrer at SPA-økter utløper stille, og en påloggings-/påloggingsgrensesnittkomponent integrert med nettstedsoppsettet. Programtillegget bruker rammeverkets mønstre gjennomgående, for eksempel React hooks, Vue composables, Angular-tjenester eller Astro-komponenter.
  5. Når mer enn én leverandør er konfigurert, genererer du en /login side gjengitt i det valgte oppsettet: vannrett rad, loddrett stabel, primær spotlight eller fanebasert.
  6. Skriver de samsvarende nettstedsinnstillingene under .powerpages-site/site-settings/ for hver leverandør, registreringsmodus, kravtilordning og valgfri funksjon.

Plugin-modulen konfigurerer også følgende valgfrie funksjoner når du slår dem på:

  • Vilkår og betingelser: En /terms SPA-side brukere må godta før de fullfører påloggingen, i tillegg til samsvarende nettstedsinnstilling og innholdssnutter.
  • Brukerprofilside: En /user-profile SPA-side der påloggede brukere redigerer kontaktinformasjonen gjennom Power Pages web-API-en.
  • Forbundspålogging: Logger også av brukeren hos identitetsleverandøren når de logger seg av nettstedet, for delte enheter eller regulerte scenarier.

Tips

Hvis du vil legge til en annen identitetsleverandør på et eksisterende område, kjører du på /setup-auth nytt. Plugin-modulen oppdager hva som allerede er konfigurert, og tilbyr å legge til en ny leverandør uten å overskrive de eksisterende. Denne fremgangsmåten er nyttig for trinnvise scenarier, for eksempel å starte med Microsoft Entra ekstern ID og senere legge til Google for sosial pålogging.

Notat

Godkjenning på klientsiden (RequireAuth, RequireRole, hasRole) er bare for brukeropplevelse. Den styrer hva brukeren ser. Tabelltillatelser på serversiden, konfigurert av /integrate-webapi, håndhever reell sikkerhet.

Trinn 9: Legge til serverlogikk

Kjør /add-server-logic for å legge til sikre endepunkter på serversiden på området. Bruk Serverlogikk når nettstedet trenger logikk som ikke kan kjøres i nettleseren, for eksempel eksterne API-kall, validering på serversiden, hemmelig administrasjon eller dataoperasjoner på tvers av enheter.

Viktig!

Serverlogikkstøtte krever PAC CLI versjon 2.6.3 eller nyere. Bruk hurtiginstallasjonsskriptet til å oppdatere til den nyeste versjonen.

Beskriv hva du trenger på vanlig språk, og plugin-modulen:

  1. Gyter en Server Logic Architect-agent som analyserer brukstilfellet og klassifiserer kompleksiteten.
  2. Foreslår en endepunktutforming, sikkerhetskonfigurasjon og eventuelle nødvendige tabelltillatelser for gjennomgangen.
  3. Når du har godkjent, genererer javascript-endepunktet på serversiden på /_api/serverlogics/<name>.
  4. Oppretter en innskrevet klientsidetjeneste for å aktivere endepunktet fra komponentene.
  5. Oppdaterer komponentene for å ringe den nye tjenesten.
  6. Konfigurerer nettrolletilordninger og tabelltillatelser for endepunktet.

Du ser gjennom og godkjenner forslaget. Ingen kode genereres før du bekrefter.

Vanlige brukstilfeller:

Notat

Kjør én /add-server-logic gang per brukstilfelle. Hvis nettstedet for eksempel trenger både et endepunkt for lagervalidering og et globalt søkeendepunkt, kjører du kompetansen to ganger.

Trinn 10: Integrer skyflyt

Kjør /add-cloud-flow for å integrere eksisterende Power Automate skyflyter på nettstedet. Denne ferdigheten kobler Power Pages-nettstedet ditt til flyter du allerede har opprettet i Power Automate. Det oppretter ikke nye skyflyter.

Plugin-modulen:

  1. Registrerer den eksisterende skyflyten på nettstedet.
  2. Genererer kode på klientsiden for å utløse flyten fra sidene.
  3. Håndterer asynkron arbeidsflyt og tilstand og tilbakekallsmønstre.
  4. Tilrettelegger datautveksling mellom siden og flyten.

Bruk /add-cloud-flow for godkjenningsarbeidsflyter, e-postvarsler, planlagte jobber og hendelsesdrevet automatisering som håndteres bedre av Power Automate enn av endepunkter på serversiden.

Alternativ: Bruk /integrate-backend til å planlegge hele servicelaget

Hvis du ikke er sikker på hvilke funksjoner som trenger Web API, Server Logic eller en skyflyt, kjører /integrate-backend du i stedet for å kjøre trinn 4 til 10 manuelt. Denne ferdigheten fungerer som en orkestrator som:

  1. Analyserer prototypen for å identifisere alle funksjoner som trenger et servicelag.
  2. Klassifiserer hver funksjon i riktig fremgangsmåte: Web-API for standard CRUD, Server Logic for server-side validering og eksterne API-er, eller skyflyt for godkjenningsarbeidsflyter og automatisering.
  3. Foreslår en sekvensert utførelsesplan med alle ferdigheter, avhengigheter og konfigurasjoner.
  4. Når du har godkjent, orkestrerer du ferdighetene i riktig rekkefølge.

Planen er vedvarende, gjenopptakbar og redigerbar. Stopp etter et trinn for å se gjennom generert kode eller teste området, og fortsett der du slapp ved å kjøre /integrate-backend på nytt.

Trinn 11: Legg til SEO

Kjør /add-seo for å optimalisere området for søkemotorer. Plugin-modulen:

  1. Oppdager ruter fra rammeverkets ruterkonfigurasjon.
  2. Genererer søkemotordirektiver og et områdekart for alle oppdagede ruter.
  3. Legger til metakoder: viewport, charset, description, Open Graph, Twitter Card og favicon references.

Trinn 12: Distribuer det endelige området

Hvis du utfører valgfrie trinn, kjører /deploy-site du på nytt for å sende endringene direkte. Plugin-modulen kjører et produksjonsbygg og laster opp området sammen med alle distribusjonsartefakter (tabelltillatelser, nettstedsinnstillinger, nettroller, serverlogikkfiler) til Power Pages miljøet.

Trinn 13: Kjøre en sikkerhetsgjennomgang

Kjør /security-review for å utføre en ende-til-ende sikkerhetsgjennomgang av nettstedet før du går til produksjon. Kompetansen orkestrerer de fokuserte sikkerhetsferdighetene og konsoliderer hvert funn i én enkelt HTML-rapport på docs/security-review-<timestamp>.html.

Plugin-modulen stiller et vanlig språkspørsmål om målet ditt og velger det samsvarende settet med fokuserte ferdigheter:

Mål Hva den kontrollerer
Kode og konfigurasjon Kildekode, avhengigheter, tabelltillatelser og godkjenningskonfigurasjon. Fungerer bare på lokale filer – ingen distribusjon kreves.
Utgivelsesberedskap (anbefales ) Full gjennomgang før publisering. Kjører alle fokuserte ferdigheter: kode og avhengigheter, distribuert nettstedsskanning, nettlesersikkerhetsoverskrifter, brannmur for webprogram, tabelltillatelser og godkjenning.
Distribuert område Bare skanning av publisert utrullet nettsted. Nyttig for kontinuerlig overvåking av et publisert nettsted.

Etter at du har bekreftet, kjører plugin-modulen de samsvarende fokuserte ferdighetene parallelt og skriver sine funn til én enkelt rapport:

  • /scan-code: Kjører statisk analyse (opengrep) og avhengighetsskanning (trivy) på lokale kildefiler. Surfaces-kodemønstre, sårbare pakker, hardkodede hemmeligheter og lisensproblemer. Hvis et av verktøyene ikke er installert, tilbyr kompetansen en manuell kodegjennomgang som et tilbakefall.
  • /scan-site: Starter en sikkerhetsskanning på serversiden mot det direktesendte nettstedet og henter den nyeste rapporten. Skannevarighet avhenger av områdestørrelse – små områder avsluttes på få minutter, store områder kan ta timer. Funnene grupperes etter alvorsgrad. Krever et distribuert område.
  • /manage-headers: Inspiserer HTTP-sikkerhetshodene som er konfigurert under .powerpages-site/site-settings/: Innholdssikkerhetspolicy, X-Frame-Alternativer, CORS, Cookie SameSite og relaterte innstillinger. Identifiserer manglende eller svake verdier og foreslår anbefalte standardverdier.
  • /manage-firewall: Inspiserer brannmuren for nettprogrammet (WAF) for produksjonsområdet, inkludert status for administrert regel og egendefinerte regler (IP-blokker, landblokker, baneblokker, rentegrenser). Bare tilgjengelig på produksjonsområder i støttede områder. kompetansen oppdager og rapporterer kvalifiseringsproblemer.
  • /audit-permissions: Overvåker eksisterende tabelltillatelser mot områdekode og dataverse metadata. Surfaces mangler tillatelser, altfor tillatte roller, ubrukte tillatelser og YAML-skjemaproblemer.

Den konsoliderte rapporten grupperer funn etter inndeling, åpnes i standardnettleseren og inneholder veiledning for utbedring på vanlig språk. Fra chatten tilbyr plugin-modulen deretter å gå gjennom reparasjoner - velg et funn, og plugin-modulen aktiverer den samsvarende fokuserte ferdigheten interaktivt for å bruke endringen.

Notat

Sikkerhetsgjennomgangen bruker aldri endringer automatisk. Hver fokuserte ferdighet kjører i modus for skrivebeskyttet gjennomgang under den konsoliderte kjøringen. Hvis du vil bruke en løsning, aktiverer plugin-modulen den samsvarende kompetansen interaktivt etter at du har valgt handlingen.

Tips

Du kan også kjøre alle fokuserte ferdigheter på egen hånd:

  • Kjør /scan-code under utvikling for å fange opp problemer på kodenivå tidlig.
  • Kjør /manage-headers for å løse en bestemt feil i innholdssikkerhetspolicyen, eller konfigurer CORS.
  • Kjør /manage-firewall for å legge til en rentegrense på påloggingssiden eller blokkere trafikk etter land.
  • Kjør /audit-permissions etter at du har endret tabelltillatelser for å bekrefte at de fortsatt samsvarer med områdekoden.
  • Kjør på nytt /security-review med målet for distribuert område for å overvåke et produksjonsområde over tid.

Bekreft nettstedet

Når du har fullført ferdighetene, må du kontrollere at Power Pages-nettstedet fungerer som det skal.

  1. Gå til Power Pages.
  2. Finn området i listen over aktive områder .
  3. Forhåndsvis nettstedet på skrivebordet med Forhåndsvis-alternativet.
  4. Test funksjonaliteten.

Promoter nettstedet ditt på tvers av ulike miljøer

Når nettstedet har arbeidet i utviklingsmiljøet, kan du bruke alm-ferdighetene (application lifecycle management) til å promotere det til test- og produksjonsmiljøer. Plugin-modulen pakker nettstedet som en Power Platform-løsning, identifiserer verdier som varierer på tvers av miljøer, og distribuerer løsningen gjennom Power Platform Pipelines eller gjennom manuell eksport og import.

Hvis du vil bruke ALM-ferdighetene, trenger du også minst ett målmiljø for Power Platform (test, produksjon eller begge deler). Hvis du vil bruke den valgfrie Azure Key Vault flyt for hemmeligheter, trenger du også tillatelse til å opprette et nøkkelhvelv i Azure-abonnementet.

Planlegg utrullingen

Kjør /plan-alm for å starte. /plan-alm er inngangspunktet for ALM og orkestrerer de andre ALM-ferdighetene, slik at du vanligvis ikke kjører dem direkte. Plugin-modulen:

  1. Oppdager gjeldende status for prosjektet, løsningen og målmiljøene.
  2. Spør om kampanjestrategien (Power Platform Pipelines eller manuell eksport og import), målfasene og eventuelle begrensninger som skal brukes.
  3. Genererer en visuell plan som docs/alm-plan.html viser hver handling den har tenkt å utføre.
  4. Venter på godkjenningen kjøring av en nedstrøms ferdighet.

Planen lagres på disk, slik at hver etterfølgende ferdighet leser fra og skriver til den samme lagrede planen. Hvis en fase mislykkes, kjører /plan-alm du på nytt og fortsetter fra der den stoppet.

Redigere løsningen

Kjør /setup-solution for å pakke nettstedet som en Power Platform-løsning. Plugin-modulen:

  1. Oppretter en utgiver og løsning, og legger deretter til Power Pages komponenter: nettstedet, nettroller, serverlogikkendepunkter, skyflytregistreringer og OAuth-leverandørinnstillinger.
  2. Klassifiserer hver områdeinnstilling etter følsomhet og foreslår miljøvariabler for verdier som varierer på tvers av miljøer.
  3. Tilbyr å klargjøre en Azure Key Vault og lagre verdier for legitimasjonstype, for eksempel tilkoblingsstrenger og API-nøkler, i den.
  4. Kjører i synkroniseringsmodus når det allerede finnes en løsning for området, for å avstemme komponenter uten å opprette en ny løsning.

Du ser gjennom og godkjenner forslaget. Plugin-modulen oppretter ingen konfigurasjon før du bekrefter.

Tips

Hvis løsningen er for stor eller sammenfiltret til å distribueres på en pålitelig måte, anbefaler plugin-modulen en deling og foreslår hvor du skal dele den. Bekreft delingen før endringene gjelder.

Distribuer med Power Platform Pipelines

Hvis du valgte Power Platform Pipelines som kampanjestrategi, kjører plugin-modulen disse ferdighetene:

  1. /ensure-pipelines-host klargjør eller oppdager et vertsmiljø for Power Platform Pipelines. Kompetansen velger det rimeligste alternativet som er tilgjengelig for leieren: en gratis plattformvert, Pipelines-appen i et eksisterende miljø eller en egendefinert vert.
  2. /setup-pipeline registrerer en datasamlebånddefinisjon i Dataverse, konfigurerer fasene du valgte, og binder hvert trinn til et målmiljø.
  3. /deploy-pipeline utløser en distribusjon for en fase, bruker miljøvariabelen per fase overstyrer gjennom deploymentSettings.json, og sporer tilstand i en distribusjonsbok.

Hvis en distribusjon mislykkes fordi målmiljøet allerede er koblet til en annen vert for Power Platform Pipelines, kan plugin-modulen kjøres /force-link-environment for å tilordne den på nytt. Handlingen krever ditt eksplisitte samtykke og er reversibel.

Distribuer med manuell eksport og import

Hvis du velger den manuelle banen, kjører plugin-modulen:

  1. /export-solution for å eksportere løsningen som en administrert eller uadministrert ZIP, med en fullstendig kontroll før eksport.
  2. /import-solution for å importere ZIP på målmiljøet, enten trinnvis for å bekrefte avhengigheter først eller direkte.

Aktivere og validere det distribuerte området

Etter en vellykket distribusjon på målmiljøet, plugin-modulen:

  1. Kjører /activate-site for å klargjøre den offentlige nettadressen for målmiljøet.
  2. Kjører /test-site for å bekrefte distribusjonen. Plugin-modulen bruker en nettleser til å kravlesøke representative sider, kjøre rollebaserte tilgangskontroller, bekrefte /_api/ anrop og registrere svarfigurer fra /_api/serverlogics/ endepunkter. Ferdigheten rapporterer resultatet som PASS, WARNINGS eller FAIL, med detaljer for hver kontroll lenket fra planen.

Hvis et trinn mislykkes, kjører /diagnose-deploymentplugin-modulen . Kompetansen samsvarer med feilen mot en katalog med kjente distribusjonsfeil, for eksempel et foreldet manifest, manglende avhengigheter, vertskonflikter, blokkert JavaScript eller utløpt godkjenning, og foreslår en konkret løsning. Plugin-modulen bruker aldri en løsning uten ditt samtykke.

Notat

Alle ALM-ferdigheter leser fra og skriver til artefakter på disken: løsningsmanifestet, plandata, datasamlebånd, distribusjonshovedbok og testresultater. Orkestreringen kan gjenopptas og overvåkes. Hvis du vil se hva som skjedde på et hvilket som helst trinn, kan du undersøke artefaktene.

Tips og anbefalte fremgangsmåter

Følgende tips hjelper deg med å få mest mulig ut av plugin-modulen og ai-kodingsagenten når du bygger Power Pages-nettsteder.

Se terminalutdata for manglende verktøy ved første kjøring

Plugin-modulen gir ferdigheter og arbeidsflyter, men AI-kodingsagenten – GitHub Copilot CLI eller Claude Code – utfører de faktiske kommandoene på maskinen. Når du bruker disse verktøyene for første gang, bør du følge terminalutdataene nøye. Ai-kodeagenten kjører kommandoer og skript bak kulissene, og noen av disse kommandoene avhenger av verktøy som kanskje ikke er installert på maskinen. Hvis et trinn mislykkes, viser terminalutdataene vanligvis hvilket verktøy eller hvilken kommando det ikke finner.

Hvis du ser en feil som command not found eller is not recognized, installerer du det manglende verktøyet og utløser arbeidsflyten på nytt. Ai-kodingsagenten fortsetter der den slapp etter at verktøyet er tilgjengelig.

Se gjennom agentforslag før godkjenning

Ai-kodingsagenten presenterer forslag, for eksempel de fra Data Model Architect og Permissions Architect, før den gjør endringer. Kode og konfigurasjon generert av ai-kodingsagenten kan være unøyaktig, så se gjennom, test og valider alle forslag og all generert kode før du godkjenner eller distribuerer den.

  • Forslag til datamodell: Kontroller at tabellnavn, kolonnetyper og relasjoner samsvarer med forretningskravene dine. Det er enklere å justere et forslag enn å gi nytt navn til kolonner etter at dataene allerede er satt inn.
  • Tillatelsesforslag: Kontroller at hver rolle har riktig tilgangsnivå (opprette, lese, oppdatere, slette) for hver tabell. Altfor tillatte tabelltillatelser er en vanlig sikkerhetsrisiko.
  • Generert kode: Les gjennom den genererte koden og test området lokalt før du distribuerer. AI-generert kode kan inneholde feil eller sikkerhetsproblemer.

Lim inn feil direkte med kontekst

Når noe mislykkes, enten det er en byggfeil, en distribusjonsfeil eller et kjøretidsunntak i nettleseren, kopierer du de fullstendige feilutdataene. Lim det inn sammen med en kort beskrivelse av hva du gjorde. Jo mer kontekst du angir, jo raskere er løsningen.

Eksempel: Byggfeil

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

Inkluder filnavnet, kommandoen du kjørte, og hva du forventet å skje. Plugin-modulen bruker denne konteksten til å finne problemet og bruke en målrettet løsning i stedet for å gjette.

Dele web-API-feil med nettadressen for fullstendig forespørsel

Et vanlig problem etter distribusjon er en 403-feil fra Power Pages Web API når en kolonne ikke er aktivert for API-tilgang. Når du støter på denne feilen, limer du inn den fullstendige API-nettadressen og det fullstendige JSON-feilsvaret. Feilmeldingen forteller deg nøyaktig hvilken tabell og kolonne som må fikses, og plugin-modulen kan oppdatere tabelltillatelsen YAML og nettstedsinnstillingene for deg.

Eksempel: Kolonne ikke aktivert 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 feilen (AttributePermissionIsMissing) betyr at oppslagskolonnen _crd50_propertyid_value finnes i dataverstabellen, men er ikke oppført i konfigurasjonen for tabelltillatelse for web-API-en. Plugin-modulen løser denne feilen ved å legge til den manglende kolonnen i tabelltillatelsen YAML i .powerpages-site/table-permissions/ og distribuere på nytt.

Notat

Power Pages Web API krever at hver kolonne som returneres av et API-kall, er eksplisitt oppført i tabelltillatelsen. Oppslagsegenskaper (prefiks med _ og suffiks med _value) er enkle å gå glipp av fordi API-navnet er forskjellig fra kolonnens logiske navn i Dataverse. Når du ser AttributePermissionIsMissing, legger du alltid til denne kolonnen i tabelltillatelsen. Ikke endre API-spørringen.

Vær spesifikk om hva du vil

Vage forespørsler gir vage resultater. Fortell plugin-modulen nøyaktig hva du trenger, inkludert oppsettinnstillinger, datafelt og virkemåte.

I stedet for Prøv
«Lag en side for stillinger» "Opprett en side for stillingsoppføringer med et søkefelt øverst, filtreringsbrikker for sted og avdeling, og et kortrutenett som viser tittel, firma, lønnsområde og en postert dato for hver jobb"
Fiks stilsettet "Jobbkortene stables loddrett på skrivebordet. Få dem til å vises i et rutenett med tre kolonner med 16 pikslers mellomrom på skjermer som er bredere enn 768 piksler"
"Legg til noen data" "Legg til 20 eksempeljobbinnlegg på tvers av fire avdelinger (Teknikk, Markedsføring, Salg, HR) med realistiske titler, lønnsområder mellom $ 60k - $ 180k og postet datoer i de siste 30 dagene"
"Konfigurere API-en" "Koble JobListings-komponenten til cr_jobposting Dataverse-tabellen. Erstatt den hardkodede matrisen med et ekte API-kall som henter tittel, avdeling, lønn og postert dato"
"Legg til pålogging" «Konfigurer Microsoft Entra ekstern ID pålogging med åpen registrering, pluss Google som en annen leverandør. Vis dem som en vannrett rad på påloggingssiden.»

Bruke skjermbilder for visuelle problemer

Når nettstedet ikke ser riktig ut i nettleseren, kan du ta et skjermbilde og lime det inn direkte i samtalen eller angi en filbane. Visuell kontekst bidrar til å identifisere oppsetts-, avstands- og stilproblemer som er vanskelige å beskrive i teksten.

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.

Gjentakelse i små trinn

I stedet for å beskrive et helt nettsted i én ledetekst, bygger du trinnvis. Start med strukturen og oppsettet, og legg deretter til funksjoner én om gangen. Denne fremgangsmåten gir deg mulighet til å se gjennom og kurskorrigere i hvert trinn.

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

Etter hvert trinn kontrollerer du forhåndsvisningen av nettleseren. Hvis noe ikke er riktig, kan du fikse det før du går videre. Det er enklere å løse problemer i én komponent enn å løse problemer på tvers av et helt nettsted.

Be om en forklaring før du godkjenner

Når du er usikker på en foreslått endring, spesielt for tillatelser, datamodellendringer eller godkjenningskonfigurasjon, kan du be plugin-modulen forklare hva den planlegger å gjøre og hvorfor før du godkjenner.

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

Kjør ferdigheter uavhengig for å gjenopprette fra problemer

Hvis en ferdighet mislykkes delvis, trenger du ikke å starte på nytt. Hver ferdighet opererer uavhengig og kan gjenoppta der den avsluttet. Hvis /integrate-webapi det for eksempel mislykkes i den tredje tabellen, kan du kjøre det på nytt, og det oppdager arbeidet som allerede er fullført.

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

Relatert innhold

  • Last updated on