Započnite s Power Pages dodatkom za GitHub Copilot CLI i Claude Code

Power Pages dodatak za GitHub Copilot CLI i Claude Code pruža AI-asistirani tijek rada za kreiranje, implementaciju i upravljanje modernim single-page aplikacijama (SPA) na Power Pages. Umjesto da ručno pokrećete projekte, pišete standardni API kod i konfigurirate dozvole, opišite što želite na prirodnom jeziku, a plugin upravlja implementacijom.

Dodatak podržava cijeli životni ciklus razvoja stranice kroz komunikacijske vještine, od izgradnje nove stranice do implementacije, postavljanja Dataverse modela podataka i konfiguracije autentifikacije.

Važno

• Generativni AI agent za kodiranje, poput GitHub Copilot CLI-ja ili Claude Codea, koristi vještine i radne tokove ovog dodatka za izvršavanje zadataka specifičnih za Power Pages.
• Kod i konfiguracija koje generira AI agent mogu biti netočni. Pregledajte, testirajte i validirajte sav generirani sadržaj prije nego što ga odobrite ili implementirate. Uvijek pregledajte prijedloge agenata prije nego što ih odobrite .

Preduvjeti

Prije nego što počnete, provjerite imate li potreban softver i dozvole.

Softverski preduvjeti

Komponenta	Minimalna verzija	Dodatne informacije
Node.js	18.0 ili kasnije	Preuzmite Node.js
Power Platform CLI (PAC CLI)	2.6.3 ili novije (obavezno za logiku poslužitelja)	Instalirajte PAC CLI
Azure CLI	Najnovije	Instaliraj Azure CLI
GitHub Copilot CLI ili Claude Code	Najnovije	GitHub Copilot CLI ili Claude kod
Visual Studio Code i Power Platform Tools ekstenzije (opcionalno)	Najnovije	Preuzmite VS Code i instalirajte Power Platform Tools

Također vam treba:

• Power Platform okruženje s uključenim Power Pages-om.
• Autentificirana PAC CLI sesija povezana s vašim ciljnim okruženjem. Bježite pac auth create ako se još niste povezali.
• Azure CLI sesija prijavljena na istog tenanta. Pokreni az login --allow-no-subscriptions za autentifikaciju.

Provjerite autentifikaciju:

Provjerite da ste autentificirani pomoću naredbe pac auth list .

pac auth list           # Should show authenticated profile

Ako niste autentificirani, pokrenite ovu naredbu:

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

Savjet

Da biste dobili URL instance, idite na Power Pages početnu stranicu, odaberite ikonu Settings u gornjem desnom kutu, a zatim odaberite Session details.

Instalirajte dodatak

Instaliraj Power Pages dodatak s marketplacea. Ako koristite GitHub Copilot CLI, pogledajte dokumentaciju Copilot CLI ekstenzija za ekvivalentne korake instalacije. Sljedeće naredbe koriste sintaksu Claudeovog koda.

Brza instalacija (preporučeno)

Pokreni instalacijski program za postavljanje svih dodataka s uključenim automatskim ažuriranjem:

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

Instalacijski program automatski:

• Instalira pac CLI ako već nije instaliran.
• Otkriva dostupne alate, poput Claude Code i GitHub Copilot CLI.
• Registrira se na marketplaceu dodataka i instalira sve navedene dodatke.
• Omogućuje automatsko ažuriranje kako bi dodaci ostali ažurni.

Nakon instalacije, ponovno pokrenite Claude Code ili GitHub Copilot CLI kako biste pristupili vještinama dodatka kao slash naredbama u svojoj agentnoj sesiji.

Instalacija s marketplacea

1. Otvorite Claude kod u svom terminalu.

2. Dodajte Microsoft marketplace:

   /plugin marketplace add microsoft/power-platform-skills
   

3. Instalirajte Power Pages dodatak:

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

Nakon instalacije plugina, ponovno pokrenite Claude Code ili GitHub Copilot CLI kako biste pristupili vještinama plugina kao slash naredbama u svojoj agentnoj sesiji.

Savjet

Za automatsko primanje ažuriranja tržišta i vještina, uključite automatsko ažuriranje. Upotrijebi naredbu /plugin , idi na Marketplaces, odaberi marketplace i uključi automatsko ažuriranje.

Pregled vještina

Dodatak pruža vještine koje pokrivaju cijeli životni ciklus Power Pages stranice. Svaku vještinu prizivaj razgovorno, bilo kao naredbu za rezanje ili opisom što želiš to do.

Vještina	Command	Čime se bavi
Stvori web mjesto	/create-site	Temelji stranicu, primjenjuje vaš dizajnerski smjer i gradi stranice i komponente
Lokacija za raspoređivanje	/deploy-site	Gradi projekt i učitava ga u Power Pages koristeći PAC CLI
Aktiviraj stranicu	/activate-site	Pruža zapis web stranice i dodjeljuje javni URL
Postavljanje modela podataka	/setup-datamodel	Kreira Dataverse tablice, stupce i odnose
Dodajte uzorke podataka (opcionalno)	/add-sample-data	Popunjava Dataverse tablice realističnim testnim zapisima
Integracija web API-ja	/integrate-webapi	Generira tipizirani API klijentski kod, usluge i dozvole tablica
Dodajte sažetke umjetne inteligencije	/add-ai-webapi	Integrira generativne AI API-je za sažimanje (sažetak pretraživanja i sažetak podataka) u vaše stranice. Generira tipiziranu uslugu sažetka s rukovanjem tokenima protiv krivotvorenja, okvirnim omotima, žičanim pozivnim stranicama i odgovarajućim postavkama Summarization stranice
Postavljanje provjere autentičnosti	/setup-auth	Dodaje se kontrola pristupa za prijavu, odjavu i kontrola pristupa temeljena na ulogama. Podržava Microsoft Entra ID, Microsoft Entra External ID, OpenID Connect, SAML 2.0, WS-Federation, Microsoftov račun, Facebook, Google te lokalnu autentifikaciju korisničkih imena i lozinki, uključujući konfiguracije s više pružatelja usluga
Kreirajte web uloge	/create-webroles	Generira web role YAML datoteke za upravljanje korisničkim access-om
Dodajte logiku poslužitelja	/add-server-logic	Generira sigurne JavaScript krajnje točke na strani poslužitelja za validaciju, vanjske API pozive, upravljanje tajnama i operacije s podacima
Dodaj cloud flow	/add-cloud-flow	Integrira postojeće Power Automate cloud tokove u vašu stranicu za odobrenje radnih tokova, obavijesti i planiranu automatizaciju
Integracija backenda	/integrate-backend	Analizira vaš prototip, određuje pravi pristup (Web API, Server Logic ili cloud flow) za svaku značajku i orkestrira cijeli slijed izgradnje
Dodaj SEO	/add-seo	Generira robots.txt, sitemap.xmli meta oznake
Pokreni sigurnosni pregled	/security-review	Orkestrira usmjerene sigurnosne vještine i konsolidira svaki nalaz u jedan HTML izvještaj. Obuhvaća kod, ovisnosti, skeniranje deployed-site, zaglavlja preglednika, firewall web aplikacija, dozvole tablica i konfiguraciju autentifikacije
Skeniraj izvorni kod	/scan-code	Izvršava statičku analizu i skeniranje ovisnosti na lokalnim izvornim datotekama; Otkriva nalaze koji pokrivaju obrasce koda, ranjive pakete, hardkodirane tajne i probleme s licencama
Skeniraj postavljenu lokaciju	/scan-site	Pokreće sigurnosni pregled na serverskoj strani protiv aktivne stranice, dohvaća najnovije izvješće i grupira nalaze prema ozbiljnosti
Upravljanje sigurnosnim zaglavljima preglednika	/manage-headers	Pregledava i konfigurira HTTP sigurnosne zaglavlja koja stranica šalje preglednicima — Politika sigurnosti sadržaja, zaštita od okvira i clickjackinga, dijeljenje između izvora, ponašanje kolačića i povezane postavke stranice
Upravljanje firewallom web aplikacija	/manage-firewall	Inspektira i konfigurira firewall web aplikacija (WAF) na produkcijskoj lokaciji: omogućuje zaštitu, dodaje ili uklanja IP blokade, blokade zemalja, blokade putanja i ograničenja brzine
Dozvole za revizijske tablice	/audit-permissions	Revizija postojećih dozvola tablica prema kodu stranice i Dataverse metapodacima; izrađuje HTML izvještaj grupiran prema težini s predloženim ispravcima
Planirano raspoređivanje	/plan-alm	Otkriva stanje projekta, prikuplja vašu strategiju promocije, izrađuje vizualni plan i orkestrira ostale vještine upravljanja životnim ciklusom aplikacije (ALM) u pravom redoslijedu
Rješenje autora	/setup-solution	Stvara izdavača i rješenje, dodaje Power Pages komponente, klasificira postavke stranice i predlaže varijable okruženja i Azure Key Vault tajne
Postavljanje pipeline hosta	/ensure-pipelines-host	Osigurava ili otkriva domaćinsko okruženje za Power Platform cjevovode
Postavljanje cjevovoda	/setup-pipeline	Registrira definiciju cjevovoda u Dataverseu i povezuje faze promocije s ciljnim okruženjima
Implementacija putem cjevovoda	/deploy-pipeline	Pokreće implementaciju cjevovoda za ciljanu fazu s nadjačavanjem varijabli okoline po fazi
Okruženje s vezom sila	/force-link-environment	Preusmjerava ciljno okruženje na novi Power Platform Pipelines host kada host blokira implementaciju
Izvoz rješenja	/export-solution	Izvozi rješenje kao upravljani ili neupravljani zip, s provjerom potpunosti prije izvoza
Uvoz rješenja	/import-solution	Uvozi rješenje zip u ciljno okruženje, fazirano ili izravno
Testno mjesto	/test-site	Provjerava implementiranu stranicu testom temeljenim na pregledniku: pretraživanje stranica, provjere pristupa temeljene na ulogama i verifikacija web API-ja
Dijagnostičko postavljanje	/diagnose-deployment	Uspoređuje neuspjehe implementacije s katalogom poznatih pogrešaka i predlaže rješenje

Tipičan tijek rada

Uobičajeni end-to-end tijek rada slijedi ovaj slijed:

1. /create-site : Scaffold, Design i build stranice
2. /deploy-site : Učitavanje u vaše Power Pages okruženje
3. /activate-site : Postavite javni URL
4. /setup-datamodel : Kreiraj Dataverse tablice
5. /add-sample-data : Popuni tablice testnim zapisima
6. /integrate-webapi : Generiranje API klijentskog koda i konfiguracija dozvola
7. /create-webroles : Definirajte access uloge
8. /setup-auth : Dodajte korisničko sučelje za prijavu, odjavu i uloge
9. /add-server-logic : Dodaj sigurne serverske krajnje točke
10. /add-cloud-flow : Integracija postojećih Power Automate tokova
11. /add-seo : Optimizacija za tražilice
12. /deploy-site : Pošaljite završne promjene uživo
13. /security-review : Pokrenite cjeloviti sigurnosni pregled prije ulaska u produkciju
14. /plan-alm : Promovirajte svoju stranicu u testnim i produkcijskim okruženjima

Savjet

• Ne morate slijediti ovaj točan redoslijed. Svaka vještina provjerava svoje preduvjete i govori ti ako nešto nedostaje. Na primjer, možete pokrenuti /setup-auth prije /integrate-webapi ako vaša stranica prvo zahtijeva autentifikaciju.
• Ako niste sigurni koji pristup koristiti za svaku značajku, pokrenite /integrate-backend umjesto koraka 4 do 10 pojedinačno. Analizira vaš prototip, utvrđuje treba li svaka značajka Web API, Server Logic ili cloud flow, te orkestrira vještine u ispravnom redoslijedu.
• Za dodavanje AI-generiranih sažetaka pretraživanja i zapisa, pokrenite /add-ai-webapi nakon /integrate-webapi. Ponovno koristi dozvole za tablice i postavke stranice koje ih konfiguriraju /integrate-webapi , pa ga pokrenite tek kad je integracija Web API-ja na mjestu.

Izgradite svoju Power Pages stranicu

Ovaj vodič pokriva cijeli životni ciklus izgradnje Power Pages stranice s dodatkom, od skele do implementacije. Svaki korak opisuje što kažete i što dodatak radi kao odgovor.

Korak 1: Kreirajte svoju stranicu

Opišite stranicu koju želite prirodnim jezikom: čemu služi, koje stranice su joj potrebne i sve dizajnerske preferencije poput sheme boja, stila rasporeda ili fontova. Pokreni /create-site ili samo opiši svoju stranicu i dodatak prepoznaje namjeru.

Ako ne specificiraš framework, plugin traži da odabereš jedan (React, Vue, Angular ili Astro), a zatim:

1. Izrađuje project iz predloška i primjenjuje ime vaše stranice, boje i dizajnerske tokene.
2. Instalira ovisnosti, pokreće razvojni server i otvara pregled preglednika uživo.
3. Svaku stranicu, komponentu i rutu koju ste tražili gradi relevantnim slikama.
4. Stvara git commitove na značajnim prekretnicama tako da imate ugrađenu povijest vraćanja.

Korak 2: Postavite svoju stranicu

Pokreni /deploy-site da učitaš svoju stranicu na Power Pages. Dodatak:

1. Provjerava je li PAC CLI instaliran i da je vaša autentifikacijska sesija aktivna.
2. Potvrđuje ciljno okruženje s vama prije nego što nastavi.
3. Pokreće produkcijsku verziju i učitava kompajlirani izlaz.
4. Stvara deployment artifacts direktorij ako već ne postoji.

Napomena

Ako tvoje okruženje blokira određene privitke datoteka, dodatak detektira problem i daje upute za njegovo rješavanje.

Korak 3: Aktivirajte svoju stranicu

Trči /activate-site kako bi stranica postala javno dostupna. Dodatak:

1. Predlaže poddomenu na temelju imena vaše stranice i omogućuje vam prilagodbu.
2. Omogućuje zapis web stranice putem Power Platform API-ja.
3. Anketira dok stranica ne postane aktivna i ne vrati javni URL.

U ovom trenutku imate funkcionalnu stranicu na javnom URL-u. Preostali koraci dodaju podatke, autentifikaciju i SEO. Preskočite sve korake koji se ne odnose na vašu stranicu.

Korak 4: Postavite svoj podatkovni model

Trči /setup-datamodel kako bi napravio Dataverse tablice koje tvoja stranica treba. Ako već imate ER dijagram ili specifičnu shemu, dostavite ga izravno umjesto da agent analizira vaš kod.

Dodatak pokreće Data Model Architect agenta koji:

1. Analizira kod vaše stranice kako bi utvrdio koje podatke stranice i komponente zahtijevaju.
2. Upituje vaše Dataverse okruženje za postojeće tablice kako bi izbjegao duplikate.
3. Predlaže podatkovni model s tablicama, stupcima, tipovima podataka i odnosima, vizualiziran kao ER dijagram.

Pregledate i odobrite prijedlog. Dodatak ne stvara ništa dok ne potvrdiš. Nakon odobrenja, dodatak kreira tablice i stupce putem API poziva i sprema manifestnu datoteku koju koriste koraci 5 i 6.

Korak 5: Dodaj uzorak podataka (Opcionalno)

Pokreni /add-sample-data se kako bi popunio tablice testnim zapisima. Ovaj korak zahtijeva podatkovni model iz 4. koraka.

Dodatak izvodi sljedeće radnje:

1. Čita manifest kako bi razumio vaše tablice, stupce i odnose.
2. Generira kontekstualno prikladne vrijednosti za svaku vrstu stupca, poput realističnih e-mailova, vjerodostojnih datuma i formatiranih iznosa valute.
3. Umeće zapise redoslijedom ovisnosti (roditeljske tablice prije dječjih tablica) i automatski osvježava autentifikacijske tokene tijekom masovnih umetanja.

Korak 6: Integracija s Dataverse web API-jem

Pokrenite /integrate-webapi zamjenu lažnih podataka s aktivnim Dataverse upitima. Ovaj korak zahtijeva podatkovni model iz 4. koraka.

Dodatak izvodi sljedeće radnje:

1. Skenira vašu bazu koda tražeći komponente koje koriste lažne podatke, privremene pozive za dohvaćanje ili hardkodirane nizove. Mapira te komponente na vaše Dataverse tablice.
2. Za svaku tablicu generira Web API Integration agenta koji generira:
   • Zajednički API klijent s upravljanjem tokenima protiv krivotvorenja i logikom ponovnog pokušaja.
   • TypeScript tipovi entiteta i domain mapperi.
   • CRUD servisni sloj.
   • Framework-specifični obrasci, poput React hookova, Vue kompozitnih datoteka ili Angular servisa.
3. Pokreće Permissions Architect agenta koji predlaže dozvole tablica i postavke stranice.

Pregledavate i odobravate prijedlog dozvola. Dodatak ne stvara nikakve konfiguracijske datoteke dok ne potvrdiš.

Dodajte sažetke generirane umjetnom inteligencijom (Opcionalno)

Pokreni /add-ai-webapi se za slojeve generativnih AI sažetaka preko tvoje Web API integracije. Ova vještina povezuje dva API API-ja za pregled sažetaka s vašim stranicama s detaljima zapisa i popisima:

• API sažetka pretraživanja: Vraća AI-sažeti sažetak rezultata pretraživanja s citatima.
• API za sažimanje podataka: Vraća sažetak po zapisu ili uvide na razini liste za Dataverse tablicu.

Ovaj korak nadograđuje podatkovni model iz 4. koraka i integraciju web API-ja iz 6. koraka. Dodatak izvodi sljedeće radnje:

1. Skenira vaš kod tražeći sažete točke integracije i potvrđuje ciljne stranice, tablice i koje API-je koristiti.
2. Delegira sve nedostajuće Web API preduvjete — dozvole tablica, popise stupaca i web uloge — na /integrate-webapi i /create-webroles, tako da postoji jedan izvor istine za dozvole.
3. Pokreće AI Web API Integration agenta koji generira tipiziranu uslugu sažetka (aiSummaryService.ts) s anti-forgery token upravljanjem, framework-specific wrapperima (React hookovi, Vue komposable ili Angular servisi) i žičanim pozivima na ciljanim stranicama.
4. Pokreće AI Web API Settings Architect agenta koji kreira Summarization postavke stranice za upite i ograničenja sadržaja.

Pregledavate i odobravate prijedloge. Dodatak ne generira kod niti stvara postavke dok ne potvrdiš.

Napomena

API-ji za sažimanje su u pregledu i ovise o uključenim administrativnim i site-level kontrolama. Ako sažeci ne budu prikazani nakon implementacije, potvrdite da je značajka omogućena kroz relevantne postavke stranice i administratorske kontrole. Za više informacija pogledajte API pregled sažetka podataka i Power Pages pretraživanje s generativnom AI.

Korak 7: Kreirajte web uloge

Pokreni /create-webroles za definiranje korisničkih access uloga. Dodatak:

1. Provjerava vaše okruženje za postojeće web uloge kako biste izbjegli duplikate.
2. Generira definicije uloga s jedinstvenim identifikatorima.
3. Osigurava da svaka stranica ima najviše jednu anonimnu i jednu autentificiranu ulogu.

Korak 8: Postavite autentifikaciju

Pokrenite /setup-auth kako biste dodali kontrolu pristupa za prijavu, odjavu i kontrolu pristupa temeljenu na ulogama na vašoj stranici. Dodatak podržava sljedeće pružatelje identiteta, a možete konfigurirati jednog ili više pružatelja istovremeno.

Davatelj baze	Najbolje za
Microsoft Entra External ID (preporučuje se za stranice usmjerene na korisnike)	Javne stranice i portali za korisnike s registracijom za samoposluživanje.
Microsoft Entra ID	Interni portali za zaposlenike ili partnerske stranice za poslovanje s poslovanjem (B2B). Power Pages automatski konfigurira roditeljskog korisnika stranice, tako da ne morate unositi podatke o tenantu.
Microsoft, Facebook, Google	Društvena prijava za potrošačku publiku.
Lokalna autentifikacija	Korisničko ime i lozinka za prijavu. Ne preporučuje se i konfigurira se samo kad to izričito zatražite.

Za više informacija o podržanim pružateljima, uključujući protokole i konfiguracijske aspekte, pogledajte Pregled autentifikacije u Power Pages.

Dodatak:

1. Analizira vašu stranicu (svrhu, stranice, publiku) i predlaže razumnu zadanu postavku. Na primjer, dodatak predlaže Microsoft Entra External ID s otvorenom registracijom za stranicu usmjerenu prema kupcima, ili Microsoft Entra ID s registracijom samo po pozivnici za interni portal. Prihvaćate preporuku ili birate vlastite pružatelje usluga.
2. Za svakog pružatelja usluga vodi vas kroz svaki preduvjet u administrativnom centru pružatelja identiteta, poput kreiranja tenanta, registracije aplikacija, kreiranja korisničkih tokova te prikupljanja ID-ova klijenata i preusmjeravanja. Dodatak potvrđuje svaku vrijednost koju ubacite natrag u razgovor i izračunava točan URI preusmjeravanja za vašu stranicu tako da vrijednost zalijepljena u registraciju aplikacije odgovara vrijednosti zapisanoj u postavkama stranice.
3. Pita kako podaci korisničkog profila trebaju teći od pružatelja identiteta u Dataverse kontakt zapis (mapiranje zahtjeva), treba li se sinkronizirati pri svakoj prijavi ili samo pri prvom prijavi, te treba li automatski povezati vanjske prijave s postojećim kontaktima putem e-pošte.
4. Generira uslugu autentifikacije, deklaracije tipova, alate za autorizaciju temeljene na ulogama (hasRole, RequireAuth, ), RequireRolehook za održavanje sesije koji sprječava tihi istek SPA sesija te komponentu sučelja za prijavu i odjavu integriranu u vaš izgled stranice. Dodatak koristi obrasce vašeg frameworka kroz cijeli proces, poput React hookova, Vue kompozitnih datoteka, Angular servisa ili Astro komponenti.
5. Kada je konfigurirano više od jednog pružatelja, generira se stranica prikazana /login u odabranom rasporedu: horizontalni red, vertikalni sloj, primarni spotlight ili tabovani.
6. Piše odgovarajuće postavke stranice za .powerpages-site/site-settings/ svakog pružatelja, način registracije, mapiranje zahtjeva i opcionalnu značajku.

Dodatak također konfigurira sljedeće opcionalne značajke kada ih uključite:

• Uvjeti i odredbe: SPA /terms stranicu koju korisnici moraju prihvatiti prije dovršetka prijave, kao i odgovarajuće postavke stranice i isječke sadržaja.
• Stranica korisničkog profila: SPA stranica /user-profile gdje prijavljeni korisnici uređuju svoje kontakt podatke putem Power Pages Web API-ja.
• Federirani odjava: Također se korisnik odjavljuje kod pružatelja identiteta kada se odjavi sa stranice, za scenarije dijeljenih uređaja ili reguliranih uređaja.

Savjet

Za dodavanje drugog pružatelja identiteta na postojeću stranicu, pokrenite /setup-auth ponovno. Dodatak prepoznaje što je već konfigurirano i nudi dodavanje novog pružatelja bez prepisivanja postojećih. Ovaj pristup je koristan za inkrementalne scenarije, poput početka s Microsoft Entra External ID-om, a kasnije dodavanja Googlea za društvenu prijavu.

Napomena

Autorizacija na strani klijenta (RequireAuth, RequireRole, hasRole) služi samo za korisničko iskustvo. On kontrolira što korisnik vidi. Dozvole za stolove na strani poslužitelja konfigurirane od strane /integrate-webapi osiguravaju stvarnu sigurnost.

Korak 9: Dodaj logiku poslužitelja

Pokreni /add-server-logic se kako bi dodao sigurne server-side endpointe na svoju stranicu. Koristite Server Logic kada vaša stranica treba logiku koja ne može raditi u pregledniku, poput vanjskih API poziva, verifikacije na strani servera, upravljanja tajnama ili operacija podataka između entiteta.

Važno

Podrška za serversku logiku zahtijeva PAC CLI verziju 2.6.3 ili noviju. Koristite skriptu za brzu instalaciju za ažuriranje na najnoviju verziju.

Opišite što vam treba jednostavnim jezikom i dodatak:

1. Pokreće Server Logic Architect agenta koji analizira vaš slučaj upotrebe i klasificira njegovu složenost.
2. Predlaže dizajn krajnje točke, sigurnosnu konfiguraciju i sve potrebne dozvole za tablice za vaš pregled.
3. Nakon odobrenja, generira se JavaScript endpoint na strani servera na ./_api/serverlogics/<name>
4. Stvara tipiziranu uslugu na strani klijenta koja poziva krajnju točku iz vaših komponenti.
5. Ažurira vaše komponente da pozovu novu uslugu.
6. Konfigurira dodjelu web uloga i dozvole tablica za krajnju točku.

Pregledate i odobrite prijedlog. Kod se ne generira dok ne potvrdite.

Uobičajeni slučajevi upotrebe:

• Povežite se na vanjske usluge. Pozivajte REST API-je, Azure Functions ili usluge trećih strana bez izlaganja vjerodajnica. (Tutorijal: interakcija s vanjskim servisima)
• Izvodite sigurne podatkovne operacije. Pretraživanje, ažuriranje ili brisanje Dataverse zapisa uz dosljednu validaciju na strani poslužitelja. (Tutorijal: interakcija s Dataverse tablicama)
• Pokreni vlastitu logiku. Agregirajte podatke kroz tablice, provodite poslovna pravila ili izračunavajte izvedene vrijednosti prije nego što vratite rezultate klijentu.
• Upravljajte tajnama na strani poslužitelja. Pohranjujte vjerodajnice i API ključeve na poslužitelju, nikada u klijentski kod. (Tutorial: komuniciraj s Microsoft Graph i SharePoint)

Napomena

Pokreni jednom /add-server-logic po upotrebi. Na primjer, ako vašoj stranici treba i endpoint za validaciju inventara i globalni endpoint za pretraživanje, pokrenite vještinu dvaput.

Korak 10: Integracija cloud tokova

Pokreni /add-cloud-flow kako bi integrirao postojeće Power Automate cloud tokove na svoju stranicu. Ova vještina povezuje vašu Power Pages stranicu s tokovima koje ste već kreirali u Power Automate. Ne stvara nove cloud tokove.

Dodatak:

1. Registrira postojeći cloud flow na vašoj stranici.
2. Generira kod na strani klijenta koji pokreće tok s vaših stranica.
3. Obrađuje asinkrono stanje tijeka rada i obrasce povratnih poziva.
4. Povezuje razmjenu podataka između stranice i toka.

Koristite /add-cloud-flow za radne tokove odobravanja, obavijesti putem e-pošte, zakazane poslove i automatizaciju vođenu događajima, što Power Automate bolje obrađuje nego poslužiteljske krajnje točke.

Alternativa: Koristiti /integrate-backend za planiranje punog sloja usluge

Ako niste sigurni koje značajke trebaju Web API, Server Logic ili cloud flow, pokrenite ga /integrate-backend umjesto ručnog pokretanja koraka 4 do 10. Ova vještina djeluje kao orkestrator koji:

1. Analizira vaš prototip kako bi identificirao sve značajke kojima je potreban servisni sloj.
2. Klasificira svaku značajku u pravi pristup: Web API za standardni CRUD, Server Logic za validaciju na serverskoj strani i vanjske API-je, ili cloud flow za odobrenje i automatizaciju.
3. Predlaže sekvencirani plan izvršavanja sa svim vještinama, ovisnostima i konfiguracijama.
4. Nakon što odobrite, orkestrirajte vještine u ispravnom redoslijedu.

Plan je postojan, može se nastaviti i može se uređivati. Zaustavite se nakon svakog koraka da pregledate generirani kod ili testirate stranicu, pa nastavite tamo gdje ste stali tako da /integrate-backend ponovno pokrenete.

Korak 11: Dodaj SEO

Trčite kako biste /add-seo optimizirali svoju stranicu za tražilice. Dodatak:

1. Otkriva rute iz konfiguracije routera vašeg frameworka.
2. Generira smjernice tražilica i kartu stranice za sve otkrivene rute.
3. Dodaje meta oznake: viewport, charset, description, Open Graph, Twitter Card i reference na favicon.

Korak 12: Rasporedite završnu lokaciju

Ako napravite bilo koje opcionalne korake, pokrenite /deploy-site ponovno da biste promjene poslali uživo. Dodatak pokreće produkcijsku verziju i učitava stranicu zajedno sa svim artefaktima za implementaciju (dozvole za tablice, postavke stranice, web uloge, logičke datoteke servera) u vaše Power Pages okruženje.

Korak 13: Pokrenite sigurnosni pregled

Trči /security-review i napravi cjelovitu sigurnosnu reviziju svoje stranice prije nego što kreneš u produkciju. Vještina koordinira fokusirane sigurnosne vještine i konsolidira svaki nalaz u jedan HTML izvještaj na .docs/security-review-<timestamp>.html

Dodatak postavlja jedno jednostavno pitanje o vašem cilju i odabire odgovarajući skup fokusiranih vještina:

Goal	Što provjerava
Kod i konfiguracija	Izvorni kod, ovisnosti, dozvole tablica i konfiguracija autentifikacije. Radi samo na lokalnim datotekama - nije potrebna implementacija.
Spremnost za puštanje (preporučeno)	Cjelovita recenzija prije objave. Pokreće sve fokusirane vještine: kod i ovisnosti, skeniranje deployed-site, sigurnosne zaglavlja preglednika, firewall web aplikacija, dozvole tablica i autentifikaciju.
Raspoređena lokacija	Samo skeniranje uživo na lokaciji. Korisno za kontinuirano praćenje objavljene stranice.

Nakon što potvrdite, dodatak paralelno pokreće usklađene vještine i zapisuje njihove nalaze u jedan izvještaj:

• /scan-code: Pokreće statičku analizu (opengrep) i skeniranje ovisnosti (trivy) na lokalnim izvornim datotekama. Surface obrazci koda, ranjivi paketi, hardkodirane tajne i problemi s licencama. Ako nijedan od alata nije instaliran, vještina nudi ručni pregled koda kao rezervu.
• /scan-site: Pokreće sigurnosni pregled na strani servera protiv aktivne stranice i dohvaća najnoviji izvještaj. Trajanje skeniranja ovisi o veličini lokacije – male stranice završe za nekoliko minuta, velike stranice mogu trajati satima. Nalazi su grupirani prema težini. Zahtijeva raspoređenu lokaciju.
• /manage-headers: Pregledava HTTP sigurnosne zaglavlja konfigurirana pod .powerpages-site/site-settings/: Content Security Policy, X-Frame-Options, CORS, cookie SameSite i povezane postavke. Identificira nedostajuće ili slabe vrijednosti i predlaže preporučene zadane vrijednosti.
• /manage-firewall: Inspektira firewall web aplikacija (WAF) za produkcijsku lokaciju, uključujući stanje upravljanih pravila i prilagođena pravila (IP blokovi, državni blokovi, blokovi puta, ograničenja brzine). Dostupno samo na proizvodnim lokacijama u podržanim regijama; Vještina otkriva i prijavljuje probleme s podobnošću.
• /audit-permissions: Revizija postojećih dozvola za tablice u odnosu na kod stranice i Dataverse metapodatke. Otkriva nedostajuće dozvole, previše permisivne uloge, neiskorištene dozvole i probleme s YAML shemom.

Objedinjeni izvještaj grupira nalaze po odjeljcima, otvara se u vašem zadanom pregledniku i uključuje upute za ispravljanje na jednostavnom jeziku. Iz chata, plugin zatim nudi da prođe kroz ispravke – odaberi nalaz i plugin interaktivno aktivira vještinu fokusiranu na matching kako bi primijenio promjenu.

Napomena

Sigurnosni pregled nikada ne primjenjuje promjene automatski. Svaka fokusirana vještina radi u načinu pregleda samo za čitanje tijekom objedinjene igre. Za primjenu popravka, dodatak interaktivno poziva odgovarajuću vještinu nakon što odaberete akciju.

Savjet

Također možeš koristiti bilo koju fokusiranu vještinu samostalno:

• Pokrenite /scan-code tijekom razvoja kako biste rano otkrili probleme na razini koda.
• Pokreni /manage-headers se kako bi se ispravila specifična greška u Politici sigurnosti sadržaja ili postavila CORS.
• Trči /manage-firewall kako bi dodao ograničenje brzine na stranicu za prijavu ili blokiraj promet po državama.
• Pokreni /audit-permissions nakon promjene dozvola tablice da provjeriš da li se još uvijek podudaraju s kodom stranice.
• Ponovno pokrenite /security-review s ciljem Deployed site kako biste pratili produkcijsku lokaciju tijekom vremena.

Provjerite svoju stranicu

Nakon što završite vještine, provjerite radi li vaša Power Pages stranica ispravno.

1. Idi na Power Pages.
2. Pronađite svoju stranicu na popisu aktivnih stranica .
3. Pregledajte svoju stranicu na desktopu koristeći opciju Pregled .
4. Testirajte funkcionalnost.

Promovirajte svoju stranicu u različitim okruženjima

Nakon što vaša stranica radi u razvojnom okruženju, iskoristite vještine upravljanja životnim ciklusom aplikacije (ALM) kako biste je promovirali u testnim i produkcijskim okruženjima. Dodatak pakira vašu stranicu kao Power Platform rješenje, identificira vrijednosti koje variraju ovisno o okruženju i implementira rješenje putem Power Platform Pipelines ili ručnog izvoza i uvoza.

Za korištenje ALM vještina također trebaš barem jedno ciljano Power Platform okruženje (testno, produkcijsko ili oboje). Za korištenje opcionalnog Azure Key Vault toka za tajne, također vam je potrebna dozvola za kreiranje key vaulta u vašoj Azure pretplati.

Planiranje implementacije

Trči /plan-alm za početak. /plan-alm je ulazna točka za ALM i orkestrira ostale ALM vještine, pa ih obično ne vodite izravno. Dodatak:

1. Detektira trenutno stanje vašeg projekta, rješenja i ciljnog okruženja.
2. Pita o vašoj strategiji promocije (Power Platform Pipelines ili ručni izvoz i uvoz), ciljanim fazama i eventualnim ograničenjima koja treba primijeniti.
3. Generira vizualni plan koji docs/alm-plan.html prikazuje svaku radnju koju namjerava poduzeti.
4. Čeka tvoje odobrenje prije nego što pokrene bilo koju dalju vještinu.

Plan ostaje na disku, pa svaka vještina niz tok čita i piše u isti trajni plan. Ako faza ne uspije, pokreni /plan-alm ponovno i nastavlja se od mjesta gdje je stala.

Napišite rješenje

Pokrenite /setup-solution se kako biste svoju stranicu pakirali kao Power Platform rješenje. Dodatak:

1. Kreira izdavača i rješenje, zatim dodaje vaše Power Pages komponente: stranicu, web uloge, logičke endpointe servera, registracije cloud flowa i postavke OAuth pružatelja.
2. Klasificira svaku postavku lokacije prema osjetljivosti i predlaže varijable okoline za vrijednosti koje variraju među okruženjima.
3. Nudi postavljanje Azure Key Vault i pohranu vrijednosti tipa vjerodajnice, poput nizova veza i API ključeva.
4. Radi u sinkroniziranom načinu rada kada rješenje već postoji za vašu stranicu, kako bi uskladio komponente bez stvaranja novog rješenja.

Pregledate i odobrite prijedlog. Dodatak ne stvara nikakvu konfiguraciju dok ne potvrdiš.

Savjet

Ako je vaše rješenje preveliko ili zapetljano za pouzdano implementaciju, dodatak preporučuje podjelu i predlaže gdje je podijeliti. Potvrdite podjelu prije nego što promjene stupe na snagu.

Implementacija s Power Platform cjevovodima

Ako ste odabrali Power Platform Pipelines kao strategiju promocije, dodatak koristi sljedeće vještine:

1. /ensure-pipelines-host osigurava ili detektira domaćinsko okruženje za Power Platform cjevovode. Vještina bira najjeftiniju opciju dostupnu za vašeg tenanta: besplatni platformski hosting, Pipelines aplikaciju u postojećem okruženju ili prilagođeni hosting.
2. /setup-pipeline registrira definiciju cjevovoda u Dataverseu, konfigurira odabrane faze i povezuje svaku fazu s ciljnim okruženjem.
3. /deploy-pipeline pokreće implementaciju za fazu, primjenjuje varijable deploymentSettings.jsonokruženja po fazi kroz , i prati stanje u knjizi implementacije.

Ako implementacija ne uspije jer je ciljno okruženje već povezano s drugim Power Platform Pipelines hostom, dodatak može pokrenuti /force-link-environment i ponovno ga dodijeliti. Radnja zahtijeva vaš izričiti pristanak i može se poništiti.

Implementacija s ručnim izvozom i uvozom

Ako odaberete ručni put, dodatak radi:

1. /export-solution za izvoz rješenja kao upravljanog ili neupravljanog ZIP-a, s provjerom potpunosti prije izvoza.
2. /import-solution za uvoz ZIP-a u ciljno okruženje, bilo fazirano za provjeru ovisnosti prvo ili izravno.

Aktivirajte i validirajte postavljenu lokaciju

Nakon uspješne implementacije u ciljnom okruženju, dodatak:

1. Pokreće /activate-site se za postavljanje javnog URL-a u ciljnom okruženju.
2. Provjerava /test-site implementaciju. Dodatak koristi preglednik za pretraživanje reprezentativnih stranica, pokretanje provjera pristupa temeljenih na ulogama, provjeru /_api/ poziva i hvatanje obrazaca odgovora s /_api/serverlogics/ krajnjih točaka. Vještina prikazuje rezultat kao PASS, WARNINGS, ili FAIL, s detaljima po provjeri povezanim s planom.

Ako korak ne uspije, dodatak se izvršava /diagnose-deployment. Vještina uspoređuje neuspjeh s katalogom poznatih pogrešaka pri implementaciji, poput zastarjelog manifesta, nedostajućih ovisnosti, sukoba s hostovima, blokiranog JavaScripta ili istekle autentifikacije, te predlaže konkretno rješenje. Dodatak nikada ne primjenjuje popravak bez vašeg pristanka.

Napomena

Svaka ALM vještina čita i piše s artefakata na disku: manifest rješenja, podatke o planu, dnevnik cjevovoda, dnevnik implementacije i rezultate testiranja. Orkestracija je nastavak i revizija. Da biste vidjeli što se dogodilo u bilo kojem koraku, pregledajte artefakte.

Savjeti i najbolje prakse

Sljedeći savjeti pomažu vam da maksimalno iskoristite dodatak i AI agenta za kodiranje prilikom izrade Power Pages stranica.

Pratite izlaz terminala za nedostajuće alate pri prvom korištenju

Dodatak pruža vještine i radne tokove, ali AI agent za kodiranje - GitHub Copilot CLI ili Claude Code - izvršava stvarne naredbe na vašem računalu. Kad prvi put koristite ove alate, pažljivo pratite izlaz terminala. AI agent za kodiranje izvršava naredbe i skripte iza kulisa, a neke od tih naredbi ovise o alatima koji možda nisu instalirani na vašem računalu. Ako neki korak ne uspije, izlaz terminala obično pokazuje koji alat ili naredbu nije uspio pronaći.

Ako vidite grešku poput command not found ili is not recognized, instalirajte nedostajući alat i ponovno pokrenite tijek rada. AI agent za kodiranje nastavlja tamo gdje je stao nakon što je alat dostupan.

Pregledajte prijedloge agenata prije odobrenja

AI agent za kodiranje predstavlja prijedloge, poput onih od Data Model Architecta i Permissions Architecta, prije nego što napravi promjene. Kod i konfiguracija koje generira AI agent mogu biti netočni, stoga pregledajte, testirajte i validirajte svaki prijedlog i sav generirani kod prije nego što ga odobrite ili implementirate.

• Prijedlozi modela podataka: Provjerite odgovaraju li nazivi tablica, tipovi stupaca i odnosi zahtjevima vašeg poslovanja. Lakše je prilagoditi prijedlog nego preimenovati stupce nakon što su podaci već umetnuti.
• Permissions proposals: Provjerite ima li svaka uloga ispravnu razinu access (kreiranje, čitanje, ažuriranje, brisanje) za svaku tablicu. Previše permisivne dozvole za tablice čest su sigurnosni rizik.
• Generirani kod: Pročitajte generirani kod i testirajte stranicu lokalno prije implementacije. Kod generiran umjetnom inteligencijom može sadržavati pogreške ili sigurnosne probleme.

Lijepite pogreške izravno s kontekstom

Kada nešto zakaže, bilo da je riječ o pogrešci izgradnje, neuspjehu implementacije ili iznimci u pregledniku u runtimeu, kopirajte cijeli izlaz pogreške. Zalijepite ga zajedno s kratkim opisom onoga što ste radili. Što više konteksta pružite, to je brže rješenje.

Primjer: Greška u izgradnji

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>
                                 

Savjet

Uključite naziv datoteke, naredbu koju ste pokrenuli i što ste očekivali da će se dogoditi. Dodatak koristi ovaj kontekst za lociranje problema i primjenu ciljanog rješenja umjesto nagađanja.

Share Web API pogreške s punim URL-om zahtjeva

Čest problem nakon implementacije je greška 403 iz Power Pages Web API-ja kada stupac nije omogućen za pristup API-ju. Kad naiđete na ovu grešku, zalijepite cijeli URL API-ja i kompletan JSON odgovor na grešku. Poruka o grešci točno vam govori koju tablicu i stupac treba popraviti, a dodatak može ažurirati YAML i postavke stranice za tablicu.

Primjer: Stupac nije omogućen za 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"
    }
  }
}

Ova pogreška (AttributePermissionIsMissing) znači da stupac _crd50_propertyid_value za pretraživanje postoji u Dataverse tablici, ali nije naveden u konfiguraciji dozvola tablice za Web API. Dodatak rješava ovu pogrešku dodavanjem nedostajućeg stupca u YAML .powerpages-site/table-permissions/ dozvolu tablice i ponovnim postavljanjem.

Napomena

Power Pages Web API zahtijeva da svaki stupac vraćen API pozivom bude eksplicitno naveden u dopuštenju tablice. Svojstva pretraživanja (s prefiksom s i _ sufiksom ) _valuelako je propustiti jer se njihov API naziv razlikuje od logičkog naziva stupca u Dataverseu. Kad vidite AttributePermissionIsMissing, uvijek dodajte taj stupac u dopuštenje tablice. Nemoj mijenjati upit za API.

Budi konkretan oko toga što želiš

Nejasni zahtjevi daju nejasne rezultate. Točno recite pluginu što vam treba, uključujući postavke rasporeda, polja podataka i ponašanje.

Umjesto	Isprobajte
"Napravi stranicu za poslove"	"Kreirajte stranicu s oglasima za posao s trakom za pretraživanje na vrhu, filtrirajte čipove za lokaciju i odjel te mrežom kartica koja prikazuje naziv, tvrtku, raspon plaće i datum objave za svaki posao"
"Popravi stil"	"Radne kartice se slažu okomito na radnoj površini. Neka se prikazuju u mreži od tri stupca s razmakom od 16px na ekranima širim od 768px"
"Dodaj neke podatke"	"Dodajte 20 primjera oglasa za posao u četiri odjela (inženjering, marketing, prodaja, ljudski resursi) s realnim nazivima, rasponom plaća između $60k-$180k i objavljenim datumima u zadnjih 30 dana"
"Postavi API"	"Povežite komponentu JobListings s tablicom cr_jobposting Dataverse. Zamijenite hardkodirani niz stvarnim API pozivom koji dohvaća naziv, odjel, plaću i datum objave."
"Dodaj prijavu"	"Postavite prijavu na Microsoft Entra External ID s otvorenom registracijom, plus Google kao drugog pružatelja. Pokažite ih kao vodoravni red na stranici za prijavu."

Koristite snimke zaslona za vizualne probleme

Kada stranica ne izgleda ispravno u pregledniku, napravite snimku zaslona i zalijepite je izravno u razgovor ili unesite putanju do datoteke. Vizualni kontekst pomaže identificirati probleme u rasporedu, razmaku i stiliziranju koje je teško opisati tekstom.

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.

Iterirajte u malim koracima

Umjesto da opisujete cijelu stranicu u jednom upitu, gradite postupno. Počnite sa strukturom i rasporedom, zatim dodajte značajke jednu po jednu. Ovaj pristup vam daje priliku da pregledate i ispravite smjer na svakom koraku.

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

Savjet

Nakon svakog koraka, provjerite pregled preglednika. Ako nešto nije u redu, popravi to prije nego što kreneš dalje. Lakše je riješiti probleme u jednoj komponenti nego razmrsiti probleme na cijeloj stranici.

Zatražite objašnjenje prije nego što odobrite

Kada niste sigurni u predloženu promjenu, posebno za dozvole, izmjene modela podataka ili konfiguraciju autentifikacije, zamolite dodatak da objasni što planira to do i zašto prije nego što odobrite.

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

Samostalno izvoditi vještine kako biste se oporavili od problema

Ako neka vještina ne uspije, ne morate počinjati ispočetka. Svaka vještina radi neovisno i može nastaviti tamo gdje je stala. Na primjer, ako /integrate-webapi ne uspije na trećoj tablici, možete je ponovno pokrenuti i ona detektira već dovršen rad.

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

Povezani sadržaj

• Kreirajte i implementirajte aplikaciju na jednoj stranici u Power Pages
• Konfiguriraj autentifikaciju za Power Pages stranicu
• Pregled logike poslužitelja
• Power Pages Web API referenca
• Pregled API-ja za sažimanje podataka
• Power Pages pretraživanje pomoću generativne AI
• PAC CLI stranice za naredbe
• GitHub Copilot CLI
• Claudeov kod