Migrácia stránok štandardných dátových modelov na vylepšený dátový model (verzia Preview)

[Táto téma je predbežnou dokumentáciou a môže sa zmeniť.]

V tomto článku sa dozviete, ako migrovať existujúcu lokalitu štandardného dátového modelu na rozšírený dátový model.

Požiadavky

• Ak chcete migrovať svoje lokality na vylepšený dátový model, musíte nainštalovať Microsoft Power Platform CLI s verziou 1.31.6 alebo vyššou. Ďalšie informácie: Nainštalujte najnovšie Power Platform CLI
• Dataverse základný portálový balík 9.3.2307.x alebo vyšší. 
• Power Pages Základný balík 1.0.2309.63 alebo vyšší. Ďalšie informácie: Aktualizujte riešenie Power Pages
• Na dokončenie krokov migrácie budete musieť pochopiť, ako používať Power Platform CLI v Power Pages . Ak nepoznáte Power Platform CLI v Power Pages, možno by ste si mali prečítať tento Power Platform príručku CLI a odkázať na Príkazy PAC CLI na prácu s Power Pages.

Krok č. 1: Stiahnite a skontrolujte prispôsobenie pre existujúce štandardné metaúdaje lokality

1. Otvorte príkazový riadok.

2. Pomocou nasledujúceho príkazu autentifikujte Dataverse organizáciu pre vaše Power Platform prostredie a stiahnite si záznam webovej lokality na migráciu.

   pac auth create -u [Dataverse URL]

   Príklad

   pac auth create -u https://contoso-org.crm.dynamics.com

   Viac informácií: pac auth create

3. Na vygenerovanie zoznamu webových lokalít v aktuálnej organizácii použite nasledujúci príkaz.

   pac powerpages list

   Viac informácií: zoznam pac powerpages

4. Na stiahnutie zostavy prispôsobenia použite nasledujúci príkaz.

   pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]

   Príklad

   pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"

Ak v stiahnutom prehľade nájdete nejaké prispôsobenie, postupujte podľa pokynov v prehľade a opravte ho po migrácii na rozšírený dátový model. Ďalšie informácie: Úvahy o prispôsobení stránok pri migrácii stránok zo štandardného na rozšírený dátový model

Krok č. 2. Migrujte údaje lokality zo štandardného na rozšírený dátový model

Na migráciu údajov lokality do rozšíreného údajového modelu použite nasledujúci príkaz.

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]

Režim môže mať 3 hodnoty:

• configurationData: migrujte metadáta pre webovú stránku. Viac informácií: Zoznam tabuliek na uloženie konfiguračných údajov

• configurationDataReferences: migrujte transakčné údaje pre web. Viac informácií: Zoznam tabuliek na ukladanie nekonfiguračných údajov

• all: migruje oba typy údajov.

Príklad

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all

Nástroj na migráciu overí riešenia. Ak je k dispozícii štandardné riešenie dátového modelu bez príslušného riešenia vylepšeného dátového modelu pre uvedenú šablónu, zobrazí sa varovanie: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Existujú špecifické šablóny, ako je registrácia programu a plánovanie a správa stretnutí, ktoré vyžadujú zhodu balíkov vylepšených dátových modelov, aby sa zabezpečilo správne fungovanie migrovanej webovej lokality. Ak chcete získať tieto balíky vylepšených dátových modelov, musíte vytvoriť novú lokalitu pre zodpovedajúcu šablónu (prostredie by malo byť povolené pre vylepšený dátový model), aby ste poskytli riešenia kompatibilné s vylepšeným dátovým modelom pre migráciu.

Podporované šablóny pre migráciu

Pre migráciu sú podporované stránky s nasledujúcimi šablónami:

• Úvodné rozloženie 1 až 5
• Spracovanie aplikácie
• Prázdna stránka
• Registrácia v programe
• Plán a správa schôdzí

Krok č. 3. Overte stav migrácie

Na overenie stavu migrácie vašej lokality použite nasledujúci príkaz:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

Príklad

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus

Krok č. 4. Po úspešnej migrácii údajov aktualizujte verziu dátového modelu lokality

Použite nasledujúci príkaz aktualizovať verziu dátového modelu lokality:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]

Príklad

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

Vráťte migrovanú lokalitu z vylepšeného na štandardný dátový model

Ak chcete po migrácii vrátiť lokalitu štandardného dátového modelu na vylepšený dátový model, použite nasledujúci príkaz:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]

Príklad

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e

Migrujte produkčnú lokalitu zo štandardného na rozšírený dátový model

Pred migráciou produkčného miesta odporúčame vytvoriť úplnú kópiu produkčného miesta. Odporúčame tiež, aby sa migrácia výrobného miesta vykonávala počas mimopracovných hodín.

Pomocou týchto krokov migrujte svoju produkčnú lokalitu na vylepšený dátový model:

1. Vyskúšajte migráciu na lokalite v skopírovanom prostredí pomocou príkazu PAC CLI migrate-datamodel .
2. Pridajte konfiguračné údaje lokality do spravované riešenie a importujte ich do produkčného prostredia.
3. Použite príkazy PAC CLI na migráciu nekonfigurovaných údajov a dokončite ju aktualizáciou verzie údajového modelu pre produkciu.

Úvahy o prispôsobení lokality pri migrácii lokalít zo štandardného na rozšírený dátový model

Táto časť poskytuje návod na opravu prispôsobenia pre migráciu lokality zo štandardného na rozšírený dátový model.

Existuje päť typov prispôsobení stránok v tabuľkách metadát adx:

• Vlastné stĺpce v tabuľkách metadát adx
• Vzťah medzi vlastnými tabuľkami a tabuľkami adx
• Odkazy na tabuľku Adx v tekutom úryvok kódu
• Odkazy na tabuľku Adx v načítaní xml
• Vlastný pracovný postup a doplnky v tabuľkách adx

Vlastné stĺpce v tabuľkách metadát adx

Ak chcete opraviť toto prispôsobenie v vylepšenom dátovom modeli, vytvorte vzťah medzi systémovými tabuľkami a novou vlastnou tabuľkou a migrujte údaje do novej tabuľky.

Štandardný dátový model: Tabuľka adx_webpage obsahuje vlastný stĺpec ako contoso_pagetype.

Vylepšený dátový model: Vytvorte novú tabuľku s názvom contoso_webpage. Bude to zahŕňať stĺpec s názvom contoso_pagetype a vyhľadávací stĺpec contoso_webpage_id , ktorý je spojený s powerpagescomponent. Na vytvorenie tabuľky použite Pracovný priestor údajov .

Vzťah medzi vlastnými tabuľkami a tabuľkami adx

Ak chcete opraviť toto prispôsobenie v vylepšenom dátovom modeli, vytvorte vzťah medzi vlastnými tabuľkami a systémovými tabuľkami.

Štandardný dátový model: Tabuľka adx_webpage má vzťah s názvom adx_webpage_contoso_pagelogs s tabuľkou contoso_pagelogs .

Vylepšený dátový model: Vytvorte nový vzťah s názvom powerpagecomponent_contoso_pagelogs s tabuľkou contoso_webpage . Na vytvorenie tabuľky použite Pracovný priestor údajov .

Odkazy na tabuľku Adx v tekutom úryvok kódu

Ak chcete opraviť toto prispôsobenie v vylepšenom dátovom modeli, nahraďte odkazy na tabuľku adx v tekutom kóde za odkazy na mspp virtuálnych tabuliek vylepšeného dátového modelu. Prípadne môžete použiť tabuľku Komponent lokality (logický názov powerpagecomponent) spolu s tabuľkou Typ komponentu (logický názov powerpagecomponenttype) na získanie zodpovedajúcich odkazov.

Štandardný dátový model:entities kvapalná značka sa používa na prístup k webovým odkazom hodnotám v {% assign app_weblinks= entities['adx_weblinks'] %} kóde.

Vylepšený dátový model: Namiesto používania webových odkazov cez entities tekutú značku použite príslušné tekuté objekty. entities[adx_weblinks] priamo. V tomto prípade entities['adx_weblinks'] môže byť nahradený weblinks tekutým objektom.

Odkazy na tabuľku Adx v načítaní xml

Ak chcete opraviť toto prispôsobenie v vylepšenom dátovom modeli, nahraďte odkazy na tabuľku adx v súbore xml načítania priamymi odkazmi na virtuálne tabuľky vylepšeného dátového modelu. Prípadne môžete použiť tabuľku Komponent lokality (logický názov powerpagecomponent) spolu s tabuľkou Typ komponentu (logický názov powerpagecomponenttype) na získanie zodpovedajúcich odkazov.

Štandardný dátový model: Názov tabuľky adx_webrole sa používa v dotaze fetch xml.

{% fetchxml app_webroles %}
<fetch>
 <entity name='adx_webrole'>
  <attribute name='adx_name'/>
 <entity>
</fetch>
{% endfetchxml %}

Rozšírený dátový model: Použite Komponent lokality (logický názov powerpagecomponent) v spojení s Atribút Typ komponentu (logický názov powerpagecomponenttype) na získanie zodpovedajúcich odkazov.

{% 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 komponentu lokality

Vlastný pracovný postup a doplnky v tabuľkách adx

Ak chcete opraviť toto prispôsobenie v vylepšenom dátovom modeli, je potrebné refaktorovať a znova zaregistrovať logiku pracovného postupu a doplnkov v príslušnej tabuľke lokality.

Ak napríklad používateľ zaregistroval pracovný postup/doplnok na Primárnu entitu ako Webovú stránku (logický názov adx_webpage) tabuľky v štandardnom dátovom modeli, potom sa kód v rámci pracovného postupu/doplnku musí upraviť na Stránka Tabuľka komponentov (logický názov powerpagecomponent) a jej atribúty pre rozšírený dátový model.

Známe problémy

Príkaz migrácie spracováva iba dávku 5K záznamov zo štandardného dátového modelu do rozšíreného dátového modelu.