Darbo su "Power Pages" papildiniu, skirtu "GitHub Copilot CLI" ir "Claude Code", pradžia

Power Pages papildinys, skirtas GitHub Copilot CLI ir Claude Code suteikia dirbtinio intelekto darbo eigą, skirtą kurti, diegti ir valdyti modernias vieno puslapio programą (SPA) svetaines Power Pages. Užuot rankiniu būdu kūrę projektus, rašydami standartinį API kodą ir konfigūravę leidimus, aprašykite, ko norite natūralia kalba, o papildinys tvarkys įgyvendinimą.

Papildinys palaiko visą svetainės kūrimo ciklą per pokalbio įgūdžius, pradedant naujos svetainės pastoliais ir baigiant jos diegimu, "Dataverse" duomenų modelių nustatymu ir autentifikavimo konfigūravimu.

Svarbu

  • Generatyvinis AI kodavimo agentas, pvz., "GitHub Copilot CLI" arba "Claude Code", naudoja šio papildinio įgūdžius ir darbo eigas, kad atliktų "Power Pages" specifines užduotis.
  • AI kodavimo agento sugeneruotas kodas ir konfigūracija gali būti netikslūs. Peržiūrėkite, išbandykite ir patvirtinkite visą sugeneruotą turinį prieš jį patvirtindami ar diegdami. Prieš patvirtindami agentų pasiūlymus, visada peržiūrėkite agentų pasiūlymus .

Būtinosios sąlygos

Prieš pradėdami patikrinkite, ar turite reikiamą programinę įrangą ir teises.

Programinės įrangos reikalavimai

Komponentas Minimali versija Daugiau informacijos
Node.js 18.0 arba naujesnė versija Atsisiųsti Node.js
Power Platform CLI (PAC CLI) 2.6.3 arba naujesnė versija (reikalinga serverio logikai) Įdiekite PAC CLI
Azure CLI Naujausi Įdiekite Azure CLI
GitHub Copilot CLI arba Claude Code Naujausi GitHub Copilot CLI arba Claude Code
"Visual Studio Code" ir "Power Platform Tools" plėtinys (pasirinktinai) Naujausi Atsisiųskite VS kodą ir įdiekite "Power Platform" įrankius

Jums taip pat reikia:

  • "Power Platform" aplinka su įgalinta "Power Pages".
  • Autentifikuotas PAC CLI seansas, prijungtas prie jūsų tikslinės aplinkos. Paleiskite pac auth create , jei dar neprisijungėte.
  • "Azure CLI" seansas, prisijungęs prie to paties nuomotojo. Paleiskite az login --allow-no-subscriptions, kad autentifikuotumėte.

Patikrinkite autentifikavimą:

Patikrinkite, ar esate autentifikuotas naudodami pac auth list komandą.

pac auth list           # Should show authenticated profile

Jei nesate autentifikuoti, vykdykite šią komandą:

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

Arbatpinigiai

Norėdami gauti egzemplioriaus URL, eikite į Power Pages pagrindinį puslapį, viršutiniame dešiniajame kampe pasirinkite piktogramą Parametrai, tada pasirinkite Seanso informacija.

Įdiekite papildinį

Įdiekite "Power Pages" papildinį iš prekyvietės. Jei naudojate GitHub Copilot CLI, lygiaverčius diegimo veiksmus rasite Copilot CLI plėtinių dokumentacijoje. Šios komandos naudoja Claude'o kodo sintaksę.

Paleiskite diegimo programą, kad nustatytumėte visus papildinius su įjungtu automatiniu atnaujinimu:

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

Diegimo programa automatiškai:

  • Įdiegia CLI, pac jei jis dar neįdiegtas.
  • Aptinka galimus įrankius, tokius kaip "Claude Code" ir "GitHub Copilot CLI".
  • Užregistruoja įskiepių prekyvietę ir įdiegia visus išvardytus papildinius.
  • Įgalina automatinį naujinimą, kad papildiniai būtų atnaujinti.

Įdiegę iš naujo paleiskite "Claude Code" arba "GitHub Copilot CLI", kad pasiektumėte papildinio įgūdžius kaip pasvirojo brūkšnio komandas agento sesijoje.

Diegti iš prekyvietės

  1. Atidarykite "Claude Code" savo terminale.

  2. Įtraukite "„Microsoft“" prekyvietę:

    /plugin marketplace add microsoft/power-platform-skills

  3. Įdiekite "Power Pages" papildinį:

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

Įdiegę papildinį, iš naujo paleiskite "Claude Code" arba "GitHub Copilot CLI", kad pasiektumėte papildinio įgūdžius kaip pasvirojo brūkšnio komandas agento sesijoje.

Arbatpinigiai

Norėdami automatiškai gauti rinkos ir įgūdžių naujinimus, įjunkite automatinį naujinimą. Naudokite /plugin komandą, eikite į Prekyvietes, pasirinkite prekyvietę ir įjunkite automatinį naujinimą.

Įgūdžių apžvalga

Papildinys suteikia įgūdžių, apimančių visą "Power Pages" svetainės gyvavimo ciklą. Iškvieskite kiekvieną įgūdį pokalbiu, kaip pasvirąjį brūkšnį arba apibūdindami, ką norite to do.

Įgūdis Komanda Kuo ji naudinga
Sukurti svetainę /create-site Sukuria svetainę, taiko jūsų dizaino kryptį ir kuria puslapius bei komponentus
Svetainės diegimas /deploy-site Sukuria projektą ir įkelia jį į "Power Pages" naudojant PAC CLI
Aktyvinti svetainę /activate-site Pateikia svetainės įrašą ir priskiria viešąjį URL
Duomenų modelio nustatymas /setup-datamodel Sukuria "Dataverse" lenteles, stulpelius ir ryšius
Duomenų pavyzdžių įtraukimas (pasirinktinai) /add-sample-data Užpildo "Dataverse" lenteles tikroviškais bandymų įrašais
Integruokite žiniatinklio API /integrate-webapi Generuoja įvestą API kliento kodą, paslaugas ir lentelės teises
Pridėkite AI santraukas /add-ai-webapi Integruoja generatyvinio AI apibendrinimo API (paieškos santrauką ir duomenų apibendrinimą) į jūsų puslapius. Sukuria įvestą suvestinės paslaugą su apsaugos nuo klastojimo žetonų tvarkymu, konkrečių sistemų įvyniojimais, laidinių skambučių svetainėmis ir atitinkamais Summarization svetainės nustatymais
Autentifikavimo nustatymas /setup-auth Prideda prisijungimo, atsijungimo ir vaidmenimis pagrįstą prieigos valdymą. Palaiko Microsoft Entra ID, „Microsoft Entra“ išorinis ID, OpenID Connect, SAML 2.0, WS-Federation, „Microsoft“ paskyra, Facebook, Google ir vietinį vartotojo vardo ir slaptažodžio autentifikavimą, įskaitant kelių teikėjų konfigūracijas
Žiniatinklio vaidmenų kūrimas /create-webroles Generuoja žiniatinklio vaidmens YAML failus vartotojo access valdymui
Pridėti serverio logiką /add-server-logic Generuoja saugius serverio "JavaScript" galinius punktus patvirtinimui, išoriniams API iškvietimams, slaptam valdymui ir duomenų operacijoms
Debesies srauto įtraukimas /add-cloud-flow Integruoja esamus "Power Automate" debesies srautus į jūsų svetainę, kad būtų galima patvirtinti darbo eigas, pranešimus ir suplanuotą automatizavimą
Integruokite užpakalinę sistemą /integrate-backend Analizuoja jūsų prototipą, nustato tinkamą metodą (žiniatinklio API, serverio logiką arba debesies srautą) kiekvienai funkcijai ir koordinuoja visą kūrimo seką
Pridėti SEO /add-seo Generuoja robots.txt, sitemap.xmlir meta žymes
Vykdyti saugos peržiūrą /security-review Orkestruoja sutelktus saugos įgūdžius ir sujungia kiekvieną radinį į vieną HTML ataskaitą. Apima kodą, priklausomybes, įdiegtos svetainės nuskaitymą, naršyklės antraštes, žiniatinklio programų užkardą, lentelės leidimus ir autentifikavimo konfigūraciją
Nuskaityti šaltinio kodą /scan-code Atlieka statinę analizę ir priklausomybių nuskaitymą vietiniuose šaltinio failuose; atskleidžia kodo šablonų, pažeidžiamų paketų, užkoduotų paslapčių ir licencijų problemų išvadas
Nuskaityti įdiegtą svetainę /scan-site Pradeda serverio saugos nuskaitymą pagal tiesioginę svetainę, gauna naujausią ataskaitą ir grupuoja išvadas pagal sunkumą
Tvarkyti naršyklės saugos antraštes /manage-headers Tikrina ir konfigūruoja HTTP saugos antraštes, kurias svetainė siunčia naršyklėms – turinio saugos strategija, rėmelių ir paspaudimų užgrobimo apsauga, bendrinimas tarp kilmių, slapukų elgsena ir susiję svetainės parametrai
Tvarkyti žiniatinklio programų užkardą /manage-firewall Tikrina ir konfigūruoja žiniatinklio programų užkardą (WAF) gamybos vietoje: įgalina apsaugą, prideda arba pašalina IP blokus, šalių blokus, kelio blokus ir greičio apribojimus
Audito lentelės teisės /audit-permissions Tikrina esamas lentelės teises pagal svetainės kodą ir "Dataverse" metaduomenis; sukuria HTML ataskaitą, sugrupuotą pagal sunkumą su siūlomais pataisymais
Planuoti diegimą /plan-alm Aptinka projekto būseną, surenka jūsų reklamos strategiją, pateikia vaizdinį planą ir tinkama tvarka koordinuoja kitus programos gyvavimo ciklo valdymo (ALM) įgūdžius
Autorinis sprendimas /setup-solution Sukuria leidėją ir sprendimą, įtraukia "Power Pages" komponentus, klasifikuoja svetainės parametrus ir siūlo aplinkos kintamuosius bei "Azure Key Vault" paslaptis
Nustatyti srauto pagrindinį kompiuterį /ensure-pipelines-host Pateikia arba aptinka "Power Platform Pipelines" pagrindinio kompiuterio aplinką
Nustatyti srautą /setup-pipeline Registruoja srauto apibrėžimą "Dataverse" ir susieja paaukštinimo etapus su tikslinėmis aplinkomis
Diegti per srautą /deploy-pipeline Suaktyvina tikslinio etapo srauto diegimą su etapo aplinkos kintamųjų nepaisymu
Jėgos ryšio aplinka /force-link-environment Iš naujo priskiria tikslinę aplinką naujam "Power Platform Pipelines" pagrindiniam kompiuteriui, kai pagrindinio kompiuterio konfliktas blokuoja diegimą
Eksportuoti sprendimą /export-solution Eksportuoja sprendimą kaip valdomąjį arba nevaldomąjį ZIP, prieš eksportuojant patikrinant išsamumą
Importavimo sprendimas /import-solution Importuoja sprendimo ZIP tikslinėje aplinkoje, etapinėje arba tiesioginėje aplinkoje
Bandymų vieta /test-site Patikrina įdiegtą svetainę naudodama naršyklės testą: puslapio tikrinimą, vaidmenimis pagrįstus prieigos patikrinimus ir žiniatinklio API patvirtinimą
Diagnozuoti diegimą /diagnose-deployment Suderina diegimo klaidas su žinomų klaidų katalogu ir siūlo pataisyti

Tipinė darbo eiga

Įprasta darbo eiga nuo galo iki galo vyksta tokia seka:

  1. /create-site : Pastoliai, dizainas ir puslapių kūrimas
  2. /deploy-site : nusiųsti į Power Pages aplinką
  3. /activate-site : Nustatykite viešąjį URL
  4. /setup-datamodel : Kurti "Dataverse" lenteles
  5. /add-sample-data : Užpildykite lenteles bandomaisiais įrašais
  6. /integrate-webapi : Generuokite API kliento kodą ir konfigūruokite leidimus
  7. /create-webroles : Apibrėžkite access vaidmenis
  8. /setup-auth : pridėkite prisijungimo, atsijungimo ir vaidmenimis pagrįstą vartotojo sąsają
  9. /add-server-logic : Įtraukite saugius serverio galinius punktus
  10. /add-cloud-flow : Integruokite esamus Power Automate srautus
  11. /add-seo : Optimizavimas paieškos sistemoms
  12. /deploy-site : Stumti galutinius pakeitimus tiesiogiai
  13. /security-review : Prieš pradėdami gaminti, atlikite išsamią saugos peržiūrą
  14. /plan-alm : Reklamuokite savo svetainę į bandymų ir gamybos aplinką

Arbatpinigiai

  • Jums nereikia laikytis šios tikslios tvarkos. Kiekvienas įgūdis patikrina savo prielaidas ir pasako, jei ko nors trūksta. Pavyzdžiui, galite paleisti /setup-auth anksčiau /integrate-webapi , jei jūsų svetainei pirmiausia reikia autentifikavimo.
  • Jei nesate tikri, kokį metodą naudoti kiekvienai funkcijai, vykdykite /integrate-backend 4–10 veiksmus atskirai. Jis analizuoja jūsų prototipą, nustato, ar kiekvienai funkcijai reikia žiniatinklio API, serverio logikos ar debesies srauto, ir koordinuoja įgūdžius teisinga tvarka.
  • Norėdami įtraukti dirbtinio intelekto sugeneruotą paiešką ir įrašų santraukas, paleiskite /add-ai-webapi po /integrate-webapi. Ji pakartotinai naudoja konfigūruojamas lentelės teises ir svetainės parametrus /integrate-webapi , todėl paleiskite ją, kai bus įdiegta žiniatinklio API integracija.

"Power Pages" svetainės kūrimas

Šioje apžvalgoje aprašomas visas "Power Pages" svetainės kūrimo naudojant papildinį ciklas – nuo pastolių kūrimo iki diegimo. Kiekviename žingsnyje aprašoma, ką sakote ir ką papildinys daro atsakydamas.

1 veiksmas: sukurkite svetainę

Apibūdinkite norimą svetainę natūralia kalba: kam ji skirta, kokių puslapių jai reikia ir kokias dizaino nuostatas, pvz., spalvų schemą, išdėstymo stilių ar šriftus. Paleiskite /create-site arba tiesiog apibūdinkite savo svetainę ir papildinys atpažįsta ketinimą.

Jei nenurodysite sistemos, papildinys paprašys pasirinkti vieną (React, Vue, Angular arba Astro), tada:

  1. Scaffolds project iš šablono ir taiko jūsų svetainės pavadinimą, spalvas ir dizaino atpažinimo ženklus.
  2. Įdiegia priklausomybes, paleidžia kūrimo serverį ir atidaro tiesioginę naršyklės peržiūrą.
  3. Sukuria kiekvieną pageidaujamą puslapį, komponentą ir maršrutą su atitinkamais vaizdais.
  4. Sukuria git įsipareigojimus reikšmingais etapais, kad turėtumėte integruotą atšaukimo retrospektyvą.

2 veiksmas: įdiekite svetainę

Paleiskite /deploy-site, kad nusiųstumėte svetainę į Power Pages. Papildinys:

  1. Patikrina, ar PAC CLI įdiegtas ir ar jūsų autentifikavimo seansas aktyvus.
  2. Prieš tęsdami patvirtina tikslinę aplinką.
  3. Paleidžia gamybos komponavimą ir įkelia sukompiliuotą išvestį.
  4. Sukuria diegimo artefacts katalogą, jei jo dar nėra.

Pastaba.

Jei jūsų aplinka blokuoja tam tikrus failų priedus, papildinys aptinka problemą ir pateikia instrukcijas, kaip ją išspręsti.

3 veiksmas: suaktyvinkite svetainę

Bėkite /activate-site , kad svetainė būtų viešai prieinama. Papildinys:

  1. Siūlo padomenį pagal svetainės pavadinimą ir leidžia jį tinkinti.
  2. Pateikia svetainės įrašą per "Power Platform" API.
  3. Apklausos, kol svetainė veikia ir pateikia viešąjį URL.

Šiuo metu turite veikiančią svetainę viešuoju URL. Likę veiksmai prideda duomenų, autentifikavimo ir SEO. Praleiskite visus veiksmus, kurie netaikomi jūsų svetainei.

4 veiksmas: nustatykite duomenų modelį

Vykdykite /setup-datamodel , kad sukurtumėte jūsų svetainei reikalingas "Dataverse" lenteles. Jei jau turite ER diagramą arba konkrečią schemą, pateikite ją tiesiogiai, o ne leiskite agentui analizuoti jūsų kodą.

Papildinys sukuria duomenų modelio architekto agentą, kuris:

  1. Analizuoja svetainės kodą, kad nustatytų, kokių duomenų reikia puslapiams ir komponentams.
  2. Jūsų "Dataverse" aplinkoje užklausia esamų lentelių, kad būtų išvengta dublikatų.
  3. Siūlo duomenų modelį su lentelėmis, stulpeliais, duomenų tipais ir ryšiais, vizualizuotu kaip ER diagrama.

Jūs peržiūrite ir patvirtinate pasiūlymą. Papildinys nieko nesukuria, kol nepatvirtinate. Po patvirtinimo papildinys sukuria lenteles ir stulpelius per API iškvietimus ir išsaugo deklaracijos failą, kurį naudoja 5 ir 6 veiksmai.

5 veiksmas: duomenų pavyzdžių įtraukimas (pasirinktinai)

Bėkite /add-sample-data , kad užpildytumėte lenteles bandomaisiais įrašais. Šiam veiksmui reikalingas duomenų modelis iš 4 veiksmo.

Papildinys atlieka šiuos veiksmus:

  1. Skaito deklaraciją, kad suprastų lenteles, stulpelius ir ryšius.
  2. Generuoja kontekstui tinkamas kiekvieno stulpelio tipo reikšmes, pvz., tikroviškus el. laiškus, tikėtinas datas ir suformatuotas valiutos sumas.
  3. Įterpia įrašus priklausomybės tvarka (pirminės lentelės prieš antrines lenteles) ir automatiškai atnaujina autentifikavimo atpažinimo ženklus masinio įterpimo metu.

6 veiksmas: integravimas su "Dataverse" žiniatinklio API

Vykdykite /integrate-webapi , kad pakeistumėte fiktyvius duomenis tiesioginėmis "Dataverse" užklausomis. Šiam veiksmui reikalingas duomenų modelis iš 4 veiksmo.

Papildinys atlieka šiuos veiksmus:

  1. Nuskaito kodų bazę, ieškodama komponentų, naudojančių fiktyvius duomenis, vietos rezervavimo ženklų gavimo skambučius arba užkoduotus masyvus. Ji susieja šiuos komponentus su jūsų "Dataverse" lentelėmis.
  2. Kiekvienai lentelei sukuria žiniatinklio API integravimo agentą, kuris sugeneruoja:
    • Bendras API klientas su apsaugos nuo klastojimo žetonų valdymu ir pakartotinių bandymų logika.
    • "TypeScript" objektų tipai ir domenų susiejimo priemonės.
    • CRUD paslaugų sluoksnis.
    • Specifiniai sistemos modeliai, pvz., "React" kabliukai, "Vue" komponuojami arba "Angular" paslaugos.
  3. Sukuria teisių architekto agentą, kuris siūlo lentelės teises ir svetainės parametrus.

Peržiūrite ir patvirtinate teisių pasiūlymą. Papildinys nesukuria jokių konfigūracijos failų, kol nepatvirtinate.

Pridėkite dirbtinio intelekto sugeneruotas santraukas (pasirinktinai)

Paleiskite /add-ai-webapi generatyvines AI santraukas ant žiniatinklio API integracijos. Šis įgūdis sujungia dvi peržiūros apibendrinimo API su įrašo informacijos ir sąrašo puslapiais:

  • Paieškos suvestinės API: pateikia dirbtinio intelekto sutrumpintą ieškos rezultatų suvestinę su citatomis.
  • Duomenų apibendrinimo API: pateikia "Dataverse" lentelės įrašo suvestinę arba sąrašo lygio įžvalgas.

Šis veiksmas grindžiamas 4 veiksmo duomenų modeliu ir 6 veiksmo žiniatinklio API integravimu. Papildinys atlieka šiuos veiksmus:

  1. Nuskaito jūsų kodą, ieškodamas suvestinių integravimo taškų, ir patvirtina tikslinius puslapius, lenteles ir kurias API naudoti.
  2. Perduoda visas trūkstamas žiniatinklio API būtinąsias sąlygas – lentelės teises, stulpelių sąrašus ir žiniatinklio vaidmenis – ir /integrate-webapi/create-webroles, kad būtų vienas teisių tiesos šaltinis.
  3. Sukuria dirbtinio intelekto žiniatinklio API integravimo agentą, kuris sukuria įvestą suvestinės paslaugą (aiSummaryService.ts) su apsaugos nuo klastojimo žetonų tvarkymu, konkrečiais sistemos įvyniojimais ("React hooks", "Vue" kompoziciniais arba "Angular" paslaugomis) ir laidinėmis skambučių svetainėmis tiksliniuose puslapiuose.
  4. Sukuria AI žiniatinklio API nustatymų architekto agentą, kuris sukuria Summarization svetainės parametrus raginimams ir turinio apribojimams.

Jūs peržiūrite ir patvirtinate pasiūlymus. Papildinys negeneruoja kodo ir nesukuria nustatymų, kol nepatvirtinate.

Pastaba.

Apibendrinimo API peržiūrimos ir priklauso nuo įjungtų administravimo ir svetainės lygio valdiklių. Jei po diegimo suvestinės nerodomos, patvirtinkite, kad funkcija įjungta naudojant atitinkamus svetainės parametrus ir administratoriaus valdiklius. Daugiau informacijos rasite Duomenų apibendrinimo API apžvalga ir Power Pages ieška naudojant generatyvinį AI.

7 veiksmas: žiniatinklio vaidmenų kūrimas

Paleiskite /create-webroles, kad apibrėžtumėte vartotojo access vaidmenis. Papildinys:

  1. Užklausia jūsų aplinkoje esamus žiniatinklio vaidmenis, kad būtų išvengta dublikatų.
  2. Generuoja vaidmenų apibrėžimus su unikaliais identifikatoriais.
  3. Užtikrina, kad kiekvienoje svetainėje būtų ne daugiau kaip vienas anoniminis vaidmuo ir vienas autentifikuotas vaidmuo.

8 veiksmas: nustatykite autentifikavimą

Vykdyti /setup-auth , kad į svetainę įtrauktumėte prisijungimo, atsijungimo ir vaidmenimis pagrįstos prieigos valdymą. Papildinys palaiko šiuos tapatybės teikėjus ir vienu metu galite konfigūruoti vieną ar kelis teikėjus.

Teikimo įrankis Geriausiai tinka
„Microsoft Entra“ išorinis ID (rekomenduojama klientams skirtose svetainėse) Viešosios svetainės ir klientų portalai su savitarnos registracija.
Microsoft Entra ID Vidiniai darbuotojų portalai arba verslas verslui (B2B) partnerių svetainės. "Power Pages" automatiškai sukonfigūruoja svetainės pirminį nuomotoją, todėl jums nereikia įvesti nuomotojo informacijos.
„Microsoft“, Facebook, Google Socialinis prisijungimas vartotojų auditorijoms.
Vietinis autentifikavimas Prisijungimas prie vartotojo vardo ir slaptažodžio. Nerekomenduojama ir sukonfigūruojama tik tada, kai to aiškiai prašote.

Daugiau informacijos apie palaikomus teikėjus, įskaitant protokolus ir konfigūracijos aspektus, rasite Autentifikavimo Power Pages apžvalga.

Papildinys:

  1. Analizuoja jūsų svetainę (tikslą, puslapius, auditoriją) ir siūlo protingą numatytąjį. Pavyzdžiui, papildinys siūlo "„Microsoft Entra“ išorinis ID" su atvira registracija klientui skirtoje svetainėje arba "Microsoft Entra ID" su registracija tik su kvietimu vidiniame portale. Jūs sutinkate su rekomendacija arba pasirenkate savo paslaugų teikėjus.
  2. Kiekvienam teikėjui pateikiami visi būtini tapatybės teikėjo administravimo centro veiksmai, pvz., nuomotojų kūrimas, programų registravimas, vartotojų srautų kūrimas ir klientų ID bei peradresavimo URI fiksavimas. Papildinys patvirtina kiekvieną reikšmę, kurią įklijuojate atgal į pokalbį, ir apskaičiuoja tikslų svetainės peradresavimo URI, kad į programos registraciją įklijuota reikšmė atitiktų svetainės nustatymuose įrašytą reikšmę.
  3. Klausiama, kaip vartotojo profilio duomenys turėtų būti perduodami iš tapatybės teikėjo į "Dataverse" kontakto įrašą (pretenzijų susiejimas), ar sinchronizuoti kiekvieną kartą prisijungus arba tik pirmą kartą prisijungus ir ar automatiškai susieti išorinius prisijungimus su esamais kontaktais el. paštu.
  4. Generuoja autentifikavimo paslaugą, tipų deklaracijas, vaidmenimis pagrįstas autorizavimo priemones (hasRole, RequireAuth, RequireRole), seanso palaikymo kabliuką, kuris neleidžia tyliai pasibaigti SPA seansams, ir prisijungimo / atsijungimo vartotojo sąsajos komponentą, integruotą į jūsų svetainės maketą. Papildinys naudoja jūsų sistemos modelius, pvz., "React" kabliukus, "Vue" komponuojamus failus, "Angular" paslaugas arba "Astro" komponentus.
  5. Kai sukonfigūruotas daugiau nei vienas teikėjas, sugeneruojamas /login pasirinktas maketas: horizontali eilutė, vertikali rietuvė, pagrindinis prožektorius arba skirtukas.
  6. Įrašo atitinkamus svetainės parametrus kiekvienam .powerpages-site/site-settings/ teikėjui, registracijos režimui, pretenzijų susiejimui ir pasirenkamai funkcijai.

Papildinys taip pat sukonfigūruoja šias pasirenkamas funkcijas, kai jas įjungiate:

  • Taisyklės ir sąlygos: SPA puslapis /terms , kurį naudotojai turi sutikti prieš prisijungdami, taip pat atitinkamas svetainės nustatymas ir turinio fragmentai.
  • Vartotojo profilio puslapis: /user-profile SPA puslapis, kuriame prisijungę vartotojai redaguoja savo kontaktinę informaciją naudodami Power Pages žiniatinklio API.
  • Susietasis atsijungimas: taip pat atsijungia vartotojas iš tapatybės teikėjo, kai jis atsijungia nuo svetainės, naudojant bendrinamus įrenginius arba reguliuojamus scenarijus.

Arbatpinigiai

Norėdami įtraukti antrą tapatybės teikėją į esamą svetainę, paleiskite /setup-auth dar kartą. Papildinys aptinka, kas jau sukonfigūruota, ir siūlo pridėti naują teikėją neperrašant esamų. Šis metodas naudingas papildomiems scenarijams, pvz., pradedant nuo "„Microsoft Entra“ išorinis ID" ir vėliau pridedant "Google" prisijungimui prie socialinių tinklų.

Pastaba.

Kliento autorizacija (RequireAuth, RequireRole, hasRole) skirta tik vartotojo patirčiai. Jis kontroliuoja, ką mato vartotojas. Serverio lentelės teisės, sukonfigūruotos įgalinant /integrate-webapi faktinę saugą.

9 veiksmas: pridėkite serverio logiką

Vykdykite /add-server-logic , kad į svetainę įtrauktumėte saugius serverio galinius punktus. Naudokite serverio logiką , kai jūsų svetainei reikia logikos, kurios negalima paleisti naršyklėje, pvz., išorinių API iškvietimų, serverio tikrinimo, slapto valdymo arba kelių objektų duomenų operacijų.

Svarbu

Serverio logikos palaikymui reikalinga PAC CLI 2.6.3 arba naujesnė versija. Naudokite greitojo diegimo scenarijų , kad atnaujintumėte į naujausią versiją.

Apibūdinkite, ko jums reikia paprasta kalba ir papildinį:

  1. Sukuria serverio logikos architekto agentą, kuris analizuoja jūsų naudojimo atvejį ir klasifikuoja jo sudėtingumą.
  2. Siūlo galinio punkto dizainą, saugos konfigūraciją ir visas reikalingas lentelės teises peržiūrai.
  3. Patvirtinus, sugeneruojamas serverio "JavaScript" galinis punktas adresu /_api/serverlogics/<name>.
  4. Sukuria įvestą kliento paslaugą, kad iškviestų galinį punktą iš jūsų komponentų.
  5. Atnaujina komponentus, kad būtų galima iškviesti naują tarnybą.
  6. Konfigūruoja žiniatinklio vaidmenų priskyrimus ir galinio punkto lentelės teises.

Jūs peržiūrite ir patvirtinate pasiūlymą. Joks kodas negeneruojamas, kol nepatvirtinate.

Dažniausi naudojimo atvejai:

Pastaba.

Paleiskite /add-server-logic vieną kartą kiekvienam naudojimo atvejui. Pavyzdžiui, jei jūsų svetainei reikia ir atsargų tikrinimo galinio punkto, ir visuotinės ieškos galinio punkto, paleiskite įgūdį du kartus.

10 veiksmas: debesies srautų integravimas

Paleiskite /add-cloud-flow, kad į svetainę integruotumėte esamus Power Automate debesies srautus. Šis įgūdis sujungia jūsų "Power Pages" svetainę su srautais, kuriuos jau sukūrėte "Power Automate". Tai nesukuria naujų debesų srautų.

Papildinys:

  1. Registruoja esamą debesies srautą jūsų svetainėje.
  2. Generuoja kliento pusės kodą, kad suaktyvintų srautą iš jūsų puslapių.
  3. Tvarko asinchroninę darbo eigos būseną ir atgalinio iškvietimo modelius.
  4. Sujungia duomenų mainus tarp puslapio ir srauto.

Naudokite /add-cloud-flow patvirtinimo darbo eigoms, el. pašto pranešimams, suplanuotoms užduotims ir įvykiais pagrįstam automatizavimui, kuriuos geriau tvarko Power Automate nei serverio galiniai punktai.

Alternatyva: naudokite /integrate-backend, kad suplanuotumėte visą paslaugų sluoksnį

Jei nesate tikri, kurioms funkcijoms reikia žiniatinklio API, serverio logikos ar debesies srauto, vykdykite /integrate-backend , o ne rankiniu būdu vykdykite 4–10 veiksmus. Šis įgūdis veikia kaip orkestruotojas, kuris:

  1. Analizuoja jūsų prototipą, kad nustatytų visas funkcijas, kurioms reikalingas aptarnavimo sluoksnis.
  2. Kiekviena funkcija klasifikuojama pagal tinkamą metodą: žiniatinklio API standartiniam CRUD, serverio logika serverio patvirtinimui ir išorinėms API arba debesies srautas patvirtinimo darbo eigoms ir automatizavimui.
  3. Siūlo sekos vykdymo planą su visais įgūdžiais, priklausomybėmis ir konfigūracijomis.
  4. Po to, kai patvirtinsite, orkestruokite įgūdžius teisinga tvarka.

Planas yra nuolatinis, atnaujinamas ir redaguojamas. Sustokite po bet kurio veiksmo, kad peržiūrėtumėte sugeneruotą kodą arba išbandytumėte svetainę, ir tęskite ten, kur baigėte, vėl paleisdami /integrate-backend .

11 veiksmas: pridėkite SEO

Paleiskite /add-seo optimizuoti savo svetainę paieškos sistemoms. Papildinys:

  1. Aptinka maršrutus iš sistemos maršrutizatoriaus konfigūracijos.
  2. Generuoja paieškos sistemų direktyvas ir visų atrastų maršrutų svetainės žemėlapį.
  3. Prideda meta žymes: peržiūros sritį, simbolių rinkinį, aprašą, Open Graph, Twitter kortelę ir favicon nuorodas.

12 veiksmas: galutinės svetainės diegimas

Jei atliksite kokius nors pasirenkamus veiksmus, paleiskite /deploy-site dar kartą, kad pakeitimai būtų paleisti tiesiogiai. Papildinys paleidžia gamybinę komponavimo versiją ir įkelia svetainę kartu su visais diegimo artefaktais (lentelės teisėmis, svetainės parametrais, žiniatinklio vaidmenimis, serverio loginiais failais) į jūsų "Power Pages" aplinką.

13 veiksmas: saugos peržiūros vykdymas

Vykdykite /security-review , kad prieš pradėdami gaminti atliktumėte išsamią svetainės saugos peržiūrą. Šis įgūdis sujungia sutelktus saugos įgūdžius ir sujungia kiekvieną radinį į vieną HTML ataskaitą docs/security-review-<timestamp>.htmladresu .

Papildinys užduoda vieną paprastą klausimą apie jūsų tikslą ir pasirenka atitinkamą sutelktų įgūdžių rinkinį:

Tikslas Ką ji tikrina
Kodas ir konfigūracija Šaltinio kodas, priklausomybės, lentelės teisės ir autentifikavimo konfigūracija. Veikia tik su vietiniais failais - nereikia diegti.
Pasirengimas išleisti (rekomenduojama) Išsami apžvalga prieš paskelbiant. Paleidžia visus sutelktus įgūdžius: kodą ir priklausomybes, įdiegtos svetainės nuskaitymą, naršyklės saugos antraštes, žiniatinklio programų užkardą, lentelės teises ir autentifikavimą.
Įdiegta svetainė Tik tiesioginis įdiegtos svetainės nuskaitymas. Naudinga nuolatiniam paskelbtos svetainės stebėjimui.

Patvirtinus, papildinys lygiagrečiai paleidžia atitinkamus įgūdžius ir įrašo jų išvadas į vieną ataskaitą:

  • /scan-code: Vykdo statinę analizę (opengrep) ir priklausomybės nuskaitymą (trivy) vietiniuose šaltinio failuose. Iškyla kodo modeliai, pažeidžiami paketai, užkoduotos paslaptys ir licencijų problemos. Jei kuris nors įrankis neįdiegtas, įgūdis siūlo rankinę kodo peržiūrą kaip atsarginę priemonę.
  • /scan-site: pradeda serverio saugos nuskaitymą tiesioginėje svetainėje ir gauna naujausią ataskaitą. Nuskaitymo trukmė priklauso nuo svetainės dydžio - mažos svetainės baigiasi per kelias minutes, didelės svetainės gali užtrukti kelias valandas. Išvados sugrupuotos pagal sunkumą. Reikalinga įdiegta svetainė.
  • /manage-headers: tikrina HTTP saugos antraštes, sukonfigūruotas dalyje .powerpages-site/site-settings/: Turinio saugos strategija, X-Frame-Options, CORS, slapukas SameSite ir susiję parametrai. Nustato trūkstamas arba silpnas reikšmes ir siūlo rekomenduojamas numatytąsias reikšmes.
  • /manage-firewall: tikrina gamybos vietos žiniatinklio programų užkardą (WAF), įskaitant valdomos taisyklės būseną ir pasirinktines taisykles (IP blokus, šalių blokus, kelio blokus, spartos apribojimus). Prieinama tik palaikomų regionų gamybos vietose; Įgūdis aptinka ir praneša apie tinkamumo problemas.
  • /audit-permissions: tikrina esamas lentelės teises pagal svetainės kodą ir "Dataverse" metaduomenis. Išryškėja trūkstami leidimai, pernelyg leistini vaidmenys, nenaudojami leidimai ir YAML schemos problemos.

Konsoliduotoje ataskaitoje išvados sugrupuojamos pagal sekciją, atidaromos numatytojoje naršyklėje ir pateikiamos taisymo gairės paprasta kalba. Iš pokalbio papildinys siūlo peržiūrėti pataisymus - pasirinkite radinį, o papildinys interaktyviai iškviečia atitinkamą įgūdį, kad pritaikytų pakeitimą.

Pastaba.

Saugos peržiūra niekada netaiko pakeitimų automatiškai. Kiekvienas sutelktas įgūdis veikia tik skaitymo peržiūros režimu konsoliduoto vykdymo metu. Norėdami pritaikyti pataisymą, papildinys interaktyviai iškviečia atitikimo įgūdį, kai pasirenkate veiksmą.

Arbatpinigiai

Taip pat galite savarankiškai paleisti bet kurį sutelktą įgūdį:

  • Paleiskite /scan-code kūrimo metu, kad anksti pastebėtumėte kodo lygio problemas.
  • Paleiskite /manage-headers , kad ištaisytumėte konkrečią turinio saugos politikos klaidą arba nustatytumėte CORS.
  • Vykdyti /manage-firewall , kad prisijungimo puslapyje pridėtumėte greičio apribojimą arba blokuotumėte srautą pagal šalį.
  • Paleiskite /audit-permissions pakeitę lentelės teises, kad patikrintumėte, ar jie vis dar atitinka svetainės kodą.
  • Paleiskite /security-review iš naujo naudodami tikslą Įdiegta svetainė , kad laikui bėgant stebėtumėte gamybos vietą.

Svetainės patvirtinimas

Baigę įgūdžius, patikrinkite, ar "Power Pages" svetainė veikia tinkamai.

  1. Eikite į Power Pages.
  2. Raskite svetainę sąraše Aktyvios svetainės .
  3. Peržiūrėkite svetainę darbalaukyje naudodami parinktį Peržiūra .
  4. Išbandykite funkcionalumą.

Svetainės reklamavimas įvairiose aplinkose

Kai svetainė veikia kūrimo aplinkoje, naudokite programos ciklo valdymo (ALM) įgūdžius, kad paskatintumėte ją testavimo ir gamybos aplinkoje. Papildinys supakuoja jūsų svetainę kaip "Power Platform" sprendimą, nustato reikšmes, kurios skiriasi įvairiose aplinkose, ir diegia sprendimą per "Power Platform Pipelines" arba rankiniu būdu eksportuojant ir importuojant.

Norint naudoti ALM įgūdžius, taip pat reikia bent vienos tikslinės "Power Platform" aplinkos (testavimo, gamybos arba abiejų). Norėdami naudoti pasirenkamą "Azure Key Vault" srautą paslapčioms, taip pat reikia leidimo sukurti raktų saugyklą "Azure" prenumeratoje.

Diegimo planavimas

Bėk /plan-alm , kad pradėtum. /plan-alm yra ALM įėjimo taškas ir orkestruoja kitus ALM įgūdžius, todėl paprastai jų tiesiogiai nenaudojate. Papildinys:

  1. Aptinka dabartinę projekto, sprendimo ir tikslinių aplinkų būseną.
  2. Klausiama apie jūsų reklamos strategiją ("Power Platform" vamzdynai arba neautomatinis eksportavimas ir importavimas), tikslinius etapus ir visus taikytinus apribojimus.
  3. Sukuria vaizdinį planą docs/alm-plan.html , kuriame rodomi visi veiksmai, kurių ketinama imtis.
  4. Laukia jūsų patvirtinimo prieš paleisdamas bet kokį pasroviui įgūdį.

Planas išlieka diske, todėl kiekvienas pasroviui įgūdis skaito ir rašo į tą patį išliekantį planą. Jei fazė nepavyksta, paleiskite /plan-alm dar kartą ir ji tęsiasi nuo tos vietos, kur sustojo.

Sprendimo kūrimas

Paleiskite /setup-solution , kad supakuotumėte svetainę kaip "Power Platform" sprendimą. Papildinys:

  1. Sukuria leidėją ir sprendimą, tada įtraukia "Power Pages" komponentus: svetainę, žiniatinklio vaidmenis, serverio loginius galinius punktus, debesies srauto registracijas ir "OAuth" teikėjo parametrus.
  2. Klasifikuoja kiekvieną svetainės parametrą pagal jautrumą ir siūlo aplinkos kintamuosius reikšmėms, kurios skiriasi įvairiose aplinkose.
  3. Siūlo parengti Azure Key Vault ir jame saugoti kredencialų tipo reikšmes, pvz., ryšio eilutes ir API raktus.
  4. Veikia sinchronizavimo režimu, kai jūsų svetainėje jau yra sprendimas, kad būtų galima suderinti komponentus nesukuriant naujo sprendimo.

Jūs peržiūrite ir patvirtinate pasiūlymą. Papildinys nesukuria jokios konfigūracijos, kol nepatvirtinate.

Arbatpinigiai

Jei jūsų sprendimas yra per didelis arba susipainiojęs, kad jį būtų galima patikimai įdiegti, papildinys rekomenduoja padalinti ir pasiūlo, kur jį padalinti. Patvirtinkite padalijimą prieš pradedant taikyti pakeitimus.

Diegimas naudojant "Power Platform" vamzdynus

Jei pasirinkote "Power Platform Pipelines" kaip reklamos strategiją, papildinys vykdo šiuos įgūdžius:

  1. /ensure-pipelines-host teikia arba aptinka "Power Platform Pipelines" pagrindinę aplinką. Įgūdis pasirenka mažiausią nuomotojui prieinamą parinktį: nemokamą platformos pagrindinį kompiuterį, "Pipelines" programą esamoje aplinkoje arba pasirinktinį pagrindinį kompiuterį.
  2. /setup-pipeline užregistruoja srauto apibrėžimą "Dataverse", sukonfigūruoja pasirinktus etapus ir susieja kiekvieną etapą su tiksline aplinka.
  3. /deploy-pipeline Suaktyvina etapo diegimą, taiko kiekvieno etapo aplinkos kintamųjų perrašymus per deploymentSettings.jsonir seka būseną diegimo knygoje.

Jei diegimas nepavyksta, nes tikslinė aplinka jau susieta su kitu "Power Platform Pipelines" pagrindiniu kompiuteriu, papildinys gali būti paleistas /force-link-environment ir jį priskirti iš naujo. Veiksmui reikalingas aiškus jūsų sutikimas ir jis yra atšaukiamas.

Diegimas naudojant rankinį eksportavimą ir importavimą

Jei pasirinksite rankinį kelią, papildinys veikia:

  1. /export-solution , kad eksportuotumėte sprendimą kaip valdomąjį arba nevaldomąjį ZIP, prieš eksportuodami patikrinkite išsamumą.
  2. /import-solution importuoti ZIP į tikslinę aplinką, etapais patikrinti priklausomybes pirmiausia arba tiesiogiai.

Įdiegtos svetainės aktyvinimas ir tikrinimas

Sėkmingai įdiegus tikslinėje aplinkoje, papildinys:

  1. Vykdoma /activate-site , kad būtų parengtas viešasis URL paskirties aplinkoje.
  2. Vykdoma /test-site siekiant patikrinti diegimą. Papildinys naudoja naršyklę reprezentatyviems puslapiams tikrinti, vaidmenimis pagrįstiems prieigos patikrinimams atlikti, skambučiams tikrinti /_api/ ir atsakymų /_api/serverlogics/ formoms iš galinių punktų fiksuoti. Įgūdis praneša rezultatą kaip PASS, WARNINGSarba FAIL, su kiekvieno čekio informacija, susieta su planu.

Jei veiksmas nepavyksta, papildinys paleidžiamas /diagnose-deployment. Įgūdis suderina gedimą su žinomų diegimo klaidų katalogu, pvz., pasenusiu manifestu, trūkstamomis priklausomybėmis, pagrindinio kompiuterio konfliktais, užblokuotu JavaScript arba pasibaigusiu autentifikavimu, ir siūlo konkretų pataisymą. Papildinys niekada netaiko pataisymo be jūsų sutikimo.

Pastaba.

Kiekvienas ALM įgūdis skaito ir rašo į artefaktus diske: sprendimo manifestą, plano duomenis, vamzdyno knygą, diegimo knygą ir bandymų rezultatus. Orkestravimas yra atnaujinamas ir audituojamas. Norėdami pamatyti, kas nutiko bet kuriame žingsnyje, apžiūrėkite artefaktus.

Patarimai ir geriausia praktika

Šie patarimai padės išnaudoti visas papildinio ir dirbtinio intelekto kodavimo agento galimybes kuriant "Power Pages" svetaines.

Stebėkite trūkstamų įrankių terminalo išvestį pirmą kartą paleidus

Papildinys suteikia įgūdžių ir darbo eigos, tačiau dirbtinio intelekto kodavimo agentas – "GitHub Copilot CLI" arba "Claude Code" – vykdo tikrąsias komandas jūsų kompiuteryje. Kai naudojate šiuos įrankius pirmą kartą, atidžiai stebėkite terminalo išvestį. AI kodavimo agentas vykdo komandas ir scenarijus užkulisiuose, o kai kurios iš šių komandų priklauso nuo įrankių, kurie gali būti neįdiegti jūsų kompiuteryje. Jei veiksmas nepavyksta, terminalo išvestis paprastai rodo, kurio įrankio ar komandos nepavyko rasti.

Jei matote klaidą, pvz. command not found , arba is not recognized, įdiekite trūkstamą įrankį ir iš naujo suaktyvinkite darbo eigą. Dirbtinio intelekto kodavimo agentas tęsia darbą ten, kur baigė, kai įrankis bus prieinamas.

Prieš patvirtindami agentų pasiūlymus peržiūrėkite

AI kodavimo agentas pateikia pasiūlymus, pvz., duomenų modelio architekto ir leidimų architekto, prieš atlikdamas pakeitimus. AI kodavimo agento sugeneruotas kodas ir konfigūracija gali būti netikslūs, todėl peržiūrėkite, išbandykite ir patvirtinkite kiekvieną pasiūlymą ir visą sugeneruotą kodą prieš patvirtindami ar diegdami.

  • Duomenų modelio pasiūlymai: patikrinkite, ar lentelių pavadinimai, stulpelių tipai ir ryšiai atitinka jūsų verslo reikalavimus. Lengviau koreguoti pasiūlymą, nei pervardyti stulpelius, kai duomenys jau įterpti.
  • Leidimų pasiūlymai: patikrinkite, ar kiekvienas vaidmuo turi tinkamą kiekvienos lentelės access lygį (kurti, skaityti, atnaujinti, naikinti). Pernelyg leistinos lentelės teisės yra dažna saugos rizika.
  • Sugeneruotas kodas: prieš diegdami perskaitykite sugeneruotą kodą ir išbandykite svetainę vietoje. Dirbtinio intelekto sugeneruotame kode gali būti klaidų ar saugumo problemų.

Įklijuokite klaidas tiesiogiai su kontekstu

Kai kas nors nepavyksta, nesvarbu, ar tai būtų kūrimo klaida, diegimo klaida ar vykdymo laiko išimtis naršyklėje, nukopijuokite visą klaidos išvestį. Įklijuokite jį kartu su trumpu aprašymu, ką darėte. Kuo daugiau konteksto pateiksite, tuo greičiau pataisysite.

Pavyzdys: kūrimo klaida

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>

Arbatpinigiai

Įtraukite failo vardą, vykdomą komandą ir tai, ko tikėjotės. Papildinys naudoja šį kontekstą, kad nustatytų problemą ir pritaikytų tikslinį pataisymą, o ne spėliotų.

Bendrinkite žiniatinklio API klaidas su visu užklausos URL

Dažna problema po diegimo yra 403 klaida iš Power Pages žiniatinklio API, kai stulpelyje neįgalinta API prieiga. Kai susiduriate su šia klaida, įklijuokite visą API URL ir visą JSON klaidos atsakymą. Klaidos pranešime tiksliai nurodoma, kurią lentelę ir stulpelį reikia pataisyti, o papildinys gali atnaujinti lentelės leidimą YAML ir svetainės nustatymus.

Pavyzdys: stulpelis neįgalintas žiniatinklio 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"
    }
  }
}

Ši klaida (AttributePermissionIsMissing) reiškia, kad peržvalgos stulpelis _crd50_propertyid_value yra "Dataverse" lentelėje, bet nėra įtrauktas į žiniatinklio API lentelės teisių konfigūraciją. Papildinys išsprendžia šią klaidą pridėdamas trūkstamą stulpelį prie lentelės leidimo YAML ir .powerpages-site/table-permissions/ iš naujo įdiegdamas.

Pastaba.

"Power Pages" žiniatinklio API reikalauja, kad kiekvienas stulpelis, kurį grąžina API iškvietimas, būtų aiškiai nurodytas lentelės teisėse. Peržvalgos ypatybes (priešdėlis ir _ priesaga _value) lengva praleisti, nes jų API pavadinimas skiriasi nuo loginio stulpelio pavadinimo "Dataverse". Kai matote AttributePermissionIsMissing, visada įtraukite tą stulpelį į lentelės teises. Nekeiskite API užklausos.

Konkrečiai nurodykite, ko norite

Neaiškios užklausos duoda neaiškius rezultatus. Tiksliai nurodykite papildiniui, ko jums reikia, įskaitant išdėstymo nuostatas, duomenų laukus ir elgesį.

Vietoj to Bandyti
"Sukurkite puslapį darbams" "Sukurkite darbo skelbimų puslapį su paieškos juosta viršuje, filtruokite lustus pagal vietą ir skyrių bei kortelių tinklelį, kuriame rodomas pavadinimas, įmonė, atlyginimo diapazonas ir kiekvieno darbo paskelbimo data"
"Pataisykite stilių" "Darbo kortelės sukrautos vertikaliai darbalaukyje. Padarykite juos rodomi trijų stulpelių tinklelyje su 16px tarpu ekranuose, platesniuose nei 768px"
"Pridėti kai kuriuos duomenis" "Pridėkite 20 darbo skelbimų pavyzdžių keturiuose skyriuose (inžinerijos, rinkodaros, pardavimų, žmogiškųjų išteklių) su realistiškais pavadinimais, atlyginimų diapazonais nuo 60 iki 180 tūkstančių dolerių ir paskelbtomis datomis per pastarąsias 30 dienų"
"Nustatykite API" "Prijunkite komponentą JobListings prie cr_jobposting Dataverse" lentelės. Pakeiskite užkoduotą masyvą tikru API iškvietimu, kuris gauna pavadinimą, skyrių, atlyginimą ir paskelbimo datą"
"Pridėti prisijungimą" "Nustatykite "„Microsoft Entra“ išorinis ID" prisijungimą su atvira registracija ir "Google" kaip antrąjį teikėją. Rodyti juos kaip horizontalią eilutę prisijungimo puslapyje."

Ekrano kopijų naudojimas esant regėjimo problemoms spręsti

Kai svetainė naršyklėje neatrodo tinkamai, padarykite ekrano kopiją ir įklijuokite ją tiesiai į pokalbį arba nurodykite failo kelią. Vaizdinis kontekstas padeda nustatyti išdėstymo, tarpų ir stiliaus problemas, kurias sunku apibūdinti tekste.

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.

Kartokite mažais žingsneliais

Užuot aprašę visą svetainę vienu raginimu, kurkite palaipsniui. Pradėkite nuo struktūros ir išdėstymo, tada pridėkite funkcijų po vieną. Šis metodas suteikia jums galimybę peržiūrėti ir koreguoti kursą kiekviename žingsnyje.

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

Arbatpinigiai

Po kiekvieno veiksmo patikrinkite naršyklės peržiūrą. Jei kažkas negerai, pataisykite tai prieš tęsdami. Lengviau išspręsti vieno komponento problemas, nei išnarplioti problemas visoje svetainėje.

Prieš patvirtindami paprašykite paaiškinimo

Jei nesate tikri dėl siūlomo pakeitimo, ypač dėl leidimų, duomenų modelio pakeitimų ar autentifikavimo konfigūracijos, prieš patvirtindami paprašykite papildinio paaiškinti, ką jis planuoja to do ir kodėl.

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

Savarankiškai vykdykite įgūdžius, kad atsigautumėte po problemų

Jei įgūdis nepavyksta pusiaukelėje, jums nereikia pradėti iš naujo. Kiekvienas įgūdis veikia savarankiškai ir gali tęsti ten, kur baigėsi. Pavyzdžiui, jei /integrate-webapi nepavyksta trečioje lentelėje, galite ją paleisti iš naujo ir ji aptiks jau atliktą darbą.

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

Susijęs turinys

  • Last updated on