Přehled migrace standardních a vylepšených datových modelů

Nástroj pro migraci rozhraní příkazového řádku Microsoft Power Platform přesune existující podporovanou konfiguraci Power Pages lokality a související záznamy ze standardního datového modelu do vylepšeného datového modelu a pak přepne lokalitu tak, aby používala migrovanou konfiguraci.

Standardní datový model ukládá konfiguraci lokality Power Pages mezi tabulkami, které používají předponu adx_. Vylepšený datový model ukládá konfiguraci lokality v tabulce komponent lokality (powerpagecomponent) a identifikuje každou komponentu podle typu součásti. Když pochopíte, jak nástroj pro migraci funguje, které šablony podporuje a která vlastní nastavení se automaticky neaktualizují, pomůže vám rozhodnout, kdy a jak přesunout web.

Kontrola výhod rozšířeného datového modelu vysvětluje, proč byste mohli zvážit migraci webu.

Je důležité si uvědomit, že ne všechny tabulky adx_* se přesouvají do powerpagecomponent. Pouze metadata adx_* – tabulky, které popisují strukturu a plochu vytváření webu, například adx_webpage, adx_webtemplate, adx_contentsnippet, adx_sitesetting, adx_pagetemplate, adx_weblinkadx_entityforma adx_entitylist – jsou sloučeny powerpagecomponent (s jejich vlastnostmi na řádku přesunutými do sloupce JSON obsahu).

Transakční / runtime tabulky adx_* – tedy tabulky, které za běhu zachycují aktivitu koncových uživatelů, například adx_invitation, adx_inviteredemption, adx_portalcomment, adx_externalidentity a tabulky odeslání a protokolů formulářů entity / rozšířených formulářů – se do powerpagecomponent nemigrují; zůstávají ve svých stávajících schématech a nadále ukládají provozní data jako dříve. U těchto transakčních tabulek se mění to, že jejich odkazy na záznamy metadat se při migraci referencí přepojí tak, aby směřovaly na nové řádky powerpagecomponent namísto původních řádků metadat adx_*.

Stávající weby vytvořené ve standardním datovém modelu se budou dál spouštět v tabulkách adx_*, takže je potřeba migrovat každou lokalitu, aby bylo možné využívat vylepšený datový model. Migrace přesune metadata konfigurace webu do podoby rozšířeného datového modelu powerpagecomponent, přesměruje transakční odkazy na tyto nové záznamy metadat a přepne záznam webu tak, aby využíval rozšířený datový model. Právě zde také vyjdou najevo a jsou napraveny přizpůsobení – vlastní sloupce adx_*, kód Liquid, který čte atributy adx_*, dotazy FetchXML nad tabulkami adx_*, moduly plug-in a pracovní postupy – protože tato přizpůsobení se automaticky nepřenášejí a musí být přepsána nebo restrukturalizována tak, aby fungovala s vylepšeným datovým modelem.

Předpoklady

Microsoft Power Platform CLIverze 2.11.2 nebo novější, který slouží ke spouštění příkazů pro stažení webu, migraci, zjištění stavu, aktivaci a vrácení změn. Další informace najdete v tématu Instalace nejnovějšího rozhraní příkazového řádku Power Platform.
Balíček CDSBasePortal základního portálu Dataverse 9.3.2607.x nebo novější, který poskytuje požadované komponenty základního portálu.
Power Pages Core package PowerPages_Core1.0.2605.x nebo novější, který poskytuje požadované komponenty modulu runtime Power Pages. Aktualizujte řešení Power Pages.
Role správce systému, správce Dynamics 365 nebo správce Power Platform, která je vyžadována k přepnutí nebo obnovení aktivního datového modelu.
Znalost nástroje Power Platform CLI pro Power Pages.
Operace na pozadí jsou povoleny, pokud je prostředí v režimu správy.

Možnosti nástroje pro migraci

Nástroj pro migraci zkopíruje podporovanou konfiguraci lokality a související záznamy do vylepšeného datového modelu. Po dokončení migrace se aktivní lokalita přepne do rozšířeného datového modelu a ověří se, než se vrátí k normálnímu použití.

Nástroj pro migraci:

Vygeneruje sestavu přizpůsobení, která může vyžadovat ruční změny.
Migruje podporovanou konfiguraci lokality a související záznamy.
Umožňuje zkontrolovat stav migrace před přepnutím aktivního datového modelu.
Umožňuje vrátit web na standardní datový model, pokud ověření identifikuje kritický problém.

Important

Nástroj pro migraci automaticky neaktualizuje všechna vlastní nastavení, která přímo závisí na standardních tabulkách datového modelu. Zkontrolujte sestavu úprav, opravte dotčený vlastní kód a před nasazením do produkce otestujte migrovaný web.

Podporované šablony

Můžete migrovat existující weby standardních datových modelů vytvořené z následujících šablon:

Počáteční rozložení 1–5
Zpracování žádosti
Prázdná stránka
Registrace programu
Plánování a správa schůzek
časté otázky
Portál komunity (Dynamics 365)
Customer Self-Service Portal (Dynamics 365)
Portál samoobsluhy zaměstnanců (Dynamics 365)
Partnerský portál (Dynamics 365)

Note

Vytváření nových webů s vylepšeným datovým modelem a migrací existujících webů jsou samostatné funkce. Pokud zde není uvedena původní šablona webu, nespouštějte pro daný web migrační nástroj.

Než začnete

Další aspekty plánování:

Nastavení přepnout na vylepšené prostředí datového modelu řídí datový model používaný pro nové weby. Zapnutím nastavení nedojde k migraci existujících lokalit.
Nejprve spusťte migraci v úplné kopii produkčního prostředí. Před migrací dokončete nápravu a ověření přizpůsobení.
K zálohování produkčního prostředí použijte standardní proces zálohování a obnovení vaší organizace.
Naplánujte okno údržby pro finální přepnutí do produkce a ověření.
Poznamenejte si ID webu, ID portálu, adresu URL prostředí, verzi rozhraní příkazového řádku, verze balíčků, čas zahájení migrace a výstup příkazu jako součást záznamu migrace.

Naplánujte posloupnost prostředí

Migrace podporuje různá prostředí s jiným režimem pro každé prostředí.

Prostředí	Doporučený režim	Co děláte
Development	`configurationData`	Proveďte migraci konfigurace, zkontrolujte zprávu o přizpůsobeních, napravte přizpůsobení, ověřte je a zaznamenejte konfiguraci do řešení.
Test nebo UAT	`configurationDataReferences`	Importujte testované řešení z vývoje, migrujte podporované související záznamy, aktivujte vylepšený datový model a ověřte.
Výrobní	`configurationDataReferences`	Importujte ověřené spravované řešení, migrujte podporované související záznamy, aktivujte se během časového období údržby a dokončete ověřování v produkčním prostředí.
Jedno prostředí nebo jednoduchá lokalita	`all`	Migrujte konfiguraci a související záznamy v rámci jediné operace pouze tehdy, pokud rozumíte dopadu vlastních úprav a nepoužíváte postup řešení pro více prostředí.

Vytvoření pracovní složky

K uložení sestav, staženého zdroje webu a souborů porovnání použijte prázdnou pracovní složku. Pro toto umístění se \<OUTPUT\> používají následující příklady.

mkdir C:\PowerPagesMigration\<site-name>
cd C:\PowerPagesMigration\<site-name>

Fáze migrace

Proces migrace se skládá ze čtyř fází:

Předběžné kontroly – Ověřte stav lokality, ID, rozhraní příkazového řádku, balíčků, řešení šablon a stavu migrace.
Konfigurace – Migrujte konfiguraci ve vývoji nebo importujte otestovanou konfiguraci do navazujících prostředí.
Migrace a aktivace – Migrace souvisejících záznamů, potvrzení dokončení, přepnutí modelů a restartování
Ověřte — otestujte chování, oprávnění, vlastní kód a postupy šablon.

Fáze 1 (zjišťování lokality a předběžné kontroly) a fáze 4 (ověřování po migraci) běží pro každou lokalitu stejným způsobem.

Fáze 2 a Fáze 3 jsou rozvětvené podle plánu – jejich tvar závisí na režimu migrace, který odvozuje trasu z typu prostředí.

Větev pro vytváření obsahu (režim configurationData nebo all) se používá pro vývojové prostředí a jednoprostředová nasazení. Samotná metadata se migrují místně a vlastní nastavení se kontrolují a opravují vůči standardnímu zdroji datového modelu před přesunutím transakčních odkazů.

Downstream větev (režim configurationDataReferences) se používá pro testovací, UAT a produkční prostředí, kde se předpokládá, že metadata konfigurace byla doručena prostřednictvím importu řešení ALM z vývojového prostředí. V této větvi se migrují jen transakční reference. Jakákoli zjištění týkající se přizpůsobení ukazují spíše na nedostatek v nadřazeném ALM než na práci, kterou byste měli dělat lokálně.

Fáze 1: Předběžné kontroly

Ověřte verzi Power Platform CLI pomocí příkazu pac --version. Pokud je vaše verze starší než požadovaná verze, nainstalujte nebo aktualizujte rozhraní příkazového řádku Microsoft Power Platform, než budete pokračovat.
Ověřte se v cílovém prostředí.
1. Spusťte pac auth list.
2. Spusťte pac auth who.
Ověřte, že aktivní profil autentizace směřuje na prostředí, které obsahuje web. Chcete-li vybrat jiný profil nebo vytvořit profil, použijte pac auth select nebo pac auth create -u "https://contoso.crm.dynamics.com".
K instalaci řešení rozšířeného datového modelu pro šablonu použijte jednu z následujících metod:
1. Vytvořte v centru pro správu web z vaší šablony se zapnutým příznakem EDM (Enhanced Data Model).
2. Použití rozhraní příkazového řádku k instalaci pomocí příkazu pac application install --application-name "PowerPages_PartnerPortal_V2"
Vyhledejte web a poznamenejte si jeho identifikátory pomocí pac pages list -v.

Poznamenejte si hodnoty uvedené v následující tabulce.

Hodnota	Používá se pro
ID webu	Všechny `migrate-datamodel` příkazy.
ID portálu	Přechod na vylepšený datový model a návrat ke standardnímu datovému modelu
Popisný název a adresa URL	Potvrzení, že jste v Centru pro správu vybrali správný web.
Verze datového modelu	Musí být standardní. Pokud už je rozšířená, migrace se nevyžaduje.

Important

ID portálu není ID aplikace Power Pages. Pokud rozhraní příkazového řádku nezobrazuje ID portálu, najdete ho v centru pro správu Power Platform v části Prostředky>Weby Power Pages> nebo přidejte /_services/about k adrese URL webu, když jste přihlášeni účtem s požadovanými oprávněními pro přístup k webu.

Pomocí následujícího příkazu zkontrolujte předchozí nebo probíhající migraci:

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

Status	Význam	Action
NotStarted nebo žádný tracker	Nebyla zahájena žádná migrace.	Pokračujte kontrolami balíčků.
Vráceno	Předchozí migrace byla vrácena zpět.	Zkontrolujte, proč se vrátil, a až budete připraveni, pokračujte.
Dokončeno	Migrace byla dokončena, ale web se možná nepřepnul.	Potvrďte aktivní datový model. Pokud je stále standardní, pokračujte v aktivaci.
Running	Migrace se stále zpracovává.	Pokračujte ve kontrole stavu. Nezahajte další migraci pro stejnou lokalitu.
Nezdařilo se	Při migraci došlo k chybě.	Shromážděte podrobnosti o výstupu příkazu a prostředí, opravte příčinu a zkuste to znovu až po pochopení selhání.

Note

Pokud migrace trvá déle, než se čekalo, potřebujete ID webu, ID prostředí, verzi rozhraní příkazového řádku, verze balíčků, výstup příkazu a čas zahájení migrace, než se obrátíte na podporu Microsoft. Aktivní migrace by neměla být resetována, pokud to nenařídí podpora nebo schválený runbook.

Ověřte požadované balíčky první strany pomocí pac solution list --includeSystemSolutions.
1. Ověřte, že CDSBasePortal, PowerPages_Core a řešení EDM pro šablonu lokality jsou nainstalována v požadovaných verzích.
Pokud balíček chybí nebo je zastaralý, aktualizujte ho z Centra pro správu Power Platform:
1. Otevřete cílové prostředí.
2. Přejděte na Prostředky>Dynamics 365 aplikace.
3. Vyhledejte požadovaný balíček.
4. Vyberte Nainstalovat nebo Upgradovat.
5. Počkejte, až se operace dokončí, a pak znovu spusťte pac solution list --includeSystemSolutions .
Note

Pokud řešení EDM pro danou šablonu není k dispozici k přímé instalaci, vytvořením dočasné lokality rozšířeného datového modelu ve stejném prostředí se stejnou šablonou se nainstaluje odpovídající řešení EDM. Po potvrzení řešení můžete dočasný web odstranit.
Vygenerujte sestavu přizpůsobení pomocí pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Generování sestavy nezmění web.

Otevřete vygenerovaný soubor CSV a zkontrolujte jednotlivé položky, které odkazují na standardní tabulky datového modelu. Před migrací do produkčního prostředí přiřaďte ke každému požadovanému nápravnému opatření odpovědnou osobu a krok ověření.

Kategorie přizpůsobení	Plan
Vlastní sloupce v tabulkách metadat adx_	Přesuňte vlastní data do podporované vlastní tabulky související s powerpagecomponent.
Relace s tabulkami metadat adx_	Znovu vytvořte relaci s podporovanou tabulkou rozšířeného datového modelu.
Odkazy Liquid nebo FetchXML na tabulky adx_	Aktualizujte kód tak, aby používal podporované objekty Liquid, virtuální tabulky nebo powerpagecomponent.
Pracovní postupy a moduly plug-in v tabulkách adx_	Refaktorujte a zaregistrujte logiku pro podporované tabulky rozšířeného datového modelu.

Note

Sestava přizpůsobení neprokazuje, že po migraci funguje veškeré chování webu; ověření je stále povinné.

Zvolte režim migrace a určete, co nástroj migruje v jedné operaci.

Mode	Co migruje	Kdy použít
configurationData	Podporovaná metadata konfigurace webu, jako jsou stránky, webové šablony, fragmenty kódu, nastavení, formuláře, seznamy, webové role a oprávnění tabulky.	Vývoj, kde opravíte konfiguraci a přesunete ji mezi řešeními.
Odkazy na konfigurační data	Podporované záznamy, které odkazují na migrovanou konfiguraci lokality.	Testovací, UAT a produkční prostředí po doručení konfigurace webu pomocí importu řešení.
all	Konfigurace i podporované související záznamy.	Jedno prostředí nebo jednoduchá migrace, která nepoužívá posloupnost prostředí založenou na řešení.

Fáze 2: Konfigurace lokality

Autorská větev: vývoj nebo jediné prostředí

Stáhněte si základní konfiguraci SDM spuštěním příkazu pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Příkaz vytvoří podřízenou složku pojmenovanou pro web. Poznamenejte si složku, která přímo obsahuje website.yml.
Migrujte konfiguraci webu spuštěním pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Pokud chcete použít postup s jednou operací, nahraďte configurationData za all.
Zkontrolujte stav migrace spuštěním pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatuspříkazu . Pomocí následující smyčky PowerShellu zkontrolujte stav jednou za minutu až 30 minut:
```
$webSiteId = "<WEBSITE_ID>"
for ($i = 1; $i -le 30; $i++) {
    $output = pac pages migrate-datamodel `
        --webSiteId $webSiteId `
        --checkMigrationStatus 2>&1 | Out-String
    if ($output -match "Completed|Failed|Reverted") {
        Write-Host $output
        break
    }
    Write-Host "Attempt $i/30 - migration is still running."
    Start-Sleep -Seconds 60
}
```
Pokud smyčka skončí, zatímco je stav stále Running, kontrola pokračuje pomocí --checkMigrationStatus. Dlouhotrvající operace nemusí nutně být neúspěšnou operací.
Napravte nahlášená přizpůsobení pomocí sestavy přizpůsobení a podle pokynů v tomto článku aktualizujte ovlivněné prvky FetchXML, Liquid, vlastní sloupce, relace, pracovní postupy a plug-iny. Znovu otestujte každou upravenou součást. Pokud aktualizujete stažený zdroj, nahrajte složku webu, která přímo obsahuje website.yml spuštěním pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1příkazu .

Podřízená trasa: Testování, UAT nebo produkce

Importujte řešení obsahující migrovanou a nápravnou konfiguraci lokality. Použijte centrum pro správu Power Platform nebo svůj zavedený kanál nasazení.
```
pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true
```
Ověřte, že konfigurace webu existuje, otevřením aplikace pro správu Power Pages v cílovém prostředí. Záznam lokality a očekávaná konfigurace musí být k dispozici před migrací souvisejících záznamů.

Migrujte podporované související záznamy. Pokud jste už tento krok použili --mode all, přeskočte tento krok. Zkontrolujte stav, dokud se nehlásí dokončeno.

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

Po úspěšném dokončení zprávy o stavu migrace přepněte aktivní lokalitu na vylepšený datový model. Standardní záznam webu datového modelu se deaktivuje a odpovídající záznam webu rozšířeného datového modelu se aktivuje.
```
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
```
Restart webu.
1. Otevřete centrum pro správu Power Platform.
2. Přejděte do prostředí a pak vyberte Zdroje>weby Power Pages.
3. Vyberte web.
4. Vyberte Restartovat. Pokud není možnost Restart k dispozici, deaktivujte a pak znovu aktivujte web.
5. Před ověřením počkejte, než se operace dokončí.
Pomocí jedné nebo více z těchto metod potvrďte aktivní datový model:
1. V Centru pro správu Power Platform vyberte lokalitu a potvrďte, že se u položky Datový model zobrazuje hodnota Rozšířené.
2. Otevřete pracovní prostor Nastavení webu v Power Pages design studiu a potvrďte zobrazený datový model.
3. Ověřte, že se v aplikaci pro správu Power Pages otevře pokročilá konfigurace.
4. Spusťte pac pages list -v a potvrďte verzi datového modelu.
Tip

Adresa URL webu a vizuální návrh se nemění jenom proto, že se změnil aktivní datový model. Pokud chcete ověřit migraci, použijte tyto kontroly – ne vzhled webu.

Fáze 4: Ověření migrované lokality

Před opětovným otevřením produkčního webu pro uživatele dokončete ověření. Používejte testovací účty pro každý důležitý typ uživatele a webovou roli a poznamenejte si výsledek každého kritického testu.

Area	Co ověřit
Stránky a obsah	Domovská stránka, reprezentativní stránky obsahu, webové šablony, fragmenty obsahu, webové soubory, navigace, přesměrování a vícejazyčný obsah.
Authentication	Přihlášení, odhlášení, registrace, pozvánky, externí zprostředkovatelé identit a možnosti odepření přístupu.
Authorization	Webové role, oprávnění k tabulce, oprávnění sloupců a pravidla přístupu k stránkám povolují a zakazují očekávané akce.
Formuláře a seznamy	Základní formuláře, vícekrokové formuláře, seznamy, metadata formulářů, odeslané položky, související záznamy a relace webových formulářů, které web používá.
cesty k šablonám Dynamics 365	Hlavní cesty zákazníka, zaměstnance, komunity nebo partnera používané vaší implementací, včetně stránek specifických pro šablony a vzorů přístupu.
Vlastní kód	Liquid, FetchXML, JavaScript, moduly plug-inů, pracovní postupy a integrace identifikované v sestavě přizpůsobení
Nastavení a soubory webu	Nastavení webu, obrázky, přílohy, soubory SVG a další webové soubory se načítají správně.
Data a odkazy	Počty důležitých záznamů a podporované související záznamy ukazují na správné migrované součásti webu.
Správa a ALM	Web se otevře v Power Pages Management a dá se přidat do řešení, exportovat a importovat z řešení podle očekávání.

Kontrola diagnostiky prohlížeče

Při testování reprezentativních stránek otevřete vývojářské nástroje prohlížeče. Prozkoumat:

Chyby konzole, které zmiňují adx\_, entity, Liquid nebo FetchXML.
Odpovědi HTTP 401 nebo 403 z \_api, které mohou naznačovat problém s oprávněním nebo rolí webu.
Odpovědi HTTP 500, které mohou indikovat selhání Liquidu, FetchXML, modulu plug-in nebo integrace.

Kritéria dokončení migrace

Migraci považujte za dokončenou pouze tehdy, když web zobrazuje vylepšený datový model, kritické obchodní procesy úspěšně proběhnou, očekávané chování zabezpečení je potvrzeno a každé zjištění týkající se úprav s vysokým dopadem je vyřešeno nebo akceptováno.

Pořadí migrace do produkčního prostředí

Ke snížení rizika migrace použijte následující produkční sekvenci:

Vytvořte úplnou kopii produkčního prostředí pro zkoušku.
Ověřte požadavky pro CLI, balíček a šablonové řešení ve zkopírovaném prostředí.
Vygenerujte a zkontrolujte zprávu o přizpůsobení.
Migrujte konfiguraci ve zkopírovaném vývojovém prostředí.
Opravte vlastní nastavení a zachyťte ověřenou konfiguraci lokality ve spravovaném řešení.
Naimportujte řešení do prostředí zkoušky, migrujte podporované související záznamy, aktivujte vylepšený datový model a dokončete úplný kontrolní seznam pro ověření.
Opakujte nápravu a nácvik, dokud všechny kritické testy úspěšně neprojdou.
Naplánujte okno údržby produkčního prostředí, sdělte rozhodovací body pro validaci a návrat k předchozí verzi a zálohujte produkci.
Znovu potvrďte požadavky na produkční balíček a řešení šablon.
Importujte ověřené spravované řešení do produkčního prostředí.
Spusťte configurationDataReferences, zkontrolujte stav migrace, přepněte aktivní datový model a restartujte web.
Spusťte kontrolní seznam pro ověření produkčního prostředí a vraťte web k normálnímu použití až po úspěšném dokončení kritických testů.

Vrácení migrované lokality do standardního datového modelu

Pokud ověření identifikuje kritický problém po aktivaci, pomocí následujícího příkazu znovu aktivujte záznam webu standardního datového modelu:

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Po dokončení příkazu:

Restartujte web z Centra pro správu Power Platform.
Ověřte, že web zobrazuje jako aktivní datový model Standard .
Znovu spusťte kritické ověřovací testy webu.
Před pokusem o další migraci uchovejte zprávu o migraci, podrobnosti chyby a poznámky k nápravě.

Important

Naplánujte rozhodnutí o vrácení zpět před migrací do produkčního prostředí. Před vrácením změn zkontrolujte změny provedené po přepnutí rozšířeného datového modelu, protože standardní a rozšířené záznamy webů jsou samostatné záznamy.

Troubleshooting

Zpráva nebo příznak	Pravděpodobná příčina	Action
není rozpoznáno	Příkaz používá nesprávný obor názvů nebo zastaralé rozhraní příkazového řádku.	Aktualizujte rozhraní příkazového řádku Power Platform a použijte `pac pages migrate-datamodel`.
`CDSBasePortal` nebo `PowerPages_Core` není v seznamu	Systémová řešení nebyla zahrnuta do výstupu příkazu nebo balíček není nainstalovaný.	Spusťte `pac solution list --includeSystemSolutions`. Nainstalujte nebo upgradujte chybějící balíček z Centra pro správu Power Platform.
Web není podporován pro migraci	Původní šablona není podporovaná, verze balíčků nejsou dostatečné nebo chybí odpovídající řešení šablony EDM.	Potvrďte způsobilost šablon, verze balíčků a řešení EDM uvedené v referenčních informacích k řešení šablony.
Byl předán neznámý argument `--webSiteId` pro `pac pages upload`	Příkaz pro nahrání nepřijme argument ID webu.	Vynechejte argument. Web je identifikován z `website.yml`.
Nahrání cílí na nesprávný web nebo se nepodaří web najít.	Cesta odkazuje na složku obálky místo složky webu.	Použijte vnořenou složku, ve které se přímo nachází soubor website.yml.
ID portálu se zobrazuje `Unknown` nebo `N/A`	Web je neaktivní nebo nainstalované CLI nevrací hodnotu.	Získejte ID portálu z Centra pro správu Power Platform nebo stránky webu `/_services/about` . Nepoužívejte ID aplikace.
Migrace hlásí `Completed`, ale web stále ukazuje `Standard`	Aktivní datový model se nepřepnul nebo se použilo nesprávné ID portálu.	Spusťte aktivační příkaz s ID webu a správným ID portálu, restartujte a ověřte web.
Stav zůstává `Running`	Migrace zpracovává velký objem dat nebo je zablokovaná.	Pokračujte ve kontrole stavu. Před kontaktováním podpory shromážděte prostředí, balíček, rozhraní příkazového řádku, čas spuštění a příkaz. Nezahajte druhou migraci.
Stav je `Failed`	Chyba balíčku, šablony, přizpůsobení, dat nebo služby tuto operaci zastavila.	Uložte úplný výstup příkazu, opravte identifikovanou příčinu a zkuste to znovu až po kontrole stavu neúspěšné migrace.
Web se otevře, ale uživatelé nemají přístup k očekávaným datům.	Webové role, oprávnění k tabulce nebo vlastní dotazy se po migraci nechovají podle očekávání.	Zkontrolujte webové role, oprávnění tabulky, oprávnění sloupců, chyby FetchXML, Liquid a sítě prohlížeče.

Důležité informace o přizpůsobení webu

Sestava přizpůsobení identifikuje přímé závislosti na standardních tabulkách datového modelu. Před použitím v produkčním prostředí dokončete požadovanou nápravu.

Vlastní sloupce v tabulkách metadat

Pokud standardní tabulka datového modelu, například adx_webpage obsahuje vlastní sloupec, vytvořte vlastní tabulku pro uložení vlastních dat a přidejte do powerpagecomponentsouboru vyhledávání . Migrujte vlastní hodnoty do nové tabulky a aktualizujte kód, který čte nebo zapisuje sloupec.

Relace mezi vlastními tabulkami a tabulkami metadat

Znovu vytvořte vlastní relace, které odkazují na adx_ tabulky, aby odkazy na příslušnou rozšířenou tabulku datového modelu, často powerpagecomponent. Aktualizace závislých formulářů, zobrazení, modulů plug-in, toků a integrací

Liquid – odkazy na tabulky metadat

Nahraďte přímý přístup entities['adx_*'] podporovaným objektem Liquid, pokud je k dispozici. Například místo přímého dotazování adx_weblinkset nebo souvisejících tabulek použijte weblinks objekt Liquid. Zkontrolujte každé použití, protože vrácený objekt a dostupné atributy se mohou lišit.

Odkazy FetchXML na tabulky metadat

Nahrazení přímých adx_ odkazů na entity odpovídající virtuální tabulkou nebo dotazem powerpagecomponent a filtrováním podle powerpagecomponenttype

Příklad standardního datového modelu:

<fetch>
  <entity name="adx_webpage">
    <attribute name="adx_name" />
    <filter>
      <condition attribute="adx_partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Příklad rozšířeného datového modelu:

<fetch>
  <entity name="powerpagecomponent">
    <attribute name="name" />
    <filter type="and">
      <condition attribute="powerpagecomponenttype" operator="eq" value="2" />
      <condition attribute="partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Vlastní pracovní postupy a zásuvné moduly

Přepracovat vlastní workflow a logiku plug-inu registrované pro tabulky adx_. Zaregistrujte aktualizovanou logiku v příslušné tabulce rozšířeného datového modelu a použijte rozšířené schéma a atributy. Otestujte chování vytváření, aktualizace, odstraňování a zabezpečení v neprodukčním prostředí.

Referenční informace k příkazům

Purpose	Command
Zkontrolovat verzi CLI	`pac --version`
Výpis profilů ověřování	`pac auth list`
Vytvoření ověřovacího profilu	`pac auth create -u "<ENV_URL>"`
Výpis webů a identifikátorů	`pac pages list -v`
Výpis systémových řešení	`pac solution list --includeSystemSolutions`
Kontrola stavu migrace	`pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus`
Stažení zdroje SDM	`pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"`
Stažení zdroje EDM	`pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"`
Vygenerovat sestavu o přizpůsobení	`pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"`
Migrovat konfiguraci	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData`
Migrace souvisejících záznamů	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences`
Migrace obou kategorií	`pac pages migrate-datamodel --webSiteId "<ID>" --mode all`
Nahrání zdroje webu	`pac pages upload --path "<SITE_ROOT>" --modelVersion 1`
Aktivovat EDM	`pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"`
Návrat k SDM	`pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"`

Reference typu komponenty webu

Při dotazu powerpagecomponentpoužijte následující hodnoty ve filtru powerpagecomponenttype .

Component	Hodnota	Component	Hodnota
Stav publikování	1	Webová stránka	2
Webový soubor	3	Sada webových odkazů	4
Webový odkaz	5	Šablona stránky	6
Fragment kódu obsahu	7	Šablona webu	8
Nastavení webu	9	Pravidlo řízení přístupu k webové stránce	10
Webová role	11	Přístup k webu	12
Značka webu	13	Základní formulář	15
Metadata základního formuláře	16	List	17
Oprávnění tabulky	18	Rozšířený formulář	19
Pokročilý formulářový krok	20	Metadata rozšířeného formuláře	21
Umístění ankety	24	Umístění reklamy	26
Konzument botů	27	Profil oprávnění sloupce	28
Oprávnění ke sloupci	29	Přesměrování	30
Pravidlo přechodu stavu publikování	31	Shortcut	32
Cloudový tok	33	Komponenta uživatelského prostředí	34

Referenční informace k řešení šablon EDM

Spuštěním příkazu potvrďte pac solution list --includeSystemSolutions , že je nainstalované řešení rozšířeného datového modelu pro šablonu webu.

Template	Jedinečný název řešení EDM
Úvodní rozložení 1	DefaultPortalTemplate_V2
Úvodní rozložení 2	PowerPages_BlankDesign002_V2
Úvodní rozložení 3	PowerPages_BlankDesign003_V2
Úvodní rozložení 4	PowerPages_BlankDesign004_V2
Úvodní rozložení 5	PowerPages_BlankDesign005_V2
Prázdná stránka	PowerPages_BlankTemplate_V2
časté otázky	PowerPages_FAQ_V2
Zpracování žádosti	PowerPages_BuildingPermit_V2
Registrace programu	PowerPages_ProgramRegistration_V2
Plánování a správa schůzek	PowerPages_BookMeeting_V2
Portál komunity (Dynamics 365)	PowerPages_CommunityPortal_V2
Customer Self-Service Portal (Dynamics 365)	PowerPages_CustomerPortal_V2
Samoobslužný portál zaměstnance (Dynamics 365)	PowerPages_ESSPortal_V2
Partnerský portál (Dynamics 365)	PowerPages_PartnerPortal_V2

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-09-01

Přehled migrace standardních a vylepšených datových modelů

Předpoklady

Možnosti nástroje pro migraci

Podporované šablony

Než začnete

Naplánujte posloupnost prostředí

Vytvoření pracovní složky

Fáze migrace

Fáze 1: Předběžné kontroly

Fáze 2: Konfigurace lokality

Autorská větev: vývoj nebo jediné prostředí

Podřízená trasa: Testování, UAT nebo produkce

Fáze 3: Související záznamy a aktivace

Fáze 4: Ověření migrované lokality

Kontrola diagnostiky prohlížeče

Kritéria dokončení migrace

Pořadí migrace do produkčního prostředí

Vrácení migrované lokality do standardního datového modelu

Troubleshooting

Důležité informace o přizpůsobení webu

Vlastní sloupce v tabulkách metadat

Relace mezi vlastními tabulkami a tabulkami metadat

Liquid – odkazy na tabulky metadat

Odkazy FetchXML na tabulky metadat

Vlastní pracovní postupy a zásuvné moduly

Referenční informace k příkazům

Reference typu komponenty webu

Referenční informace k řešení šablon EDM

Související obsah

Váš názor

Další materiály