Standartinio ir patobulinto duomenų modelio perkėlimo apžvalga

Microsoft Power Platform CLI perkėlimo priemonė perkelia esamą Power Pages svetainės palaikomą konfigūraciją ir susijusius įrašus iš standartinio duomenų modelio į patobulintą duomenų modelį, tada perjungia svetainę, kad būtų naudojama perkelta konfigūracija.

Standartinis duomenų modelis saugo Power Pages svetainės konfigūraciją lentelėse, kuriose naudojamas adx_ prefiksas. Patobulintas duomenų modelis svetainės konfigūraciją saugo svetainės komponento lentelėje (powerpagecomponent) ir identifikuoja kiekvieną komponentą pagal komponento tipą. Suprasdami, kaip veikia perkėlimo paslaugų programa, kokius šablonus ji palaiko ir kurie tinkinimai nėra atnaujinamos automatiškai, padeda nuspręsti, kada ir kaip perkelti svetainę.

Peržiūrėjus patobulinto duomenų modelio pranašumus paaiškinama, kodėl galite apsvarstyti galimybę perkelti svetainę.

Svarbu atkreipti dėmesį, kad ne visos adx_* lentelės pereina į powerpagecomponent. Sujungiami powerpagecomponent tik metaduomenys adx_* lentelės – tie, kurie aprašo svetainės struktūrą ir kūrimo paviršių, pvzadx_webpage., , adx_webtemplate, , adx_contentsnippet, adx_sitesetting, adx_pagetemplate, adx_weblink, ir adx_entityformadx_entitylist – (kai jų vienos eilutės ypatybės perkeliamos į turinio JSON stulpelį).

Operacijų / vykdymo laiko adx_* lentelės – tos, kurios fiksuoja galutinio vartotojo veiklą vykdymo metu, pvz adx_invitation., , adx_inviteredemption, adx_portalcomment, ir adx_externalidentityobjekto formos / išplėstinės formos pateikimas ir žurnalo lentelės – neperkeliami į powerpagecomponent; jos lieka esamose schemose ir laiko vykdymo laiko duomenis kaip anksčiau. Kokie šių operacijų lentelių pakeitimai yra tie, kad jų metaduomenų įrašų peržvalgos iš naujo priverčiamos perkeliant nuorodas, kad jos nukreiptų į naujas powerpagecomponent eilutes, o ne senstelėjusius metaduomenis adx_* eilutes.

Esamos svetainės, kuriamos naudojant standartinį duomenų modelį, toliau veikia adx_* lentelėse, todėl kiekviena svetainė turi būti perkelta, kad būtų galima pasinaudoti patobulintu duomenų modeliu. Perkėlimas perkelia svetainės konfigūracijos metaduomenis į patobulinto duomenų modelio powerpagecomponent figūrą, iš naujo priverčia operacijų nuorodas į tuos naujus metaduomenų įrašus ir apverčia svetainės įrašą, kad jis būtų naudojamas patobulintame duomenų modelyje. Tai taip pat vieta, kurioje tinkinimai – pasirinktiniai adx_* stulpeliai, "Liquid", perskaitomi adx_* atributai, "FetchXML" per adx_* lenteles, priedus ir darbo eigas – yra suformatuoti ir iš naujo sutvarkyti, nes šie tinkinimai nėra automatiškai perkeliami ir juos reikia perrašyti arba pertvarkyti, kad būtų galima dirbti su patobulintu duomenų modeliu.

Būtinosios sąlygos

Microsoft Power Platform CLI2.11.2 arba naujesnę versiją, kuri paleidžia svetainės atsisiuntimo, perkėlimo, būsenos, aktyvinimo ir keitimų atšaukimo komandas. Daugiau informacijos žr. Naujausios "Power Platform" CLI diegimas.
"Dataverse" bazinio portalo paketas CDSBasePortal9.3.2607.x arba naujesnis, kuris suteikia reikiamus bazinio portalo komponentus.
Power Pages branduolio paketą PowerPages_Core1.0.2605.x arba naujesnį, kuris suteikia reikiamus Power Pages vykdymo laiko komponentus. Atnaujinkite Power Pages sprendimą.
Sistemos administratorius, Dynamics 365 administratorius arba "Power Platform" administratoriaus vaidmuo, būtinas norint perjungti arba grąžinti aktyvų duomenų modelį.
Susipažinkite su Power Pages "Power Platform" CLI.
Foninės operacijos įgalintos, jei aplinka veikia administravimo režimu.

Perkėlimo priemonės galimybės

Perkėlimo priemonė nukopijuoja palaikomą svetainės konfigūraciją ir susijusius įrašus į patobulintą duomenų modelį. Baigus perkėlimą, aktyvi svetainė persijungia į patobulintą duomenų modelį ir patikrinama prieš jai grįžtnt į įprastą naudojimą.

Perkėlimo paslaugų programa:

Generuoja tinkinimų, kuriuos gali reikėti keisti rankiniu būdu, ataskaitą.
Perkelia palaikomą svetainės konfigūraciją ir susijusius įrašus.
Leidžia patikrinti perkėlimo būseną prieš perjungiant aktyvų duomenų modelį.
Leidžia grąžinti svetainę į standartinį duomenų modelį, jei tikrinant nustatoma kritinė problema.

Svarbu

Perkėlimo paslaugų programa automatiškai neatnaujina kiekvieno tinkinimo, kuris tiesiogiai priklauso nuo standartinių duomenų modelio lentelių. Peržiūrėkite tinkinimo ataskaitą, pataisykite paveiktą pasirinktinį kodą ir prieš naudodami gamybą patikrinkite perkeltą svetainę.

Palaikomi šablonai

Galite perkelti esamas standartinio duomenų modelio svetaines, sukurtas iš šių šablonų:

1-5 darbo pradžios maketas
Programa apdorojama
Tuščias puslapis
Programos registracija
Planuoti ir tvarkyti susitikimus
DUK
Bendruomenės portalas (Dynamics 365)
Klientų Self-Service portalas (Dynamics 365)
Darbuotojų Self-Service portalas (Dynamics 365)
Partnerių portalas (Dynamics 365)

Pastaba.

Naujos svetainės su patobulintu duomenų modeliu ir esamų svetainių perkėlimas yra atskiros galimybės. Jei svetainės pradinis šablonas čia nenurodytas, ne paleiskite tos svetainės perkėlimo priemonę.

Prieš pradėdami

Papildomi planavimo aspektai:

Parametras Perjungti į patobulinto duomenų modelio aplinką valdo duomenų modelį, naudojamą naujose svetainėse. Įjungus šį parametrą, esamos svetainės neperkeliamos.
Pirmiausia vykdykite perkėlimą visos gamybos aplinkos kopijoje. Prieš pereidami užbaikite tinkinimo taisymą ir tikrinimą.
Naudokite standartinį organizacijos atsarginių kopijų kūrimo ir atkūrimo procesą, kad galėtumėte kurti atsargines gamybos aplinkos kopijas.
Suplanuokite galutinio gamybos keitimo ir tikrinimo priežiūros langą.
Įrašykite svetainės ID, portalo ID, aplinkos URL, CLI versiją, paketo versijas, perkėlimo pradžios laiką ir komandos išvesties formą kaip perkėlimo įrašo dalį.

Aplinkos sekos planavimas

Perkėlimas palaiko skirtingas aplinkas, naudojant skirtingą kiekvienos aplinkos režimą.

Aplinkos	Rekomenduojamas režimas	Ką darote
Kūrimas	`configurationData`	Perkelkite konfigūraciją, peržiūrėkite tinkinimo ataskaitą, išbandykite tinkinimus, patvirtinkite ir užfiksuokite konfigūraciją sprendime.
Testas arba UAT	`configurationDataReferences`	Importuokite išbandytą sprendimą iš kūrimo, perkelkite palaikomus susijusius įrašus, suaktyvinkite patobulintą duomenų modelį ir patikrinkite.
Gamyba	`configurationDataReferences`	Importuokite patikrintą valdomąjį sprendimą, perkelkite palaikomus susijusius įrašus, aktyvinkite techninės priežiūros lange ir užbaikite gamybos tikrinimą.
Viena aplinka arba paprasta svetainė	`all`	Konfigūracijos ir susijusių įrašų perkėlimas vienos operacijos metu tik tada, kai suprantate tinkinimo poveikį ir nenaudojate kelių aplinkos sprendimų kelio.

Darbinio aplanko kūrimas

Naudokite tuščią darbinį aplanką ataskaitoms, atsisiųstiems svetainės šaltiniams ir palyginimo failams laikyti. Toliau pateikti pavyzdžiai naudojami \<OUTPUT\> šioje vietoje.

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

Perkėlimo etapai

Perkėlimo procesą sudaro keturi etapai:

Išankstiniai tikrinimai – patikrinkite svetainės, ID, CLI, paketus, šablono sprendimą ir perkėlimo būseną.
Konfigūracija – konfigūracijos perkėlimas kuriant arba importuojant išbandyto konfigūravimo procesą vėlesnėse aplinkose.
Perkėlimas ir aktyvinimas – susijusių įrašų perkėlimas, užbaigimo patvirtinimas, modelių perjungimas ir paleidimas iš naujo.
Tikrinti – tikrinti veikimą, teises, pasirinktinį kodą ir šablonų ciklus.

1 etapas (svetainės aptikimas ir išankstiniai tikrinimai) ir 4 etapas (tikrinimas po perkėlimo) veikia taip pat kiekvienoje svetainėje.

2 etapas ir 3 etapas yra sekami šakomis – jų forma priklauso nuo perkėlimo režimo, kuris gaunamas iš aplinkos tipo.

Kūrimo sekimas (režimas configurationData arba all) naudojamas kūrėjų ir vienos aplinkos sąrankoms. Patys metaduomenys perkeliami vietoje, o tinkinimai nuskaitomi ir pataisomi standartinio duomenų modelio šaltinyje prieš perkeliant operacijų nuorodas.

Tolesnių versijų sekimas (režimasconfigurationDataReferences) naudojamas bandymo, UAT ir gamybos aplinkose, kuriose laikoma, kad konfigūracijos metaduomenys gauti naudojant ALM sprendimo importavimą iš "Dev". Šiame takeliuose perkeliamos tik operacijų nuorodos. Bet kokie tinkinimo rezultatai rodo srovę almo atotrūkį, o ne darbą, kurį turėtumėte atlikti vietoje.

1 etapas: išankstiniai tikrinimai

Patikrinkite savo "Power Platform" CLI versiją naudodami pac --version. Jei jūsų versija yra ankstesnė nei būtina versija, įdiekite arba atnaujinkite Microsoft Power Platform CLI prieš tęsdami.
Autentifikuoti paskirties aplinkoje.
1. Vykdyti pac auth list.
2. Vykdyti pac auth who.
Įsitikinkite, kad aktyvus autentifikavimo profilis nurodo aplinką, kurioje yra svetainė. Norėdami pasirinkti kitą profilį arba sukurti profilį, naudokite pac auth select arba pac auth create -u "https://contoso.crm.dynamics.com".
Įdiekite patobulinto duomenų modelio sprendimus savo šablonui vienu iš šių būdų:
1. Šablono svetainės parengimas naudojant administravimo centre įgalintą išplėstinio duomenų modelio (EDM) žymę.
2. Cli naudojimas norint įdiegti naudojant komandą pac application install --application-name "<template package name>"
Pastaba.

pac application install Jei nepavyksta įdiegti patobulinto duomenų modelio sprendimo, sukurkite laikiną svetainę naudodami tą patį šabloną Power Pages dizaino studijoje. Kuriant svetainę įdiegiami reikiami šablonų sprendimai. Instrukcijas žr. Power Pages svetainės kūrimas.
Raskite svetainę ir įrašykite jos identifikatorius naudodami pac pages list -v.

Įrašyti šioje lentelėje rodomas reikšmes.

Vertė	Naudojama
Svetainės ID	Visos `migrate-datamodel` komandos.
Portalo ID	Perjungiama į patobulintą duomenų modelį ir grąžinamas standartinis duomenų modelis.
Nesudėtingas pavadinimas ir URL	Patvirtindami, kad administravimo centre pasirinkote tinkamą svetainę.
Duomenų modelio versija	Turi būti Standartinis. Jei jau patobulinta, perkėlimas nebūtinas.

Svarbu

Portalo ID nėra Power Pages taikomosios programos ID. Jei CLI nerodomas portalo ID, jis pasiekiamas "Power Platform" administravimo centre dalyje Ištekliai>Power Pages svetainės>išsami informacija arba pridėti /_services/about prie svetainės URL prisijungus naudojant reikiamas svetainės prieigos teises.

Patikrinkite, ar yra ankstesnis arba vykdomas perkėlimas, naudodami šią komandą:

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

Būsena	Reikšmė	Veiksmas
NotStarted or no tracker	Perkėlimo nepradėta.	Tęskite paketo patikras.
Grąžinta	Ankstesnis perkėlimas atšauktas.	Peržiūrėkite, kodėl ji buvo grąžinta, tada tęskite, kai būsite pasirengę.
Baigta	Perkėlimas baigtas, bet svetainė gali būti neperjungta.	Patvirtinkite aktyvų duomenų modelį. Jei jis vis dar standartinis, tęskite aktyvinimą.
Vykdoma	Perkėlimas vis dar apdorojamas.	Tęsti būsenos tikrinimą. Nepradėti kito tos pačios svetainės perkėlimo.
Neišlaikyta	Perkėlimo metu įvyko klaida.	Surinkite komandos išvesties ir aplinkos informaciją, pataisykite priežastį ir bandykite dar kartą tik tada, kai suvoksite triktį.

Pastaba.

Jei perkėlimas vykdomas ilgiau nei tikėtasi, prieš kreipdamiesi į „Microsoft“ palaikymo tarnybą, jums reikia svetainės ID, aplinkos ID, CLI versijos, paketo versijų, komandų išvesties ir perkėlimo pradžios laiko. Aktyvaus perkėlimo negalima nustatyti iš naujo, nebent tai nurodo palaikymas arba patvirtintas vykdymo vadovas.

Patikrinkite reikiamus pirmosios šalies paketus naudodami pac solution list --includeSystemSolutions.
1. Įsitikinkite, kad CDSBasePortal, PowerPages_Coreir svetainės šablono EDM sprendimai įdiegti reikiamose versijose.
Jei paketo nėra arba jis pasenęs, atnaujinkite jį "Power Platform" administravimo centre:
1. Atidarykite tikslinę aplinką.
2. Eikite į Ištekliai>Dynamics 365 programėles.
3. Raskite reikiamą paketą.
4. Pasirinkite Diegti arba Naujinti versiją.
5. Palaukite, kol operacija bus baigta, tada vykdykite pac solution list --includeSystemSolutions dar kartą.
Pastaba.

Jei šablono EDM sprendimo negalima tiesiogiai įdiegti, sukūrus laikiną patobulinto duomenų modelio svetainę toje pačioje aplinkoje su tuo pačiu šablonu įdiegiamas atitinkamas EDM sprendimas. Kai sprendimas bus patvirtintas, laikiną svetainę galėsite panaikinti.
Generuoti tinkinimo ataskaitą naudojant pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Generuojant ataskaitą svetainė nesikeičia.

Atidarykite sugeneruotą CSV failą ir peržiūrėkite kiekvieną elementą, kuris nurodo standartines duomenų modelio lenteles. Priskirkite savininką ir tikrinimo veiksmą kiekvienam būtinam taisymui prieš atliekant gamybos perkėlimą.

Tinkinimo kategorija	Planas
Pasirinktiniai adx_ metaduomenų lentelių stulpeliai	Perkelkite pasirinktinius duomenis į palaikomą pasirinktinę lentelę, susijusią su powerpagecomponent.
Ryšiai su metaduomenų lentelių adx_	Iš naujo sukurkite ryšį su palaikoma patobulinto duomenų modelio lentele.
"Liquid" arba "FetchXML" nuorodos į adx_ lenteles	Atnaujinkite kodą, kad galėtumėte naudoti palaikomus "Liquid" objektus, virtualiąsias lenteles arba "powerpagecomponent".
Darbo eigos ir priedai adx_ lentelėse	Iš naujo įregistruokite logiką palaikomose išplėstinio duomenų modelio lentelėse.

Pastaba.

Tinkinimo ataskaita neįrodo, kad visas svetainės veikimas veikia po perkėlimo; vis dar reikia patvirtinti.

Pasirinkite perkėlimo režimą, kad nustatytumėte, ką paslaugų programa perkelia per vieną operaciją.

Režimas	Kas perkeliama	Kada naudoti
konfigūracijos duomenys	Palaikomi svetainės konfigūracijos metaduomenys, pvz., puslapiai, žiniatinklio šablonai, fragmentai, parametrai, formos, sąrašai, žiniatinklio vaidmenys ir lentelės teisės.	Kūrimas, kur galite pertvarkyti konfigūraciją ir perkelti ją per sprendimus.
configurationDataReferences	Palaikomi įrašai, nurodantys perkeltos svetainės konfigūraciją.	Bandymas, UAT ir gamyba, kai svetainės konfigūracija gaunama importuojant sprendimą.
visas	Konfigūracija ir palaikomi susiję įrašai.	Viena aplinka arba paprastas perkėlimas, kuris nenaudoja sprendimu pagrįstos aplinkos sekos.

2 etapas: svetainės konfigūracija

Kūrimo sekimas: kūrimas arba viena aplinka

Atsisiųskite SDM bazinį planą paleisdami pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Komanda sukuria antrinį aplanką, pavadintą svetainei. Įrašykite aplanką, kuriame yra website.ymltiesiogiai .
Perkelti svetainės konfigūraciją vykdant pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Jei norite vieno veiksmo kelio, pakeiskite į configurationDataall.
Patikrinkite perkėlimo būseną paleisdami pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Norėdami patikrinti būseną vieną kartą per minutę iki 30 minučių, naudokite šį "PowerShell" ciklą:
```
$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
}
```
Jei ciklas baigiasi, kol būsena vis dar vykdoma, tikrinimas tęsiamas --checkMigrationStatus. Ilgai trunkantis veiksmas nebūtinai yra nepavykusi operacija.
Iš naujo atlikite nurodytus tinkinimus naudodami tinkinimo ataskaitą ir šiame straipsnyje pateiktus nurodymus, kaip atnaujinti paveiktus "FetchXML", "Liquid", pasirinktinius stulpelius, ryšius, darbo eigas ir priedus. Iš naujo patikrinkite kiekvieną pakeistą komponentą. Jei atnaujinsite atsisiųstą šaltinį, nusiųskite svetainės aplanką, kuriame yra website.yml tiesiogiai, paleisdami pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.

Tolesnis bėgių kelias: bandymas, UAT arba gamyba

Importuoti sprendimą, kuriame yra perkelta ir iš naujo sutvarkyta svetainės konfigūracija. Naudokite "Power Platform" administravimo centrą arba sukurtą diegimo srautą.
```
pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true
```
Įsitikinkite, kad svetainės konfigūracija yra, paskirties aplinkoje atidarydami Power Pages valdymo taikomąją programą. Svetainės įrašas ir numatoma konfigūracija turi būti prieš perkeliant susijusius įrašus.

Perkelti palaikomus susijusius įrašus. Jei jau naudojote --mode all, praleiskite šį veiksmą. Tikrinti būseną, kol bus baigta ataskaita.

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

Kai perkėlimo būsena praneša apie sėkmingą užbaigimą, perjunkite aktyvią svetainę į patobulintą duomenų modelį. Standartinio duomenų modelio svetainės įrašas išjungiamas ir aktyvus atitinkamas išplėstinio duomenų modelio svetainės įrašas.
```
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
```
Paleisti svetainę iš naujo.
1. Atidarykite "Power Platform" administravimo centrą.
2. Eikite į aplinką, tada pasirinkite Ištekliai>Power Pages svetainės.
3. Pasirinkite svetainę.
4. Pasirinkite Paleisti iš naujo. Jei paleisti iš naujo negalima, išjunkite ir suaktyvinkite svetainę.
5. Palaukite, kol operacija bus baigta prieš tikrinimą.
Patvirtinkite aktyvų duomenų modelį vienu ar keliais iš šių būdų:
1. "Power Platform" administravimo centre pasirinkite svetainę ir įsitikinkite, kad duomenų modelyje rodoma Patobulinta.
2. Atidarykite svetainės sąrankos darbo sritį Power Pages dizaino studijoje ir patvirtinkite rodomą duomenų modelį.
3. Įsitikinkite, kad išplėstinė konfigūracija atidaroma Power Pages valdymo programėlėje.
4. Paleiskite pac pages list -v ir patvirtinkite duomenų modelio versiją.
Patarimas

Svetainės URL ir vaizdinis dizainas nesikeičia vien todėl, kad pakeistas aktyvus duomenų modelis. Norėdami patikrinti perkėlimą, naudokite šiuos tikrinimus, o ne svetainės išvaizdą.

4 etapas: perkeltos svetainės tikrinimas

Prieš iš naujo atidarydami gamybos svetainę vartotojams, užbaikite tikrinimą. Naudokite bandomąsias paskyras kiekvienam svarbiam vartotojo tipui ir žiniatinklio vaidmeniui ir įrašykite kiekvieno kritinio tikrinimo rezultatą.

Sritis	Ką tikrinti
Puslapiai ir turinys	Pagrindinis puslapis, atstovo turinio puslapiai, žiniatinklio šablonai, turinio fragmentai, žiniatinklio failai, naršymas, peradresavimai ir daugiakalbis turinys.
Autentifikavimas	Prisijungimas, atsijungimas, registracija, kvietimai, išoriniai tapatybės teikėjai ir prieigos atsisakymo funkcijos.
Autorizavimas	Žiniatinklio vaidmenys, lentelės teisės, stulpelio teisės ir puslapio prieigos taisyklės leidžia ir atmeta numatomus veiksmus.
Formos ir sąrašai	Pagrindinės formos, daugiastepės formos, sąrašai, formos metaduomenys, pateikimai, susiję įrašai ir žiniatinklio formų seansai, kuriuos naudoja svetainė.
Dynamics 365 šablonų ciklai	Pagrindiniai klientai, darbuotojai, bendruomenės ar partnerių veiklos ciklai, naudojami įgyvendinant, įskaitant konkretaus šablono puslapius ir prieigos modelius.
Pasirinktinis kodas	Liquid, FetchXML, JavaScript, plug-ins, workflows, and integrations identified in the customization report.
Svetainės parametrai ir failai	Svetainės parametrai, vaizdai, priedai, SVG failai ir kiti žiniatinklio failai įkeliami tinkamai.
Duomenys ir nuorodos	Svarbių įrašų skaičius ir palaikomi susiję įrašai nurodo teisingus perkeltus svetainės komponentus.
Administravimas ir ALM	Svetainė atidaroma naudojant Power Pages valdymo funkciją ir ją galima įtraukti į sprendimus, eksportuoti ir importuoti iš sprendimų, kaip numatyta.

Naršyklės diagnostikos tikrinimas

Atidarykite naršyklės kūrėjo įrankius tikrindami atstovo puslapius. Ištirti:

Konsolės klaidos, nurodančios adx\_objektus, "Liquid" arba "FetchXML".
HTTP 401 arba 403 atsakymai iš \_api, kurie gali nurodyti teisę arba žiniatinklio vaidmens problemą.
HTTP 500 atsakymai, galintys nurodyti "Liquid", "FetchXML", priedo arba integravimo triktį.

Perkėlimo baigimo kriterijai

Apsvarstykite, ar perkėlimas baigtas tik tada, kai svetainėje rodomas patobulintas duomenų modelis, kritiniai verslo veiklos ciklai, patvirtinamas numatomas saugos veikimas ir išspręstos arba priimamos visos didelio poveikio tinkinimo išvados.

Gamybos perkėlimo seka

Norėdami sumažinti perkėlimo riziką, naudokite šią gamybos seką:

Sukurkite visą repeticijai skirtos gamybos aplinkos kopiją.
Nukopijuotoje aplinkoje patvirtinkite CLI, paketo ir šablono sprendimo būtinąsias sąlygas.
Generuoti ir peržiūrėti tinkinimo ataskaitą.
Perkelti konfigūraciją nukopijuotoje kūrimo aplinkoje.
Iš naujo kurkite tinkinimus ir užfiksuokite patikrintą svetainės konfigūraciją valdomame sprendime.
Importuokite sprendimą į repeticijas, perkelkite palaikomus susijusius įrašus, suaktyvinkite patobulintą duomenų modelį ir užpildykite visą tikrinimo kontrolinį sąrašą.
Kartokite taisymą ir repeticijas, kol praeis visi kritiniai testai.
Planuoti gamybos priežiūros langą, pranešti tikrinimo ir keitimų atšaukimo sprendimo taškus bei kurti atsarginę gamybos kopiją.
Dar kartą patvirtinkite gamybos paketo ir šablono sprendimo būtinąsias sąlygas.
Importuokite patikrintą valdomą sprendimą į gamybą.
Paleiskite configurationDataReferences, patikrinkite perkėlimo būseną, perjunkite aktyvų duomenų modelį ir iš naujo paleiskite svetainę.
Paleiskite gamybos tikrinimo kontrolinį sąrašą ir grįžkite į įprastą svetainės naudojimą tik po kritinių bandymų atlikimo.

Perkeltos svetainės sugrąžinti į standartinį duomenų modelį

Jei patikrinus nustatoma kritinė problema po aktyvinimo, naudokite šią komandą, kad iš naujo suaktyvintumėte standartinio duomenų modelio svetainės įrašą:

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

Kai komanda baigiama:

Iš naujo paleiskite svetainę iš "Power Platform" administravimo centro.
Patvirtinkite, kad svetainėje kaip aktyvus duomenų modelis rodoma Standartinė .
Iš naujo paleiskite svetainės kritinius tikrinimo testus.
Prieš bandydami kitą perkėlimą, išsaugokite perkėlimo ataskaitą, klaidų išsamią informaciją ir taisymo pastabas.

Svarbu

Suplanuokite sprendimą atšaukti keitimus prieš gamybos perkėlimą. Peržiūrėkite keitimus, atliktus po patobulinto duomenų modelio perjungimo prieš atkuriant, nes standartiniai ir išplėstiniai svetainių įrašai yra atskiri įrašai.

Gedimų šalinimas

Pranešimas arba požymis	Tikėtina priežastis	Veiksmas
`pac powerpages migrate-datamodel` neatpažįstamas	Komanda naudoja netinkamą vardų sritį arba pasenusią CLI.	Atnaujinkite "Power Platform" CLI ir naudokite `pac pages migrate-datamodel`.
`CDSBasePortal` arba `PowerPages_Core` nėra sąraše	Sistemos sprendimai nebuvo įtraukti į komandų išvestį arba paketas neįdiegtas.	Vykdyti `pac solution list --includeSystemSolutions`. Įdiekite arba atnaujinkite trūkstamą paketą "Power Platform" administravimo centre.
Svetainė nepalaikoma perkėlimui	Pradinis šablonas nepalaikomas, nepakanka paketo versijų arba trūksta atitinkančio EDM šablono sprendimo.	Patvirtinti šablono tinkamumą, paketo versijas ir EDM sprendimą, pateiktą šablono sprendimo nuorodoje.
Perduotas nežinomas argumentas `--webSiteIdpac pages upload`	Nusiuntimo komanda nepriima svetainės ID argumento.	Praleisti argumentą. Svetainė identifikuojama iš `website.yml`.
Nusiuntimas nurodo netinkamą svetainę arba nepavyksta rasti svetainės	Kelias nukreipia į aplanko aplanką, o ne į svetainės aplanką.	Naudokite antrinį aplanką, kuriame tiesiogiai yra website.yml.
Portalo ID rodo `Unknown` arba `N/A`	Svetainė yra neaktyvi arba įdiegta CLI nepateikia reikšmės.	Gaukite portalo ID iš "Power Platform" `/_services/about` administravimo centro arba svetainės puslapio. Nenaudokite taikomosios programos ID.
Perkėlimo ataskaitos `Completed` , tačiau svetainė vis dar rodoma `Standard`	Nebuvo perjungtas aktyvus duomenų modelis arba buvo naudojamas netinkamas portalo ID.	Vykdykite aktyvinimo komandą su svetainės ID ir teisingu portalo ID, tada paleiskite iš naujo ir patikrinkite svetainę.
Būsena išlieka `Running`	Perkėlimas apdoroja didelį duomenų kiekį arba yra blokuojamas.	Tęsti būsenos tikrinimą. Prieš kreipdamiesi į palaikymo tarnybą, surinkite informaciją apie aplinką, paketą, CLI, pradžios laiką ir komandų informaciją. Nepradėti antrojo perkėlimo.
Būsena yra `Failed`	Paketo, šablono, tinkinimo, duomenų arba tarnybos klaida sustabdė operaciją.	Įrašykite visą komandų išvestį, pataisykite nustatytą priežastį ir bandykite dar kartą tik peržiūrėję nepavykusio perkėlimo būseną.
Svetainė atidaroma, bet vartotojai negali pasiekti numatytų duomenų	Žiniatinklio vaidmenys, lentelės teisės arba pasirinktinės užklausos po perkėlimo neveikia taip, kaip tikėtasi.	Peržiūrėkite žiniatinklio vaidmenis, lentelės teises, stulpelio teises, "FetchXML", "Liquid" ir naršyklės tinklo klaidas.

Svetainės tinkinimo aptarimas

Tinkinimo ataskaita identifikuoja tiesiogines priklausomybes nuo standartinių duomenų modelio lentelių. Prieš pradėdami naudoti gamybą, užbaikite reikiamą taisymą.

Pasirinktiniai metaduomenų lentelių stulpeliai

Jei standartinėje duomenų modelio lentelėje, pvz adx_webpage ., yra pasirinktinis stulpelis, sukurkite pasirinktinę lentelę pasirinktiniams duomenims saugoti ir įtraukite peržvalgą į powerpagecomponent. Perkelkite pasirinktines reikšmes į naują lentelę ir atnaujinkite kodą, kuris skaito arba rašo stulpelį.

Ryšiai tarp pasirinktinių lentelių ir metaduomenų lentelių

Iš naujo sukurkite pasirinktinius ryšius, nurodančius adx_ į lenteles, kad jie nukreiptų į atitinkamą patobulinto duomenų modelio lentelę, paprastai powerpagecomponent. Naujinti priklausomas formas, rodinius, priedus, srautus ir integravimus.

Skystos nuorodos į metaduomenų lenteles

Pakeisti tiesioginę entities['adx_*'] prieigą palaikomu "Liquid" objektu, kuriame toks yra. Pavyzdžiui, naudokite objektą weblinks Liquid, o ne tiesiogiai užklausas adx_weblinkset arba susijusias lenteles. Peržiūrėkite kiekvieną naudojimą, nes pateiktas objektas ir galimi atributai gali skirtis.

FetchXML nuorodos į metaduomenų lenteles

Pakeisti tiesiogines adx_ objekto nuorodas atitinkama virtualia lentele arba užklausa powerpagecomponent ir filtruoti pagal powerpagecomponenttype

Standartinio duomenų modelio pavyzdys:

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

Patobulinto duomenų modelio pavyzdys:

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

Pasirinktinės darbo eigos ir priedai

Iš naujo įtraukite pasirinktinę darbo eigą ir priedo logiką, užregistruotą adx_ lentelėse. Užregistruokite atnaujintą logiką atitinkamoje patobulinto duomenų modelio lentelėje ir naudokite patobulintą schemą bei atributus. Patikrinkite kūrimo, naujinimo, naikinimo ir saugos veikimą negamybinėje aplinkoje.

Komandos nuoroda

Paskirtis	Komanda
Patikrinkite CLI versiją	`pac --version`
Autentifikacijos profilių sąrašas	`pac auth list`
Autentifikavimo profilio kūrimas	`pac auth create -u "<ENV_URL>"`
Svetainių ir identifikatorių sąrašas	`pac pages list -v`
Sistemos sprendimų sąrašas	`pac solution list --includeSystemSolutions`
Perkėlimo būsenos tikrinimas	`pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus`
Atsisiųsti SDM šaltinį	`pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"`
Atsisiųsti EDM šaltinį	`pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"`
Generuoti tinkinimo ataskaitą	`pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"`
Perkelti konfigūraciją	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData`
Susijusių įrašų perkėlimas	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences`
Abiejų kategorijų perkėlimas	`pac pages migrate-datamodel --webSiteId "<ID>" --mode all`
Svetainės šaltinio nusiuntimas	`pac pages upload --path "<SITE_ROOT>" --modelVersion 1`
Aktyvinti EDM	`pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"`
Grįžti į SDM	`pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"`

Svetainės komponento tipo nuoroda

Kai pateikiate užklausą powerpagecomponent, naudokite šias reikšmes powerpagecomponenttype filtre.

Komponentas	Vertė	Komponentas	Vertė
Publikavimo būsena	1	Tinklalapis	2
Žiniatinklio failas	3	Žiniatinklio saitų rinkinys	4
Žiniatinklio saitas	5	Puslapio šablonas	6
Turinio fragmentas	7	Žiniatinklio šablonas	8
Svetainės parametras	9	Tinklalapio prieigos valdymo taisyklė	10
Žiniatinklio vaidmuo	11	Svetainės prieiga	12
Svetainės žymeklis	13	Paprastoji forma	15
Pagrindinės formos metaduomenys	16	Sąrašas	17
Lentelės teisė	18	Išplėstinė forma	19
Išplėstinės formos veiksmas	20	Išplėstinės formos metaduomenys	21
Apklausos vieta	24	Reklamos vieta	26
Roboto vartotojas	27	Stulpelio teisių profilis	28
Stulpelio teisė	29	Peradresavimas	30
Publikavimo būsenos perėjimo taisyklė	31	Nuoroda	32
Debesies srautas	33	UX komponentas	34

EDM šablono sprendimo nuoroda

Vykdykite, pac solution list --includeSystemSolutions kad patvirtintumėte, jog įdiegtas svetainės šablono patobulinto duomenų modelio sprendimas.

Šablonas	EDM sprendimo unikalus pavadinimas
1 pradinis maketas	DefaultPortalTemplate_V2
2 pradinis maketas	PowerPages_BlankDesign002_V2
3 pradinis maketas	PowerPages_BlankDesign003_V2
4 pradinis maketas	PowerPages_BlankDesign004_V2
5 pradinis maketas	PowerPages_BlankDesign005_V2
Tuščias puslapis	PowerPages_BlankTemplate_V2
DUK	PowerPages_FAQ_V2
Programa apdorojama	PowerPages_BuildingPermit_V2
Programos registracija	PowerPages_ProgramRegistration_V2
Planuoti ir tvarkyti susitikimus	PowerPages_BookMeeting_V2
Bendruomenės portalas (Dynamics 365)	PowerPages_CommunityPortal_V2
Klientų Self-Service portalas (Dynamics 365)	PowerPages_CustomerPortal_V2
Darbuotojų Self-Service portalas (Dynamics 365)	PowerPages_ESSPortal_V2
Partnerių portalas (Dynamics 365)	PowerPages_PartnerPortal_V2

Atsiliepimai

Ar šis puslapis buvo naudingas?

Paskutinį kartą atnaujinta 2026-10-02

Standartinio ir patobulinto duomenų modelio perkėlimo apžvalga

Būtinosios sąlygos

Perkėlimo priemonės galimybės

Palaikomi šablonai

Prieš pradėdami

Aplinkos sekos planavimas

Darbinio aplanko kūrimas

Perkėlimo etapai

1 etapas: išankstiniai tikrinimai

2 etapas: svetainės konfigūracija

Kūrimo sekimas: kūrimas arba viena aplinka

Tolesnis bėgių kelias: bandymas, UAT arba gamyba

3 etapas: susiję įrašai ir aktyvinimas

4 etapas: perkeltos svetainės tikrinimas

Naršyklės diagnostikos tikrinimas

Perkėlimo baigimo kriterijai

Gamybos perkėlimo seka

Perkeltos svetainės sugrąžinti į standartinį duomenų modelį

Gedimų šalinimas

Svetainės tinkinimo aptarimas

Pasirinktiniai metaduomenų lentelių stulpeliai

Ryšiai tarp pasirinktinių lentelių ir metaduomenų lentelių

Skystos nuorodos į metaduomenų lenteles

FetchXML nuorodos į metaduomenų lenteles

Pasirinktinės darbo eigos ir priedai

Komandos nuoroda

Svetainės komponento tipo nuoroda

EDM šablono sprendimo nuoroda

Susijęs turinys

Atsiliepimai

Papildomi ištekliai