GitHub Copilot CLI:n ja Claude Coden Power Pages laajennuksen käytön aloittaminen

GitHub Copilot CLI:n ja Claude Coden Power Pages -laajennus tarjoaa tekoälyavusteisen työnkulun modernien yksisivuisten sovellussivustojen (SPA) luomiseen, käyttöönottoon ja hallintaan Power Pagesilla. Sen sijaan, että projektit rakenneisiin manuaalisesti, kirjoittaisit kattilaalustan ohjelmointirajapintakoodia ja määrittäisit käyttöoikeudet, kuvailet, mitä haluat luonnollisella kielellä, ja laajennus käsittelee toteutuksen.

Laajennus tukee sivuston koko kehittämisen elinkaarta keskustelutaitojen avulla uuden sivuston luomisesta sen käyttöönottoon, Dataverse-tietomallien määrittämiseen ja todentamisen määrittämiseen.

Tärkeää

  • Luotu tekoälykoodausagentti, kuten GitHub Copilot CLI tai Claude Code, käyttää laajennuksen taitoja ja työnkulkuja Power Pages tehtävien suorittamiseen.
  • Tekoälykoodausagentin luoma koodi ja määritys voivat olla virheellisiä. Tarkista, testaa ja vahvista kaikki luotu sisältö, ennen kuin hyväksyt tai otat sen käyttöön. Tarkista aina agenttiehdotukset ennen niiden hyväksymistä.

Edellytykset

Ennen kuin aloitat, varmista, että sinulla on tarvittavat ohjelmistot ja käyttöoikeudet.

Ohjelmistovaatimukset

Komponentti Vähimmäisversio Lisätietoja
Node.js 18.0 tai uudempi Lataa Node.js
Power Platform CLI (PAC CLI) 2.6.3 tai uudempi (palvelinlogiikan edellyttämä) ASENNA PAC CLI
Azure CLI Latest Azure CLI:n asentaminen
GitHub Copilot CLI tai Claude Code Latest GitHub Copilot CLI tai Claude Code
Visual Studio Code- ja Power Platform Tools -laajennus (valinnainen) Latest Lataa VS Code ja asenna Power Platform -työkalut

Tarvitset myös seuraavat:

  • Power Platform -ympäristö, jossa Power Pages on käytössä.
  • Kohdeympäristöön yhdistetty todennettu PAC CLI -istunto. Suorita pac auth create , jos et ole vielä muodostanut yhteyttä.
  • Azure CLI -istunto on kirjautunut sisään samaan vuokraajaan. Suorita az login --allow-no-subscriptions todentaaksesi.

Vahvista todentaminen:

Varmista todentautuneesi - käytä komentoa pac auth list.

pac auth list           # Should show authenticated profile

Jos sinua ei ole todennettu, suorita tämä komento:

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

Vinkki

Saat esiintymän URL-osoitteen siirtymällä Power Pagesin aloitussivulle, valitsemalla Asetukset-kuvakkeen oikeassa yläkulmassa ja valitsemalla sitten Istunnon tiedot.

Laajennuksen asentaminen

Asenna Power Pages-laajennus Marketplacesta. Jos käytät GitHub Copilot CLI:tä, katso vastaavat asennusohjeet Copilot CLI -laajennusten dokumentaatiosta. Seuraavissa komennoissa käytetään Claude Code -syntaksia.

Suorita asennusohjelma, jotta voit määrittää kaikki laajennukset niin, että automaattinenupdate on käytössä:

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

Asennusohjelma automaattisesti:

  • Asentaa komentorivikäyttöliittymän, pac jos sitä ei ole vielä asennettu.
  • Havaitsee käytettävissä olevat työkalut, kuten Claude Coden ja GitHub Copilot CLI:n.
  • Rekisteröi laajennuksen Marketplacen ja asentaa kaikki luetellut laajennukset.
  • Ottaa käyttöön automaattiset päivitykset, jotta laajennukset pysyvät ajan tasalla.

Asennuksen jälkeen käynnistä Claude Code tai GitHub Copilot CLI käyttääksesi laajennuksen taitoja vinokomentoina agenttiistunnossasi.

Asenna Marketplacesta

  1. Avaa Claude Code päätteessäsi.

  2. Lisää Microsoft Marketplace:

    /plugin marketplace add microsoft/power-platform-skills

  3. Asenna Power Pages-laajennus:

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

Kun olet asentanut laajennuksen, käynnistä Claude Code tai GitHub Copilot CLI uudelleen päästäksesi laajennuksen ominaisuuksiin vinoviivakomennoilla agenttisi istunnossa.

Vinkki

Jos haluat saada Marketplacen päivitykset ja taidot automaattisesti, ota automaattinen päivitys käyttöön. Käytä komentoa /plugin , siirry Marketplaceen, valitse Marketplace ja ota automaattinen päivitys käyttöön.

Taitojen yleiskatsaus

Laajennus tarjoaa taitoja, jotka kattavat Power Pages -sivuston koko elinkaaren. Voit käynnistää kunkin taidon keskustelukohtaisesti joko vinoviivakomennona tai kuvailemalla, mitä haluat tehdä.

Osaamisalue Komento Toiminnot
Luo sivusto /create-site Sivustorakenne, suunnittelusuunnan käyttäminen ja sivujen ja osien koostaminen
Ota sivusto käyttöön /deploy-site Luo projektin ja lataa sen Power Pages PAC CLI:n avulla
Aktivoi sivusto /activate-site Asettaa verkkosivuston tietueen ja määrittää julkisen URL-osoitteen
Tietomallin määrittäminen /setup-datamodel Luo Dataverse-taulukoita, -sarakkeita ja -suhteita
Mallitietojen lisääminen (valinnainen) /add-sample-data Täyttää Dataverse-taulukot realistisin testitietuein
Integroi WWW-ohjelmointirajapinta /integrate-webapi Luo kirjoitetun ohjelmointirajapinnan asiakaskoodin, palvelut ja taulukon käyttöoikeudet
Tekoälyyhteenvetojen lisääminen /add-ai-webapi Integroi tekoälyn yhteenveto-ohjelmointirajapinnat (hakuyhteenveto ja tietojen yhteenveto) sivuillesi. Luo kirjoitetun yhteenvetopalvelun väärennösten vastaisella tunnuksen käsittelyllä, sovelluskehyskohtaisilla paketoinneilla, lankapuhelusivustoilla ja vastaavilla Summarization sivuston asetuksilla
Todennuksen määrittäminen /setup-auth Lisää sisäänkirjautumisen, sisäänkirjautumisen ja roolipohjaisen käytön hallinnan. Tukee Microsoft Entra ID, Ulkoinen Microsoft Entra -tunnus, OpenID Connectin, SAML 2.0:n, WS-liittoutumisen, Microsoft-tili,Facebookin, Googlen ja paikallisen käyttäjänimen ja salasanan todennusta, mukaan lukien monen palveluntarjoajan määritykset
Verkkoroolien luominen /create-webroles Luo verkkoroolin YAML-tiedostot käyttäjien pääsyn hallintaan
Lisää palvelinlogiikka /add-server-logic Luo suojattuja palvelinpuolen JavaScript-päätepisteitä vahvistusta, ulkoisia ohjelmointirajapintakutsuja, salaisten koodien hallintaa ja tietotoimintoja varten
Pilvityönkulun lisääminen /add-cloud-flow Integroi olemassa olevat Power Automate pilvipalvelutyönkulut sivustoosi hyväksynnän työnkulkuja, ilmoituksia ja ajoitettua automaatiota varten
Integroi tausta /integrate-backend Analysoi prototyypin, määrittää oikean lähestymistavan (WWW-ohjelmointirajapinta, palvelinlogiikka tai pilvipalvelutyönkulku) kullekin ominaisuudelle ja järjestää koko koontiversion
Lisää SEO /add-seo Luo robots.txt-, sitemap.xml- ja metatunnisteet
Suorita suojauksen tarkistus /security-review Se järjestää keskitetyt suojaustaidot ja kokoaa jokaisen löydön yksittäiseksi HTML-raportiksi. Kattaa koodin, riippuvuudet, käyttöönotetun sivuston tarkistuksen, selaimen otsikot, verkkosovelluksen palomuurin, taulukon käyttöoikeudet ja todentamisen määritykset
Skannaa lähdekoodi /scan-code Suorittaa staattisen analyysin ja riippuvuuksien tarkistuksen paikallisista lähdetiedostoista. paljastaa koodimallien, haavoittuvassa asemassa olevien pakettien, kiinteästi koodattuja salaisia koodauksia ja käyttöoikeusongelmia
Skannaa käyttöönotettu sivusto /scan-site Käynnistää palvelinpuolen suojaustarkistuksen reaaliaikaisella sivustolla, hakee uusimman raportin ja ryhmittelee havainnot vakavuusasteen mukaan
Selaimen suojausotsikoiden hallinta /manage-headers Tarkistaa ja määrittää sivuston selaimiin lähettämät HTTP-suojausotsikot – sisällön suojauskäytäntö, kehys- ja napsautussuojaus, alkuperän välinen jakaminen, evästeiden toiminta ja siihen liittyvät sivuston asetukset
Verkkosovelluksen palomuurin hallinta /manage-firewall Tarkastaa ja määrittää verkkosovelluksen palomuurin tuotantosivustossa: mahdollistaa suojauksen, lisää tai poistaa IP-lohkoja, maalohkoja, polkulohkoja ja hintarajoituksia
Valvontataulukon käyttöoikeudet /audit-permissions Auditoi olemassa olevat taulukon käyttöoikeudet sivuston koodia ja Dataversen metatietoja vastaan; tuottaa HTML-raportin, joka on ryhmitelty vakavuusasteen mukaan ehdotettujen korjausten avulla
Käyttöönoton suunnittelu /plan-alm Havaitsee projektitilan, kerää ylentämisstrategian, hahmontaa visuaalisen suunnitelman ja järjestää muut sovelluksen elinkaaren hallinnan (ALM) taidot oikeassa järjestyksessä
Tekijäratkaisu /setup-solution Luo julkaisijan ja ratkaisun, lisää Power Pages komponentteja, luokittelee sivuston asetukset ja ehdottaa ympäristömuuttujia ja Azure Key Vault salaisuuksia
Putki-isännän määrittäminen /ensure-pipelines-host Luo tai tunnistaa Power Platform Pipelinesin isäntäympäristön
Putken määrittäminen /setup-pipeline Rekisteröi putken määrityksen Dataversessa ja sitoo ylentämisvaiheet kohdeympäristöihin
Ota käyttöön putken kautta /deploy-pipeline Käynnistää putkiston käyttöönoton kohdevaiheelle vaihekohtaisten ympäristömuuttujien ohituksilla
Pakotetun linkityksen ympäristö /force-link-environment Määritä kohdeympäristö uudelleen uuteen Power Platform -putkien isäntään, kun isäntäristiriita estää käyttöönoton
Ratkaisun vieminen /export-solution Vie ratkaisun hallittuna tai hallitsemattomana zip-tiedostona ja tarkistaa täydellisyystarkistuksen ennen vientiä
Ratkaisun tuominen /import-solution Ratkaisun zip-tiedoston tuominen kohdeympäristöön, vaiheistettuun tai suoraan
Testisivusto /test-site Tarkistaa käyttöönotetun sivuston selainpohjaisella testillä: sivujen selaaminen, roolipohjaiset käyttöoikeustarkistukset ja WWW-ohjelmointirajapinnan tarkistus
Käyttöönoton vianmääritys /diagnose-deployment Vastaa käyttöönoton virheitä tunnettujen virheiden luetteloon nähden ja ehdottaa korjausta

Tyypillinen työnkulku

Yleinen päästä päähän -työnkulku noudattaa seuraavaa järjestystä:

  1. /create-site : Luonnostele, suunnittele ja rakenna sivuja
  2. /deploy-site: Lataa Power Pages ympäristöösi
  3. /activate-site: Määritä julkinen URL-osoite
  4. /setup-datamodel : Luo Dataverse-taulukoita
  5. /add-sample-data : Taulukoiden täyttäminen testitietueilla
  6. /integrate-webapi : Luo ohjelmointirajapinta-asiakaskoodi ja määritä käyttöoikeudet
  7. /create-webroles: Määritä access roolit
  8. /setup-auth : Lisää sisäänkirjautuminen, uloskirjautuminen ja roolipohjainen käyttöliittymä
  9. /add-server-logic : Lisää suojattuja palvelinpuolen päätepisteitä
  10. /add-cloud-flow: Aiemmin luotujen Power Automate työnkulkujen integrointi
  11. /add-seo : Hakukoneoptimointi
  12. /deploy-site : Lähetä lopulliset muutokset reaaliaikaisesti
  13. /security-review : Suorita päästä päähän -suojausarviointi ennen tuotantoon aloittamista
  14. /plan-alm: Sivuston ylentäminen testi- ja tuotantoympäristöihin

Vinkki

  • Sinun ei tarvitse noudattaa tätä tarkkaa järjestystä. Jokainen taito tarkistaa omat edellytyksensä ja kertoo, puuttuuko siitä jotain. Voit /setup-auth suorittaa komennon ennen todennusta /integrate-webapi , jos sivustosi tarvitsee ensin todentamisen.
  • Jos et ole varma, mitä lähestymistapaa kussakin ominaisuudessa käytetään, suorita /integrate-backend vaiheiden 4–10 sijaan yksitellen. Se analysoi prototyypin ja määrittää, tarvitseeko kukin ominaisuus WWW-ohjelmointirajapintaa, palvelinlogiikkaa vai pilvipalvelutyönkulkua, ja järjestää taidot oikeassa järjestyksessä.
  • Jos haluat lisätä tekoälyn luomia haku- ja tietueyhteenvedoja, suorita /add-ai-webapi :n jälkeen /integrate-webapi. Se käyttää uudelleen määritettyjä taulukon käyttöoikeuksia ja sivuston asetuksia /integrate-webapi , joten suorita se, kun WWW-ohjelmointirajapinnan integrointi on määritetty.

Luo Power Pages -sivustosi

Näissä vaiheittaisissa ohjeissa käsitellään Power Pages -sivuston luomisen koko elinkaarta laajennuksen avulla koko rakennevaiheesta käyttöönottoon asti. Jokaisessa vaiheessa kuvataan, mitä sanot ja mitä laajennus tekee vastaukseksi.

Vaihe 1: Luo sivustosi

Kuvaile haluamasi sivusto luonnollisella kielellä: mitä varten se on tarkoitettu, mitä sivuja se tarvitsee ja mitkä tahansa suunnitteluasetukset, kuten värimalli, asettelutyyli tai fontit. Suorita /create-site sivustosi tai vain kuvaa sivustosi, niin laajennus tunnistaa tarkoituksen.

Jos et määritä kehystä, laajennus pyytää sinua valitsemaan sellaisen (React, Vue, Angular tai Astro), ja sitten:

  1. Luo projektin mallipohjasta ja soveltaa sivustosi nimeä, värejä ja suunnittelumääritteitä.
  2. Asentaa riippuvuuksia, käynnistää kehityspalvelimen ja avaa reaaliaikaisen selaimen esikatselun.
  3. Luo kaikki pyytämäsi sivut, komponentit ja reitit asianmukaisilla kuvilla.
  4. Luo Git-vahvistuksia merkittävien välitavoitteiden mukaan, joten sinulla on sisäinen palautushistoria.

Vaihe 2: Sivuston käyttöönotto

Lataa sivustosi Power Pagesiin suorittamalla /deploy-site . Laajennus:

  1. Varmistaa, että PAC CLI on asennettu ja että todentamisistuntosi on aktiivinen.
  2. Vahvistaa kohdeympäristön kanssasi ennen jatkamista.
  3. Suorittaa tuotannon koontiversiota ja lataa käännetyn tuloksen.
  4. Luo käyttöönoton artefaktien hakemiston, jos sellaista ei vielä ole olemassa.

Muistio

Jos ympäristösi estää tietyt tiedostoliitteet, laajennus havaitsee ongelman ja antaa ohjeet sen ratkaisemiseen.

Vaihe 3: Aktivoi sivustosi

Suorita /activate-site , jotta sivusto on julkisesti käytettävissä. Laajennus:

  1. Ehdottaa sivustosi nimeen perustuvaa alitoimimaa ja mahdollistaa sen mukauttamisen.
  2. Tarjoaa sivustotietueen Power Platform -ohjelmointirajapinnan kautta.
  3. Kyselyt, kunnes sivusto on julkaistu ja palauttaa julkisen URL-osoitteen.

Tässä vaiheessa sinulla on työsivusto julkisessa URL-osoitteessa. Muut vaiheet lisäävät tiedot, todentamisen ja hakukoostamisen. Ohita kaikki vaiheet, jotka eivät koske sivustoasi.

Vaihe 4: Tietomallin määrittäminen

Luo sivustosi tarvitsemat Dataverse-taulukot suorittamalla /setup-datamodel tämä. Jos sinulla on jo ER-kaavio tai tietty rakenne, anna se suoraan sen sijaan, että agentti analysoisi koodisi.

Laajennus synnyttää tietomallin arkkitehtiagentin , joka:

  1. Analysoi sivustosi koodin määrittääkseen, mitä tietoja sivut ja komponentit tarvitsevat.
  2. Tekee kyselyn Dataverse-ympäristöstäsi aiemmin luoduille taulukoille kaksoiskappaleiden välttämiseksi.
  3. Ehdottaa tietomallia, joka sisältää TAULUKOIta, sarakkeita, tietotyyppejä ja suhteita ja joka on visualisoitu ER-kaavioksi.

Tarkistat ja hyväksyt ehdotuksen. Laajennus ei luo mitään, ennen kuin vahvistat sen. Hyväksynnän jälkeen laajennus luo taulukot ja sarakkeet API-kutsujen kautta ja tallentaa kokoonpanotiedoston, jota vaiheet 5 ja 6 käyttävät.

Vaihe 5: Mallitietojen lisääminen (valinnainen)

Suorita /add-sample-data , jotta voit täyttää taulukot testitietueilla. Tämä vaihe edellyttää tietomallia vaiheesta 4.

Laajennus suorittaa seuraavat toiminnot:

  1. Lue lisää luettelotiedostosta, jotta opit ymmärtämään taulukoita, sarakkeita ja suhteita.
  2. Luo tilannekohtaisesti sopivat arvot kullekin saraketyypille, kuten realistiset sähköpostiviestit, uskottavat päivämäärät ja muotoillut valuuttasummat.
  3. Lisää tietueet riippuvuusjärjestyksessä (päätaulukot ennen alitaulukoita) ja päivittää todennustunnukset automaattisesti joukkolisäysten aikana.

Vaihe 6: Integroi Dataverse Web API :n kanssa

Suorita /integrate-webapi , jos haluat korvata pilkkatiedot reaaliaikaisella Dataverse-kyselyllä. Tämä vaihe edellyttää tietomallia vaiheesta 4.

Laajennus suorittaa seuraavat toiminnot:

  1. Tarkastaa koodipohjan komponentteja, jotka käyttävät mallitietoja, paikkamerkkihakukutsuja tai kiinteästi koodattuja taulukoita. Se yhdistää nämä komponentit Dataverse-taulukoihin.
  2. Muodostaa WWW-ohjelmointirajapinnan integrointiagentin kullekin taulukolle, joka luo:
    • Jaettu ohjelmointirajapinta-asiakas, jolla on väärennösten vastainen tunnuksen hallinta ja uudelleenyritysten logiikka.
    • TypeScript-entiteettityypit ja toimialueen yhdistäjät.
    • CRUD-palvelukerros.
    • Sovelluskehyskohtaiset mallit, kuten React-koukkuja, Vue-säilöjä tai Angular-palveluita.
  3. Luo käyttöoikeusarkkitehti-agentti, joka ehdottaa taulukon käyttöoikeuksia ja sivuston asetuksia.

Tarkistat ja hyväksyt käyttöoikeusehdotuksen. Laajennus ei luo määritystiedostoja, ennen kuin vahvistat ne.

Lisää tekoälyn luomia yhteenvetoja (valinnainen)

Suorita /add-ai-webapi kerrostavia tekoälyyhteenvedoita WWW-ohjelmointirajapinnan integroinnin lisäksi. Taito yhdistää kaksi esikatselun yhteenveto-ohjelmointirajapintaa tietue- ja luettelosivuihin:

  • Haun yhteenvedon ohjelmointirajapinta: palauttaa tekoälytiivistetyt yhteenvedot hakutuloksista lainausteineen.
  • Tietojen yhteenvedon ohjelmointirajapinta: palauttaa tietuekohtaisen yhteenvedon tai luettelotason merkitykselliset tiedot Dataverse-taulukolle.

Tämä vaihe perustuu vaiheen 4 tietomalliin ja vaiheen 6 VERKKO-ohjelmointirajapinnan integrointiin. Laajennus suorittaa seuraavat toiminnot:

  1. Tarkistaa koodista yhteenvedon integrointipisteet ja vahvistaa kohdesivut, taulukot ja käytettävät ohjelmointirajapinnat.
  2. Delegoi mahdolliset puuttuvat WWW-ohjelmointirajapinnan edellytykset – taulukon käyttöoikeudet, sarakeluettelot ja verkkoroolit – ille /integrate-webapi ja /create-webroles, joten käyttöoikeuksille on yksi ainoa totuuden lähde.
  3. Muodostaa tekoälyn www-ohjelmointirajapinnan integrointiagentin , joka luo kirjoitetun yhteenvetopalvelun (aiSummaryService.ts), joka käsittelee väärennösten vastaisia tunnuksia, sovelluskehyskohtaisia paketoijia (React-koukkuja, Vue-säilöjä tai Angular-palveluja) sekä kohdesivuille liitettyjä puhelusivustoja.
  4. Muodostaa tekoälyn WWW-ohjelmointirajapinnan asetukset Arkkitehtiagentti , joka luo Summarization kehotteiden ja sisältörajoitusten sivuston asetukset.

Tarkistat ja hyväksyt ehdotukset. Laajennus ei luo koodia tai luo asetuksia, ennen kuin vahvistat sen.

Muistio

Yhteenvedon ohjelmointirajapinnat ovat esikatselutilassa ja riippuvat siitä, onko hallinta- ja sivustotason ohjausobjektit käytössä. Jos yhteenvetoja ei näy käyttöönoton jälkeen, varmista, että ominaisuus on otettu käyttöön asianmukaisilla sivuston asetuksissa ja järjestelmänvalvojan ohjausobjekteissa. Lisätietoja on artikkelissa Datan yhteenveto -ohjelmointirajapinnan yleiskatsaus ja Power Pages haku generative AI avulla.

Vaihe 7: Verkkoroolien luominen

Määritä käyttäjän access roolit suorittamalla /create-webroles. Laajennus:

  1. Tekee kyselyjä ympäristöstäsi aiemmin luotujen verkkoroolien osalta kaksoiskappaleiden välttämiseksi.
  2. Luo roolimääritykset yksilöivien tunnisteiden avulla.
  3. Valvoo, että jokaisella sivustolla on enintään yksi nimetön rooli ja yksi todennettu rooli.

Vaihe 8: Todennuksen määrittäminen

Suorita /setup-auth , jotta voit lisätä kirjautumisen, sisäänkirjautumisen ja roolipohjaisen käytön hallinnan sivustoosi. Laajennus tukee seuraavia tunnistetietopalveluja, ja voit määrittää yhden tai useita palveluita samanaikaisesti.

Tarjoaja Sopii parhaiten
Ulkoinen Microsoft Entra -tunnus (suositellaan asiakkaille suunnatuille sivustoille) Julkiset sivustot ja asiakasportaalit, joissa on omatoiminen rekisteröinti.
Microsoft Entra ID Sisäiset työntekijäportaalit tai yritysten väliset (B2B) kumppanisivustot. Power Pages määrittää automaattisesti sivuston päävuokraajan, joten sinun ei tarvitse antaa vuokraajan tietoja.
Microsoft, Facebook, Google Sosiaalinen sisäänkirjautuminen kuluttajayleisöille.
Paikallinen todentaminen Käyttäjänimen ja salasanan sisäänkirjautuminen. Ei suositella, ja se määritetään vain, kun pyydät sitä eksplisiittisesti.

Lisätietoja tuetuista palveluntarjoajista, mukaan lukien protokollat ja määritysnäkökohdat, on artikkelissa Overview of authentication in Power Pages.

Laajennus:

  1. Analysoi sivustosi (tarkoitus, sivut ja yleisö) ja ehdottaa merkitsevää oletusarvoa. Laajennus esimerkiksi ehdottaa Ulkoinen Microsoft Entra -tunnus avoimella rekisteröinnillä asiakaskohtaiseen sivustoon tai Microsoft Entra ID, jolla on vain kutsu -rekisteröinti sisäiseen portaaliin. Hyväksyt suosituksen tai valitset omat palveluntarjoajasi.
  2. Opastaa sinua jokaista palvelua varten tunnistetietopalvelun hallintakeskuksen kaikissa edellytyksistä, kuten vuokraajien luomisesta, sovellusten rekisteröimisestä, käyttäjien työnkulkujen luomisesta sekä asiakastunnusten tallentamisesta ja URI-osoitteiden uudelleenohjaamisesta. Laajennus vahvistaa jokaisen keskusteluun liittämäsi arvon ja laskee sivustosi tarkan uudelleenohjauksen URI-tunnuksen niin, että sovelluksen rekisteröintiin liitetty arvo vastaa sivuston asetuksiin kirjoitettua arvoa.
  3. Kysyy, miten käyttäjäprofiilin tiedot kulkevat tunnistetietopalvelusta Dataversen yhteystietotietueeseen (vaatimusten yhdistäminen), synkronoidaanko kaikki kirjautumiset vai vain ensimmäinen kirjautuminen, ja linkitetaankö ulkoiset kirjautumiset automaattisesti olemassa oleviin yhteystietoihin sähköpostitse.
  4. Luo todennuspalvelun, tyyppi-esittelyt, roolipohjaiset valtuutusapuohjelmat (hasRole, , RequireAuth), istunnon riittävyyskoukun, RequireRolejoka estää SPA-istuntojen hiljaisen umpeutumisen, ja kirjautumis-/uloskirjautumisen käyttöliittymäkomponentin, joka on integroitu sivuston asetteluun. Laajennus käyttää sovelluskehyksen malleja, kuten React-koukkuja, Vue-säilöjä, Angular-palveluita tai Astro-osia.
  5. Kun määritettynä on useampi kuin yksi palvelu, luo sivun, joka /login hahmonnetaan valitsemassasi asettelussa: vaakasuora rivi, pystypino, ensisijainen korostus tai sarkainta.
  6. Kirjoittaa kunkin palvelun, rekisteröintitilan, vaatimusten yhdistämismäärityksen ja valinnaisen ominaisuuden vastaavat sivustoasetukset .powerpages-site/site-settings/ .

Laajennus määrittää myös seuraavat valinnaiset ominaisuudet, kun otat ne käyttöön:

  • Käyttöehdot: /terms SPA-sivun käyttäjien on hyväksyttävä ennen kirjautumisen valmistumista sekä vastaavat sivuston asetukset ja sisältökatkelmat.
  • Käyttäjäprofiilisivu: A /user-profile SPA -sivu, jossa kirjautuneet käyttäjät muokkaavat yhteystietojaan Power Pages WWW-ohjelmointirajapinnan kautta.
  • Liitetty uloskirjautuminen: Kirjaa käyttäjän ulos myös tunnistetietopalvelussa, kun hän kirjautuu ulos sivustolta jaettujen laitteiden tai säänneltyjen skenaarioiden osalta.

Vinkki

Jos haluat lisätä toisen tunnistetietopalvelun aiemmin luotuun sivustoon, suorita /setup-auth uudelleen. Laajennus tunnistaa, mitä on jo määritetty, ja tarjoaa uuden palveluntarjoajan lisäämistä korvaamatta olemassa olevia. Tämä lähestymistapa on hyödyllinen lisäävässä skenaariossa, kuten alkaen Ulkoinen Microsoft Entra -tunnus ja myöhemmin lisäämällä Googlen sosiaaliseen kirjautumiseen.

Muistio

Asiakaspuolen valtuutus (RequireAuth, RequireRole, hasRole) on tarkoitettu vain käyttökokemukseen. Se ohjaa sitä, mitä käyttäjä näkee. /integrate-webapi määrittämät palvelinpuolen taulukon käyttöoikeudet varmistavat todellisen suojauksen.

Vaihe 9: Lisää palvelinlogiikka

Lisää suojattuja palvelinpuolen päätepisteitä sivustoosi suorittamalla tämä /add-server-logic . Käytä Palvelinlogiikkaa , kun sivustosi tarvitsee logiikkaa, joka ei voi toimia selaimessa, kuten ulkoiset ohjelmointirajapintakutsut, palvelinpuolen vahvistus, salaisen koodin hallinta tai entiteettien väliset tietotoiminnot.

Tärkeää

Palvelinlogiikan tuki edellyttää PAC-komentorivikäyttöliittymän versiota 2.6.3 tai uudempaa versiota. Päivitä uusimpaan versioon pika-asennuksen komentosarjan avulla.

Kuvaile, mitä tarvitset pelkällä kielellä, ja laajennus:

  1. Spawns a Server Logic Architect - agentti analysoi käyttötapauksesi ja luokittelee sen monimutkaisuuden.
  2. Ehdottaa päätepisteen rakennetta, suojausmääritystä ja mahdollisia vaadittuja taulukon käyttöoikeuksia arviointia varten.
  3. Kun olet hyväksynyt tämän, luo palvelinpuolen JavaScript-päätepisteen osoitteessa /_api/serverlogics/<name>.
  4. Luo kirjoitetun asiakaspuolen palvelun, joka käynnistää päätepisteen osistasi.
  5. Päivittää komponentit uuden palvelun kutsumista varten.
  6. Määrittää päätepisteen verkkoroolimääritykset ja taulukon käyttöoikeudet.

Tarkistat ja hyväksyt ehdotuksen. Koodia ei muodonneta ennen kuin vahvistat sen.

Yleisiä käyttötapauksia:

  • Yhteyden muodostaminen ulkoisiin palveluihin. Kutsu REST-ohjelmointirajapintoja, Azure-funktiot- tai kolmannen osapuolen palveluja ilman tunnistetietojen paljastamista. (Opetusohjelma: ulkoisten palveluiden käyttö)
  • Suorita suojattuja tietotoimintoja. Kysele, päivitä tai poista Dataverse-tietueita yhdenmukaisella palvelinpuolen vahvistuksilla. (Opetusohjelma: käsittele Dataverse-taulukoita)
  • Suorita mukautettu logiikka. Koosta tietoja taulukoista, valvo liiketoimintasääntöjä tai laske johdettuja arvoja ennen tulosten palauttamista asiakkaalle.
  • Hallitse salaisuuksia palvelinpuolella. Tallenna tunnistetiedot ja ohjelmointirajapinta-avaimet palvelimeen, ei koskaan asiakaskoodiin. (Tutorial: käsittele Microsoft Graph ja SharePoint)

Muistio

Suorita /add-server-logic kerran käyttötapausta kohden. Jos sivustosi tarvitsee esimerkiksi sekä varaston vahvistuksen päätepisteen että yleisen haun päätepisteen, suorita osaamista kahdesti.

Vaihe 10: Pilvityönkulkujen integrointi

Voit integroida olemassa olevat Power Automate pilvipalvelutyönkulut sivustoosi suorittamalla /add-cloud-flow. Tämä taito yhdistää Power Pages sivustosi työnkulkuihin, jotka olet jo luonut Power Automate. Se ei luo uusia pilvityönkulkuja.

Laajennus:

  1. Rekisteröi olemassa olevan pilvipalvelun työnkulun sivustossasi.
  2. Luo asiakaspuolen koodin, joka käynnistää työnkulun sivuiltasi.
  3. Käsittelee asynkronisen työnkulun tilan ja takaisinkutsumallit.
  4. Kytkee tiedonsiirron sivun ja työnkulun välillä.

Käytä /add-cloud-flow hyväksymisen työnkuluissa, sähköposti-ilmoituksissa, ajoitetuissa tehtävissä ja tapahtumapohjaisessa automaatiossa, jotka Power Automate käsittelee paremmin kuin palvelinpuolen päätepisteet.

Vaihtoehto: Käytä /integrate-backend suunnitellaksesi koko palvelukerroksen

Jos et ole varma, mitkä ominaisuudet tarvitsevat WWW-ohjelmointirajapinnan, palvelinlogiikan tai pilvipalvelun työnkulun, suorita /integrate-backend vaiheiden 4–10 manuaalisen suorittamisen sijaan. Tämä taito toimii orkestraattorina, joka:

  1. Analysoi prototyypin ja tunnistaa kaikki ominaisuudet, jotka tarvitsevat palvelutason.
  2. Luokittelee kunkin ominaisuuden oikean lähestymistavan: WWW-ohjelmointirajapinta vakio-CRUD:lle, Palvelinlogiikka palvelinpuolen vahvistukselle ja ulkoisille ohjelmointirajapinnoille tai pilvipalvelutyönkulku hyväksynnän työnkuluille ja automaatiolle.
  3. Ehdottaa jaksotettua suoritussuunnitelmaa, joka sisältää kaikki taidot, riippuvuudet ja kokoonpanot.
  4. Hyväksymisen jälkeen järjestät taidot oikeassa järjestyksessä.

Suunnitelma on pysyvä, jatkuvasti ja muokattavissa. Lopeta minkä tahansa vaiheen jälkeen, jos haluat tarkastella luotua koodia tai testata sivustoa, ja jatkaa siitä, mihin jäit, suorittamalla /integrate-backend se uudelleen.

Vaihe 11: Lisää SEO

Optimoi sivustosi hakukoneille suorittamalla /add-seo . Laajennus:

  1. Järjestelmän reititinmäärityksestä löydetään reittejä.
  2. Luo hakukonedirektiivejä ja sivustokartan kaikille löydetyille reiteille.
  3. Lisää metatunnisteet: näyttönäkymä, charset, kuvaus, Open Graph, Twitter Card ja favicon-viittaukset.

Vaihe 12: lopullisen sivuston käyttöönotto

Jos suoritat valinnaisia vaiheita, suorita /deploy-site se uudelleen, jotta muutokset lähetetään reaaliajassa. Laajennus suorittaa tuotannon koontiversion ja lataa sivuston kaikki käyttöönottoarteaktit (taulukon käyttöoikeudet, sivuston asetukset, verkkoroolit, palvelinlogiikkatiedostot) Power Pages ympäristöön.

Vaihe 13: Suorita suojauksen tarkistus

Suorita /security-review sivustosi suojausarviointi päästä päähän ennen tuotantoon aloittamista. Taito järjestää keskitetyt suojaustaidot ja kokoaa kaikki löydöt yksittäiseksi HTML-raportiksi osoitteessa docs/security-review-<timestamp>.html.

Laajennus esittää yhden pelkkään kieleen perustuvan kysymyksen tavoitteestasi ja valitsee keskitetyt taidot:

Tavoite Mitä se tarkistaa
Koodi ja määritys Lähdekoodi, riippuvuudet, taulukon käyttöoikeudet ja todentamisen määritys. Toimii vain paikallisissa tiedostoissa – käyttöönottoa ei tarvita.
Julkaisuvalmius (suositus) Täydellinen katsaus ennen julkaisemista. Suorittaa jokaisen keskitetyn taidon: koodin ja riippuvuudet, käyttöönotetun sivuston tarkistuksen, selaimen suojausotsikot, verkkosovelluksen palomuurin, taulukon käyttöoikeudet ja todentamisen.
Käyttöönotetut sivustot Vain reaaliaikaisten käyttöön otettujen sivustojen skannaus. Tästä on hyötyä julkaistun sivuston jatkuvassa seurannassa.

Kun olet vahvistanut tämän, laajennus suorittaa vastaavat keskitetyt taidot rinnakkain ja kirjoittaa havaintonsa yhteen raporttiin:

  • /scan-code: Suorittaa staattisen analyysin (opengrep) ja riippuvuussuhteen skannaamisen (trivy) paikallisille lähdetiedostoille. Se sisältää koodimalleja, haavoittuvassa asemassa olevia paketteja, kiinteästi koodattuja salaisia koodauksia ja käyttöoikeusongelmia. Jos jompikumpi työkalu ei ole asennettu, taidot tarjoavat manuaalisen kooditarkistelun varakeinona.
  • /scan-site: Käynnistää palvelinpuolen suojaustarkistuksen reaaliaikaista sivustoa vasten ja hakee uusimman raportin. Skannauksen kesto riippuu sivuston koosta : pienet sivustot päättyvät minuuteissa, suuret sivustot voivat kestää tunteja. Havainnot on ryhmitelty vakavuuden mukaan. Edellyttää käyttöönotetun sivuston.
  • /manage-headers: Tutkii HTTP-suojausotsikot, jotka on määritetty seuraavissa .powerpages-site/site-settings/toiminnoissa: Sisällön suojauskäytäntö, X-Frame-Options, CORS, cookie SameSite ja siihen liittyvät asetukset. Tunnistaa puuttuvat tai heikot arvot ja ehdottaa suositeltuja oletusarvoja.
  • /manage-firewall: Tarkastaa verkkosovelluksen palomuurin tuotantosivustossa, mukaan lukien hallitun säännön tila ja mukautetut säännöt (IP-lohkot, maalohkot, polkulohkot, hintarajoitukset). Käytettävissä vain tuettujen alueiden tuotantokohteissa; havaitsee taidon ja raportoi kelpoisuuden ongelmista.
  • /audit-permissions: Valvoe olemassa olevia taulukon käyttöoikeuksia sivuston koodin ja Dataversen metatietojen perusteella. Tuo esiin puuttuvat käyttöoikeudet, yli sallittavat roolit, käyttämättömät käyttöoikeudet ja YAML-rakenneongelmat.

Koontiraportti ryhmittelee havainnot osioittain, avautuu oletusselaimessasi ja sisältää pelkän kielen mukaisen korjausohjeet. Chatissa laajennus tarjoaa sitten mahdollisuuden käydä läpi korjauksia – valitse havainto ja laajennus kutsuu vastaavan keskitetyn taidon vuorovaikutteisesti muutoksen soveltamiseksi.

Muistio

Suojaustarkastelu ei koskaan ota muutoksia käyttöön automaattisesti. Jokainen kohdistettu taito suoritetaan vain luku -tarkistustilassa yhdistetyn suorituksen aikana. Jos haluat ottaa korjauksen käyttöön, laajennus käynnistää vastaavan taidon vuorovaikutteisesti sen jälkeen, kun olet valinnut toiminnon.

Vinkki

Voit myös suorittaa minkä tahansa yksittäisen taidon erikseen:

  • Suorita /scan-code kehityksen aikana, jotta saat kooditason ongelmat ajoissa.
  • Korjaa /manage-headers tietyn sisällön suojauskäytännön virhe suorittamalla komento tai määrittämällä CORS.
  • Lisää maksurajoitus kirjautumissivulle tai estä liikenne maan mukaan suorittamalla /manage-firewall .
  • Suorita /audit-permissions , kun olet muuttanut taulukon käyttöoikeuksia ja varmista, että ne vastaavat edelleen sivuston koodia.
  • Suorita /security-review uudelleen käyttöönotetun sivuston tavoite tuotantoalueen seuraamiseksi ajan kuluessa.

Tarkista sivustosi

Kun olet suorittanut taidot, varmista, että Power Pages -sivustosi toimii oikein.

  1. Siirry kohtaan Power Pages.
  2. Etsi sivustosi Aktiivisten sivustojen luettelosta.
  3. Esikatsele sivustosi työpöydällä Esikatselu-vaihtoehdon avulla.
  4. Testaa toiminnallisuus.

Sivuston ylentäminen kaikissa ympäristöissä

Kun sivustosi on työskentelenyt kehitysympäristössäsi, käytä sovelluksen elinkaaren hallinnan (ALM) taitoja sen ylentämiseksi testi- ja tuotantoympäristöihin. Laajennus pakkaa sivustosi Power Platform -ratkaisuna, tunnistaa eri ympäristöissä vaihtelevat arvot ja ottaa ratkaisun käyttöön Power Platform -putkien kautta tai manuaalisen viennin ja tuonnin kautta.

Jos haluat käyttää ALM-taitoja, tarvitset myös vähintään yhden Power Platform -kohdeympäristön (testi, tuotanto tai molemmat). Jos haluat käyttää valinnaista Azure Key Vault salaisten koodien työnkulkua, tarvitset myös oikeuden luoda key vaultin Azure tilauksessasi.

Käyttöönoton suunnittelu

Aloita suorittamalla /plan-alm . /plan-alm on ALM:n aloituskohta ja järjestää muut ALM-taidot, joten et tavallisesti suorita niitä suoraan. Laajennus:

  1. Tunnistaa projektisi, ratkaisusi ja kohdeympäristöjesi nykyisen tilan.
  2. Kysyy ylentämisstrategiasta (Power Platform Pipelines tai manuaalinen vienti ja tuonti), kohdevaiheista ja mahdollisista rajoituksista.
  3. Luo visuaalisen suunnitelman docs/alm-plan.html , jossa näytetään kaikki toiminnot, jotka se aikoo suorittaa.
  4. Odottaa hyväksyntääsi, ennen kuin suorittaa loppuvaiheen osaamista.

Suunnitelma jatkuu levyllä, joten jokainen loppuvaiheen taito lukee samasta jatkuvasta suunnitelmasta ja kirjoittaa siihen. Jos vaihe epäonnistuu, suorita /plan-alm se uudelleen ja se jatkuu pysäytetystä kohdasta.

Ratkaisun luominen

Paketoi sivustosi Power Platform -ratkaisuksi suorittamalla /setup-solution . Laajennus:

  1. Luo julkaisijan ja ratkaisun ja lisää sitten Power Pages komponentit: sivuston, verkkoroolit, palvelinlogiikan päätepisteet, pilvityönkulun rekisteröinnit ja OAuth-palveluasetukset.
  2. Luokittelee jokaisen sivuston asetuksen luottamuksellisuusarvojen perusteella ja ehdottaa ympäristömuuttujia eri ympäristöissä vaihteleville arvoille.
  3. Tarjoaa mahdollisuuden valmistella Azure Key Vault ja tallentaa siihen tunnistetietotyyppisiä arvoja, kuten yhteysmerkkijonoja ja ohjelmointirajapinta-avaimia.
  4. Suoritetaan synkronointitilassa, kun sivustolle on jo olemassa ratkaisu. Komponenttien täsmäyttäminen ilman uuden ratkaisun luomista.

Tarkistat ja hyväksyt ehdotuksen. Laajennus ei luo määrityksiä, ennen kuin vahvistat sen.

Vinkki

Jos ratkaisusi on liian suuri tai kooutunut käyttöön luotettavasti, laajennus suosittelee jakoa ja ehdottaa, missä se jaetaan. Vahvista jako ennen muutosten käyttöönomista.

Käyttöönotto Power Platform -putkien avulla

Jos valitsit ylentämisstrategiaksesi Power Platform Pipelinesin, laajennus suorittaa seuraavat taidot:

  1. /ensure-pipelines-host päivittää tai havaitsee Power Platform -putkien isäntäympäristön. Taito valitsee vuokraajallesi edullisimman käytettävissä olevan vaihtoehdon: maksuttoman ympäristön isännän, olemassa olevan ympäristön Pipelines-sovelluksen tai mukautetun isännän.
  2. /setup-pipeline rekisteröi putken määrityksen Dataversessa, määrittää valitsemasi vaiheet ja sitoo kunkin vaiheen kohdeympäristöön.
  3. /deploy-pipeline käynnistää vaiheen käyttöönoton, ottaa käyttöön vaihekohtaisen ympäristömuuttujan ja deploymentSettings.jsonseuraa käyttöönottokirjauksen tilaa.

Jos käyttöönotto epäonnistuu, koska kohdeympäristö on jo linkitetty eri Power Platform Pipelines -isäntään, laajennus voidaan suorittaa /force-link-environment uudelleen määrittämiseksi. Toiminto edellyttää eksplisiittistä suostumusta, ja se voidaan kumota.

Käyttöönotto manuaalisen viennin ja tuonnin avulla

Jos valitset manuaalisen polun, laajennus suoritetaan:

  1. /export-solution voit viedä ratkaisun hallittuna tai hallitsemattomana ZIP-tiedostona ja tarkistaa täydellisyystarkistuksen ennen vientiä.
  2. /import-solution zip-tiedoston tuomiseksi kohdeympäristöön joko vaihe vaiheiteltuna riippuvuuksien tarkistamiseksi ensin tai suoraan.

Käyttöönotetun sivuston aktivoiminen ja vahvistaminen

Kohdeympäristön onnistuneen käyttöönoton jälkeen laajennus:

  1. Suoritetaan /activate-site julkisen URL-osoitteen valmistelemiseksi kohdeympäristössä.
  2. Suoritetaan /test-site käyttöönoton varmistamiseksi. Laajennus selaa selaimen avulla edustavia sivuja, suorittaa roolipohjaisia käyttöoikeuksien tarkistuksia, tarkistaa /_api/ kutsuja ja siepata vastausmuotoja päätepisteistä /_api/serverlogics/ . Taito raportoi tuloksen muodossa PASS, WARNINGStai FAIL, ja tarkistuskohtaiset tiedot on linkitetty suunnitelmasta.

Jos vaihe epäonnistuu, laajennus suoritetaan /diagnose-deployment. Taito vastaa tunnettujen käyttöönottovirheiden luetteloa, kuten vanhentunutta luetteloa, puuttuvia riippuvuuksia, isäntäristiriitoja, estettyä JavaScriptiä tai vanhentunutta todentamista, ja ehdottaa konkreettista korjausta. Laajennus ei koskaan käytä korjausta ilman lupaasi.

Muistio

Kaikki ALM-taidot lukevat levyllä olevia artefakteja ja kirjoittavat niitä: ratkaisun luettelotiedosto, suunnitelmatiedot, jaksokirjaukset, käyttöönottokirjaukset ja testitulokset. Orkestrointi on jatkettavissa ja auditoitavissa. Jos haluat nähdä, mitä tapahtui missä tahansa vaiheessa, tarkista artefaktit.

Vihjeitä ja parhaita käytäntöjä

Seuraavien vinkkien avulla saat kaiken hyödyn irti laajennuksesta ja tekoälykoodausagentista, kun luot Power Pages -sivustoja.

Tarkkaile terminaalin tulosteita puuttuvien työkalujen varalta ensimmäisellä suorituksella

Laajennus tarjoaa taitoja ja työnkulkuja, mutta tekoälykoodausagentti - GitHub Copilot CLI tai Claude Code - suorittaa koneesi todelliset komennot. Kun käytät näitä työkaluja ensimmäistä kertaa, katso terminaalin tulos tarkasti. Tekoälykoodausagentti suorittaa komentoja ja komentosarjoja taustalla, ja jotkin näistä komennoista riippuvat työkaluista, joita ei ehkä ole asennettu koneeseesi. Jos vaihe epäonnistuu, päätetuloste näyttää yleensä, mitä työkalua tai komentoa se ei löytänyt.

Jos näet virheen, kuten command not found tai is not recognized, asenna puuttuva työkalu ja käynnistä työnkulku uudelleen. Tekoälykoodausagentti jatkaa siitä, mihin se jäi, kun työkalu on saatavilla.

Tarkista agenttiehdotukset ennen hyväksymistä

Tekoälykoodausagentti esittää ennen muutosten tekemiä ehdotuksia, kuten tietomallin arkkitehti- ja lupa-arkkitehtien ehdotuksia. Tekoälykoodausagentin luoma koodi ja määritys voivat olla virheellisiä, joten tarkista, testaa ja vahvista kaikki ehdotukset ja kaikki luodut koodit ennen kuin hyväksyt tai otat sen käyttöön.

  • Tietomalliehdotukset: Tarkista, että taulukoiden nimet, saraketyypit ja suhteet vastaavat liiketoiminnan vaatimuksia. Ehdotusta on helpompi muuttaa kuin nimetä sarakkeet uudelleen, kun tiedot on jo lisätty.
  • Käyttöoikeusehdotukset: Varmista, että kullakin roolilla on oikea käyttöoikeustaso (luo, lue, päivitä, poista) kullekin taulukolle. Liian sallivat taulukon käyttöoikeudet ovat yleinen suojausriski.
  • Luotu koodi: Lue luotu koodi ja testaa sivusto paikallisesti ennen käyttöönottoa. Tekoälyn luoma koodi voi sisältää virheitä tai suojausongelmia.

Liitä virheet suoraan kontekstin avulla

Jos jokin epäonnistuu, kopioi täydelliset virhetulokset, olipa kyseessä koontiversiovirhe, käyttöönottovirhe tai selaimen suorituksenaikainen poikkeus. Liitä se ja lyhyt kuvaus siitä, mitä olit tekemässä. Mitä enemmän kontekstia annat, sitä nopeammin korjaus on.

Esimerkki: Koontivirhe

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>

Vinkki

Sisällytä tiedoston nimi, suorittamiesi komento ja mitä odotit tapahtuvan. Laajennus etsii ongelman tämän kontekstin avulla ja käyttää kohdennettua korjausta arvailun sijaan.

Jaa WWW-ohjelmointirajapinnan virheet koko pyynnön URL-osoitteen kanssa

Yleinen ongelma käyttöönoton jälkeen on 403-virhe Power Pages WWW-ohjelmointirajapinnasta, kun saraketta ei ole otettu käyttöön ohjelmointirajapinnan käyttöä varten. Kun kohtaat tämän virheen, liitä täydellinen ohjelmointirajapinnan URL-osoite ja täydellinen JSON-virhevastaus. Virhesanoma kertoo tarkalleen, mikä taulukko ja sarake on korjattava, ja laajennus voi päivittää taulukon käyttöoikeuden YAML:n ja sivuston asetukset puolestasi.

Esimerkki: Sarake, jota ei ole otettu käyttöön WWW-ohjelmointirajapinnalle (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"
    }
  }
}

Tämä virhe (AttributePermissionIsMissing) tarkoittaa, että hakusarake _crd50_propertyid_value on olemassa Dataverse-taulukossa, mutta sitä ei ole lueteltu WWW-ohjelmointirajapinnan taulukon käyttöoikeusmäärityksessä. Laajennus ratkaisee tämän virheen lisäämällä puuttuvan sarakkeen yaml-taulukkoon .powerpages-site/table-permissions/ ja ottamalla sen uudelleen sisään.

Muistio

Power Pages -www-ohjelmointirajapinta edellyttää, että kaikki ohjelmointirajapintakutsun palauttamat sarakkeet luetellaan eksplisiittisesti taulukon käyttöoikeudessa. Hakuominaisuudet (etuliite _ ja jälkiliite _value) on helppo jättää huomiotta, koska niiden ohjelmointirajapinnan nimi eroaa sarakkeen loogisesta nimestä Kohdassa Dataverse. Kun näet kohteen AttributePermissionIsMissing, lisää aina kyseinen sarake taulukon käyttöoikeudeksi. Älä muuta ohjelmointirajapintakyselyä.

Kerro tarkasti, mitä haluat

Epämääräiset pyynnöt tuottavat epämääräisiä tuloksia. Kerro laajennukselle täsmälleen, mitä tarvitset, mukaan lukien asettelun asetukset, tietokentät ja toiminta.

Sen sijaan Kokeile
"Tee sivu töitä varten" "Luo työpaikkaluettelosivu, jonka yläreunassa on hakupalkki, suodatinsirut sijainnille ja osastolle sekä korttiruudukko, joka näyttää otsikon, yrityksen, palkka-alueen ja kunkin työn julkaistun päivämäärän"
"Korjaa muotoilu" "Työkortit pinoavat pystysuunnassa työpöydällä. Tee niistä näkyviä kolmen sarakkeen ruudukossa, jossa on 16 pikson aukko yli 768 kuvapistettä leveämmillä näytöillä.
"Lisää joitakin tietoja" "Lisää 20 mallityön kirjausta neljässä osastossa (suunnittelu, markkinointi, myynti, HR), joissa on realistiset otsikot, palkka-alueet välillä $60k-$180k ja julkaistut päivämäärät viimeisten 30 päivän aikana"
"Määritä ohjelmointirajapinta" "Yhdistä JobListings-komponentti cr_jobposting Dataverse-taulukkoon. Korvaa pysyväiskoodattu matriisi oikealla ohjelmointirajapintakutsulla, joka hakee otsikon, osaston, palkan ja julkaisupäivämäärän"
"Lisää kirjautuminen" "Määritä Ulkoinen Microsoft Entra -tunnus sisäänkirjautuminen avoimella rekisteröinnillä sekä Google toisena palveluntarjoajana. Näytä ne kirjautumissivulla vaakasuuntaisena rivinä."

Näyttökuvien käyttäminen visuaalisiin ongelmiin

Kun sivusto ei näytä oikealta selaimessa, ota näyttökuva ja liitä se suoraan keskusteluun tai anna tiedostopolku. Visuaalinen konteksti auttaa tunnistamaan asettelun, välistyksen ja muotoiluongelmat, joita on vaikea kuvailla tekstissä.

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.

Iteroi pienin askelin

Sen sijaan, että kuvailet koko sivuston yhdessä kehotteessa, rakenna asteittain. Aloita rakenteesta ja asettelusta ja lisää sitten ominaisuuksia yksi kerrallaan. Tämän lähestymistavan ansiosta voit tarkistaa kurssin ja tehdä sen oikein kussakin vaiheessa.

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

Vinkki

Tarkista jokaisen vaiheen jälkeen selaimen esikatselu. Jos jokin ei ole oikein, korjaa se ennen jatkamista. Yhdessä komponentissa on helpompi korjata ongelmia kuin selvittää ongelmia koko sivustossa.

Pyydä selitystä ennen hyväksymistä

Kun et ole varma ehdotetusta muutoksesta, erityisesti käyttöoikeuksista, tietomallin muokkauksista tai todentamismäärityksestä, pyydä laajennusta selittämään, mitä se aikoo tehdä ja miksi ennen hyväksymistä.

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

Suorita taitoja itsenäisesti, jotta voit toipua ongelmista

Jos taidot epäonnistuvat osittain, sinun ei tarvitse aloittaa alusta. Jokainen taito suoritetaan itsenäisesti, ja ne voivat jatkaa siitä, mihin se jäi. Jos esimerkiksi /integrate-webapi kolmannessa taulukossa epäonnistuu, voit suorittaa sen uudelleen, jolloin se tunnistaa jo suoritetun työn.

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

Liittyvä sisältö

  • Last updated on