Začněte s doplňkem Power Pages pro GitHub Copilot CLI a Claude Code

Plugin Power Pages pro GitHub Copilot CLI a Claude Code poskytuje pracovní postup s podporou umělé inteligence pro vytváření, nasazování a správu moderních jednostránkových aplikací (SPA) na Power Pages. Místo ručního vytváření kostry projektů, psaní šablonového kódu API a konfigurace oprávnění v přirozeném jazyce popište, co chcete, a plugin zpracovává implementaci.

Modul plug-in podporuje celý životní cyklus vývoje webu prostřednictvím konverzačních dovedností, od generování nového webu až po jeho nasazení, nastavení datových modelů Dataverse a konfiguraci ověřování.

Předpoklady

Než začnete, ověřte, že máte požadovaný software a oprávnění.

Softwarové požadavky

Potřebujete také:

• Prostředí Power Platform s aktivovanou funkcionalitou Power Pages.
• Ověřená relace PAC CLI připojená k vašemu cílovému prostředí. Spusťte pac auth create , pokud jste se ještě nepřipojili.
• Relace Azure CLI se přihlásila ke stejnému klientovi. Spusťte az login --allow-no-subscriptions, abyste se ověřili.

Ověřte ověření:

Pomocí příkazu ověřte, že jste ověřeni pac auth list .

pac auth list           # Should show authenticated profile

Pokud nejste ověřeni, spusťte tento příkaz:

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

Instalace modulu plug-in

Nainstalujte modul plug-in Power Pages z marketplace. Pokud používáte GitHub Copilot CLI, najdete ekvivalentní instalační kroky v dokumentaci k rozšířením Copilot CLI. Následující příkazy používají syntaxi Claudu Code.

Rychlá instalace (doporučeno)

Spusťte instalační program a nastavte všechny pluginy s povolenou automatickou aktualizací:

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

Instalační program automaticky:

• Nainstaluje pac CLI, pokud ještě není nainstalované.
• Detekuje dostupné nástroje, jako je Claude Code a GitHub Copilot CLI.
• Zaregistruje marketplace pluginů a nainstaluje všechny uvedené pluginy.
• Povolí automatické aktualizace, aby moduly plug-in zůstaly aktuální.

Po instalaci restartujte Claude Code nebo GitHub Copilot CLI, abyste mohli v agentní relaci přistupovat k dovednostem pluginu prostřednictvím příkazů se znakem lomítka.

Instalace z marketplace

1. Otevřete Clauda Code v terminálu.

2. Přidejte marketplace Microsoft:

   /plugin marketplace add microsoft/power-platform-skills
   

3. Nainstalujte modul plug-in Power Pages:

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

Po instalaci pluginu restartujte Claude Code nebo rozhraní příkazového řádku GitHub Copilot, abyste v relaci vašeho agenta mohli přistupovat k dovednostem modulu plugin jako příkazům s lomítkem.

Přehled dovedností

Modul plug-in poskytuje dovednosti, které pokrývají celý životní cyklus webu Power Pages. Každou dovednost lze vyvolat v rámci konverzace, buď jako příkaz s lomítkem, nebo tím, že popíšete, co chcete udělat.

Typický pracovní postup

Běžný ucelený pracovní postup se řídí tímto pořadím:

1. /create-site : Generujte, navrhujte a vytvářejte stránky
2. /deploy-site: Nahrání do prostředí Power Pages
3. /activate-site : Nastavení veřejné adresy URL
4. /setup-datamodel : Vytvoření tabulek Dataverse
5. /add-sample-data : Naplnění tabulek testovacími záznamy
6. /integrate-webapi : Generování kódu klienta rozhraní API a konfigurace oprávnění
7. /create-webroles: Definování přístupových rolí
8. /setup-auth : Přidání přihlášení, odhlášení a uživatelského rozhraní na základě role
9. /add-server-logic : Přidání zabezpečených koncových bodů na straně serveru
10. /add-cloud-flow: Integrace toků Power Automate, které již existují
11. /add-seo : Optimalizace vyhledávacího webu
12. /deploy-site : Nasadit konečné změny naživo
13. /security-review : Před přechodem do produkčního prostředí spusťte kompletní kontrolu zabezpečení.
14. /plan-alm : Přesunout web do testovacího a produkčního prostředí

Vytvoření webu Power Pages

Tento průvodce podrobně popisuje celý životní cyklus vytváření webové stránky pomocí Power Pages pluginu, od úvodního návrhu až po nasazení. Každý krok popisuje, co říkáte a co modul plug-in dělá v reakci.

Krok 1: Vytvoření webu

Popište požadovaný web v přirozeném jazyce: k čemu je určen, jaké stránky potřebuje, a všechny předvolby návrhu, jako je barevné schéma, styl rozložení nebo písma. Spusťte /create-site nebo jednoduše popište svůj web a modul plug-in rozpozná záměr.

Pokud nezadáte architekturu, modul plug-in vás požádá o výběr (React, Vue, Angular nebo Astro), pak:

1. Vygeneruje projekt ze šablony a použije název webu, barvy a tokeny návrhu.
2. Nainstaluje závislosti, spustí vývojový server a otevře dynamický náhled prohlížeče.
3. Sestaví každou stránku, součást a trasu, kterou jste požadovali, s příslušnými obrázky.
4. Vytváří git commity při významných milnících, takže máte integrovanou historii pro vrácení zpět.

Krok 2: Nasazení webu

Spuštěním příkazu /deploy-site nahrajte web do Power Pages. Plugin:

1. Ověří, že je nainstalované příkazové rozhraní PAC a že je aktivní vaše autentizační relace.
2. Než budete pokračovat, potvrdí s vámi cílové prostředí.
3. Spustí produkční sestavení a nahraje zkompilovaný výstup.
4. Vytvoří adresář artefaktů nasazení, pokud ještě neexistuje.

Krok 3: Aktivace webu

Spusťte /activate-site , aby byl web veřejně přístupný. Plugin:

1. Navrhne subdoménu založenou na názvu webu a umožní vám ji přizpůsobit.
2. Zřídí záznam webu prostřednictvím rozhraní API Power Platform.
3. Dotazuje se, dokud web nebude aktivní a nevrátí veřejnou adresu URL.

V tomto okamžiku máte pracovní web na veřejné adrese URL. Zbývající kroky přidávají data, ověřování a SEO. Přeskočte všechny kroky, které se na váš web nevztahují.

Krok 4: Nastavení datového modelu

Spusťte /setup-datamodel, abyste vytvořili tabulky Dataverse, které vaše webová stránka potřebuje. Pokud už máte diagram ER nebo konkrétní schéma, zadejte ho přímo místo toho, abyste agenta analyzovali váš kód.

Modul plug-in vytvoří agenta architekta datového modelu , který:

1. Analyzuje kód webu a určí, jaká data stránky a komponenty vyžadují.
2. Dotazuje prostředí Dataverse na existující tabulky, aby nedocházelo k duplicitám.
3. Navrhuje datový model s tabulkami, sloupci, datovými typy a relacemi, vizualizovanými jako diagram ER.

Návrh zkontrolujete a schválíte. Modul plug-in nic nevytvoří, dokud ho neověříte. Po schválení modul plug-in vytvoří tabulky a sloupce prostřednictvím volání rozhraní API a uloží soubor manifestu, který použije kroky 5 a 6.

Krok 5: Přidání ukázkových dat (volitelné)

Spuštěním /add-sample-data naplníte tabulky testovacími záznamy. Tento krok vyžaduje datový model z kroku 4.

Modul plug-in provede následující akce:

1. Přečte manifest, který vám umožní porozumět tabulkám, sloupcům a relacím.
2. Generuje kontextově odpovídající hodnoty pro každý typ sloupce, jako jsou realistické e-maily, přijatelné kalendářní data a formátované částky měny.
3. Vloží záznamy v pořadí závislostí (nadřazené tabulky před podřízenými tabulkami) a během hromadného vkládání automaticky aktualizuje ověřovací tokeny.

Krok 6: Integrace s webovým rozhraním API služby Dataverse

Spusťte /integrate-webapi pro nahrazení testovacích dat živými dotazy Dataverse. Tento krok vyžaduje datový model z kroku 4.

Modul plug-in provede následující akce:

1. Prohledá základ kódu na komponenty, které používají ukázková data, volání zástupných symbolů načtení nebo pevně zakódovaná pole. Mapuje tyto komponenty na vaše tabulky Dataverse.
2. Vytvoří agenta integrace webového rozhraní API pro každou tabulku, která generuje:
   • Sdílený klient rozhraní API se správou tokenů proti padělání a logikou opakování.
   • Typy entit TypeScriptu a mapovače domény
   • Vrstva služby CRUD.
   • Vzory konkrétní architektury, např. hooky React, Vue composables nebo služby Angular.
3. Vytvoří agenta Architekta oprávnění, který navrhuje oprávnění k tabulce a nastavení webu.

Návrh oprávnění zkontrolujete a schválíte. Modul plug-in nevytvoří žádné konfigurační soubory, dokud ho neověříte.

Přidání souhrnů generovaných AI (volitelné)

Spusťte /add-ai-webapi, chcete-li nad vaši integraci webového rozhraní API přidat souhrny generované umělou inteligencí. Dovednost propojuje dvě rozhraní API pro sumarizaci ve verzi Preview se stránkami detailu záznamu a seznamu:

• API pro souhrn vyhledávání: Vrací stručný souhrn výsledků vyhledávání vytvořený pomocí AI, včetně citací.
• Rozhraní API pro shrnutí dat: Vrátí shrnutí jednotlivých záznamů nebo přehledy na úrovni celé tabulky Dataverse.

Tento krok vychází z datového modelu z kroku 4 a integrace webového rozhraní API z kroku 6. Modul plug-in provede následující akce:

1. Vyhledá v kódu souhrnné integrační body a potvrdí cílové stránky, tabulky a rozhraní API, která se mají použít.
2. Deleguje všechny chybějící požadavky webového rozhraní API – oprávnění tabulky, seznamy sloupců a webové role – do /integrate-webapi a /create-webrolesproto existuje jediný zdroj pravdivých informací o oprávněních.
3. Vytvoří agenta Integrace AI Web API, který vygeneruje typovanou službu pro souhrny (aiSummaryService.ts) s obsluhou tokenů proti padělání, wrappery specifickými pro framework (hooky React, Vue composables nebo služby Angular) a napojenými místy volání na cílových stránkách.
4. Vytvoří agenta AI Web API Settings Architect , který vytvoří Summarization nastavení webu pro výzvy a omezení obsahu.

Návrhy zkontrolujete a schválíte. Plugin negeneruje kód ani nevytváří nastavení, dokud to nepotvrdíte.

Krok 7: Vytvoření webových rolí

Spuštěním /create-webroles definujte role přístupu uživatelů. Plugin:

1. Dotazuje vaše prostředí na existující webové role, aby nedocházelo k duplicitám.
2. Generuje definice rolí s jedinečnými identifikátory.
3. Vynucuje, aby každá lokalita má maximálně jednu anonymní roli a jednu ověřenou roli.

Krok 8: Nastavení ověřování

Spuštěním /setup-auth příkazu přidáte na web přihlašování, odhlášení a řízení přístupu na základě role. Modul plug-in podporuje následující zprostředkovatele identity a současně můžete nakonfigurovat jednoho nebo několik zprostředkovatelů.

Další informace o podporovaných poskytovatelích, včetně protokolů a aspektů konfigurace, najdete v tématu Přehled ověřování v Power Pages.

Plugin:

1. Analyzuje váš web (účel, stránky, cílovou skupinu) a navrhuje rozumné výchozí nastavení. Modul plug-in například navrhuje Microsoft Entra Externí ID s otevřenou registrací pro web určený zákazníkem nebo Microsoft Entra ID s registrací pouze s pozvánkou pro interní portál. Doporučení přijmete nebo vyberete vlastní poskytovatele.
2. U každého poskytovatele vás provede všemi nezbytnými kroky v centru pro správu poskytovatele identity, jako je vytváření tenantů, registrace aplikací, vytváření toků uživatelů a zaznamenání ID klienta a identifikátorů URI pro přesměrování. Modul plug-in ověří každou hodnotu, kterou vložíte zpět do konverzace, a vypočítá přesný identifikátor URI přesměrování vašeho webu tak, aby hodnota vložená do registrace aplikace odpovídala hodnotě zapsané do nastavení webu.
3. Ptá se, jak by data profilů uživatelů měla proudit od zprostředkovatele identity do záznamu kontaktu Služby Dataverse (mapování deklarací identity), jestli se mají synchronizovat jenom pro každé přihlášení nebo první přihlášení a jestli se mají automaticky propojit externí přihlášení k existujícím kontaktům e-mailem.
4. Vygeneruje autentizační službu, deklarace typů, nástroje pro autorizaci na základě rolí (hasRole, RequireAuth, RequireRole), hook pro udržování aktivní relace, který brání tomu, aby relace SPA nepozorovaně vypršela, a komponentu uživatelského rozhraní pro přihlášení/odhlášení integrovanou do rozvržení webu. Plugin využívá napříč celým řešením vzory vašeho frameworku, například hooky Reactu, composables ve Vue, služby v Angularu nebo komponenty Astro.
5. Pokud je nakonfigurován více než jeden poskytovatel, vygeneruje se stránka /login zobrazená ve vámi zvoleném rozložení: vodorovná řada, svislé uspořádání, primární zvýraznění nebo rozložení do záložek.
6. Zapíše odpovídající nastavení webu pod .powerpages-site/site-settings/ pro každého poskytovatele, režim registrace, mapování deklarací a volitelnou funkci.

Modul plug-in také při zapnutí nakonfiguruje následující volitelné funkce:

• Podmínky: /terms Uživatelé stránky SPA musí před dokončením přihlášení přijmout a také odpovídající nastavení webu a fragmenty obsahu.
• Stránka profilu uživatele: Stránka /user-profile SPA, kde přihlášení uživatelé upravují kontaktní údaje prostřednictvím webového rozhraní API Power Pages.
• Federované odhlášení: Také odhlásí uživatele u zprostředkovatele identity, když se odhlásí z webu, ve scénářích se sdílenými zařízeními nebo v regulovaných prostředích.

Krok 9: Přidání logiky serveru

Spusťte /add-server-logic pro přidání zabezpečených koncových bodů na straně serveru do vašeho webu. Logiku serveru použijte, když váš web potřebuje logiku, která se nedá spustit v prohlížeči, jako jsou externí volání rozhraní API, ověření na straně serveru, správa tajných kódů nebo operace s daty mezi entitou.

Popište, co potřebujete srozumitelně, a plugin:

1. Vytvoří agenta Server Logic Architect , který analyzuje váš případ použití a klasifikuje jeho složitost.
2. Poskytuje návrh koncového bodu, konfiguraci zabezpečení a všechna požadovaná oprávnění tabulky ke kontrole.
3. Po schválení vygeneruje koncový bod JavaScriptu na straně serveru na /_api/serverlogics/<name>adrese .
4. Vytvoří typovou službu na straně klienta pro vyvolání koncového bodu z komponent.
5. Aktualizuje vaše komponenty tak, aby volaly novou službu.
6. Konfiguruje přiřazení webových rolí a oprávnění pro tabulky pro koncový bod.

Návrh zkontrolujete a schválíte. Dokud ho nepotvrdíte, vygeneruje se žádný kód.

Běžné případy použití:

• Připojte se k externím službám. Volání rozhraní REST API, Azure Functions nebo služeb třetích stran bez vystavení přihlašovacích údajů (Kurz: Interakce s externími službami)
• Provádění zabezpečených operací s daty Dotazování, aktualizace nebo odstranění záznamů Dataverse s konzistentním ověřováním na straně serveru (Kurz: Interakce s tabulkami Dataverse)
• Spusťte vlastní logiku. Agregujte data mezi tabulkami, vynucujte obchodní pravidla nebo počítejte odvozené hodnoty před vrácením výsledků klientovi.
• Správa tajných kódů na straně serveru Ukládat přihlašovací údaje a klíče rozhraní API na serveru, nikdy v klientském kódu. (Tutorial: práce s Microsoft Graph a SharePoint)

Krok 10: Integrace cloudových toků

Spuštěním příkazu /add-cloud-flow integrujte existující toky cloudu Power Automate do vašeho webu. Tato dovednost propojuje váš Power Pages web s toky, které jste už vytvořili v Power Automate. Nevytváří nové cloudové toky.

Plugin:

1. Zaregistruje existující cloudový tok na vašem webu.
2. Vygeneruje kód na straně klienta, který spustí tok z vašich stránek.
3. Zpracovává stavy a vzory zpětného volání pro asynchronní pracovní postup.
4. Nastaví výměnu dat mezi stránkou a tokem.

Použijte /add-cloud-flow pro pracovní postupy schvalování, e-mailová oznámení, naplánované úlohy a automatizaci řízenou událostmi, které jsou lépe zpracovány Power Automate než koncovými body na straně serveru.

Alternativa: K naplánování úplné vrstvy služby použijte /integrate-back-end.

Pokud si nejste jistí, které funkce vyžadují webové rozhraní API, logiku serveru nebo tok cloudu, spusťte /integrate-backend místo ručního spuštění kroků 4 až 10. Tato dovednost funguje jako orchestrátor, který:

1. Analyzuje váš prototyp a identifikuje všechny funkce, které potřebují vrstvu služby.
2. Klasifikuje každou funkci do správného přístupu: Webové rozhraní API pro standardní CRUD, logiku serveru pro ověřování na straně serveru a externí rozhraní API nebo tok cloudu pro schvalovací pracovní postupy a automatizaci.
3. Navrhuje sekvencovaný plán provádění se všemi dovednostmi, závislostmi a konfiguracemi.
4. Po schválení orchestruje dovednosti ve správném pořadí.

Plán je trvalý, obnovitelný a upravitelný. Zastavte se po jakémkoli kroku, abyste zkontrolovali vygenerovaný kód nebo otestovali web, a znovu spusťte /integrate-backend místo, kde jste skončili.

Krok 11: Přidání SEO

Spusťte /add-seo optimalizaci webu pro vyhledávací weby. Plugin:

1. Zjišťuje trasy z konfigurace směrovače vašeho rámce.
2. Generuje direktivy vyhledávacího webu a mapu webu pro všechny zjištěné trasy.
3. Přidá metaznačky: viewport, charset, description, Open Graph, Twitter Card a favicon reference.

Krok 12: Nasazení poslední lokality

Pokud provedete nějaké volitelné kroky, spusťte znovu /deploy-site, aby se změny aplikovaly živě. Modul plug-in spustí produkční sestavení a nahraje web společně se všemi artefakty nasazení (oprávněními k tabulce, nastavením webu, webovými rolemi, soubory logiky serveru) do vašeho Power Pages prostředí.

Krok 13: Spuštění kontroly zabezpečení

Před přechodem do produkčního prostředí spusťte /security-review komplexní kontrolu zabezpečení vašeho webu. Dovednost koordinuje specializované bezpečnostní dovednosti a sjednocuje všechna zjištění do jedné zprávy HTML na adrese docs/security-review-<timestamp>.html.

Plugin položí jednu srozumitelně formulovanou otázku ohledně vašeho cíle a vybere odpovídající sadu cílených dovedností:

Po potvrzení plugin paralelně spustí odpovídající specializované dovednosti a zapíše jejich zjištění do jediné zprávy:

• /scan-code: Spustí statickou analýzu (opengrep) a kontrolu závislostí (trivy) u místních zdrojových souborů. Zobrazí vzory kódu, zranitelné balíčky, pevně zakódované tajné kódy a problémy s licencemi. Pokud některý z nástrojů není nainstalovaný, dovednost nabízí ruční kontrolu kódu jako záložní.
• /scan-site: Spustí kontrolu zabezpečení na straně serveru na živém webu a načte nejnovější sestavu. Doba trvání kontroly závisí na velikosti webu – malé weby se dokončí v minutách, velké weby můžou trvat hodiny. Závěry jsou seskupeny podle závažnosti. Vyžaduje nasazený web.
• /manage-headers: Zkontroluje hlavičky zabezpečení HTTP nakonfigurované v části .powerpages-site/site-settings/: Zásady zabezpečení obsahu, X-Frame-Options, CORS, cookie SameSite a související nastavení. Identifikuje chybějící nebo slabé hodnoty a navrhuje doporučené výchozí hodnoty.
• /manage-firewall: Zkontroluje firewall webových aplikací (WAF) pro produkční web, včetně stavu spravovaného pravidla a vlastních pravidel (bloky IP adres, bloky zemí, bloky cest, limity rychlosti). Dostupné pouze v produkčních lokalitách v podporovaných oblastech; dovednost zjišťuje a hlásí problémy s způsobilostí.
• /audit-permissions: Kontroluje stávající oprávnění k tabulce vůči kódu webu a metadatům Dataverse. Zobrazí chybějící oprávnění, příliš permisivní role, nepoužitá oprávnění a problémy se schématem YAML.

Sloučená sestava seskupuje zjištění podle oddílu, otevře se ve výchozím prohlížeči a obsahuje pokyny k nápravě ve formátu prostého jazyka. V chatu pak plugin nabídne, že vás provede opravami – vyberte zjištění a plugin interaktivně spustí odpovídající specializovanou dovednost, aby provedl danou změnu.

Ověření webu

Po dokončení dovedností ověřte, že váš web Power Pages funguje správně.

1. Přejděte na Power Pages.
2. Vyhledejte svůj web v seznamu aktivních webů .
3. Zobrazte náhled svého webu na ploše pomocí možnosti Náhled.
4. Otestujte funkčnost.

Propagujte svůj web v různých prostředích

Jakmile bude váš web fungovat ve vašem vývojovém prostředí, využijte dovednosti správy životního cyklu aplikací (ALM) k jeho podpoře do testovacího a produkčního prostředí. Modul plug-in zabalí váš web jako řešení Power Platform, identifikuje hodnoty, které se v různých prostředích liší, a nasadí řešení prostřednictvím kanálů Power Platform nebo ručního exportu a importu.

Abyste mohli využívat dovednosti ALM, potřebujete alespoň jedno cílové prostředí Power Platform (testování, produkce nebo obojí). Pokud chcete pro tajné kódy použít volitelný tok Azure Key Vault, potřebujete také oprávnění k vytvoření trezoru klíčů ve vašem Azure předplatném.

Plánování nasazení

Spusťte /plan-alm, chcete-li začít. /plan-alm je vstupním bodem ALM a orchestruje ostatní dovednosti ALM, takže je obvykle nespustíte přímo. Plugin:

1. Zjistí aktuální stav vašeho projektu, řešení a cílových prostředí.
2. Ptá se na vaši strategii nasazení (Power Platform Pipelines nebo ruční export a import), cílové fáze a veškerá omezení, která se mají uplatnit.
3. Vygeneruje vizuální plán na docs/alm-plan.html, který zobrazuje všechny akce, které hodlá provést.
4. Před spuštěním jakékoli podřízené dovednosti počká na schválení.

Plán se ukládá na disk, takže každá následná dovednost čte ze stejného uloženého plánu a zapisuje do něj. Pokud fáze selže, spusťte /plan-alm ji znovu a obnoví se z místa, kde se zastavila.

Vytvoření řešení

Spusťte /setup-solution, chcete-li zabalit svůj web jako řešení Power Platform. Plugin:

1. Vytvoří vydavatele a řešení a poté přidá komponenty Power Pages: web, webové role, koncové body serverové logiky, registrace cloudových toků a nastavení poskytovatele OAuth.
2. Klasifikuje každé nastavení webu podle citlivosti a navrhuje proměnné prostředí pro hodnoty, které se v různých prostředích liší.
3. Nabízí zřízení Azure Key Vault a uložení hodnot typu přihlašovacích údajů, jako jsou připojovací řetězce a klíče rozhraní API.
4. Spustí se v režimu synchronizace, pokud už řešení pro váš web existuje, aby se komponenty odsouhlasily bez vytvoření nového řešení.

Návrh zkontrolujete a schválíte. Plugin nevytvoří žádné nastavení, dokud jej nepotvrdíte.

Nasadit s kanály Power Platform

Pokud jste jako strategii nasazování zvolili Power Platform Pipelines, modul plug-in spouští tyto dovednosti:

1. /ensure-pipelines-host zřizuje nebo zjišťuje hostitelské prostředí pro Power Platform Pipelines. Dovednost vybere pro vašeho klienta dostupnou možnost s nejnižšími náklady: bezplatně hostovanou platformu, aplikaci Pipelines ve stávajícím prostředí nebo vlastního hostitele.
2. /setup-pipeline zaregistruje definici kanálu ve službě Dataverse, nakonfiguruje vámi zvolené fáze a každou fázi sváže s cílovým prostředím.
3. /deploy-pipeline spustí nasazení pro danou fázi, prostřednictvím deploymentSettings.json aplikuje přepsání proměnných prostředí pro jednotlivé fáze a sleduje stav v evidenci nasazení.

Pokud nasazení selže, protože cílové prostředí je již propojené s jiným hostitelem kanálů Power Platform, může se modul plug-in spustit /force-link-environment a znovu ho přiřadit. Akce vyžaduje váš explicitní souhlas a je nevratná.

Nasazení pomocí ručního exportu a importu

Pokud zvolíte ruční cestu, modul plug-in se spustí:

1. /export-solution k exportu řešení jako spravovaného nebo nespravovaného souboru ZIP s kontrolou úplnosti před exportem.
2. /import-solution k importu souboru ZIP do cílového prostředí, buď postupně, aby se nejprve ověřily závislosti, nebo přímo.

Aktivace a ověření nasazené lokality

Po úspěšném nasazení v cílovém prostředí modul plug-in:

1. Spustí /activate-site k vytvoření veřejné URL v cílovém prostředí.
2. Spustí /test-site pro ověření nasazení. Zásuvný modul využívá prohlížeč k procházení reprezentativních stránek, spouštění kontrol přístupu podle rolí, ověřování volání /_api/ a zachycení struktur odpovědí z koncových bodů /_api/serverlogics/. Funkce hlásí výsledek jako PASS, WARNINGS nebo FAIL, přičemž plán obsahuje odkazy na podrobnosti o jednotlivých kontrolách.

Pokud krok selže, modul plug-in spustí /diagnose-deployment. Dovednost porovnává selhání s katalogem známých chyb nasazení, jako jsou zastaralý manifest, chybějící závislosti, konflikty hostitelů, blokovaný JavaScript nebo prošlé ověření, a navrhne konkrétní řešení. Plugin nikdy nepoužije opravu bez vašeho souhlasu.

Tipy a osvědčené postupy

Následující tipy vám pomohou získat co nejvíce z doplňku a AI agenta pro kódování při vytváření stránek Power Pages.

Sledujte výstup z terminálu pro chybějící nástroje při prvním spuštění

Plugin poskytuje dovednosti a pracovní postupy, ale agent pro kódování AI – GitHub Copilot CLI nebo Claude Code – spouští skutečné příkazy ve vašem systému. Když tyto nástroje použijete poprvé, pozorně sledujte výstup terminálu. Agent pro kódování AI spouští příkazy a skripty na pozadí a některé z těchto příkazů závisí na nástrojích, které nemusí být na vašem počítači nainstalované. Pokud krok selže, výstup terminálu obvykle ukazuje, který nástroj nebo příkaz se nepodařilo najít.

Pokud se zobrazí chyba podobná command not found nebo is not recognized, nainstalujte chybějící nástroj a znovu aktivujte pracovní postup. AI agent pro kódování pokračuje tam, kde skončil, jakmile je tento nástroj dostupný.

Kontrola návrhů agentů před schválením

Agent kódování AI před provedením změn prezentuje návrhy, například návrhy od architekta datového modelu a architekta oprávnění. Kód a konfigurace vygenerované agentem kódování AI můžou být nepřesné, proto před schválením nebo nasazením zkontrolujte, otestujte a ověřte všechny návrhy a veškerý vygenerovaný kód.

• Návrhy datového modelu: Zkontrolujte, jestli názvy tabulek, typy sloupců a relace odpovídají vašim obchodním požadavkům. Návrh je jednodušší upravit než přejmenovat sloupce po vložení dat.
• Návrhy oprávnění: Ověřte, že každá role má správnou úroveň přístupu (vytvoření, čtení, aktualizace, odstranění) pro každou tabulku. Nadměrná oprávnění tabulek jsou běžným rizikem zabezpečení.
• Vygenerovaný kód: Před nasazením si pročtěte vygenerovaný kód a otestujte web místně. Vygenerovaný kód AI může obsahovat chyby nebo problémy se zabezpečením.

Vkládejte chyby přímo s kontextem

Pokud něco selže, ať už se jedná o chybu sestavení, selhání nasazení nebo výjimku modulu runtime v prohlížeči, zkopírujte úplný výstup chyby. Vložte ho spolu se stručným popisem toho, co jste dělali. Čím více kontextu zadáte, tím rychleji se oprava vyřeší.

Příklad: Chyba sestavení

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>
                                 

Sdílejte chyby webového rozhraní API s úplnou adresou URL požadavku

Běžným problémem po nasazení je chyba 403 z webového rozhraní API Power Pages, když není povolený sloupec pro přístup k rozhraní API. Když narazíte na tuto chybu, vložte úplnou adresu URL rozhraní API a úplnou chybovou odpověď JSON. Chybová zpráva vám přesně řekne, kterou tabulku a sloupec je potřeba opravit, a plugin může za vás aktualizovat nastavení oprávnění tabulky a YAML souboru na webu.

Příklad: Sloupec není povolený pro webové rozhraní 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"
    }
  }
}

Tato chyba (AttributePermissionIsMissing) znamená, že vyhledávací sloupec _crd50_propertyid_value existuje v tabulce Dataverse, ale není uvedený v konfiguraci oprávnění tabulky pro webové rozhraní API. Plugin tuto chybu vyřeší přidáním chybějícího sloupce do YAML oprávnění tabulky v .powerpages-site/table-permissions/ a opětovným nasazením.

Konkrétní informace o tom, co chcete

Vágní požadavky vytvářejí nejasné výsledky. Řekněte modulu plug-in přesně, co potřebujete, včetně předvoleb rozložení, datových polí a chování.

Použijte snímky obrazovky pro vizuální problémy.

Pokud web nevypadá přímo v prohlížeči, pořídit snímek obrazovky a vložit ho přímo do konverzace nebo zadat cestu k souboru. Vizuální kontext pomáhá identifikovat problémy s rozložením, mezerou a styly, které se obtížně popisují v textu.

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.

Iterace v malých krocích

Místo toho, abyste popisovali celý web pomocí jednoho zadání, budujte jej postupně. Začněte strukturou a rozložením a přidejte funkce po jednom. Tento přístup vám dává možnost zkontrolovat a opravit kurz v každém kroku.

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

Před schválením požádejte o vysvětlení.

Pokud si nejste jisti navrhovanou změnou, zejména pokud jde o oprávnění, úpravy datového modelu nebo konfiguraci ověřování, požádejte modul plug-in, aby vysvětlil, co plánuje udělat a proč, než to schválíte.

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

Spuštění dovedností nezávisle pro řešení problémů

Pokud dovednost selže uprostřed procesu, nemusíte začínat znovu. Každá dovednost běží nezávisle a může pokračovat tam, kde skončila. Pokud například /integrate-webapi selže na třetí tabulce, můžete ho spustit znovu a rozpozná dokončenou práci.

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

Související obsah

• Vytvoření a nasazení jednostrákové aplikace v Power Pages
• Konfigurování ověřování pro lokalitu Power Pages
• Přehled logiky serveru
• Referenční informace k webovému rozhraní API služby Power Pages
• Přehled rozhraní API pro sumarizaci dat
• Vyhledávání v Power Pages pomocí generativní AI
• Referenční informace k příkazům stránek rozhraní příkazového řádku PAC
• GitHub Copilot CLI
• Claude Code