Migracija web-mjesta standardnog podatkovnog modela na poboljšani podatkovni model (pretpregled)
[Ova je tema dokumentacija prije izdanja i podložna je promjenama.]
U ovom članku saznajte kako migrirati postojeće web-mjesto standardnog podatkovnog modela na poboljšani podatkovni model.
Važno
- Ovo je značajka pretpregleda.
- Značajke pretpregleda nisu namijenjene u proizvodne svrhe i mogu imati ograničene funkcije. Te su značajke dostupne prije službenog izdavanja da bi se klijentima omogućio prijevremeni pristup i slanje povratnih informacija.
Preduvjeti
- Morate instalirati Microsoft Power Platform CLI s verzijom 1.31.6 ili novijom da biste migrirali svoje web-lokacije na poboljšani podatkovni model. Dodatne informacije: Instalacija najnovijeg Power Platform CLI-ja
- Dataverse Osnovni paket portala 9.3.2307.x ili noviji.
- Power Pages Osnovni paket 1.0.2309.63 ili noviji. Dodatne informacije: Ažuriranje Power Pages rješenja
- Morat ćete razumjeti kako koristiti Power Platform CLI da Power Pages biste dovršili korake migracije. Ako niste upoznati s Power Platform CLI-jem Power Pages, možda ćete htjeti pregledati ovaj Power Platform vodič za CLI i uputiti se na naredbe PAC CLI za rad s njima Power Pages.
1. korak Preuzmite i provjerite prilagodbu za postojeće standardne metapodatke web-mjesta
Otvorite naredbeni redak.
Upotrijebite sljedeću naredbu za provjeru autentičnosti u tvrtki ili ustanovi Dataverse za vaše Power Platform okruženje da biste preuzeli zapis web-mjesta za migraciju.
pac auth create -u [Dataverse URL]
Primjer
pac auth create -u https://contoso-org.crm.dynamics.com
Više informacija: pac auth create
Pomoću sljedeće naredbe generirajte popis web-mjesta u trenutnoj tvrtki ili ustanovi.
pac powerpages list
Dodatne informacije: popis stranica za pojačane stranice
Upotrijebite sljedeću naredbu za preuzimanje izvješća o prilagodbi.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]
Primjer
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"
Ako u preuzetom izvješću pronađete prilagodbu, slijedite upute u izvješću da biste je popravili nakon migracije na poboljšani podatkovni model. Dodatne informacije: Razmatranja za prilagodbu web-mjesta prilikom migracije web-mjesta sa standardnog na poboljšani podatkovni model
2. korak Migracija podataka web-mjesta sa standardnog na poboljšani podatkovni model
Pomoću sljedeće naredbe migrirajte podatke web-mjesta u poboljšani podatkovni model.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]
Način rada može imati 3 vrijednosti:
configurationData: migrirajte metapodatke za web stranicu. Dodatne informacije: Popis tablica za pohranu konfiguracijskih podataka
configurationDataReferences: migrirajte transakcijske podatke za web stranicu. Dodatne informacije: Popis tablica za pohranu podataka koji nisu konfiguraciji
Sve: migrirajte obje vrste podataka.
Primjer
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all
Alat za migraciju provjerava rješenja. Ako postoji standardno rješenje podatkovnog modela bez odgovarajućeg rješenja poboljšanog podatkovnog modela za spomenuti predložak, prikazuje se upozorenje: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template
Postoje posebni predlošci, kao što su Registracija programa i Zakazivanje i upravljanje sastancima, koji zahtijevaju odgovarajuće pakete poboljšanih podatkovnih modela kako bi se osiguralo ispravno funkcioniranje migrirane web stranice. Da biste dobili ove pakete poboljšanih podatkovnih modela, morate stvoriti novo web-mjesto za odgovarajući predložak (okruženje bi trebalo biti omogućeno za poboljšani podatkovni model) da biste pružili poboljšana rješenja kompatibilna s podatkovnim modelom za migraciju.
Podržani predlošci za migraciju
Web-mjesta sa sljedećim predlošcima podržana su za migraciju:
- Početni raspored 1 – 5
- Obrada aplikacije
- Prazna stranica
- Registracija programa
- Zakažite sastanke i upravljajte njima
3. korak Provjera statusa migracije
Pomoću sljedeće naredbe provjerite status migracije web-lokacije:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus
Primjer
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus
Napomena
Ako migracija web-lokacije traje dulje nego što se očekivalo, to može biti zbog količine podataka. Ako se naredbeni redak zatvori, otvorite novi naredbeni redak i upotrijebite naredbu u ovom korak da biste provjerili status web-lokacije.
4. korak Ažuriranje verzije podatkovnog modela web-mjesta nakon uspješne migracije podataka
Upotrijebite sljedeću naredbu za ažuriranje verzije podatkovnog modela web-mjesta:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]
Napomena
- ID portala možete pronaći tako da odete na web stranicu s '/_services/about' dodanim URL-u web stranice. Da bi mogao vidjeti ove opcije, korisnik bi trebao imati web ulogu sa svim dodijeljenim dozvolama za pristup web stranici.
- Nakon ažuriranja verzije podatkovnog modela web-mjesta, zapis web-mjesta povezan sa standardnim podatkovnim modelom bit će deaktiviran. Umjesto toga, web-mjesto će se sada pozivati na zapis web-mjesta povezan s poboljšanim podatkovnim modelom.
- Korisnik bi trebao imati bilo koju od sljedećih uloga za izvršavanje naredbe migracije s
updateDatamodelVersion
argumentima ilirevertToStandardDataModel
. Budući da će ovo izvršiti administratorsku radnju za prebacivanje vaše web stranice na enahance podatkovni model ili obrnuto.
Primjer
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e
Vraćanje migriranog web-mjesta iz poboljšanog u standardni podatkovni model
Upotrijebite sljedeću naredbu da biste vratili web-mjesto standardnog podatkovnog modela na poboljšani podatkovni model nakon migracije:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]
Napomena
Kada migrirano web-mjesto prebacite s proširenog podatkovnog modela natrag na standardni podatkovni model, zapis web-mjesta povezan s poboljšanim podatkovnim modelom bit će deaktiviran, a zapis web-mjesta za standardni podatkovni model ponovno će se aktivirati.
Primjer
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e
Migracija proizvodnog web-mjesta sa standardnog na poboljšani podatkovni model
Prije migracije proizvodnog web-mjesta preporučujemo stvaranje potpune kopije proizvodnog web-mjesta. Također preporučujemo da se migracija proizvodnog mjesta provede izvan radnog vremena.
Slijedite ove korake da biste migrirali proizvodno web-mjesto na poboljšani podatkovni model:
- Isprobajte migraciju na web-mjestu u kopiranom okruženju pomoću naredbe PAC CLI
migrate-datamodel
. - Dodajte podatke o konfiguraciji web-mjesta u upravljano rješenje i uvezite ga u proizvodno okruženje.
- Upotrijebite naredbe PAC CLI za migraciju podataka koji nisu konfiguraciji i dovršite ih ažuriranjem verzije podatkovnog modela za proizvodnju.
Napomena
Za migraciju su izvor i ID proizvodne web stranice isti.
Razmatranja za prilagodbu web-mjesta prilikom migracije web-mjesta sa standardnog na poboljšani podatkovni model
U ovom se odjeljku nalaze smjernice za prilagodbu za migraciju web-mjesta sa standardnog na poboljšani podatkovni model.
Postoji pet vrsta prilagodbi web-lokacije u tablicama adx metapodataka:
- Prilagođeni stupci u tablicama adx metapodataka
- Odnos između prilagođenih tablica i adx tablica
- Reference tablice Adx u tekućem isječak koda
- Reference tablice Adx u xml dohvaćanju
- Prilagođeni tijek rada i dodaci na adx tablicama
Napomena
Svi popravci povezani s prilagodbom izvršit će se nakon migracije na poboljšani podatkovni model.
Prilagođeni stupci u tablicama adx metapodataka
Da biste popravili ovu prilagodbu u poboljšanom podatkovnom modelu, stvorite odnos između sistemskih tablica i nove prilagođene tablice i migrirajte podatke u novu tablicu.
Standardni podatkovni model: Tablica adx_webpage
sadrži prilagođeni stupac kao contoso_pagetype
.
Poboljšani podatkovni model: Stvorite novu tablicu s contoso_webpage
nazivom. To će uključivati stupac koji se zove contoso_pagetype
i stupac contoso_webpage_id
s vrijednostima koji je povezan s powerpagescomponent
. Koristite radni prostor podataka za stvaranje tablice.
Odnos između prilagođenih tablica i adx tablica
Da biste popravili ovu prilagodbu u poboljšanom podatkovnom modelu, stvorite odnos između prilagođenih tablica i tablica sustava.
Standardni podatkovni model: Tablica adx_webpage
ima odnos nazvan adx_webpage_contoso_pagelogs
s tablicom contoso_pagelogs
.
Poboljšani podatkovni model: Stvorite novi odnos nazvan powerpagecomponent_contoso_pagelogs
s tablicom contoso_webpage
. Koristite radni prostor podataka za stvaranje tablice.
Reference tablice Adx u tekućem isječak koda
Da biste popravili ovu prilagodbu u poboljšanom podatkovnom modelu, zamijenite reference adx tablice u tekućem kodu referencama mspp virtualnih tablica modela podataka. Alternativno, možete koristiti tablicu Komponenta web-mjesta (logički naziv powerpagecomponent
) zajedno s atributom Vrsta komponente (logički naziv powerpagecomponenttype
) za dohvaćanje odgovarajućih referenci.
Standardni podatkovni model:entities
tekuća oznaka koristi se za pristup vrijednostima web-veza u kodu {% assign app_weblinks= entities['adx_weblinks'] %}
.
Poboljšani model podataka: Umjesto korištenja web-veza putem entities
oznake liquid, koristite odgovarajuće tekuće objekte.
entities[adx_weblinks]
direktno. U tom slučaju entities['adx_weblinks']
može se zamijeniti tekućim predmetom weblinks
.
Reference tablice Adx u xml dohvaćanju
Da biste popravili ovu prilagodbu u poboljšanom podatkovnom modelu, zamijenite reference adx tablice u dohvaćanju xml-a izravnim referencama virtualnih tablica modela podataka. Alternativno, možete koristiti tablicu Komponenta web-mjesta (logički naziv powerpagecomponent
) zajedno s atributom Vrsta komponente (logički naziv powerpagecomponenttype
) za dohvaćanje odgovarajućih referenci.
Standardni podatkovni model: Naziv adx_webrole
tablice koristi se unutar xml upita za dohvaćanje.
{% fetchxml app_webroles %}
<fetch>
<entity name='adx_webrole'>
<attribute name='adx_name'/>
<entity>
</fetch>
{% endfetchxml %}
Poboljšani podatkovni model: Koristite komponentu web-mjesta (logički naziv powerpagecomponent
) u kombinaciji s atributom Vrsta komponente (logički naziv powerpagecomponenttype
) za dohvaćanje odgovarajućih referenci.
{% fetchxml app_webroles %}
<fetch>
<entity name='powerpagecomponent'>
<attribute name='adx_name'/>
<filter type='and'>
<condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
<entity>
</fetch>
{% endfetchxml %}
Vrsta i vrijednosti komponente web-mjesta
Vrsta komponente | Vrijednost |
---|---|
Stanje objavljivanja | 1 |
Web-stranica | 2 |
Web-datoteka | 3 |
Skup veza na web-mjesto | 4 |
Web-veza | 5 |
Predložak stranice | 6 |
Isječak sadržaja | 7 |
Web-predložak | 8 |
Postavka web-mjesta | 9 |
Pravilo kontrole pristupa web-stranici | 1,0 |
Web-uloga | 11 |
Pristup web-mjestu | 12 |
Oznaka web-mjesta | 13 |
Osnovni obrazac | 15 |
Metapodaci osnovnog obrasca | 16 |
Popis | 17 |
Dozvola za tablice | 18 |
Napredni obrazac | 19 |
Korak naprednog obrasca | 20 |
Metapodaci naprednog obrasca | 21 |
Položaj ankete | 24 |
Položaj oglasa | 26 |
Bot potrošač | 27 |
Profil dozvole stupca | 28 |
Dozvola stupca | 29 |
Preusmjeravanje | 30 |
Pravilo prijelaza stanja objave | 31 |
Prečac | 32 |
Tok oblaka | 33 |
UX komponenta | 34 |
Prilagođeni tijek rada i dodaci na adx tablicama
Da biste popravili ovu prilagodbu u poboljšanom podatkovnom modelu, tijek rada i logika dodatka moraju se refaktorirati i ponovno registrirati u odgovarajućoj tablici web-mjesta.
Na primjer, ako je korisnik registrirao tijek rada/dodatak u tablicu Primarni entitet kao web-stranica (logički naziv ) u standardnom podatkovnom modelu, tada se kôd unutar tijeka rada/dodatka mora izmijeniti u adx_webpage
tablicu komponenti web-mjesta (logički naziv ) i njezine atribute za poboljšani powerpagecomponent
podatkovni model.
Poznati problemi
Naredba za migraciju obrađuje samo seriju od 5 tisuća zapisa iz standardnog podatkovnog modela u poboljšani podatkovni model.