Zdieľať cez

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

  • Článok

[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.

Dôležité

  • Táto funkcia je ukážková funkcia.
  • Funkcie ukážky nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.

Požiadavky

Krok č. 1: Stiahnite si a skontrolujte prispôsobenie pre existujúce štandardné metadáta lokality

  1. Otvorte príkazový riadok.

  2. Použite nasledujúci príkaz na autentifikáciu Dataverse organizácie 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í: Vytvorenie pac auth

  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ý údajový 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:

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

Poznámka

Ak migrácia vašich stránok trvá dlhšie, ako sa očakávalo, môže to byť spôsobené množstvom údajov. Ak sa váš príkazový riadok zatvorí, otvorte nový príkazový riadok a pomocou príkazu v tomto krok overte stav svojej lokality.

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]

Poznámka

  • Identifikátor portálu môžete nájsť tak, že prejdete na webovú lokalitu s reťazcom „/_services/about“ pripojeným k adrese URL webovej lokality. Ak chcete zobraziť tieto možnosti, používateľ by mal mať pridelenú webovú rolu so všetkými oprávneniami na prístup na web .
  • Po aktualizácii verzie dátového modelu stránky bude záznam stránky prepojený so štandardným dátovým modelom deaktivovaný. Namiesto toho bude lokalita teraz odkazovať na záznam webovej lokality spojený s rozšíreným dátovým modelom.
  • Používateľ by mal mať niektorú z nasledujúcich rolí na vykonanie príkazu migrácie s argumentmi updateDatamodelVersion alebo revertToStandardDataModel . Tým sa vykoná akcia správcu na prepnutie vášho webu na vylepšený dátový model alebo naopak.

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]

Poznámka

Keď prepnete migrovanú lokalitu z rozšíreného dátového modelu späť na štandardný dátový model, záznam webovej lokality spojený s rozšíreným dátovým modelom sa deaktivuje a záznam webovej lokality pre štandardný dátový model sa znova aktivuje.

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.

Poznámka

Pre migráciu je ID zdroja a produkčného webu rovnaké.

Ú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:

Poznámka

Všetky opravy súvisiace s prispôsobením sa vykonajú po migrácii na vylepšený dátový model.

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 .

Vytvorte tabuľku contoso_webpage v vylepšenom dátovom modeli na opravu kódu

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) atribút 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) atribút 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

Typ súčasti Hodnota
Stav publikovania 1
Webová stránka 2
Webový súbor 3
Množina webových prepojení 4
Webové prepojenie 5
Šablóna stránky 6
Úryvok obsahu 7
Webová šablóna 8
Nastavenie lokality 9
Pravidlo riadenia prístupu na webovú stránku 10
Webová rola 11
Prístup na webovú lokalitu 12
Značka lokality 13
Základný formulár 15
Metaúdaje základného formulára 16
List 17
Povolenie tabuľky 18
Rozšírený formulár 19
Krok rozšíreného formulára 20
Metaúdaje rozšíreného formulára 21
Umiestnenie ankety 24
Umiestnenie reklamy 26
Spotrebiteľ bota 27
Profil povolenia stĺpca 28
Povolenie stĺpca 29
Presmerovať 30
Pravidlo prechodu do stavu publikovania 31
Odkaz 32
Postup v cloude 33
Súčasť používateľského prostredia 34

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 Komponent lokality (logický názov powerpagecomponent) tabuľky a jej atribútov pre rozšírený dátový model.

Použite tabuľku komponentov lokality v rámci pracovného toku a jej atribúty pre vylepšený 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.