Hasi Power Pages pluginarekin GitHub Copilot CLI eta Claude Code-rako

GitHub Copilot CLI< / c0> eta Claude Code< / c1> Power Pages lan-fluxua eskaintzen du orrialde bakarreko aplikazio (SPA) gune modernoak sortzeko, hedatzeko eta kudeatzeko Power Pages. Eskuz aldamioak egin beharrean, boilerplate API kodea idatzi eta baimenak konfiguratu beharrean, deskribatu nahi duzuna hizkuntza naturalean, eta pluginak kudeatzen du inplementazioa.

Pluginak gunearen garapenaren bizi-ziklo osoa onartzen du elkarrizketa-trebetasunen bidez, gune berri bat zabalduz, Dataverse datu-ereduak ezartzeko eta autentifikazioa konfiguratzeko.

Aurrebaldintzak

Hasi aurretik, egiaztatu beharrezko softwarea eta baimenak dituzula.

Softwarearen eskakizunak

Zuk ere behar duzu:

• Power Platform-eko ingurunea, Power Pages gaituta duena.
• Helburuko ingurunearekin konektatutako PAC CLI saio autentifikatua. Exekutatu pac auth create oraindik konektatu ez bazara.
• Azure CLI saioa maizter berean saioa hasi da. Exekutatu az login --allow-no-subscriptions autentifikatzeko.

Egiaztatu autentifikazioa:

Egiaztatu autentifikatuta zaudela komandoa erabiliz pac auth list .

pac auth list           # Should show authenticated profile

Authentifikatuta ez bazaude, exekutatu komando hau:

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

Instalatu plugina

Instalatu Power Pages plugina merkatutik. CLI GitHub Copilot erabiltzen baduzu, ikus Copilot CLI hedapenen dokumentazioa instalazio urrats baliokideak lortzeko. Ondorengo komandoek Claude Code-ren sintaxia erabiltzen dute.

Instalazio azkarra (gomendagarria)

Exekutatu instalatzailea eguneratze automatikoa gaituta duten plugin guztiak konfiguratzeko:

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

Instalatzailea automatikoki:

• CLIa pac instalatzen du, dagoeneko instalatuta ez badago.
• Erabilgarri dauden tresnak detektatzen ditu, hala nola Claude Code eta GitHub Copilot CLI.
• Pluginen merkatua erregistratzen du eta zerrendatutako plugin guztiak instalatzen ditu.
• Eguneratze automatikoa gaitzen du, pluginak eguneratuta egon daitezen.

Instalatu ondoren, berrabiarazi Claude Code edo GitHub Copilot CLI pluginaren trebetasunak agentearen saioan barra komando gisa sartzeko.

Instalatu merkatutik

1. Ireki Claude Code zure terminalean.

2. Gehitu Microsoft merkatua:

   /plugin marketplace add microsoft/power-platform-skills
   

3. Instalatu Power Pages plugina:

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

Plugina instalatu ondoren, berrabiarazi Claude Code edo GitHub Copilot CLI, pluginaren trebetasunetara sartzeko agentearen saioan.

Gaitasunen ikuspegi orokorra

Pluginak Power Pages gune baten bizi-ziklo osoa estaltzen duten trebetasunak eskaintzen ditu. Deitu trebetasun bakoitza elkarrizketan, bai barra komando gisa edo zer egin nahi to do deskribatuz.

Lan-fluxu tipikoa

Muturreko lan-fluxu arrunt batek sekuentzia hau jarraitzen du:

1. /create-site : Aldamioa, diseinua eta eraikuntza orriak
2. /deploy-site : Kargatu zure Power Pages ingurunera
3. /activate-site : Konfiguratu URL publikoa
4. /setup-datamodel : Sortu Dataverse-ren taulak
5. /add-sample-data : Bete taulak proba-erregistroekin
6. /integrate-webapi : Sortu API bezeroaren kodea eta konfiguratu baimenak
7. /create-webroles : Definitu access rolak
8. /setup-auth : Gehitu saioa hastea, saioa amaitzea eta roletan oinarritutako interfazea
9. /add-server-logic : Gehitu zerbitzariaren aldeko amaiera-puntu seguruak
10. /add-cloud-flow : Integratu lehendik dauden Power Automate fluxuak
11. /add-seo : Bilaketa-motoreen optimizazioa
12. /deploy-site : Bultzatu azken aldaketak zuzenean
13. /segurtasun-berrikuspena : Ekoizpenera joan aurretik amaieratik amaierara segurtasun berrikuspen bat egin
14. /plan-alm : Zure gunea proba eta produkzio inguruneetan sustatu

Eraiki zure Power Pages gunea

Ibilbide honek Power Pages gune bat pluginarekin eraikitzearen bizi-ziklo osoa estaltzen du, aldamiotik hedapenera arte. Urrats bakoitzak esaten duzuna eta pluginak erantzuteko zer egiten duen deskribatzen du.

1. urratsa: Sortu zure webgunea

Deskribatu nahi duzun gunea hizkuntza naturalean: zertarako balio duen, zer orrialde behar dituen eta diseinu-lehentasunak, hala nola kolore eskema, diseinu estiloa edo letra-tipoak. Exekutatu /create-site edo deskribatu zure webgunea eta pluginak asmoa aitortuko du.

Esparrurik zehazten ez baduzu, pluginak bat aukeratzeko eskatzen dizu (React, Vue, Angular edo Astro), ondoren:

1. Scaffolds the project from a template from a and apply your site name, colors, and design tokens.
2. Mendekotasunak instalatzen ditu, garapen-zerbitzari bat abiarazten du eta zuzeneko arakatzailearen aurrebista irekitzen du.
3. Eskatu duzun orri, osagai eta ibilbide bakoitza irudi garrantzitsuekin eraikitzen du.
4. Git commits mugarri esanguratsuetan sortzen ditu, rollback historia integratua izan dezazun.

2. urratsa: Zabaldu zure webgunea

Exekutatu /deploy-site zure webgunea Power Pages igotzeko. Plugina:

1. PAC CLI instalatuta dagoela eta autentifikazio-saioa aktibo dagoela egiaztatzen du.
2. Helburuko ingurunea zurekin baieztatzen du aurrera jarraitu aurretik.
3. Ekoizpen-eraikuntza exekutatzen du eta konpilatutako irteera igotzen du.
4. Deploy artifacts direktorio bat sortzen du, dagoeneko existitzen ez bada.

3. urratsa: Aktibatu zure webgunea

Webgunea /activate-site publikoki eskuragarri jartzeko. Plugina:

1. Zure webgunearen izenean oinarritutako azpidomeinu bat iradokitzen du eta pertsonalizatzeko aukera ematen dizu.
2. Webgunearen erregistroa Power Platform APIaren bidez hornitzen du.
3. Inkestak egiten ditu webgunea martxan jarri arte eta URL publikoa itzuli arte.

Une honetan, URL publiko batean lan egiteko gune bat duzu. Gainerako urratsek datuak, autentifikazioa eta SEO gehitzen dituzte. Saltatu zure webgunean aplikatzen ez diren urratsak.

4. urratsa: Konfiguratu zure datu-eredua

Exekutatu /setup-datamodel zure webguneak behar dituen Dataverse taulak sortzeko. Dagoeneko ER diagrama edo eskema espezifiko bat baduzu, eman zuzenean agenteak zure kodea aztertu beharrean.

Pluginak Data Model Architect agentea sortzen du:

1. Zure webgunearen kodea aztertzen du orrialdeek eta osagaiek zer datu behar dituzten zehazteko.
2. Dataverse inguruneari kontsulta egiten dio lehendik dauden taulak bilatzeko, bikoizketak saihesteko.
3. Taulak, zutabeak, datu motak eta erlazioak dituen datu-eredu bat proposatzen du, ER diagrama gisa bistaratuta.

Proposamena aztertu eta onartu behar duzu. Pluginak ez du ezer sortzen baieztatu arte. Onartu ondoren, pluginak taulak eta zutabeak sortzen ditu API deien bidez eta 5. eta 6. urratsek erabiltzen duten manifestu fitxategi bat gordetzen du.

5. urratsa: Gehitu datuen adibidea (aukerakoa)

Exekutatu /add-sample-data taulak probako erregistroekin betetzeko. Urrats honek 4. urratseko datu-eredua behar du.

Pluginak ekintza hauek egiten ditu:

1. Manifestua irakurtzen du zure taulak, zutabeak eta harremanak ulertzeko.
2. Zutabe mota bakoitzerako testuinguru egokiak diren balioak sortzen ditu, hala nola mezu elektroniko errealistak, data sinesgarriak eta formateatutako moneta zenbatekoak.
3. Erregistroak mendekotasun-ordenan txertatzen ditu (taula gurasoak taula umeen aurretik) eta autentifikazio-tokenak automatikoki freskatzen ditu txertaketa masiboetan.

6. urratsa: Dataverse Web APIarekin integratzea

Exekutatu /integrate-webapi datu faltsuak Dataverse kontsulta zuzenekin ordezkatzeko. Urrats honek 4. urratseko datu-eredua behar du.

Pluginak ekintza hauek egiten ditu:

1. Zure kode-basea eskaneatzen du datu faltsuak, leku-markak eskuratzeko deiak edo kodetutako matrizeak erabiltzen dituzten osagaien bila. Osagai horiek Dataverse-ren tauletara mapatzen ditu.
2. Web APIen integrazio-agente bat sortzen du taula bakoitzerako:
   • API bezero partekatua, faltsutzearen aurkako tokenen kudeaketa eta berriro saiakera logika.
   • TypeScript entitate motak eta domeinu-mapatzaileak.
   • CRUD zerbitzu-geruza.
   • Esparru espezifiko ereduak, hala nola React kakoak, Vue konposagarriak edo Angular zerbitzuak.
3. Taularen baimenak eta gunearen ezarpenak proposatzen dituen Permissions Architect agente bat sortzen du.

Baimenen proposamena aztertu eta onartzen duzu. Pluginak ez du konfigurazio-fitxategirik sortzen baieztatu arte.

AI-k sortutako laburpenak gehitu (Aukerakoa)

Sortu /add-ai-webapi AI laburpenak zure Web APIaren integrazioaren gainean geruzatu. Gaitasunak bi aurrebista laburpen API lotzen ditu zure erregistro-xehetasun eta zerrenda orriekin:

• Bilaketa laburpen APIa: Bilaketa-emaitzen AI bidez laburtutako laburpena itzultzen du, aipamenekin.
• Datuen laburpen APIa: Dataverse taula baterako erregistro bakoitzeko laburpen edo zerrenda mailako ikuspegiak itzultzen ditu.

Pauso honek 4. urratseko datu ereduan eta 6. urratseko Web APIaren integrazioan oinarritzen da. Pluginak ekintza hauek egiten ditu:

1. Zure kodea eskaneatzen du laburpen integrazio puntuak bilatzeko eta helburu orriak, taulak eta zein API erabili behar diren baieztatzen ditu.
2. Web APIaren aurre-baldintza faltak—taulen baimenak, zutabe-zerrendak eta web rolak—/integrate-webapi/create-webroleseta eta -ri delegatuak ematen dizkio, baimenen egia iturri bakarra egon dadin.
3. AI Web API integrazio agente bat sortzen du, laburpen mota zerbitzu bat (aiSummaryService.ts) sortzen duena, anti-faltsutze token kudeaketa, framework espezifikoak (React hook-ak, Vue konposagarriak edo Angular zerbitzuak) eta helburu orrietan deialdi kableatuak dituena.
4. AI Web API Ezarpen Arkitekto agente bat sortzen du, gunearen ezarpenak Summarization sortzen dituena prompt eta edukien mugak.

Proposamenak berrikusten eta onartzen dituzu. Pluginak ez du kodea sortzen edo ezarpenak sortzen zuk baieztatu arte.

7. urratsa: Sortu web rolak

Exekutatu /create-webroles erabiltzailearen access rolak definitzeko. Plugina:

1. Zure inguruneari kontsulta egiten dio lehendik dauden web rolak bikoiztuak saihesteko.
2. Rolen definizioak identifikatzaile esklusiboekin sortzen ditu.
3. Gune bakoitzak gehienez ere rol anonimo bat eta autentifikatutako rol bat izatea indartzen du.

8. urratsa: Konfiguratu autentifikazioa

/setup-auth Sartu saioa, saioa itxi eta rolen araberako sarbide kontrola gehitzeko zure guneari. Pluginak honako nortasun hornitzaile hauek onartzen ditu, eta aldi berean hornitzaile bat edo batzuk konfigura ditzakezu.

Onartutako hornitzaileei buruzko informazio gehiago nahi izanez gero, protokoloak eta konfigurazio kontuak barne, ikus Autentifikazioaren ikuspegi orokorra Power Pages.

Plugina:

1. Zure gunea aztertzen du (helburua, orriak, audientzia) eta lehenetsi zentzudun bat proposatzen du. Adibidez, pluginak Microsoft Entra External ID proposatzen du, bezeroarentzako gune baterako erregistro irekiarekin, edo Microsoft Entra ID barneko atari baterako gonbidapen bidezko erregistroarekin. Gomendioa onartzen duzu edo zure hornitzaileak aukeratzen dituzu.
2. Hornitzaile bakoitzean, identitate hornitzailearen administrazio zentroan aurreko urrats guztiak azaltzen ditu, hala nola alokairudunak sortzea, aplikazioak erregistratzea, erabiltzaile-fluxuak sortzea eta bezeroen IDak eta birbideratze URIak harrapatzea. Pluginak balioztatzen du elkarrizketan itsatsitako balio bakoitza, eta zure gunearen birbideratze URI zehatza kalkulatzen du, aplikazioaren erregistroan itsatsitako balioa gunearen ezarpenetan idatzitako balioarekin bat etor dadin.
3. Nola erabiltzaile profilaren datuak identitate hornitzailetik Dataverse kontaktu erregistroan (eskaeren mapaketa) nola igo behar diren galdetzen du, saioa hasi edo lehen saioa hasi behar den bakoitzean sinkronizatu, eta kanpoko saioak automatikoki lotu behar diren lehendik dauden kontaktuetara posta elektronikoz.
4. Autentifikazio zerbitzua, mota deklarazioak, rol-oinarritutako baimen tresnak (hasRole, RequireAuth, RequireRole), saioaren keepalive hook bat sortzen ditu, SPA saioak isilean iraungitzea saihesten duena, eta zure gunearen diseinuarekin integratutako saio-hasi/saioa itxi UI osagaia. Pluginak zure markoaren patroiak erabiltzen ditu zehar, hala nola React hook-ak, Vue konposagarriak, Angular zerbitzuak edo Astro osagaiak.
5. Hornitzaile bat baino gehiago konfiguratuta dagoenean, zure aukeratutako diseinuan orrialde bat /login sortzen du: errenkada horizontala, pila bertikal, fokua nagusia edo fitxatua.
6. Hornitzaile bakoitzaren gunearen parekatze ezarpenak, erregistro modua, erreklamazioen mapaketa eta aukerako funtzioa idazten ditu..powerpages-site/site-settings/

Pluginak aukera ezaugarri hauek ere konfiguratzen ditu pizten dituzunean:

• Baldintzak eta baldintzak: SPA orri bat /terms erabiltzaileek onartu behar dute saioa hasi aurretik, baita gunearen ezarpen eta edukien zatiak ere.
• Erabiltzaile profil orria: /user-profile SPA orri bat, non saioa hasi duten erabiltzaileek beren kontaktu informazioa editatzen duten Power Pages Web APIaren bidez.
• Federated let-out: Era berean, erabiltzailea identitate hornitzailean saioa ateratzen du webgunetik irteten denean, gailu partekatuetan edo araututako egoeretan.

9. urratsa: Gehitu zerbitzariaren logika

Exekutatu /add-server-logic zerbitzariaren aldeko amaierako puntu seguruak zure gunean gehitzeko. Erabili zerbitzariaren logika zure guneak nabigatzailean exekutatu ezin den logika behar duenean, hala nola kanpoko API deiak, zerbitzariaren aldeko baliozkotzea, sekretuen kudeaketa edo entitate arteko datuen eragiketak.

Deskribatu zer behar duzun hizkuntza arruntean eta plugina:

1. Server Logic Architect agente bat sortzen du, zure erabilera kasua aztertzen duena eta bere konplexutasuna sailkatzen duena.
2. Amaierako diseinua, segurtasun konfigurazioa eta zure berrikuspenerako beharrezko taulako baimenak proposatzen ditu.
3. Onartu ondoren, zerbitzariaren aldeko JavaScript amaiera-puntua sortzen du /_api/serverlogics/<name>.
4. Bezeroaren aldeko zerbitzu tipifikatu bat sortzen du zure osagaietatik amaierako puntua deitzeko.
5. Zure osagaiak eguneratzen ditu zerbitzu berrira deitzeko.
6. Web rolen esleipenak eta taula baimenak konfiguratzen ditu amaierarako.

Proposamena aztertu eta onartu behar duzu. Ez da koderik sortzen baieztatu arte.

Erabilera kasu arruntak:

• Kanpoko zerbitzuekin konektatu. Deitu REST APIak, Azure Functions edo hirugarrenen zerbitzuak kredentzialak agerian utzi gabe. (Tutoriala: Kanpoko zerbitzuekin elkarreragiten)
• Datuen eragiketa seguruak egitea. Kontsultatu, eguneratu edo ezabatu Dataverse erregistroak zerbitzariaren aldeko baliozkotze koherentearekin. (Tutoriala: Dataverse taulekin elkarreragiten)
• Exekutatu logika pertsonalizatua. Batu datuak tauletan zehar, negozio-arauak betearazteko edo eratorritako balioak kalkulatu emaitzak bezeroari itzuli aurretik.
• Kudeatu sekretuak zerbitzariaren aldetik. Gorde kredentzialak eta API gakoak zerbitzarian, inoiz ez bezeroaren kodean. (Tutoriala: Microsoft Graph eta SharePoint)

10. urratsa: hodeiko fluxuak integratzea

Exekutatu /add-cloud-flow lehendik dauden Power Automate hodeiko fluxuak zure gunean integratzeko. Trebetasun honek zure Power Pages gunea Power Automate-n sortu dituzun fluxuekin konektatzen du. Ez du hodei-fluxu berririk sortzen.

Plugina:

1. Lehendik dagoen hodeiko fluxua zure webgunean erregistratzen du.
2. Bezeroaren aldeko kodea sortzen du zure orrialdeetatik fluxua abiarazteko.
3. Lan-fluxuaren egoera asinkronoa eta atzera deitzeko ereduak kudeatzen ditu.
4. Orrialdearen eta fluxuaren arteko datu-trukea kableatzen du.

Erabili /add-cloud-flow onarpen-lan-fluxuetarako, posta elektronikoko jakinarazpenetarako, programatutako lanetarako eta gertaeretan oinarritutako automatizaziorako, zerbitzariaren aldeko amaiera-puntuek baino hobeto kudeatzen dituztenak Power Automate.

Alternatiba: Erabili /integrate-backend zerbitzu geruza osoa planifikatzeko

Ziur ez bazaude zein ezaugarri behar dituzten Web API, Server Logic edo hodeiko fluxua, exekutatu /integrate-backend 4tik 10era urratsak eskuz exekutatu beharrean. Trebetasun honek orkestra gisa funtzionatzen du:

1. Zure prototipoa aztertzen du zerbitzu geruza bat behar duten ezaugarri guztiak identifikatzeko.
2. Ezaugarri bakoitza ikuspegi egokian sailkatzen du: CRUD estandarretarako Web APIrako, Server Logic zerbitzariaren aldeko baliozkotzerako eta kanpoko APIetarako, edo hodeiko fluxua onarpen-fluxuetarako eta automatizaziorako.
3. Exekuzio plan sekuentziatua proposatzen du, trebetasun, mendekotasun eta konfigurazio guztiekin.
4. Onartu ondoren, trebetasunak ordena egokian orkestratzen ditu.

Plana iraunkorra, berrabiarazgarria eta editagarria da. Gelditu sortutako kodea berrikusteko edo gunea probatzeko urrats baten ondoren, eta jarraitu utzi zenuen lekuan berriro exekutatuz /integrate-backend .

11. urratsa: gehitu SEO

Exekutatu /add-seo zure webgunea bilatzaileetarako optimizatzeko. Plugina:

1. Zure esparruaren bideratzailearen konfiguraziotik ibilbideak aurkitzen ditu.
2. Bilaketa-motorren jarraibideak eta aurkitutako ibilbide guztien webgunearen mapa sortzen ditu.
3. Meta etiketak gehitzen ditu: viewport, karaktere-multzoa, deskribapena, Open Graph, Twitter txartela eta favicon erreferentziak.

12. urratsa: Azken gunea martxan jartzea

Aukerako urratsak egiten badituzu, exekutatu /deploy-site berriro aldaketak zuzenean bultzatzeko. Pluginak ekoizpen-eraikuntza bat exekutatzen du eta gunea inplementazio-artefaktu guztiekin batera igotzen du (taulako baimenak, gunearen ezarpenak, web rolak, zerbitzariaren logika-fitxategiak) zure Power Pages ingurunean.

13. urratsa: Segurtasun berrikuspena egin

Egin /security-review zure gunearen segurtasun azterketa osoa ekoizpenera joan aurretik. Trebetasun honek segurtasun trebetasun fokatuak koordinatzen ditu eta aurkikuntza guztiak HTML txosten bakar batean bateratzen ditu.docs/security-review-<timestamp>.html

Pluginak zure helburuari buruzko galdera arrunt bat egiten du eta trebetasun fokalizatuen multzo bat aukeratzen du:

Berretsi ondoren, pluginak gaitasun fokalizatuak paraleloan exekutatzen ditu eta haien aurkikuntzak txosten bakar batean idazten ditu:

• /scan-code: Analisi estatikoa (opengrep) eta mendekotasun eskaneatze (trivy) exekutatzen ditu tokiko iturburu fitxategietan. Surface-en kode patroiak, pakete ahulak, sekretu finkoak eta lizentzia arazoak. Tresna horietako bat ez badago instalatuta, trebetasunak kodearen berrikuspen eskuzkoa eskaintzen du atzera begirako gisa.
• /scan-site: Zerbitzari aldeko segurtasun eskaneatze bat hasten du zuzeneko gunearen aurka eta azken txostena jasotzen du. Eskaneatzearen iraupena gunearen tamainaren araberakoa da - gune txikiak minutu gutxitan amaitzen dira, handiek orduak iraun dezakete. Aurkikuntzak larritasunaren arabera taldekatuta daude. Ezarritako gune bat behar da.
• /manage-headers: HTTP segurtasun goiburuak aztertzen ditu: Content Security Policy, X-Frame-Options, CORS, cookie SameSite eta lotutako ezarpenetan .powerpages-site/site-settings/. Balio faltak edo ahulak identifikatzen ditu eta gomendatutako lehenetsiak proposatzen ditu.
• /manage-firewall: Ekoizpen guneko web aplikazioen suebakia (WAF) aztertzen du, kudeatutako arau egoera eta arau pertsonalizatuak barne (IP blokeak, herrialde blokeak, bide blokeak, tasa mugak). Eskualde babestuetako ekoizpen guneetan bakarrik eskuragarri; Trebetasunak egokitasun arazoak detektatu eta jakinarazten ditu.
• /audit-permissions: Dagoeneko dauden taula baimenak aztertzen ditu gunearen kodearen eta Dataverse metadatuen aurka. Gainazalek baimenik gabe, gehiegizko baimenak, erabilera gabeko baimenak eta YAML eskema arazoak.

Txosten bateratuak aurkikuntzak atalka biltzen ditu, zure nabigatzaile lehenetsian irekitzen da eta hizkuntza arruntean zuzenketa gida bat barne hartzen du. Txatetik, pluginak konponbideak azaltzeko eskaintzen du - aurkikuntza bat aukeratu eta pluginak gaitasun fokalizatua modu interaktiboan erabiltzen du aldaketa aplikatzeko.

Egiaztatu zure webgunea

Trebetasunak amaitu ondoren, egiaztatu zure Power Pages guneak behar bezala funtzionatzen duela.

1. Joan Power Pages.
2. Lokalizatu zure webgunea Webgune aktiboen zerrendan.
3. Aurreikusi gunea mahaigainean, Aurrebista aukera erabiliz.
4. Funtzionaltasuna probatu.

Sustatu zure webgunea ingurune desberdinetan

Zure gunea garapen ingurunean lan egiten duenean, erabili aplikazioaren bizitza-zikloaren kudeaketa (ALM) trebetasunak proba eta produkzio inguruneetara sustatzeko. Pluginak zure gunea Power Platform soluzio gisa paketatzen du, ingurune desberdinetan balioak identifikatzen ditu eta soluzioa Power Platform Pipelines bidez edo eskuzko esportazio eta inportazio bidez ezartzen du.

ALM trebetasunak erabiltzeko, gutxienez Power Platform helburu bat behar duzu (proba, ekoizpena edo biak). Azure Key Vault aukerako fluxua sekretuetarako erabiltzeko, baimena behar duzu zure Azure harpidetzan gako kutxa bat sortzeko.

Hedapena planifikatu

Korrika /plan-alm hasteko. /plan-alm ALMrako sarrera puntua da eta beste ALM trebetasunak antolatzen ditu, beraz, normalean ez dituzu zuzenean exekutatzen. Plugina:

1. Zure proiektuaren, soluzioaren eta helburu inguruneen egoera eguneratua detektatzen du.
2. Zure promozio estrategia (Power Platform Pipelines edo eskuzko esportazioa eta inportazioa), helburu faseak eta aplikatu beharreko mugak galdetzen ditu.
3. Plan bisual bat sortzen du docs/alm-plan.html , bere ekintza guztiak erakusten dituena.
4. Zure onespena itxaroten du beherago edozein trebetasun exekutatu aurretik.

Plana diskoan mantentzen da, beraz, beheko trebetasun bakoitzak plan iraunkor beretik irakurtzen eta idazten du. Fase bat huts egiten badu, berriro exekutatu /plan-alm eta gelditu zen lekutik berriro hasten da.

Soluzioaren egilea

Exekutatu /setup-solution zure webgunea Power Platform soluzio gisa paketatzera. Plugina:

1. Argitaletxe eta soluzio bat sortzen ditu, eta gero zure Power Pages osagaiak gehitzen ditu: webgunea, web rolak, zerbitzari logika puntuak, hodeiko fluxu erregistroak eta OAuth hornitzailearen ezarpenak.
2. Gune bakoitza sentikortasunaren arabera sailkatzen du eta ingurune aldagaiak proposatzen ditu ingurune desberdinen balioetarako.
3. Azure Key Vault hornitzeko eta konfidentzial motako balioak, hala nola konexio kateak eta API gakoak, gordetzeko eskaintzen du.
4. Sinkronizazio moduan exekutatzen da zure gunerako soluzio bat dagoenean, osagaiak bateratzeko soluzio berririk sortu gabe.

Proposamena aztertu eta onartu behar duzu. Pluginak ez du konfiguraziorik sortzen zuk baieztatu arte.

Power Platform Pipeline-ekin ezarri

Power Platform Pipelines aukeratu baduzu zure promozio estrategia gisa, pluginak trebetasun hauek exekutatzen ditu:

1. /ensure-pipelines-host Power Platform Pipeline-entzako host ingurune bat ezartzen edo detektatzen du. Gaitasunak zure alokairudunarentzat eskuragarri dagoen aukera merkeena aukeratzen du: plataforma doako ostalari bat, Pipelines aplikazioa ingurune batean dagoeneko dagoen batean, edo ostalari pertsonalizatu bat.
2. /setup-pipeline Dataverse-n pipeline definizio bat erregistratzen du, aukeratutako etapak konfiguratzen ditu, eta etapa bakoitza helburu-ingurune bati lotzen dio.
3. /deploy-pipeline etapa baterako inplementazio bat abiarazten du, etapa bakoitzeko ingurune aldagaien gainidazpenak deploymentSettings.jsonaplikatzen ditu eta egoera jarraitzen du inplementazio liburu batean.

Inplementazio bat huts egiten badu, helburu ingurunea dagoeneko beste Power Platform Pipelines host batekin lotuta dagoelako, pluginak exekutatu /force-link-environment daiteke berriro esleitzeko. Ekintzak zure baimen esplizitua behar du eta atzera botatzen da.

Eskuzko esportazio eta inportazio bidez inplementatu

Eskuzko bidea aukeratzen baduzu, pluginak honela funtzionatzen du:

1. /export-solution soluzioa kudeatutako edo kudeatu gabeko ZIP gisa esportatzeko, esportazioaren aurretik osotasun-egiaztapen batekin.
2. /import-solution ZIP-a helburu ingurunean inportatzeko, mendekotasunak lehenik egiaztatzeko edo zuzenean egiaztatuta.

Aktibatu eta balioztatu ezarritako gunea

Helburu ingurunean arrakastaz ezarri ondoren, plugina:

1. Helburu ingurunean URL publikoa hornitzeko exekutatzen /activate-site da.
2. Exekuzioa egiaztatzeko exekutatzen /test-site da. Pluginak nabigatzaile bat erabiltzen du ordezkari orriak arakatzeko, rolen araberako sarbide egiaztapenak egiteko, deiak egiaztatzeko /_api/ eta endpointetako /_api/serverlogics/ erantzun formak harrapatzeko. Trebetasunak emaitza adierazten du PASS, WARNINGS, edo FAIL, eta txeke bakoitzeko xehetasunak planetik lotuta daude.

Urrats bat huts egiten badu, pluginak exekutatzen /diagnose-deploymentdu. Gaitasunak porrota ezagun diren inplementazio errore katalogo batekin bat egiten du, hala nola manifestu zaharkitua, mendekotasun faltak, host gatazkak, blokeatutako JavaScript edo autentifikazio iraungitua, eta konponbide zehatz bat proposatzen du. Pluginak ez du inoiz konponbiderik aplikatzen zure baimenik gabe.

Aholkuak eta praktika onak

Ondorengo aholkuek pluginari eta AI kodeketa agenteari ahalik eta etekin handiena ateratzen laguntzen dizute Power Pages guneak eraikitzerakoan.

Begiratu terminalaren irteera falta den tresnak lehen exekuzioan

Pluginak trebetasunak eta lan-fluxuak eskaintzen ditu, baina AI kodeketa agenteak - GitHub Copilot CLI edo Claude Code - zure ordenagailuan benetako komandoak exekutatzen ditu. Tresna hauek lehen aldiz erabiltzen dituzunean, begiratu terminalaren irteera arretaz. AI kodeketa agenteak komandoak eta scriptak exekutatzen ditu atzean, eta komando horietako batzuk zure ordenagailuan instalatuta ez dauden tresnen araberakoak dira. Urrats batek huts egiten badu, terminalaren irteerak normalean erakutsiko du zein tresna edo komando ezin izan duen aurkitu.

Errore command not found bat ikusten baduzu edo is not recognized, instalatu falta den tresna eta abiarazi lan-fluxua. AI kodeketa agenteak utzitako lekuan jarraitzen du tresna eskuragarri egon ondoren.

Aztertu agenteen proposamenak onartu aurretik

AI kodeketa agenteak proposamenak aurkezten ditu, hala nola Data Model Architect eta Permissions Architect-enak, aldaketak egin aurretik. AI kode-agenteak sortutako kodea eta konfigurazioa zehaztugabeak izan daitezke, beraz, berrikusi, probatu eta baliozkotu proposamen eta sortutako kode guztia onartu edo inplementatu aurretik.

• Datu-eredu proposamenak: Egiaztatu taulen izenak, zutabe motak eta erlazioak zure negozioaren eskakizunekin bat datozen. Proposamen bat egokitzea errazagoa da datuak sartu ondoren zutabeak izendatzea baino.
• Baimenen proposamenak: egiaztatu rol bakoitzak taula bakoitzerako access maila egokia duela (sortu, irakurri, eguneratu, ezabatu). Taularen baimen gehiegi permisiboak segurtasun arrisku arrunta dira.
• Kode sortua: Irakurri sortutako kodea eta probatu gunea tokian tokiko inplementatu aurretik. AI-k sortutako kodeak akatsak edo segurtasun arazoak izan ditzake.

Itsatsi erroreak zuzenean testuinguruarekin

Zerbaitek huts egiten duenean, eraikuntza-errorea, inplementazio-hutsegitea edo exekuzio-denboraren salbuespen bat nabigatzailean, kopiatu errore-irteera osoa. Itsatsi egiten ari zarenaren deskribapen labur batekin batera. Zenbat eta testuinguru gehiago eman, orduan eta azkarrago konponduko da.

Adibidea: eraikitze-errorea

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>
                                 

Partekatu Web APIaren erroreak eskaeraren URL osoarekin

Zabaldu ondorengo arazo ohikoena errorea Power Pages Web APItik zutabe bat API sarbiderako gaituta ez dagoenean. Errore hau aurkitzen duzunean, itsatsi API URL osoa eta JSON errorearen erantzun osoa. Errore-mezuak zehatz-mehatz adierazten dizu zein taula eta zutabe konpondu behar diren, eta pluginak taularen baimenaren YAML eta gunearen ezarpenak eguneratu ditzake.

Adibidea: Zutabea ez gaituta Web APIrako (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"
    }
  }
}

Errore honek (AttributePermissionIsMissing) esan nahi du bilaketa-zutabea _crd50_propertyid_value Dataverse-ren taulan dagoela, baina ez dagoela Web APIaren taularen baimenen konfigurazioan zerrendatuta. Pluginak errore hau konpontzen du falta den zutabea YAML taulan baimena .powerpages-site/table-permissions/ gehituz eta berriro banatuz.

Izan zehatz-mehatz zer nahi duzun

Eskaera lausoek emaitza lausoak sortzen dituzte. Esan pluginari zehazki zer behar duzun, diseinuaren hobespenak, datu-eremuak eta portaera barne.

Erabili pantaila-argazkiak ikusmen-arazoetarako

Gunea nabigatzailean itxura zuzena ez duenean, hartu pantaila-argazkia eta itsatsi zuzenean elkarrizketan edo eman fitxategiaren bide-izena. Testuinguru bisualak testuan deskribatzeko zailak diren diseinu, tarte eta estilo arazoak identifikatzen laguntzen du.

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.

Iteratu urrats txikietan

Gune oso bat gonbidatu beharrean, eraiki pixkanaka. Hasi egiturarekin eta diseinuarekin, gero gehitu ezaugarriak banan-banan. Ikuspegi honek urrats bakoitzean berrikusteko eta zuzentzeko aukera ematen dizu.

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

Eskatu azalpenak onartu aurretik

Proposatutako aldaketa bati buruz ziur ez zaudenean, batez ere baimenetan, datu-ereduaren aldaketetan edo autentifikazioaren konfigurazioan, eskatu pluginari zer to do eta zergatik azaltzeko onartu aurretik.

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

Gaitasunak modu independentean exekutatzea arazoetatik berreskuratzeko

Trebetasun batek erdibidean huts egiten badu, ez duzu berriro hasi beharrik. Trebetasun bakoitza modu independentean exekutatzen da eta utzi zuen lekuan jarrai dezake. Adibidez, /integrate-webapi hirugarren taulan huts egiten badu, berriro exekutatu dezakezu eta dagoeneko amaitutako lana antzematen du.

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

Erlazionatutako edukia

• Sortu eta zabaldu orrialde bakarreko aplikazio bat Power Pages
• Konfiguratu autentifikazioa Power Pages gune baterako
• Zerbitzariaren logikaren ikuspegi orokorra
• Power Pages Web APIaren erreferentzia
• Datuen laburpen APIaren ikuspegi orokorra
• Power Pages AI sortzailearekin bilatu
• PAC CLI orrialdeen komandoen erreferentzia
• GitHub Copilot CLI
• Claude kodea