Comença amb el plugin Power Pages per a GitHub Copilot CLI i Claude Code

El connector Power Pages per a GitHub Copilot CLI i Claude Code proporciona un flux de treball assistit per IA per crear, desplegar i gestionar llocs moderns d'aplicacions d'una sola pàgina (SPA) a Power Pages. En lloc de fer estructures manuals als projectes, escriure codi API estàndard i configurar permisos, descriu què vols en llenguatge natural, i el connector s'encarrega de la implementació.

El connector suporta tot el cicle de vida del desenvolupament del lloc mitjançant habilitats conversacionals, des de l'estructura d'un nou lloc fins al seu desplegament, la configuració de models de dades de Dataverse i la configuració de l'autenticació.

Important

  • Un agent de codificació d'IA generativa, com GitHub Copilot CLI o Claude Code, utilitza les habilitats i fluxos de treball d'aquest connector per completar tasques específiques de Power Pages.
  • El codi i la configuració generats per l'agent de codificació d'IA poden ser inexactes. Revisa, prova i valida tot el contingut generat abans d'aprovar-lo o desplegar-lo. Revisa sempre les propostes dels agents abans d'aprovar-les.

Requisits previs

Abans de començar, verifica que tens el programari i els permisos necessaris.

Requisits de programari

Component Versió mínima Més informació
Node.js 18.0 o posteriors Descarrega Node.js
Power Platform CLI (PAC CLI) 2.6.3 o posterior (requerida per a la lògica del servidor) Instal·la PAC CLI
Azure CLI Últims Instal·la Azure CLI
GitHub Copilot CLI o Codi Claude Últims GitHub Copilot CLI o Claude Code
Visual Studio Code i extensió Power Platform Tools (Opcional) Últims Descarrega VS Code i instal·la les eines de Power Platform

També necessites:

  • Un entorn Power Platform amb Power Pages activat.
  • Una sessió PAC CLI autenticada connectada al teu entorn objectiu. Corre pac auth create si encara no t'has connectat.
  • Una sessió d'Azure CLI ha iniciat sessió amb el mateix inquilí. Executa az login --allow-no-subscriptions per autenticar.

Verifica l'autenticació:

Verifica que estàs autenticat utilitzant l'ordre pac auth list .

pac auth list           # Should show authenticated profile

Si no estàs autenticat, executa aquesta comanda:

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

Propina

Per obtenir l'URL de la instància, ves a Power Pages home, selecciona la icona Settings a la cantonada superior dreta, i després selecciona Detalls de la sessió.

Instal·la el connector

Instal·la el connector Power Pages des del mercat. Si utilitzes GitHub Copilot CLI, consulta la documentació d'extensions de CLI Copilot per a passos d'instal·lació equivalents. Les següents ordres utilitzen la sintaxi Claude Code.

Executa l'instal·lador per configurar tots els plugins amb l'actualització automàtica activada:

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

L'instal·lador automàticament:

  • Instal·la la pac CLI si encara no està instal·lada.
  • Detecta eines disponibles, com Claude Code i GitHub Copilot CLI.
  • Registra el mercat de plugins i instal·la tots els plugins llistats.
  • Activa l'actualització automàtica perquè els plugins es mantinguin actualitzats.

Després de la instal·lació, reinicia Claude Code o la CLI de GitHub Copilot per accedir a les habilitats del connector com a ordres de barra a la sessió de l'agent.

Instal·la des del marketplace

  1. Obre el Codi Claude al teu terminal.

  2. Afegeix el mercat de Microsoft:

    /plugin marketplace add microsoft/power-platform-skills

  3. Instal·la el connector Power Pages:

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

Després d'instal·lar el plugin, reinicia Claude Code o la CLI de GitHub Copilot per accedir a les habilitats del connector com a ordres de barra a la teva sessió d'agent.

Propina

Per rebre automàticament actualitzacions del mercat i de les habilitats, activa l'actualització automàtica. Fes servir l'ordre /plugin , ves als Mercats, tria el mercat i activa l'actualització automàtica.

Visió general de les habilitats

El connector proporciona habilitats que cobreixen tot el cicle de vida d'un lloc de Power Pages. Invoca cada habilitat de manera conversacional, ja sigui com una ordre de tall o descrivint què vols to do.

Habilitat Ordre Què fa
Crea un lloc web /create-site Estructura un lloc, aplica la teva direcció de disseny i construeix pàgines i components
Lloc de desplegament /deploy-site Construeix el projecte i el puja a Power Pages utilitzant PAC CLI
Activar el lloc /activate-site Proporciona un registre web i assigna una URL pública
Configuració del model de dades /setup-datamodel Crea taules, columnes i relacions Dataverse
Afegir dades de mostra (opcional) /add-sample-data Omple taules de Dataverse amb registres de proves realistes
Integra l'API web /integrate-webapi Genera codi client d'API, serveis i permisos de taula tipats
Afegeix resums d'IA /add-ai-webapi Integra les APIs de resum generatiu per IA (resum de cerca i resum de dades) a les teves pàgines. Genera un servei de resum mecanografiat amb gestió de tokens anti-falsificació, wrappers específics del framework, llocs de trucades per cable i la configuració del lloc corresponent Summarization
Configurar l'autenticació /setup-auth Afegeix inici de sessió, desconnexió i control d'accés basat en rols. Suporta Microsoft Entra ID, Microsoft Entra External ID, OpenID Connect, SAML 2.0, WS-Federation, Microsoft account, Facebook, Google i autenticació local de nom d'usuari i contrasenya, incloent-hi configuracions multi-proveïdor
Crea rols web /create-webroles Genera fitxers YAML de rol web per a la gestió d'access d'usuari
Afegeix lògica del servidor /add-server-logic Genera punts d'enllaç JavaScript segurs al costat del servidor per a validació, crides a API externes, gestió de secrets i operacions de dades
Afegeix flux de núvol /add-cloud-flow Integra els fluxos existents al núvol de Power Automate al teu lloc per a fluxos de treball d'aprovació, notificacions i automatització programada
Integrar el backend /integrate-backend Analitza el teu prototip, determina l'enfocament adequat (Web API, Server Logic o flux al núvol) per a cada funcionalitat i orquestra tota la seqüència de compilació
Afegeix SEO /add-seo Genera robots.txt, sitemap.xml, i etiquetes meta
Fes una revisió de seguretat /security-review Orquestra les habilitats de seguretat especialitzades i consolida cada troballa en un únic informe HTML. Cobreix codi, dependències, escaneig del lloc desplegat, capçaleres del navegador, tallafocs d'aplicacions web, permisos de taula i configuració d'autenticació
Escanejar el codi font /scan-code Executa anàlisi estàtica i escaneig de dependències en fitxers font locals; Revela troballes a través de patrons de codi, paquets vulnerables, secrets codificats fixament i qüestions de llicència
Escaneig del lloc desplegat /scan-site Inicia un escaneig de seguretat al costat del servidor contra el lloc en viu, obté l'últim informe i agrupa les troballes segons la gravetat
Gestionar capçaleres de seguretat del navegador /manage-headers Inspecciona i configura les capçaleres de seguretat HTTP que un lloc envia als navegadors — Política de Seguretat de Contingut, protecció contra trames i clickjacking, compartició entre orígens, comportament de galetes i configuració relacionada del lloc
Gestionar el tallafocs d'aplicacions web /manage-firewall Inspecciona i configura el tallafocs d'aplicacions web (WAF) en un lloc de producció: activa la protecció, afegeix o elimina blocs IP, blocs de país, blocs de camí i límits de velocitat
Permisos per a la taula d'auditoria /audit-permissions Audita els permisos existents de les taules contra el codi del lloc i les metadades de Dataverse; produeix un informe HTML agrupat per gravetat amb solucions suggerides
Desplegament del pla /plan-alm Detecta l'estat del projecte, recull la teva estratègia de promoció, elabora un pla visual i orquestra les altres habilitats de gestió del cicle de vida de l'aplicació (ALM) en l'ordre correcte
Solució de l'autor /setup-solution Crea un editor i una solució, afegeix components de Power Pages, classifica la configuració del lloc i proposa variables d'entorn i secrets d'Azure Key Vault
Configurar host de pipeline /ensure-pipelines-host Provisiona o detecta un entorn hoste per a Power Platform Pipelines
Configurar pipeline /setup-pipeline Registra una definició de pipeline a Dataverse i vincula les etapes de promoció als entorns objectiu
Desplegar a través de la pipeline /deploy-pipeline Desencadena un desplegament de pipeline per a una etapa objectiu amb sobreescriptures de variables d'entorn per etapa
Entorn d'enllaç de força /force-link-environment Reassigna un entorn objectiu a un nou host de Power Platform Pipelines quan un conflicte d'hoste bloqueja el desplegament
Exportar la solució /export-solution Exporta la solució com a zip gestionat o no gestionat, amb una comprovació de completitud abans de l'exportació
Importar la solució /import-solution Importa una solució zip en un entorn objectiu, ja sigui per fases o directament
Lloc de prova /test-site Verifica un lloc desplegat amb una prova basada en navegador: rastreig de pàgines, comprovacions d'accés basades en rols i verificació de l'API web
Diagnosticar el desplegament /diagnose-deployment Compara les fallades de desplegament amb un catàleg d'errors coneguts i proposa una solució

Flux de treball típic

Un flux de treball comú d'extrem a extrem segueix aquesta seqüència:

  1. /create-site : Pàgines d'andamiatge, disseny i construcció
  2. /deploy-site : Puja al teu entorn Power Pages
  3. /activate-site : Configura una URL pública
  4. /setup-datamodel : Crea taules Dataverse
  5. /add-sample-data : Omplir taules amb registres de prova
  6. /integrate-webapi : Generar codi client de l'API i configurar permisos
  7. /create-webroles : Defineix access rols
  8. /setup-auth : Afegeix inici de sessió, desconnexió i interfície basada en rols
  9. /add-server-logic : Afegeix punts finals segurs al costat del servidor
  10. /add-cloud-flow : Integrar fluxos de Power Automate existents
  11. /add-seo : Optimització per a motors de cerca
  12. /deploy-site : Envia els canvis finals en directe
  13. /revisió de seguretat : Fes una revisió de seguretat integral abans d'anar a producció
  14. /plan-alm : Promociona el teu lloc en entorns de prova i producció

Propina

  • No cal que segueixis aquesta ordre exacta. Cada habilitat comprova els seus propis requisits i t'indica si falta alguna cosa. Per exemple, pots executar /setup-auth abans /integrate-webapi si el teu lloc necessita autenticació primer.
  • Si no tens clar quin enfocament utilitzar per a cada funcionalitat, executa /integrate-backend en comptes dels passos 4 a 10 individualment. Analitza el teu prototip, determina si cada funcionalitat necessita Web API, Server Logic o un flux al núvol, i orquestra les habilitats en l'ordre correcte.
  • Per afegir resums de cerca i registres generats per IA, executa /add-ai-webapi després /integrate-webapide . Reutilitza els permisos de taula i la configuració del lloc que /integrate-webapi configuren, així que executa'l un cop la integració de l'API web estigui en marxa.

Construeix el teu lloc de Power Pages

Aquesta guia cobreix tot el cicle de vida de la construcció d'un lloc Power Pages amb el plugin, des de l'estructura fins al desplegament. Cada pas descriu què dius i què fa el plugin en resposta.

Pas 1: Crea el teu lloc web

Descriu el lloc que vols en llenguatge natural: per a què serveix, quines pàgines necessita i qualsevol preferència de disseny com l'esquema de colors, l'estil de maquetació o les tipografies. Executa /create-site o simplement descriu el teu lloc i el plugin reconeix la intenció.

Si no especifiques un framework, el plugin et demana que en triïs un (React, Vue, Angular o Astro), i llavors:

  1. Estructura el project a partir d'una plantilla i aplica el nom del teu lloc, colors i tokens de disseny.
  2. Instal·la dependències, inicia un servidor de desenvolupament i obre una previsualització en temps real del navegador.
  3. Construeix cada pàgina, component i ruta que hagis sol·licitat amb imatges rellevants.
  4. Crea commits git en fites importants perquè tinguis un historial de rollback integrat.

Pas 2: Desplega el teu lloc web

Executa /deploy-site per pujar el teu lloc a Power Pages. El plugin:

  1. Verifica que el PAC CLI està instal·lat i que la teva sessió d'autenticació està activa.
  2. Confirma l'entorn objectiu amb tu abans de continuar.
  3. Executa una compilació de producció i puja la sortida compilada.
  4. Crea un directori d'artefacts de desplegament si encara no n'existeix un.

Nota

Si el teu entorn bloqueja certs fitxers adjunts, el connector detecta el problema i proporciona instruccions per resoldre'l.

Pas 3: Activa el teu lloc web

Corre /activate-site per fer el lloc accessible públicament. El plugin:

  1. Suggereix un subdomini basat en el nom del teu lloc i et permet personalitzar-lo.
  2. Proporciona un registre web a través de l'API de Power Platform.
  3. Enquestes fins que el lloc estigui actiu i retorni l'URL pública.

En aquest punt, tens un lloc web funcional amb una URL pública. Els passos restants afegeixen dades, autenticació i SEO. Salta qualsevol pas que no s'apliqui al teu lloc.

Pas 4: Configura el teu model de dades

Corre /setup-datamodel per crear les taules de Dataverse que necessita el teu lloc. Si ja tens un diagrama ER o un esquema específic, proporciona'l directament en lloc que l'agent analitzi el teu codi.

El connector genera un agent Data Model Architect que:

  1. Analitza el codi del teu lloc per determinar quines dades requereixen les pàgines i components.
  2. Consulta el teu entorn Dataverse per taules existents per evitar duplicats.
  3. Proposa un model de dades amb taules, columnes, tipus de dades i relacions, visualitzat com un diagrama ER.

Revises i aproves la proposta. El plugin no crea res fins que no ho confirmis. Després de l'aprovació, el connector crea les taules i columnes mitjançant crides a l'API i desa un fitxer manifest que utilitzen els Passos 5 i 6.

Pas 5: Afegir dades de mostra (Opcional)

Corre /add-sample-data a omplir les teves taules amb registres de prova. Aquest pas requereix el model de dades del Pas 4.

El connector realitza les següents accions:

  1. Llegeix el manifest per entendre les teves taules, columnes i relacions.
  2. Genera valors contextualment adequats per a cada tipus de columna, com ara correus realistes, dates plausibles i quantitats de moneda formatades.
  3. Insereix registres en ordre de dependència (taules pares abans de les taules fills) i actualitza automàticament els tokens d'autenticació durant les insercions massives.

Pas 6: Integra amb l'API web de Dataverse

Executa /integrate-webapi per substituir les dades simulades per consultes en directe de Dataverse. Aquest pas requereix el model de dades del Pas 4.

El connector realitza les següents accions:

  1. Escaneja la teva base de codi buscant components que utilitzin dades simulades, crides de recollida provisionals o arrays codificats fixament. Mapeja aquests components a les teves taules Dataverse.
  2. Genera un agent d'integració d'API web per a cada taula que genera:
    • Un client API compartit amb gestió de tokens anti-falsificació i lògica de reintents.
    • Tipus d'entitat TypeScript i mapadors de domini.
    • Una capa de servei CRUD.
    • Patrons específics del framework, com ara hooks de React, composables de Vue o serveis Angular.
  3. Genera un agent d'Arquitecte de Permisos que proposa permisos de taula i configuració del lloc.

Revises i aproves la proposta de permisos. El connector no crea cap fitxer de configuració fins que no ho confirmis.

Afegeix resums generats per IA (Opcional)

Corre /add-ai-webapi per superposar resums d'IA generativa a sobre de la teva integració amb l'API web. L'habilitat connecta dues APIs de resum de previsualització amb les pàgines de detall de registre i llista:

  • API de resum de cerca: retorna un resum condensat per IA dels resultats de la cerca, amb cites.
  • API de resum de dades: Retorna un resum per registre o informació a nivell de llista per a una taula Dataverse.

Aquest pas es basa en el model de dades del pas 4 i la integració de l'API web del pas 6. El connector realitza les següents accions:

  1. Escaneja el teu codi buscant punts d'integració resum i confirma les pàgines objectiu, taules i quines APIs utilitzar.
  2. Delega qualsevol requisit previ mancat de l'API web — permisos de taula, llistes de columnes i rols web — a /integrate-webapi i /create-webroles, de manera que hi hagi una única font de veritat per als permisos.
  3. Genera un agent d'integració d'API web amb IA que genera un servei de resum escritat (aiSummaryService.ts) amb gestió de tokens anti-falsificació, embolcalls específics del framework (hooks React, composables Vue o serveis Angular) i llocs de trucada per cable a les pàgines objectiu.
  4. Genera un agent d'IA Web API Settings Architect que crea la Summarization configuració del lloc per a prompts i límits de contingut.

Revises i aproves les propostes. El connector no genera codi ni crea configuracions fins que no ho confirmis.

Nota

Les APIs de resum estan en previsualització i depenen que s'activin els controls administratius i a nivell de lloc. Si no apareixen resums després del desplegament, confirma que la funció està activada a través de la configuració del lloc i els controls d'administració corresponents. Per a més informació, vegeu resum de dades API Overview i Power Pages cerca amb generative AI.

Pas 7: Crea rols web

Executa /create-webroles per definir els rols d'usuari access. El plugin:

  1. Consulta el teu entorn per a rols web existents per evitar duplicats.
  2. Genera definicions de rol amb identificadors únics.
  3. Fa complir que cada lloc tingui com a màxim un rol anònim i un rol autenticat.

Pas 8: Configurar l'autenticació

Corre /setup-auth per afegir inici de sessió, tancament i control d'accés basat en rols al teu lloc. El connector admet els següents proveïdors d'identitat, i pots configurar un proveïdor o diversos al mateix temps.

Proveïdor El millor per a
Microsoft Entra External ID (recomanat per a llocs orientats al client) Llocs públics i portals de clients amb registre d'autoservei.
Microsoft Entra ID Portals interns d'empleats o llocs socis business-to-business (B2B). Power Pages configura automàticament el llogater pare del lloc, així que no cal que introdueixis la informació del llogater.
Microsoft, Facebook, Google Inici de sessió social per a audiències de consumidors.
Autenticació local Inici de sessió amb nom d'usuari i contrasenya. No es recomana i només es configura quan ho sol·licites explícitament.

Per a més informació sobre proveïdors compatibles, incloent-hi protocols i consideracions de configuració, vegeu Visió general de l'autenticació en Power Pages.

El plugin:

  1. Analitza el teu lloc (propòsit, pàgines, audiència) i proposa un valor per defecte raonable. Per exemple, el connector proposa Microsoft Entra External ID amb registre obert per a un lloc orientat al client, o Microsoft Entra ID amb registre només per invitació per a un portal intern. Acceptes la recomanació o tries els teus propis proveïdors.
  2. Per a cada proveïdor, t'explica cada pas previ al centre d'administració del proveïdor d'identitat, com ara crear llogaters, registrar aplicacions, crear fluxos d'usuari i capturar IDs de clients i URIs de redireccionament. El connector valida cada valor que enganxes de nou a la conversa i calcula l'URI exacte de redirecció per al teu lloc perquè el valor enganxat al registre de l'aplicació coincideixi amb el valor escrit a la configuració del lloc.
  3. Pregunta com haurien de fluir les dades del perfil d'usuari del proveïdor d'identitat cap al registre de contacte de Dataverse (mapatge de reclamacions), si s'ha de sincronitzar en cada inici de sessió o només en el primer inici de sessió, i si s'han d'enllaçar automàticament els inicis de sessió externs amb contactes existents per correu electrònic.
  4. Genera el servei d'autenticació, declaracions de tipus, utilitats d'autorització basades en rols (hasRole, RequireAuth, RequireRole), un hook de manteniment de sessions que impedeix que les sessions SPA caduquin silenciosament, i un component d'interfície d'usuari d'inici de sessió/desconnexió integrat amb el disseny del teu lloc. El connector utilitza patrons del teu framework a tot arreu, com ara hooks de React, composables de Vue, serveis Angular o components d'Astro.
  5. Quan hi ha més d'un proveïdor configurat, es genera una /login pàgina renderitzada en el disseny escollit: fila horitzontal, pila vertical, focus principal o pestanyes.
  6. Escriu la configuració del lloc corresponent per a .powerpages-site/site-settings/ cada proveïdor, el mode de registre, el mapatge de reclamacions i la funció opcional.

El connector també configura les següents funcions opcionals quan les actives:

  • Termes i condicions: Una pàgina SPA que /terms els usuaris han d'acceptar abans de completar l'inici de sessió, a més de la configuració del lloc i fragments de contingut corresponents.
  • pàgina de perfil d'usuari: Una pàgina /user-profile SPA on els usuaris iniciats sessió editen la seva informació de contacte a través de l'API web Power Pages.
  • Tancament federat: També desconnecta l'usuari al proveïdor d'identitat quan tanca la sessió del lloc, per a dispositius compartits o escenaris regulats.

Propina

Per afegir un segon proveïdor d'identitat a un lloc existent, executa-ho /setup-auth de nou. El connector detecta el que ja està configurat i ofereix afegir un nou proveïdor sense sobreescriure els existents. Aquest enfocament és útil per a escenaris incrementals, com començar amb Microsoft Entra External ID i després afegir Google per iniciar sessió social.

Nota

L'autorització del costat del client (RequireAuth, RequireRole, hasRole) és només per a l'experiència d'usuari. Controla el que veu l'usuari. Els permisos de taula al costat del servidor configurats per /integrate-webapi imposar una seguretat real.

Pas 9: Afegeix lògica del servidor

Executa /add-server-logic per afegir punts finals segurs al costat del servidor al teu lloc. Utilitza la lògica del servidor quan el teu lloc necessiti una lògica que no es pugui executar al navegador, com ara crides a API externes, validació al servidor, gestió de secrets o operacions de dades entre entitats.

Important

El suport a la lògica del servidor requereix PAC CLI versió 2.6.3 o posterior. Utilitza l'script d'instal·lació ràpida per actualitzar a l'última versió.

Descriu què necessites en un llenguatge clar, i el plugin:

  1. Genera un agent de Server Logic Architect que analitza el teu cas d'ús i classifica la seva complexitat.
  2. Proposa un disseny d'endpoint, configuració de seguretat i qualsevol permís de taula necessari per a la teva revisió.
  3. Després d'aprovar, genera l'endpoint JavaScript del costat del servidor a /_api/serverlogics/<name>.
  4. Crea un servei de costat client tipat per invocar l'endpoint des dels teus components.
  5. Actualitza els teus components per trucar al nou servei.
  6. Configura assignacions de rols web i permisos de taula per a l'endpoint.

Revises i aproves la proposta. No es genera cap codi fins que no ho confirmis.

Casos d'ús comuns:

Nota

Executa't /add-server-logic una vegada per cas d'ús. Per exemple, si el teu lloc necessita tant un punt final de validació d'inventari com un punt final de cerca global, executa l'habilitat dues vegades.

Pas 10: Integra els fluxos del núvol

Executa /add-cloud-flow per integrar fluxos de núvol Power Automate existents al teu lloc. Aquesta habilitat connecta el teu lloc de Power Pages amb fluxos que ja has creat a Power Automate. No crea nous fluxos de núvol.

El plugin:

  1. Registra el flux de núvol existent amb el teu lloc.
  2. Genera codi al costat del client per activar el flux des de les teves pàgines.
  3. Gestiona l'estat del flux de treball asíncron i els patrons de retorn de trucada.
  4. Connecta l'intercanvi de dades entre la pàgina i el flux.

Utilitza /add-cloud-flow per a fluxos de treball d'aprovació, notificacions per correu electrònic, tasques programades i automatització basada en esdeveniments que són millor gestionades per Power Automate que per endpoints del costat servidor.

Alternativa: Utilitza /integrate-backend per planificar la capa de servei complet

Si no tens clar quines funcionalitats necessiten Web API, Server Logic o un flux al núvol, executa /integrate-backend en comptes d'executar manualment els passos 4 a 10. Aquesta habilitat actua com a orquestrador que:

  1. Analitza el teu prototip per identificar totes les característiques que necessiten una capa de servei.
  2. Classifica cada funcionalitat en l'enfocament correcte: API web per a CRUD estàndard, Server Logic per a validació al costat del servidor i APIs externes, o flux al núvol per a fluxos de treball d'aprovació i automatització.
  3. Proposa un pla d'execució seqüenciat amb totes les habilitats, dependències i configuracions.
  4. Després d'aprovar, orquestra les habilitats en l'ordre correcte.

El pla és persistent, reprenible i editable. Atura't després de qualsevol pas per revisar el codi generat o provar el lloc, i reprèn on ho vas deixar tornant a executar /integrate-backend .

Pas 11: Afegir SEO

Executa /add-seo per optimitzar el teu lloc per als motors de cerca. El plugin:

  1. Descobreix rutes des de la configuració del router del teu framework.
  2. Genera directrius dels motors de cerca i un mapa del lloc per a totes les rutes descobertes.
  3. Afegeix etiquetes meta: viewport, caràcters, descripció, Open Graph, Twitter Card i referències a favicon.

Pas 12: Desplegar el lloc final

Si fas algun pas opcional, torna a executar-lo /deploy-site per posar els canvis en directe. El connector executa una compilació de producció i puja el lloc juntament amb tots els artefactes de desplegament (permisos de taula, configuració del lloc, rols web, fitxers lògics del servidor) al teu entorn Power Pages.

Pas 13: Fes una revisió de seguretat

Corre /security-review per fer una revisió de seguretat integral del teu lloc abans d'anar a producció. L'habilitat orquestra les habilitats de seguretat enfocades i consolida cada troballa en un únic informe HTML a docs/security-review-<timestamp>.html.

El connector fa una pregunta en llenguatge pla sobre el teu objectiu i tria el conjunt d'habilitats enfocades que corresponen:

Objectiu Què comprova
Codi i configuració Codi font, dependències, permisos de taula i configuració d'autenticació. Funciona només amb fitxers locals - no cal desplegar-me.
Preparació per al llançament (recomanat) Revisió completa abans de publicar. Executa totes les habilitats especialitzades: codi i dependències, escaneig del lloc desplegat, capçaleres de seguretat del navegador, tallafocs d'aplicacions web, permisos de taula i autenticació.
Lloc desplegat Només escaneig en viu desplegat al lloc. Útil per al seguiment continu d'un lloc publicat.

Després de confirmar-ho, el connector executa les habilitats enfocades a la coincidència en paral·lel i escriu les seves conclusions en un únic informe:

  • /scan-code: Executa anàlisi estàtica (opengrep) i escaneig de dependències (trivial) en fitxers font locals. Patrons de codi de Surface, paquets vulnerables, secrets codificats de manera fixa i problemes de llicències. Si cap de les dues eines està instal·lada, l'habilitat ofereix una revisió manual de codi com a opció B.
  • /scan-site: Inicia un escaneig de seguretat al costat del servidor contra el lloc en funcionament i obté l'últim informe. La durada de l'escaneig depèn de la mida del lloc: els llocs petits acaben en minuts, els grans poden trigar hores. Les troballes s'agrupen per gravetat. Requereix un lloc desplegat.
  • /manage-headers: Inspecciona les capçaleres de seguretat HTTP configurades sota .powerpages-site/site-settings/: Política de Seguretat de Contingut, X-Frame-Options, CORS, cookie SameSite i configuracions relacionades. Identifica valors que falten o són febles i proposa valors per defecte recomanats.
  • /manage-firewall: Inspecciona el tallafocs d'aplicacions web (WAF) del lloc de producció, incloent-hi l'estat de les regles gestionades i les regles personalitzades (blocs IP, blocs de país, blocs de camí, límits de velocitat). Disponible només en llocs de producció de regions suportades; L'habilitat detecta i informa de qüestions d'elegibilitat.
  • /audit-permissions: Audita els permisos de taules existents contra el codi del lloc i les metadades de Dataverse. Superfícies sense permisos, rols excessivament permissius, permisos no utilitzats i problemes d'esquema YAML.

L'informe consolidat agrupa les troballes per secció, s'obre al navegador per defecte i inclou guies de remediació en llenguatge senzill. Des del xat, el plugin s'ofereix a revisar les solucions: tria una troballa i el connector invoca interactivament l'habilitat centrada en la coincidència per aplicar el canvi.

Nota

La revisió de seguretat mai aplica canvis automàticament. Cada habilitat enfocada s'executa en mode de revisió de només lectura durant la partida consolidada. Per aplicar una correcció, el connector invoca l'habilitat d'emparellament de manera interactiva després d'escollir l'acció.

Propina

També pots executar qualsevol habilitat focalitzada per si sola:

  • Executa-ho /scan-code durant el desenvolupament per detectar problemes a nivell de codi aviat.
  • Corre /manage-headers per corregir un error específic en la Política de Seguretat de Continguts o configura CORS.
  • Executa /manage-firewall per afegir un límit de velocitat a la pàgina d'inici de sessió o bloqueja el trànsit per país.
  • Executa /audit-permissions després de canviar els permisos de taula per verificar que encara coincideixen amb el codi del lloc.
  • Reexecuta /security-review amb l'objectiu del lloc desplegat per monitoritzar un lloc de producció al llarg del temps.

Verifica el teu lloc

Després d'acabar les habilitats, comprova que el teu lloc web de Power Pages funcioni correctament.

  1. Ves a Power Pages.
  2. Localitza el teu lloc a la llista de llocs actius .
  3. Previsualitza el teu lloc a l'escriptori utilitzant l'opció de Previsualització .
  4. Prova la funcionalitat.

Promociona el teu lloc web a través d'entorns

Després que el teu lloc funcioni en l'entorn de desenvolupament, utilitza les habilitats de gestió del cicle de vida de l'aplicació (ALM) per promocionar-lo als entorns de prova i producció. El plugin empaqueta el teu lloc com una solució Power Platform, identifica valors que varien segons l'entorn i desplega la solució a través de Power Platform Pipelines o mitjançant exportació i importació manual.

Per utilitzar les habilitats ALM, també necessites almenys un entorn objectiu de Power Platform (prova, producció o ambdós). Per utilitzar el flux opcional d'Azure Key Vault per a secrets, també necessites permís per crear una caixa forta de claus a la teva subscripció d'Azure.

Planificar el desplegament

Corre /plan-alm per començar. /plan-alm és el punt d'entrada a l'ALM i orquestra les altres habilitats de l'ALM, així que normalment no les executes directament. El plugin:

  1. Detecta l'estat actual del teu projecte, la solució i els entorns objectiu.
  2. Pregunta sobre la teva estratègia de promoció (Power Platform Pipelines o exportació i importació manual), les etapes objectiu i qualsevol restricció a aplicar.
  3. Genera un pla visual que docs/alm-plan.html mostra cada acció que pretén dur a terme.
  4. Espera la teva aprovació abans d'executar qualsevol habilitat posterior.

El pla persisteix al disc, així que cada habilitat avall llegeix i escriu al mateix pla persistent. Si una fase falla, torna a executar-la /plan-alm i es reprèn des d'on s'ha aturat.

Autor de la solució

Corre /setup-solution per empaquetar el teu lloc com una solució Power Platform. El plugin:

  1. Crea un editor i una solució, i després afegeix els teus components de Power Pages: el lloc, els rols web, els punts finals de lògica del servidor, els registres de flux al núvol i la configuració del proveïdor OAuth.
  2. Classifica cada entorn del lloc per sensibilitat i proposa variables ambientals per a valors que varien segons l'entorn.
  3. Ofereix provisionar un Azure Key Vault i emmagatzemar-hi valors de tipus credencial, com cadenes de connexió i claus API.
  4. Funciona en mode sincronitzat quan ja existeix una solució per al teu lloc, per conciliar components sense crear una solució nova.

Revises i aproves la proposta. El connector no crea cap configuració fins que no ho confirmis.

Propina

Si la teva solució és massa gran o entrellaçada per desplegar-la de manera fiable, el connector recomana una divisió i proposa on dividir-la. Confirma la divisió abans que s'apliquin els canvis.

Desplegar amb pipelines de Power Platform

Si has triat Power Platform Pipelines com a estratègia de promoció, el connector executa aquestes habilitats:

  1. /ensure-pipelines-host provisiona o detecta un entorn hoste per a Power Platform Pipelines. L'habilitat tria l'opció de menor cost disponible per al teu llogater: un hoste de plataforma gratuït, l'aplicació Pipelines en un entorn existent o un host personalitzat.
  2. /setup-pipeline registra una definició de pipeline a Dataverse, configura les etapes que has triat i vincula cada etapa a un entorn objectiu.
  3. /deploy-pipeline activa un desplegament per a una etapa, aplica sobreescriptures de variables d'entorn per etapa a través de deploymentSettings.json, i fa un seguiment de l'estat en un llibre major de desplegament.

Si un desplegament falla perquè l'entorn objectiu ja està vinculat a un host diferent de Power Platform Pipelines, el connector pot executar-se /force-link-environment per reassignar-lo. L'acció requereix el teu consentiment explícit i és reversible.

Desplega amb exportació i importació manuals

Si tries el camí manual, el connector funciona:

  1. /export-solution per exportar la solució com a ZIP gestionat o no gestionat, amb una comprovació de completitud abans de l'exportació.
  2. /import-solution per importar el ZIP a l'entorn de destinació, ja sigui per fases per verificar les dependències primer o directament.

Activa i valida el lloc desplegat

Després d'un desplegament reeixit a l'entorn objectiu, el connector:

  1. S'executa /activate-site per provisionar la URL pública a l'entorn objectiu.
  2. S'executa /test-site per verificar el desplegament. El connector utilitza un navegador per rastrejar pàgines representatives, executar comprovacions d'accés basades en rols, verificar /_api/ trucades i capturar formes de resposta dels /_api/serverlogics/ punts finals. L'habilitat informa del resultat com PASS, WARNINGS, o FAIL, amb detalls per xec enllaçats des del pla.

Si un pas falla, el connector s'executa /diagnose-deployment. L'habilitat compara la fallada amb un catàleg d'errors de desplegament coneguts, com ara un manifest obsolet, dependències mancants, conflictes d'amfitrió, JavaScript bloquejat o autenticació caducada, i proposa una solució concreta. El connector mai aplica una solució sense el teu consentiment.

Nota

Cada habilitat ALM llegeix i escriu en artefactes al disc: el manifest de la solució, les dades del pla, el llibre major de la canonada, el llibre major de desplegament i els resultats de proves. L'orquestració és reprenible i auditable. Per veure què passava en cada pas, inspecciona els artefactes.

Consells i bones pràctiques

Els següents consells t'ajudaran a treure el màxim profit del plugin i de l'agent de codificació d'IA quan creïs llocs de Power Pages.

Mira la sortida del terminal per eines que falten a la primera execució

El connector proporciona les habilitats i fluxos de treball, però l'agent de codificació d'IA - GitHub Copilot CLI o Claude Code - executa les ordres reals a la teva màquina. Quan utilitzis aquestes eines per primera vegada, observa atentament la sortida del terminal. L'agent de codificació d'IA executa ordres i scripts entre bastidors, i alguns d'aquests depenen d'eines que potser no estan instal·lades a la teva màquina. Si un pas falla, la sortida del terminal normalment mostra quina eina o comanda no ha pogut trobar.

Si veus un error com command not found o is not recognized, instal·la l'eina que falta i torna a activar el flux de treball. L'agent de codificació d'IA continua on ho va deixar després que l'eina estigui disponible.

Revisa les propostes dels agents abans d'aprovar-les

L'agent de codificació d'IA presenta propostes, com ara les de l'Arquitecte de Models de Dades i l'Arquitecte de Permisos, abans de fer canvis. El codi i la configuració generats per l'agent de codificació d'IA poden ser inexactes, així que revisa, prova i valida cada proposta i tot el codi generat abans d'aprovar-lo o desplegar-lo.

  • Propostes de models de dades: Comprova que els noms de taules, tipus de columnes i relacions coincideixin amb els requisits del teu negoci. És més fàcil ajustar una proposta que renombrar columnes després que ja s'hagin inserit dades.
  • Propostes de permisos: Verifica que cada rol tingui el nivell de access correcte (crear, llegir, actualitzar, eliminar) per a cada taula. Els permisos excessivament permissius a les taules són un risc de seguretat comú.
  • Codi generat: Llegeix el codi generat i prova el lloc localment abans de desplegar. El codi generat per IA pot contenir errors o problemes de seguretat.

Enganxar errors directament amb context

Quan alguna cosa falla, ja sigui un error de compilació, un error de desplegament o una excepció en temps d'execució al navegador, copia la sortida completa de l'error. Enganxa-ho juntament amb una breu descripció del que estaves fent. Com més context donis, més ràpid serà la solució.

Exemple: Error de construcció

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>

Propina

Inclou el nom de l'arxiu, l'ordre que vas executar i què esperaves que passés. El connector utilitza aquest context per localitzar el problema i aplicar una solució específica en lloc d'endevinar.

Comparteix errors de l'API web amb l'URL completa de la sol·licitud

Un problema comú després del desplegament és un error 403 de l'API web de Power Pages quan una columna no està habilitada per accedir a l'API. Quan et trobis amb aquest error, enganxa l'URL completa de l'API i la resposta completa a l'error JSON. El missatge d'error t'indica exactament quina taula i columna cal arreglar, i el connector pot actualitzar el permís de taula, el YAML i la configuració del lloc per tu.

Exemple: Columna no activada per a 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"
    }
  }
}

Aquest error (AttributePermissionIsMissing) significa que la columna _crd50_propertyid_value de cerca existeix a la taula Dataverse però no apareix a la configuració de permisos de la taula per a l'API web. El connector resol aquest error afegint la columna que faltava al permís YAML .powerpages-site/table-permissions/ de la taula i tornant a desplegar.

Nota

Power Pages Web API requereix que cada columna retornada per una crida a l'API estigui explícitament llistada a la taula de permisos. Les propietats de cerca (prefixades i _ sufixades amb _value) són fàcils de passar per alt perquè el nom de la seva API difereix del nom lògic de la columna a Dataverse. Quan ho vegis AttributePermissionIsMissing, sempre afegeix aquesta columna al permís de la taula. No canviïs la consulta de l'API.

Sigues específic sobre el que vols

Les peticions vagues produeixen resultats vagues. Digues-li exactament al connector què necessites, incloent-hi preferències de disposició, camps de dades i comportament.

En lloc de Provar
"Fes una pàgina per a feines" "Crea una pàgina d'ofertes de feina amb una barra de cerca a la part superior, filtra xips per ubicació i departament, i una quadrícula de targetes que mostri el títol, l'empresa, el rang salarial i una data publicada per a cada feina"
"Arregla l'estil" "Les fitxes de feina s'apilen verticalment a l'escriptori. Fes que s'exhibeixin en una quadrícula de tres columnes amb un espai de 16px a pantalles més amples que 768px"
"Afegeix dades" "Afegeix 20 exemples d'ofertes de feina en quatre departaments (Enginyeria, Màrqueting, Vendes, Recursos Humans) amb títols realistes, rangs salarials entre $60k i $180k, i dates publicades en els últims 30 dies"
"Configurar l'API" "Connecta el component JobListings a la taula cr_jobposting Dataverse. Substitueix l'array codificat fixament per una crida real a l'API que obtingui el títol, departament, salari i data de publicació"
"Afegir inici de sessió" "Configura l'inici de sessió de Microsoft Entra External ID amb registre obert, més Google com a segon proveïdor. Mostra'ls com una fila horitzontal a la pàgina d'inici de sessió."

Utilitza captures de pantalla per a problemes visuals

Quan el lloc no es veu bé al navegador, fes una captura de pantalla i enganxa-la directament a la conversa o proporciona una ruta de fitxer. El context visual ajuda a identificar problemes de disposició, espaiat i estil que són difícils de descriure en un text.

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.

Iterar en petits passos

En lloc de descriure tot un lloc en una sola proposta, construeix de manera incremental. Comença per l'estructura i la distribució, i després afegeix característiques una a una. Aquest enfocament et dóna l'oportunitat de revisar i corregir el rumb en cada pas.

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

Propina

Després de cada pas, comprova la previsualització del navegador. Si alguna cosa no va bé, arregla-ho abans de continuar. És més fàcil arreglar problemes en un sol component que desenredar problemes a tot un lloc.

Demana una explicació abans d'aprovar

Quan no estiguis segur d'un canvi proposat, especialment pel que fa a permisos, modificacions del model de dades o configuració d'autenticació, demana al connector que t'expliqui què to do i per què abans d'aprovar-lo.

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

Executa habilitats de manera independent per recuperar-te dels problemes

Si una habilitat falla a mig camí, no cal començar de nou. Cada habilitat funciona de manera independent i pot continuar on ho va deixar. Per exemple, si /integrate-webapi falla a la tercera taula, la pots tornar a executar i detecta la feina ja completada.

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

Contingut relacionat

  • Last updated on