Migrace webů se standardním datovým modelem na vylepšený datový model (preview)
[Toto téma představuje předběžnou dokumentaci, která může být změněna.]
V tomto článku se dozvíte, jak migrovat stávající web se standardním datovým modelem na vylepšený datový model.
Důležité
- Toto je funkce Preview.
- Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. Jsou to funkce, které jsou poskytnuté před svým oficiálním vydáním, aby si je zákazníci mohli co nejdříve vyzkoušet a mohli nám napsat své názory.
Předpoklady
- Chcete-li migrovat své weby na vylepšený datový model, musíte nainstalovat Microsoft Power Platform CLI ve verzi 1.31.6 nebo vyšší. Další informace: Instalace nejnovějšího řešení Power Platform CLI
- Základní portálový balíček Dataverse9.3.2307.x nebo vyšší.
- Základní balíček služby Power Pages ve verzi 1.0.2309.63 nebo vyšší. Více informací: Aktualizace řešení Power Pages
- K dokončení kroků migrace budete muset pochopit, jak používat Power Platform CLI v Power Pages. Pokud neznáte Power Platform CLI v Power Pages, možná si budete chtít přečíst tento Power Platform výukový program CLI a odkázat na Příkazy PAC CLI pro práci s Power Pages.
Krok 1. Stáhněte a zkontrolujte přizpůsobení stávajících standardních metadat webu
Otevřete příkazový řádek.
Pomocí následujícího příkazu se ověřte u organizace Dataverse pro vaše prostředí Power Platform a stáhněte si záznam webu pro migraci.
pac auth create -u [Dataverse URL]
Příklad
pac auth create -u https://contoso-org.crm.dynamics.com
Další informace: pac auth create
Pomocí následujícího příkazu vygenerujte seznam webů v aktuální organizaci.
pac powerpages list
Další informace: pac powerpages list
Ke stažení sestavy přizpůsobení použijte následující příkaz.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]
Příklad
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"
Pokud ve staženém přehledu najdete nějaké přizpůsobení, postupujte podle pokynů v přehledu a opravte jej po migraci na vylepšený datový model. Další informace: Úvahy o přizpůsobení webu při migraci webů ze standardního na vylepšený datový model
Krok 2. Migrace dat webů ze standardního na vylepšený datový model
Pomocí následujícího příkazu migrujte data webu do vylepšeného datového modelu.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]
Režim může mít 3 hodnoty:
configurationData: migrujte metadata pro web. Více informací: Seznam tabulek pro uložení konfiguračních dat
configurationDataReferencs: migrujte transakční data pro web. Více informací: Seznam tabulek pro uložení nekonfiguračních dat
vše: migrujte oba typy dat.
Příklad
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all
Nástroj pro migraci ověřuje řešení. Pokud je k dispozici standardní řešení datového modelu bez příslušného rozšířeného řešení datového modelu pro uvedenou šablonu, zobrazí se varování: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template
Existují konkrétní šablony, jako je registrace programu a plánování a správa schůzek, které vyžadují odpovídající balíčky vylepšených datových modelů, aby bylo zajištěno správné fungování migrovaného webu. Chcete-li získat tyto balíčky vylepšeného datového modelu, musíte vytvořit nový web pro odpovídající šablonu (prostředí by mělo být pro vylepšený datový model povoleno), abyste poskytli řešení kompatibilní s vylepšeným datovým modelem pro migraci.
Podporované šablony pro migraci
Pro migraci jsou podporovány weby s následujícími šablonami:
- Počáteční rozložení 1–5
- Zpracování žádosti
- Prázdná stránka
- Registrace programu
- Plánování a správa schůzek
Krok 3. Ověření stavu migrace
Pomocí následujícího příkazu ověřte stav migrace svého webu:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus
Příklad
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus
Poznámka:
Pokud migrace vašeho webu trvá déle, než se očekávalo, může to být způsobeno objemem dat. Pokud se příkazový řádek zavře, otevřete nový příkazový řádek a pomocí příkazu v tomto kroku ověřte stav webu.
Krok 4. Aktualizujte verzi datového modelu webu po úspěšné migraci dat
Použijte následující příkaz aktualizovat verzi datového modelu webu:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]
Poznámka:
- ID portálu můžete najít tak, že přejdete na webovou stránku s '/_services/about připojenou k adrese URL webu. Aby bylo možné zobrazit tyto možnosti, měl by mít uživatel webovou roli s přidělenými všemi oprávněními k přístupu na web.
- Po aktualizaci verze datového modelu webu bude záznam webu propojený se standardním datovým modelem deaktivován. Místo toho bude web nyní odkazovat na záznam webu spojený s vylepšeným datovým modelem.
- Uživatel by měl mít kteroukoli z následujících rolí pro provádění příkazu migrace s argumenty
updateDatamodelVersion
neborevertToStandardDataModel
. Protože to provede akci správce, která přepne váš web na vylepšený datový model nebo naopak.
Příklad
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e
Vraťte migrovaný web zpět z vylepšeného standardní datový model
Chcete-li po migraci vrátit web standardního datového modelu na rozšířený datový model, použijte následující příkaz:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]
Poznámka:
Když přepnete migrovaný web z rozšířeného datového modelu zpět na standardní datový model, záznam webu spojený s rozšířeným datovým modelem bude deaktivován a záznam webu pro standardní datový model bude znovu aktivován.
Příklad
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e
Migrace produkčního webu ze standardního na vylepšený datový model
Před migrací produkčního místa doporučujeme vytvořit úplnou kopii produkčního webu. Také doporučujeme, aby migrace produkčního webu probíhala mimo pracovní dobu.
Pomocí těchto kroků migrujte svůj produkční web do vylepšeného datového modelu:
- Vyzkoušejte migraci na webu ve zkopírovaném prostředí pomocí příkazu PAC CLI
migrate-datamodel
. - Přidejte konfigurační data webu do spravovaného řešení a importujte je do produkčního prostředí.
- Použijte příkazy PAC CLI k migraci nekonfiguračních dat a dokončete ji aktualizací verze datového modelu pro produkci.
Poznámka:
Pro migraci je ID zdroje a produkčního webu stejné.
Úvahy o přizpůsobení webu při migraci webů ze standardního na vylepšený datový model
Tato část poskytuje návod, jak upravit vlastní nastavení pro migraci webu ze standardního na vylepšený datový model.
V tabulkách metadat adx existuje pět typů přizpůsobení webu:
- Vlastní sloupce v tabulkách metadat adx
- Vztah mezi vlastními tabulkami a tabulkami adx
- Odkazy na tabulku Adx v fragmentu kódu liquid
- Odkazy na tabulku Adx v načtení xml
- Vlastní pracovní postup a moduly plug-in v tabulkách adx
Poznámka:
Všechny opravy související s přizpůsobením budou provedeny po migraci na vylepšený datový model.
Vlastní sloupce v tabulkách metadat adx
Chcete-li opravit toto přizpůsobení v rozšířeném datovém modelu, vytvořte vztah mezi systémovými tabulkami a novou vlastní tabulkou a migrujte data do nové tabulky.
Standardní datový model: Tabulka adx_webpage
obsahuje vlastní sloupec jako contoso_pagetype
.
Vylepšený datový model: Vytvořte novou tabulku s názvem contoso_webpage
. To bude zahrnovat sloupec s názvem contoso_pagetype
a vyhledávací sloupec contoso_webpage_id
, který je spojen s powerpagescomponent
. Pro vytvoření tabulky použijte Pracovní prostor pro data.
Vztah mezi vlastními tabulkami a tabulkami adx
Chcete-li opravit toto přizpůsobení v rozšířeném datovém modelu, vytvořte vztah mezi vlastními a systémovými tabulkami.
Standardní datový model: Tabulka adx_webpage
má vztah s názvem adx_webpage_contoso_pagelogs
s tabulkou contoso_pagelogs
.
Vylepšený datový model: Vytvořte nový vztah pojmenovaný powerpagecomponent_contoso_pagelogs
s tabulkou contoso_webpage
. Pro vytvoření tabulky použijte Pracovní prostor pro data.
Odkazy na tabulku Adx ve fragmentu kódu liquid
Chcete-li opravit toto přizpůsobení ve vylepšeném datovém modelu, nahraďte odkazy na tabulky adx v kódu liquid za odkazy na mspp virtuálních tabulek vylepšeného datového modelu. Případně můžete použít tabulku Komponenta webu (logický název powerpagecomponent
) spolu s Typ komponenty (logický název powerpagecomponenttype
) pro získání odpovídajících odkazů.
Standardní datový model:entities
značka liquid se používá k přístupu k hodnotám webových odkazů v kódu {% assign app_weblinks= entities['adx_weblinks'] %}
.
Vylepšený datový model: Místo používání webových odkazů prostřednictvím značky liquid entities
použijte příslušné objekty liquid.
entities[adx_weblinks]
přímo. V tomto případě entities['adx_weblinks']
může být nahrazeno objektem liquid weblinks
.
Odkazy na tabulku Adx v načtení xml
Chcete-li opravit toto přizpůsobení ve vylepšeném datovém modelu, nahraďte odkazy na tabulky adx v načtení xml za přímé odkazy virtuálních tabulek vylepšeného datového modelu. Případně můžete použít tabulku Komponenta webu (logický název powerpagecomponent
) spolu s Typ komponenty (logický název powerpagecomponenttype
) pro získání odpovídajících odkazů.
Standardní datový model: Název tabulky adx_webrole
se používá v dotazu načítání xml.
{% fetchxml app_webroles %}
<fetch>
<entity name='adx_webrole'>
<attribute name='adx_name'/>
<entity>
</fetch>
{% endfetchxml %}
Vylepšený datový model: Použijte Komponentu webu (logický název powerpagecomponent
) spolu s Typem komponenty (logický název powerpagecomponenttype
) pro získání odpovídajících odkazů.
{% fetchxml app_webroles %}
<fetch>
<entity name='powerpagecomponent'>
<attribute name='adx_name'/>
<filter type='and'>
<condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
<entity>
</fetch>
{% endfetchxml %}
Typ a hodnoty komponenty webu
Typ komponenty | Hodnota |
---|---|
Stav publikování | 01 |
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 |
Označení webu | 13 |
Základní formulář | 15 |
Metadata základního formuláře | 16 |
Seznam | 17 |
Oprávnění tabulky | 18 |
Rozšířený formulář | 19 |
Krok rozšířeného formuláře | 20 |
Metadata rozšířeného formuláře | 21 |
Umístění ankety | 24 |
Umístění reklamy | 26 |
Konzument robota | 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 |
Zástupce | 32 |
Cloudový tok | 33 |
Komponenta uživatelského prostředí | 34 |
Vlastní pracovní postup a moduly plug-in v tabulkách adx
Chcete-li opravit toto přizpůsobení ve vylepšeném datovém modelu, je třeba refaktorovat a znovu zaregistrovat logiku pracovního postupu a pluginu v příslušné tabulce webu.
Pokud například uživatel zaregistroval pracovní postup/plugin do Primární entity jako Webovou stránku (logický název adx_webpage
) ve standardním datovém modelu, pak je nutné kód v rámci pracovního postupu/pluginu upravit na Komponentu webu (logický název powerpagecomponent
) a její atributy pro vylepšený datový model.
Známé problémy
Příkaz migrace zpracovává pouze dávku 5K záznamů ze standardního datového modelu do rozšířeného datového modelu.