Začnite z vtičnikom Power Pages za GitHub Copilot CLI in Claude Code

Vtičnik Power Pages za GitHub Copilot CLI in Claude Code zagotavlja AI-podprt delovni proces za ustvarjanje, nameščanje in upravljanje sodobnih enostranskih aplikacijskih (SPA) na Power Pages. Namesto da ročno podpirate projekte, pišete standardno API kodo in konfigurirate dovoljenja, opišite, kaj želite, v naravnem jeziku, vtičnik pa upravlja implementacijo.

Vtičnik podpira celoten življenjski cikel razvoja strani skozi pogovorne veščine, od oblikovanja nove strani do njene namestitve, postavitve podatkovnih modelov Dataverse in konfiguracije avtentikacije.

Zahteve

Preden začnete, preverite, ali imate potrebno programsko opremo in dovoljenja.

Zahteve programske opreme

Prav tako potrebujete:

• Okolje Power Platform z omogočenim Power Pages.
• Avtentificirana PAC CLI seja, povezana z vašim ciljnim okoljem. Beži pac auth create , če se še nisi povezal.
• Azure CLI seja, prijavljena v istega najemnika. Zaženi az login --allow-no-subscriptions za avtentikacijo.

Preverite avtentikacijo:

Preverite, ali ste avtentikirani z ukazom pac auth list .

pac auth list           # Should show authenticated profile

Če niste avtentikirani, zaženite ta ukaz:

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

Namestite vtičnik

Namestite vtičnik Power Pages iz marketplace. Če uporabljate GitHub Copilot CLI, si oglejte dokumentacijo razširitev Copilot CLI za ustrezne korake namestitve. Naslednji ukazi uporabljajo sintakso Claudeove kode.

Hitra namestitev (priporočeno)

Zaženi namestitveni program, da nastaviš vse vtičnike z omogočenim samodejnim posodabljanjem:

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

Namestitveni program samodejno:

• Namesti CLI, pac če še ni nameščen.
• Zaznava razpoložljiva orodja, kot sta Claude Code in GitHub Copilot CLI.
• Registrira tržnico vtičnikov in namesti vse navedene vtičnike.
• Omogoči samodejno posodabljanje, da so vtičniki ažurni.

Po namestitvi ponovno zaženi Claude Code ali GitHub Copilot CLI, da dostopaš do veščin vtičnika kot poševnih ukazov v agentni seji.

Namestitev iz marketplace

1. Odpri Claudeovo kodo v svojem terminalu.

2. Dodajte Microsoft marketplace:

   /plugin marketplace add microsoft/power-platform-skills
   

3. Namestite vtičnik Power Pages:

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

Po namestitvi vtičnika ponovno zaženi Claude Code ali GitHub Copilot CLI, da dostopaš do veščin vtičnika kot ukazov za poševnico v svoji agentni seji.

Pregled veščin

Vtičnik ponuja veščine, ki pokrivajo celoten življenjski cikel Power Pages strani. Vsako veščino uporabi pogovorno, bodisi kot ukaz za rezanje ali tako, da opišeš, kaj želiš to do.

Tipičen potek dela

Pogost celoten delovni proces sledi naslednjemu zaporedju:

1. /create-site : Strani za odgradnjo, oblikovanje in izdelavo
2. /deploy-site : Naloži v svoje Power Pages okolje
3. /activate-site : Nastavite javni URL
4. /setup-datamodel : Ustvarjanje Dataverse tabel
5. /add-sample-data : Napolnite tabele s testnimi zapisi
6. /integrate-webapi : Generiranje API kode odjemalca in konfiguracija dovoljenj
7. /create-webroles : Definiraj access vloge
8. /setup-auth : Dodajte uporabniški vmesnik za prijavo, odjavo in uporabniški vmesnik, ki temelji na vlogi
9. /add-server-logic : Dodajte varne strežniške končne točke
10. /add-cloud-flow : Integracija obstoječih Power Automate tokov
11. /add-seo : Optimizacija za iskalnike
12. /deploy-site : Pošiljanje končnih sprememb v živo
13. /security-review : Pred začetkom produkcije zaženi celovit varnostni pregled
14. /plan-alm : Promovirajte svojo stran v testnih in produkcijskih okoljih

Zgradite svojo Power Pages stran

Ta vodič zajema celoten življenjski cikel gradnje Power Pages strani z vtičnikom, od podpore do namestitve. Vsak korak opisuje, kaj rečeš in kaj vtičnik naredi kot odgovor.

Korak 1: Ustvarite svojo spletno stran

Opišite spletno stran, ki jo želite, v naravnem jeziku: za kaj je namenjena, katere strani potrebuje in katere oblikovne preference so barvna shema, slog postavitve ali pisave. Zaženi /create-site ali samo opiši svojo stran in vtičnik prepozna namen.

Če ne določite ogrodja, vas vtičnik prosi, da izberete enega (React, Vue, Angular ali Astro), nato:

1. Project sestavlja iz predloge in uporabi ime vaše strani, barve ter oblikovalske žetone.
2. Namesti odvisnosti, zažene razvojni strežnik in odpre predogled brskalnika v živo.
3. Vsako stran, komponento in pot, ki ste jo zahtevali, zgradi z ustreznimi slikami.
4. Ustvari git commite ob pomembnih mejnikih, tako da imaš vgrajeno zgodovino povračila.

Korak 2: Namestite svojo stran

Zaženite /deploy-site, da naložite svojo stran na Power Pages. Vtičnik:

1. Preveri, ali je PAC CLI nameščen in da je vaša avtentikacijska seja aktivna.
2. Preden nadaljuje, potrdi ciljno okolje s tabo.
3. Zažene produkcijsko gradnjo in naloži prevedeni izhod.
4. Ustvari deployment artifacts imenik, če ta še ne obstaja.

Korak 3: Aktivirajte svojo stran

Teci, /activate-site da bo stran javno dostopna. Vtičnik:

1. Predlaga poddomeno glede na ime vaše strani in vam omogoča prilagoditev.
2. Vzpostavi zapis spletne strani preko Power Platform API-ja.
3. Anketirajte, dokler stran ni aktivna in ne vrne javnega URL-ja.

Trenutno imate delujočo stran na javnem URL-ju. Preostali koraki dodajajo podatke, avtentikacijo in SEO. Preskočite vse korake, ki ne veljajo za vašo stran.

Korak 4: Nastavite svoj podatkovni model

Teči, /setup-datamodel da ustvariš Dataverse tabele, ki jih tvoja stran potrebuje. Če že imate ER diagram ali specifično shemo, ga zagotovite neposredno, namesto da agent analizira vašo kodo.

Vtičnik ustvari agenta Data Model Architect , ki:

1. Analizira kodo vaše strani, da ugotovi, katere podatke strani in komponente potrebujejo.
2. Poizveduje vaše okolje Dataverse za obstoječe tabele, da se izognete podvajanjem.
3. Predlaga podatkovni model s tabelami, stolpci, podatkovnimi tipi in relacijami, vizualiziran kot ER diagram.

Vi pregledate in odobrite predlog. Vtičnik ne ustvari ničesar, dokler ne potrdiš. Po odobritvi vtičnik ustvari tabele in stolpce preko API klicev ter shrani manifestno datoteko, ki jo uporabljata koraka 5 in 6.

Korak 5: Dodaj vzorčne podatke (neobvezno)

Zaženi se /add-sample-data , da napolniš tabele s testnimi zapisi. Ta korak zahteva podatkovni model iz 4. koraka.

Vtičnik izvaja naslednja dejanja:

1. Prebere manifest, da razume vaše tabele, stolpce in odnose.
2. Generira kontekstualno ustrezne vrednosti za vsako vrsto stolpca, kot so realistična e-poštna sporočila, verjetni datumi in oblikovani zneski valute.
3. Vstavlja zapise po vrstnem redu odvisnosti (nadrejene tabele pred otroškimi tabelami) in samodejno osvežuje avtentikacijske žetone med množičnim vstavljanjem.

6. korak: Integracija z Dataverse Web API-jem

Zaženi /integrate-webapi se, da nadomestiš simulirane podatke z živimi poizvedbami v Dataverse. Ta korak zahteva podatkovni model iz 4. koraka.

Vtičnik izvaja naslednja dejanja:

1. Preišče vašo kodo za komponentami, ki uporabljajo lažne podatke, nadomestne klice za pridobivanje ali trdo kodirane tabele. Te komponente preslika v vaše Dataverse tabele.
2. Za vsako tabelo ustvari agent za integracijo spletnega API-ja , ki generira:
   • Deljeni API odjemalec z upravljanjem žetonov proti ponarejanju in logiko ponovnega poskusa.
   • TypeScript entitetni tipi in domenski mapperji.
   • CRUD storitveni sloj.
   • Vzorci, specifični za ogrodje, kot so React kljuke, Vue kompozitorji ali Angular storitve.
3. Ustvari agenta Permissions Architect , ki predlaga dovoljenja za tabele in nastavitve strani.

Pregledate in odobrite predlog dovoljenj. Vtičnik ne ustvari nobenih konfiguracijskih datotek, dokler ne potrdiš.

Dodajte povzetke, ki jih generira umetna inteligenca (neobvezno)

Uporabite /add-ai-webapi povzetke generativne umetne inteligence nad vašo integracijo spletnega API-ja. Ta veščina povezuje dva API-ja za predogledno povzemanje z vašimi stranmi za podrobnosti zapisov in seznam:

• API za povzetek iskanja: Vrne AI-skrajšani povzetek rezultatov iskanja s citati.
• API za povzemanje podatkov: Vrne povzetek na zapis ali vpoglede na ravni seznama za tabelo Dataverse.

Ta korak temelji na podatkovnem modelu iz 4. koraka in integraciji spletnega API-ja iz 6. koraka. Vtičnik izvaja naslednja dejanja:

1. Pregleda vašo kodo za povzetke integracijskih točk in potrdi ciljne strani, tabele ter katere API-je uporabiti.
2. Delegira vse manjkajoče pogoje spletnega API-ja — dovoljenja za tabele, sezname stolpcov in spletne vloge — na /integrate-webapi in /create-webroles, tako da obstaja en vir resnice za dovoljenja.
3. Ustvari AI agent za integracijo spletnega API-ja , ki generira tipkano storitev povzetkov (aiSummaryService.ts) z obravnavo žetonov proti ponarejevanju, ogrodje-specifičnimi ovitki (React hooks, Vue kompozitorji ali Angular storitve) in povezavami za žične klice na ciljnih straneh.
4. Ustvari AI Web API Settings Architect agenta, ki ustvari Summarization nastavitve strani za pozive in omejitve vsebine.

Pregledate in odobrite predloge. Vtičnik ne generira kode ali ustvarja nastavitev, dokler ne potrdiš.

Korak 7: Ustvarite spletne vloge

Zaženi /create-webroles za definiranje uporabniških access vlog. Vtičnik:

1. Preveri vaše okolje za obstoječe spletne vloge, da se izognete podvajanjem.
2. Generira definicije vlog z edinstvenimi identifikatorji.
3. Zagotavlja, da ima vsaka stran največ eno anonimno vlogo in eno avtentičeno vlogo.

Korak 8: Nastavite avtentikacijo

Uporabite za /setup-auth dodajanje prijave, odjave in nadzora dostopa na podlagi vlog na vaši strani. Vtičnik podpira naslednje ponudnike identitet, hkrati pa lahko konfigurirate enega ali več ponudnikov.

Za več informacij o podprtih ponudnikih, vključno s protokoli in konfiguracijskimi vidiki, glejte Pregled avtentikacije v Power Pages.

Vtičnik:

1. Analizira vašo spletno stran (namen, strani, občinstvo) in predlaga smiselno privzeto rešitev. Na primer, vtičnik predlaga Zunanja identiteta Microsoft Entra z odprto registracijo za spletno stran, usmerjeno v stik s strankami, ali Microsoft Entra ID z registracijo samo na povabilo za notranji portal. Sprejmete priporočilo ali pa izberete svoje storitve.
2. Za vsakega ponudnika vas vodi skozi vse potrebne korake v administrativnem centru ponudnika identitete, kot so ustvarjanje najemnikov, registracija aplikacij, ustvarjanje uporabniških tokov ter zajem ID-jev odjemalcev in preusmeritev URI-jev. Vtičnik potrdi vsako vrednost, ki jo prilepite nazaj v pogovor, in izračuna natančen URI preusmeritve za vašo stran, tako da vrednost, prilepljena v registracijo aplikacije, ustreza vrednosti, zapisani v nastavitvah strani.
3. Sprašuje, kako naj podatki uporabniškega profila tečejo iz ponudnika identitete v zapis stikov Dataverse (preslikava zahtevkov), ali naj se sinhronizirajo ob vsaki prijavi ali samo ob prvi prijavi in ali naj se zunanje prijave samodejno povežejo z obstoječimi stiki po elektronski pošti.
4. Generira storitev avtentikacije, deklaracije tipov, orodja za avtorizacijo na osnovi vlog (hasRole, RequireAuth, ), RequireRolehook za ohranjanje seje, ki preprečuje, da bi SPA seje tiho potekle, ter komponento uporabniškega vmesnika za prijavo/odjavo, integrirano z vašo postavitvijo strani. Vtičnik uporablja vzorce vašega ogrodja, kot so React hooks, Vue kompozitorni elementi, Angular storitve ali Astro komponente.
5. Ko je konfiguriranih več ponudnikov, se ustvari stran, upodobljena /login v izbrani postavitvi: vodoravna vrstica, vertikalni sklad, primarni poudarek ali zavihek.
6. Zapiše ustrezne nastavitve strani za .powerpages-site/site-settings/ vsakega ponudnika, način registracije, kartiranje zahtevkov in opcijsko funkcijo.

Vtičnik ob vklopu konfigurira tudi naslednje dodatne funkcije:

• Pogoji uporabe: SPA /terms stran, ki jo morajo uporabniki sprejeti pred dokončanjem prijave, poleg tega pa tudi ustrezna nastavitev strani in vsebinski izseki.
• Uporabniška profilna stran: SPA stran /user-profile, kjer prijavljeni uporabniki urejajo svoje kontaktne podatke prek Power Pages spletnega API-ja.
• Federativna odjava: Prav tako odjavi uporabnika pri ponudniku identitete, ko se odjavi s strani, za primere skupne naprave ali regulirane primere.

Korak 9: Dodajte strežniško logiko

Uporabite /add-server-logic za dodajanje varnih strežniških končnih točk na vašo stran. Uporabite strežniško logiko, kadar vaša stran potrebuje logiko, ki ne more delovati v brskalniku, kot so zunanji API klici, strežniška validacija, upravljanje skrivnosti ali medentitetne podatkovne operacije.

Opišite, kaj potrebujete, v preprostem jeziku in vtičnik:

1. Ustvari agenta Server Logic Architect , ki analizira vaš primer uporabe in razvrsti njegovo kompleksnost.
2. Predlaga zasnovo končne točke, varnostno konfiguracijo in vse potrebne dovoljenja za tabelo za vaš pregled.
3. Po odobritvi generira strežniški JavaScript endpoint na /_api/serverlogics/<name>.
4. Ustvari tipizirano storitev na strani odjemalca, ki kliče končno točko iz vaših komponent.
5. Posodobi vaše komponente, da pokličejo novo storitev.
6. Konfigurira dodelitve spletnih vlog in dovoljenja za tabele za končno točko.

Vi pregledate in odobrite predlog. Nobena koda se ne generira, dokler ne potrdiš.

Pogosti primeri uporabe:

• Povežite se z zunanjimi storitvami. Pokliči REST API-je, Azure Functions ali storitve tretjih oseb brez razkritja poverilnic. (Vodič: interakcija z zunanjimi storitvami)
• Izvajanje varnih podatkovnih operacij. Poizvedujte, posodabljajte ali brišite zapise v Dataverse z dosledno strežniško validacijo. (Vodič: interakcija z Dataverse tabelami)
• Zaženi prilagojeno logiko. Združujte podatke med tabelami, uveljavljajte poslovna pravila ali izračunavajte izpeljane vrednosti, preden rezultate vrnete stranki.
• Upravljanje skrivnosti na strežniški strani. Poverilnice in API ključe shranjujte na strežniku, nikoli v kodi odjemalca. (Tutorial: interakcija z Microsoft Graph in SharePoint)

Korak 10: Integrirajte tokove v oblaku

Zaženite /add-cloud-flow za integracijo obstoječih Power Automate oblačnih tokov v vašo spletno stran. Ta veščina poveže vašo Power Pages stran s tokovi, ki ste jih že ustvarili v Power Automate. Ne ustvarja novih oblačnih tokov.

Vtičnik:

1. Zabeleži obstoječi tok oblaka na vaši strani.
2. Generira kodo na strani odjemalca, ki sproži tok iz vaših strani.
3. Obvladuje asinhrono stanje delovnega toka in vzorce povratnih klicev.
4. Povezuje izmenjavo podatkov med stranjo in tokom.

Uporabite /add-cloud-flow za delovne tokove odobritve, e-poštna obvestila, načrtovana opravila in avtomatizacijo, ki jo upravlja Power Automate bolje kot strežniški končni sistemi.

Alternativa: Uporabite /integrate-backend za načrtovanje celotne storitvene plasti

Če niste prepričani, katere funkcije potrebujejo spletni API, strežniško logiko ali cloud flow, zaženite /integrate-backend namesto ročnega izvajanja korakov 4 do 10. Ta veščina deluje kot orkestrator, ki:

1. Analizira vaš prototip, da identificira vse funkcije, ki potrebujejo servisno plast.
2. Vsako funkcijo razvrsti v pravi pristop: spletni API za standardni CRUD, strežniška logika za strežniško validacijo in zunanje API-je ali cloud flow za odobritvene delovne procese in avtomatizacijo.
3. Predlaga zaporedni načrt izvajanja z vsemi veščinami, odvisnostmi in konfiguracijami.
4. Ko odobriš, orkestriraj veščine v pravilnem vrstnem redu.

Načrt je vztrajen, obnovljiv in urejaven. Po vsakem koraku se ustavite za pregled generirane kode ali testiranje strani in nadaljujte tam, kjer ste končali, tako da ponovno zaženete /integrate-backend .

Korak 11: Dodaj SEO

Uporabite /add-seo optimizacijo svoje strani za iskalnike. Vtičnik:

1. Odkrije poti iz konfiguracije usmerjevalnika vašega sistema.
2. Generira direktive iskalnikov in zemljevid strani za vse odkrite poti.
3. Dodaja meta oznake: viewport, charset, opis, Open Graph, Twitter Card in reference na favicon.

Korak 12: Namestite končno lokacijo

Če izvedete kakšen neobvezen korak, ga ponovno zaženete /deploy-site , da prenesete spremembe v živo. Vtičnik zažene produkcijsko različico in naloži stran skupaj z vsemi artefakti namestitve (dovoljenja za tabele, nastavitve strani, spletne vloge, logične datoteke strežnika) v vaše Power Pages okolje.

Korak 13: Izvedite varnostni pregled

Pred /security-review začetkom produkcije opravite celovit varnostni pregled svoje strani. Veščina orkestrira osredotočene varnostne veščine in združuje vsako ugotovitev v eno samo HTML poročilo na .docs/security-review-<timestamp>.html

Vtičnik postavi eno preprosto vprašanje o vašem cilju in izbere usklajen nabor usmerjenih veščin:

Ko potrdite, vtičnik vzporedno izvede ujemajoče se veščine in njihove ugotovitve zapiše v eno poročilo:

• /scan-code: Izvaja statično analizo (opengrep) in skeniranje odvisnosti (trivy) na lokalnih izvornih datotekah. Surface vzorce kode, ranljive pakete, trdo kodirane skrivnosti in licenčne težave. Če nobeno orodje ni nameščeno, veščina ponuja ročni pregled kode kot rezervno možnost.
• /scan-site: Začne varnostni pregled na strežniški strani proti živi strani in pridobi najnovejše poročilo. Trajanje skeniranja je odvisno od velikosti lokacije – manjše lokacije končajo v nekaj minutah, velike pa lahko vzamejo ure. Ugotovitve so razvrščene po resnosti. Zahteva nameščeno lokacijo.
• /manage-headers: Pregleduje HTTP varnostne glave, konfigurirane pod .powerpages-site/site-settings/: Politika varnosti vsebine, X-Frame-Options, CORS, piškotki SameSite in sorodne nastavitve. Prepozna manjkajoče ali šibke vrednosti in predlaga priporočene privzete vrednosti.
• /manage-firewall: Pregleduje požarni zid spletnih aplikacij (WAF) za produkcijsko lokacijo, vključno s stanjem upravljanih pravil in prilagojenimi pravili (IP bloki, državni bloki, bloki poti, omejitve hitrosti). Na voljo le na proizvodnih lokacijah v podprtih regijah; Veščina zazna in poroča o težavah z upravičenostjo.
• /audit-permissions: Pregleduje obstoječe dovoljenja za tabele glede na kodo strani in metapodatke Dataverse. Razkrije manjkajoča dovoljenja, preveč permisivne vloge, neuporabljena dovoljenja in težave z YAML shemo.

Konsolidirano poročilo združuje ugotovitve po razdelkih, se odpre v vašem privzetem brskalniku in vključuje smernice za odpravo v preprostem jeziku. Iz klepeta vtičnik nato ponudi pregled popravkov – izberi ugotovitev in vtičnik interaktivno uporabi veščino, osredotočeno na ujemanje, da uvede spremembo.

Preverite svojo spletno stran

Ko opravite veščine, preverite, ali vaša Power Pages stran deluje pravilno.

1. Pojdi na Power Pages.
2. Poiščite svojo stran na seznamu aktivnih strani .
3. Predogled vaše strani na namizju lahko uporabite z možnostjo Predogled .
4. Preizkusite funkcionalnost.

Promovirajte svojo stran v različnih okoljih

Ko vaša lokacija deluje v razvojnem okolju, uporabite veščine upravljanja življenjskega cikla aplikacije (ALM), da jo promovirate v testna in produkcijska okolja. Vtičnik zapakira vašo stran kot rešitev Power Platforme, prepozna vrednosti, ki se razlikujejo med okoljem, in rešitev uvaja preko Power Platform Pipelines ali ročnega izvoza in uvoza.

Za uporabo ALM veščin potrebujete tudi vsaj eno ciljno okolje Power Platform (testno, produkcijsko ali oboje). Za uporabo opcijskega poteka Azure Key Vault za skrivnosti potrebujete tudi dovoljenje za ustvarjanje key vaulta v svoji naročnini na Azure.

Načrtujte razporeditev

Teci /plan-alm za začetek. /plan-alm je vstopna točka za ALM in orkestrira druge ALM veščine, zato jih običajno ne uporabljaš neposredno. Vtičnik:

1. Zaznava trenutno stanje vašega projekta, rešitve in ciljnih okolij.
2. Sprašuje o vaši strategiji napredovanja (Power Platform Pipelines ali ročni izvoz in uvoz), ciljnih fazah in morebitnih omejitvah, ki jih je treba uporabiti.
3. Ustvari vizualni načrt, docs/alm-plan.html ki prikazuje vsako dejanje, ki ga namerava izvesti.
4. Počaka na tvoje odobritev, preden uporabi katerokoli nadaljno veščino.

Načrt ostane na disku, tako da vsaka nadaljnja veščina bere in piše v isti trajni načrt. Če faza odpove, zaženi /plan-alm znova in se nadaljuje tam, kjer se je ustavila.

Napiši rešitev

Teči, da svojo stran zapakiraš /setup-solution kot rešitev Power Platforme. Vtičnik:

1. Ustvari založnika in rešitev, nato doda vaše Power Pages komponente: spletno stran, spletne vloge, logične končne točke strežnika, registracije v oblaku in nastavitve ponudnika OAuth.
2. Vsako nastavitev lokacije razvrsti glede na občutljivost in predlaga okoljske spremenljivke za vrednosti, ki se razlikujejo med okoljem.
3. Ponuja možnost vzpostavitve Azure Key Vault in shranjevanje vrednosti poverilnih podatkov, kot so povezovalni nizi in API ključi.
4. Deluje v sinhroniziranem načinu, ko rešitev že obstaja za vašo lokacijo, da uskladi komponente brez ustvarjanja nove rešitve.

Vi pregledate in odobrite predlog. Vtičnik ne ustvari nobene konfiguracije, dokler ne potrdiš.

Uvedba z Power Platform Pipelines

Če ste kot svojo promocijsko strategijo izbrali Power Platform Pipelines, vtičnik izvaja naslednje veščine:

1. /ensure-pipelines-host zagotavlja ali zaznava gostiteljsko okolje za Power Platform Pipelines. Veščina izbere najcenejšo možnost, ki je na voljo za vašega najemnika: brezplačni platformni gostitelj, aplikacijo Pipelines v obstoječem okolju ali prilagojen gostitelj.
2. /setup-pipeline zabeleži definicijo cevovoda v Dataverse, konfigurira izbrane stopnje in vsako fazo poveže s ciljnim okoljem.
3. /deploy-pipeline sproži namestitev za fazo, uporabi okoljske spremenljivke deploymentSettings.jsonza vsako stopnjo preko , in spremlja stanje v knjigi nameščanja.

Če namestitev ne uspe, ker je ciljno okolje že povezano z drugim gostiteljem Power Platform Pipelines, lahko vtičnik zažene /force-link-environment in ga ponovno dodeli. Za to dejanje je potrebna vaša izrecna privolitev in je povratno.

Namestitev z ročnim izvozom in uvozom

Če izberete ročno pot, vtičnik deluje:

1. /export-solution za izvoz rešitve kot upravljanega ali neupravljanega ZIP-a, s preverjanjem popolnosti pred izvozom.
2. /import-solution za uvoz ZIP-a v ciljno okolje, bodisi najprej za preverjanje odvisnosti ali neposredno.

Aktivirajte in preverite nameščeno lokacijo

Po uspešni namestitvi v ciljnem okolju vtičnik:

1. Izvaja se /activate-site za zagotavljanje javnega URL-ja v ciljnem okolju.
2. Izvaja za /test-site preverjanje namestitve. Vtičnik uporablja brskalnik za pregledovanje reprezentativnih strani, izvajanje preverjanj dostopa na podlagi vlog, preverjanje /_api/ klicev in zajem oblik odzivov s /_api/serverlogics/ končnih točk. Veščina rezultate poroča kot PASS, WARNINGS, ali FAIL, s podatki o posameznem čeku, povezanimi iz načrta.

Če korak ne uspe, vtičnik zažene /diagnose-deployment. Veščina primerja neuspeh s katalogom znanih napak pri namestitvi, kot so zastarel manifest, manjkajoče odvisnosti, konflikti gostiteljev, blokiran JavaScript ali potekla avtentikacija, in predlaga konkretno rešitev. Vtičnik nikoli ne uporabi popravka brez vašega soglasja.

Nasveti in najboljše prakse

Naslednji nasveti vam pomagajo, da kar najbolje izkoristite vtičnik in AI programerski agent pri gradnji Power Pages strani.

Pri prvem zagonu spremljajte izhod terminala za manjkajoča orodja

Vtičnik zagotavlja veščine in delovne procese, medtem ko AI agent za kodiranje – GitHub Copilot CLI ali Claude Code – izvaja dejanske ukaze na vašem računalniku. Ko prvič uporabljate ta orodja, pozorno spremljajte izhod terminala. AI programerski agent izvaja ukaze in skripte v ozadju, nekateri od teh ukazov pa so odvisni od orodij, ki morda niso nameščena na vašem računalniku. Če korak ne uspe, izhod terminala običajno pokaže, katerega orodja ali ukaza ni našel.

Če vidiš napako, kot command not found je ali is not recognized, namesti manjkajoče orodje in ponovno zaženi potek dela. AI programer nadaljuje tam, kjer je končal, ko je orodje na voljo.

Pred odobritvijo pregledajte predloge agentov

Agent za kodiranje umetne inteligence predstavi predloge, kot so tisti od Arhitekta podatkovnih modelov in Arhitekta dovoljenj, preden naredi spremembe. Koda in konfiguracija, ki jo generira AI programerski agent, sta lahko netočni, zato pregledajte, testirajte in validirajte vsak predlog in vso generirano kodo, preden jo odobrite ali namestite.

• Predlogi podatkovnih modelov: Preverite, ali imena tabel, vrste stolpcev in odnosi ustrezajo vašim poslovnim zahtevam. Lažje je prilagoditi predlog kot preimenovati stolpce, potem ko so podatki že vstavljeni.
• Permissions proposals: Preverite, ali ima vsaka vloga pravilno raven access (ustvarjanje, branje, posodabljanje, brisanje) za vsako tabelo. Preveč popustljiva dovoljenja za tabele so pogosta varnostna tveganja.
• Generirana koda: Preberite generirano kodo in lokalno testirajte spletno stran pred namestitvijo. Koda, ki jo generira umetna inteligenca, lahko vsebuje napake ali varnostne težave.

Prilepite napake neposredno v kontekst

Ko kaj odpove, naj bo to napaka pri sestavi, neuspeh pri namenu ali izjema med izvajanjem v brskalniku, kopirajte celoten izhod napake. Prilepi ga skupaj s kratkim opisom, kaj si počel. Več konteksta kot poveš, hitrejša je rešitev.

Primer: Napaka gradnje

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>
                                 

Deli napake spletnega API-ja s polnim URL-jem zahteve

Pogosta težava po namestitvi je napaka 403 iz Power Pages Web API-ja, kadar stolpec ni omogočen za dostop do API-ja. Ko naletite na to napako, prilepite celoten URL API-ja in celoten JSON odziv na napake. Sporočilo o napaki vam natančno pove, katero tabelo in stolpec je treba popraviti, vtičnik pa lahko za vas posodobi dovoljenje za YAML in nastavitve strani.

Primer: Stolpec ni omogočen za spletni 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"
    }
  }
}

Ta napaka (AttributePermissionIsMissing) pomeni, da stolpec _crd50_propertyid_value za iskanje obstaja v tabeli Dataverse, vendar ni naveden v konfiguraciji dovoljenj tabele za spletni API. Vtičnik to napako odpravi tako, da manjkajoči stolpec doda v YAML dovoljenje tabele in .powerpages-site/table-permissions/ ga ponovno namesti.

Bodi natančen glede tega, kaj želiš

Nejasne zahteve prinašajo nejasne rezultate. Vtičniku natančno povejte, kaj potrebujete, vključno z nastavitvami postavitve, podatkovnimi polji in vedenjem.

Uporabite posnetke zaslona za vizualne težave

Ko stran v brskalniku ne izgleda pravilno, naredite posnetek zaslona in ga prilepite neposredno v pogovor ali vnesite pot do datoteke. Vizualni kontekst pomaga prepoznati težave s postavitvijo, razmikom in stiliziranjem, ki jih je težko opisati v besedilu.

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.

Iteracija v majhnih korakih

Namesto da opisujete celotno stran v enem izzivu, gradite postopoma. Začnite s strukturo in postavitvijo, nato dodajte značilnosti eno za drugo. Ta pristop vam omogoča, da na vsakem koraku ponovno pregledate in popravite smer.

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

Pred odobritvijo zahtevajte pojasnilo

Če niste prepričani glede predlagane spremembe, zlasti glede dovoljenj, sprememb podatkovnega modela ali nastavitve avtentikacije, vtičnik prosite, naj pojasni, kaj namerava to do in zakaj, preden odobri.

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

Samostojno izvajanje veščin za okrevanje po težavah

Če veščina odpove na pol poti, ni treba začeti znova. Vsaka veščina deluje neodvisno in lahko nadaljuje tam, kjer je končala. Na primer, če /integrate-webapi ne uspe na tretji tabeli, jo lahko ponovno zaženete in zazna že opravljeno delo.

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

Sorodna vsebina

• Ustvarite in namestite enostransko aplikacijo v Power Pages
• Konfiguriraj avtentikacijo za Power Pages spletno stran
• Pregled strežniške logike
• Power Pages Web API reference
• Pregled API-ja za povzetek podatkov
• Power Pages iskanje z generativno AI
• PAC CLI strani ukazov
• GitHub Copilot CLI
• Claudeova koda