Standardne täiustatud andmemudelite migreerimise ülevaatele

Microsoft Power Platform CLI migreerimisutiliit teisaldab olemasoleva Power Pages saidi toetatud konfiguratsiooni ja seotud kirjed standardsest andmemudelist täiustatud andmemudelisse ja seejärel aktiveerib saidi migreeritud konfiguratsiooni kasutamiseks.

Standardandmemudel talletab Power Pages saidikonfiguratsiooni tabelites, mis kasutavad eesliidet adx_. Täiustatud andmemudel talletab saidikonfiguratsiooni tabelis Saidikomponent (powerpagecomponent) ja tuvastab iga komponendi komponenditüübi järgi. Migreerimisutiliidi tööpõhimõtted, toetatud mallid ja kohandused, mida migreerimisutiliit automaatselt ei värskenda, aitavad teil otsustada, millal ja kuidas saiti teisaldada.

Täiustatud andmemudeli eeliste läbivaatamisel selgitatakse, miks võiksite saidi migreerimist kaaluda.

Oluline on meeles pidada, et kõik adx_* tabelid ei liigu powerpagecomponenti. Ainult metaandmed adx_* tabelid – need, mis kirjeldavad saidi struktuuri ja loomepinda (nt adx_webpage, , adx_pagetemplateadx_contentsnippetadx_webtemplateadx_weblinkadx_entityformadx_sitesettingja adx_entitylist ) ühendatakse powerpagecomponent (reakohased atribuudid teisaldatakse JSON-i sisuveergu).

Tehingu/ käitusaja adx_* tabeleid – neid, mis jäädvustavad käitusajal lõppkasutaja tegevust (nt adx_invitation, adx_inviteredemption, adx_portalcomment, adx_externalidentityja olemivormi / täpsema vormi edastus- ja logitabelid), ei migreerita powerpagecomponent; need jäävad olemasolevatele skeemidele ja säilitavad käitusajaandmed nagu varem. Tehingutabelite muudatused on see, et nende metaandmete kirjete otsingud nipsatakse viidete migreerimise ajal uuesti, nii et need osutavad uutele powerpagecomponent ridadele, mitte pärand-metaandmete adx_* ridadele.

Standardsel andmemudelil põhinevad olemasolevad saidid töötavad jätkuvalt adx_* tabelites, seega tuleb iga sait migreerida, et saaksite kasutada täiustatud andmemudelit. Migreerimine teisaldab saidi konfiguratsiooni metaandmed täiustatud andmemudelikujundisse powerpagecomponent , viib tehinguviited nendesse uutesse metaandmete kirjetesse ja pöörab saidikirje ümber, et seda saaks kasutada täiustatud andmemudelist. Seal on ka kohandused – kohandatud adx_* veerud, Vedelik, mis loeb ette adx_* atribuudid, FetchXML üle adx_* tabelite, lisandmoodulite ja töövoogude, pinnatakse ja parandatakse, kuna need kohandused ei kanna automaatselt üle ja need tuleb täiustatud andmemudeliga töötamiseks ümber kirjutada või ümber korraldada.

Eeltingimused

  • Microsoft Power Platform CLIversioon 2.11.2 või uuem versioon, mis käivitab saidi allalaadimise, migreerimise, oleku, aktiveerimise ja tagasipööramise käsud. Lisateavet leiate teemast Uusima Power PlatformI CLI installimine.
  • Dataverse base portal package CDSBasePortal9.3.2607.x või uuem versioon, mis pakub nõutavaid portaali põhikomponente.
  • Power Pages Core'i pakett PowerPages_Core1.0.2605.x või uuem, mis sisaldab nõutavaid Power Pages käitusaja komponente. Värskendage Power Pages lahendust.
  • Süsteemiadministraator, Dynamics 365 administraator või Power Platformi administraatori roll, mida on vaja aktiivse andmemudeli vahetamiseks või ennistamiseks.
  • Power Platform CLI-ga Power Pages tutvustus.
  • Taustatoimingud on lubatud, kui keskkond on administreerimisrežiimis.

Migreerimisutiliidi võimalused

Migreerimisutiliit kopeerib toetatud saidikonfiguratsiooni ja seotud kirjed täiustatud andmemudelisse. Pärast migreerimise lõpule viimist lülitub aktiivne sait täiustatud andmemudelile ja see valideeritakse enne tavakasutuse naasmist.

Migreerimisutiliit:

  • Genereerib kohanduste aruande, mis võib vajada käsitsi muutmist.
  • Migreerib toetatud saidikonfiguratsiooni ja seotud kirjed.
  • Saate enne aktiivse andmemudeli vahetamist kontrollida migreerimise olekut.
  • Võimaldab lähtestada saidi standardse andmemudeli, kui valideerimine tuvastab kriitilise probleemi.

Oluline

Migreerimisutiliit ei värskenda automaatselt kõiki kohandusi, mis sõltuvad otse standardsetest andmemudeli tabelitest. Vaadake kohandusaruanne läbi, parandage mõjutatud kohandatud kood ja testige migreeritud saiti enne tootmiskasutust.

Toetatud mallid

Saate migreerida olemasolevad standardsed andmemudelisaidid, mis on loodud järgmiste mallide põhjal.

  • Algpaigutus 1-5
  • Rakenduse töötlemine
  • Tühi leht
  • Programmi registreerimine
  • Koosolekute kavandamine ja haldamine
  • KKK
  • Kogukonnafoorumi portaal (Dynamics 365)
  • Kliendi Self-Service portaal (Dynamics 365)
  • Töötaja Self-Service portaal (Dynamics 365)
  • Partneriportaal (Dynamics 365)

Märkus.

Täiustatud andmemudeliga uute saitide loomine ja olemasolevate saitide migreerimine on omaette võimalused. Kui saidi algset malli pole siin loetletud, ärge käivitage selle saidi migreerimisutiliiti.

Enne alustamist

Täiendavad kavandamisega seotud kaalutlused.

  • Täiustatud andmemudeli keskkonnasätte aktiveerimine reguleerib uute saitide jaoks kasutatavat andmemudelit. Sätte sisselülitamisel ei migreerita olemasolevaid saite.
  • Käivitage migreerimine esmalt tootmiskeskkonna täielikus koopias. Enne migreerimist viige kohanduste parandused ja valideerimine lõpule.
  • Töökeskkonna varundamiseks ja taastamiseks saate kasutada oma ettevõtte standardset varundus- ja taasteprotsessi.
  • Saate plaanida lõpliku tootmislüliti ja valideerimise hooldusakna.
  • Migreerimiskirje osana saate salvestada veebisaidi ID, portaali ID, keskkonna URL-i, CLI versiooni, paketiversioonid, migreerimise algusaja ja käsuväljundi vormi.

Keskkonnajada kavandamine

Migreerimine toetab erinevaid keskkondi, millel on iga keskkonna jaoks erinev režiim.

Keskkond Soovitatav režiim Mida te teete?
Arendus configurationData Migreerige konfiguratsioon, vaadake kohandusaruanne läbi, kohandage kohandused, valideerige ja jäädvustage konfiguratsioon lahenduses.
Test või UAT configurationDataReferences Importige testitud lahendus arendusest, migreerige toetatud seotud kirjed, aktiveerige täiustatud andmemudel ja valideerige.
Tootmine configurationDataReferences Importige valideeritud hallatav lahendus, migreerige toetatud seotud kirjed, aktiveerige hooldusaknas ja viige lõpule tootmise valideerimine.
Üksikkeskkond või lihtne sait all Migreerige ühe toiminguga konfiguratsioon ja seotud kirjed ainult siis, kui mõistate kohandamise mõju ega kasuta multikeskkonna lahenduse teed.

Töökausta loomine

Aruandeid, allalaaditud saidiallikaid ja võrdlusfaile saate hoida tühjas töökaustas. Selle asukoha puhul kasutatakse \<OUTPUT\> järgmisi näiteid.

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

Migreerimise etapid

Migreerimisprotsess koosneb neljast etapist.

  1. Eelkontrollid – kontrollige saiti, ID-sid, CLI-t, pakette, mallilahendust ja migreerimise olekut.
  2. Konfiguratsioon – migreerige konfiguratsioon arenduses või importige testitud konfiguratsioon allvoolu keskkondades.
  3. Migreerimine ja aktiveerimine – seotud kirjete migreerimine, lõpuleviimise kinnitamine, mudelite vahetamine ja taaskäivitamine.
  4. Valideerimine – testi käitumine, õigused, kohandatud kood ja malliteekonnad.

Täiustatud andmemudeli migreerimisprotsessi standardit näitava vooskeemi kuvatõmmis.

1. etapp (saidi tuvastamine ja eelkontrollid) ja 4. etapp (migreerimisejärgne valideerimine) töötavad iga saidi puhul samamoodi.

2. ja 3. etapp on rada hargnevad – nende kuju sõltub migreerimisrežiimist, mis tuletab rööbastee keskkonnatüübist.

Loometee (režiim configurationData või all) kasutatakse arendus- ja ühekeskkonnaliste häälestuste jaoks. Metaandmed migreeritakse kohalikult ning kohandused kontrollitakse ja parandatakse enne tehinguviidete teisaldamist standardse andmeallika suhtes.

Allavoolu rada (režiim configurationDataReferences) kasutatakse testimis-, UAT- ja tootmiskeskkondades, kus eeldatakse, et konfiguratsiooni metaandmed on saabunud ALM-i lahenduse impordi kaudu devist. Sellel palal migreeritakse ainult tehinguviited. Kõik kohandusleiud viitavad ALM-i ülesvoolu vahele, mitte tööle, mida peaksite tegema kohalikult.

Etapp 1: eelkontrollid

  1. Kinnitage oma Power PlatformI CLI versioon i abil pac --version. Kui teie versioon on nõutavast versioonist varasem, installige või värskendage enne jätkamist Microsoft Power Platform CLI.

  2. Saate autentida sihtkeskkonnas.

    1. Käivitage pac auth list.
    2. Käivitage pac auth who.

  3. Veenduge, et aktiivne autentimisprofiil osutaks saiti sisaldavale keskkonnale. Mõne muu profiili valimiseks või profiili loomiseks kasutage või pac auth selectpac auth create -u "https://contoso.crm.dynamics.com".

  4. Installige oma malli jaoks täiustatud andmemudeli lahendused, kasutades ühte järgmistest meetoditest.

    1. Saate oma malli saidi ette valmistada, kui täiustatud andmemudeli (EDM) lipp on halduskeskuses lubatud.
    2. Käsuga installimiseks kasutage CLI-t pac application install --application-name "PowerPages_PartnerPortal_V2"

  5. Otsige sait üles ja salvestage selle identifikaatorid i abil pac pages list -v.

  6. Salvestage järgmises tabelis kuvatavad väärtused.

    Väärtus Kasutatakse
    Veebisaidi ID Kõik migrate-datamodel käsud.
    Portaali ID Täiustatud andmemudeli aktiveerimine ja standardandmemudeli ennistamine.
    Sõbralik nimi ja URL Kinnitades, et valisite halduskeskuses õige saidi.
    Andmemudeli versioon Peab olema Standardne. Kui see on juba täiustatud, pole migreerimine nõutav.

    Oluline

    Portaali ID pole Power Pages rakenduse ID. Kui CLI ei kuva portaali ID-d, on see saadaval Power Platformi halduskeskuse jaotises Ressursid>Power Pages saitide>üksikasjad või lisage /_services/about saidi URL-i, kui olete sisse logitud nõutavate veebisaidi juurdepääsuõigustega.

  7. Otsige eelmist või pooleliolevat migreerimist järgmise käsuga:

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus
    Olek Tähendus Toiming
    Jälgurita või käivitamata Migreerimist pole alustatud. Jätkake paketikontrollidega.
    Ennistatud Eelmine migreerimine on tagasi pööratud. Vaadake üle, miks see ennistutati, ja jätkake siis, kui see on valmis.
    Lõpetatud Migreerimine on lõpule viidud, kuid sait ei pruugi olla aktiveeritud. Kinnitage aktiivne andmemudel. Kui see on endiselt Standardne, jätkake aktiveerimist.
    Töötab Migreerimine on alles töötluses. Jätka oleku kontrollimist. Ärge käivitage sama saidi jaoks muud migreerimist.
    Läbi kukkunud Migreerimisel ilmnes tõrge. Koguge kokku käsuväljundi ja keskkonna üksikasjad, parandage põhjus ja proovige uuesti alles pärast nurjumise mõistmist.

    Märkus.

    Kui migreerimine töötab oodatust kauem, vajate enne Microsoft toe poole pöördumist veebisaidi ID, keskkonna ID, CLI versiooni, paketiversioonide, käsuväljundi ja migreerimise algusaega. Aktiivset migreerimist ei tohiks lähtestada, kui tugiteenust või kinnitatud käitusraamatut ei juhendata.

  8. Kinnitage nõutavad esimese osapoole paketid i abil pac solution list --includeSystemSolutions.

    1. Veenduge, et CDSBasePortalPowerPages_Core, ja saidimalli EDM-i lahendused oleksid installitud nõutavasse versiooni.

  9. Kui pakett puudub või on aegunud, värskendage seda Power Platformi halduskeskuse kaudu.

    1. Avage sihtkeskkond.
    2. Avage Jaotis Ressursid>Dynamics 365 rakendused.
    3. Leidke nõutav pakett.
    4. Valige Installi või Täienda.
    5. Oodake, kuni toiming on lõpule viia, ja seejärel käivitage pac solution list --includeSystemSolutions uuesti.

    Märkus.

    Kui malli EDM-i lahendus pole otseinstallimiseks saadaval, installib sama malliga samas keskkonnas ajutise täiustatud andmemudelisaidi loomine vastava EDM-i lahenduse. Ajutise saidi saate kustutada pärast lahenduse kinnitamist.

  10. Saate luua kohandusaruande i abil pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Aruande genereerimine ei muuda saiti.

  11. Avage loodud CSV-fail ja vaadake läbi kõik üksused, mis viitavad standardsetele andmemudeli tabelitele. Määrake enne tootmise migreerimist iga nõutava paranduse jaoks omanik ja valideerimise etapp.

    Kohandamiskategooria Plaan
    Kohandatud veerud adx_ metaandmete tabelites Teisaldage kohandatud andmed powerpage'i komponendiga seotud toetatud kohandatud tabelisse.
    Adx_ metaandmete tabelite seosed Looge seos toetatud täiustatud andmemudeli tabeliga uuesti.
    Liquid or FetchXML references to adx_ tables Värskendage koodi, et kasutada toetatud vedelobjekte, virtuaaltabeleid või powerpage'i komponente.
    Töövood ja lisandmoodulid adx_ tabelites Refactor and register the logic against supported enhanced data model tables.

    Märkus.

    Kohandamisaruanne ei tõesta, et kogu saidi käitumine töötab pärast migreerimist; valideerimine on endiselt nõutav.

  12. Valige migreerimisrežiim, et teha kindlaks, mida utiliit ühe toiminguga migreerib.

    Režiim Mida see migreerib? Eesmärk
    configurationData Toetatud saidikonfiguratsiooni metaandmed (nt lehed, veebimallid, lõiked, sätted, vormid, loendid, veebirollid ja tabeliõigused). Arendus, kus saate konfiguratsiooni heastada ja lahendused läbi viia.
    configurationDataReferences Toetatud kirjed, mis viitavad migreeritud saidikonfiguratsioonile. Testimine, UAT ja tootmine pärast saidi konfigureerimist lahenduse importimise kaudu.
    kõik Nii konfiguratsioon kui ka toetatud seotud kirjed. Üks keskkond või lihtne migreerimine, mis ei kasuta lahendusepõhist keskkonnajada.

Etapp 2: saidi konfigureerimine

Autorlusrada: arendus või üks keskkond

  1. SDM-alusjoone allalaadimiseks käivitage .pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm" Käsuga luuakse saidi jaoks tütarkaust. Salvestage kaust, mis sisaldab website.ymlotse kausta .

  2. Saidikonfiguratsiooni migreerimiseks käivitage .pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData Kui soovite ühekordset teed, asendage configurationData see vorminguga all.

  3. Migreerimise oleku kontrollimiseks käivitage .pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus Kasutage järgmist PowerShelli tsüklit, et kontrollida olekut üks kord minutis kuni 30 minutit:

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

    Kui tsükkel lõpeb oleku töötamise ajal, jätkub kontroll tsükliga --checkMigrationStatus. Pikaajaline toiming ei pruugi olla nurjunud toiming.

  4. Teatatud kohanduste lahendamiseks saate kasutada kohandusaruannet ja selles artiklis toodud juhiseid, et värskendada mõjutatud fetchXML-i, vedelat, kohandatud veergu, seoseid, töövooge ja lisandmooduleid. Saate muudetud komponente uuesti testida. Kui värskendate allalaaditud allikat, laadige üles saidikaust, mis otse sisaldabwebsite.yml, käivitades .pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1

Alletapi rada: testimine, UAT või tootmine

  1. Importige lahendus, mis sisaldab migreeritud ja parandatud saidikonfiguratsiooni. Kasutage Power Platformi halduskeskust või oma loodud juurutus konveierid.

    pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true

  2. Veendumaks, et saidi konfiguratsioon on olemas, avage Power Pages haldusrakendus sihtkeskkonnas. Enne seostuvate kirjete migreerimist peab saidikirje ja eeldatav konfiguratsioon olema olemas.

  1. Toetatud seostuvate kirjete migreerimine. Kui te juba kasutasite --mode all, jätke see toiming vahele. Kontrolli olekut, kuni see teatab Lõpule viidud.

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

  2. Kui migreerimise olek on edukalt lõpule viidud, aktiveerige aktiivne sait täiustatud andmemudelile. Standardne andmemudeli veebisaidikirje inaktiveeritakse ja vastav täiustatud andmemudeli veebisaidi kirje muutub aktiivseks.

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

  3. Taaskäivitage sait.

    1. Ava Power Platform halduskeskus.
    2. Avage keskkond ja seejärel valige Ressursid>Power Pages saidid.
    3. Valige sait.
    4. Valige Taaskäivita. Kui taaskäivitamine pole saadaval, inaktiveerige sait ja seejärel aktiveerige sait.
    5. Enne valideerimist oodake, kuni toiming lõpeb.

  4. Kinnitage aktiivne andmemudel, kasutades ühte või mitut järgmistest meetoditest.

    1. Valige Power Platformi halduskeskuses sait ja veenduge, et andmemudelis oleks kuvatud täiustatud vorm.
    2. Avage saidi installitööruum Power Pages kujundusstuudios ja kinnitage kuvatud andmemudel.
    3. Veenduge, et Power Pages haldusrakenduses avatakse täpsem konfiguratsioon.
    4. Käivitage pac pages list -v ja kinnitage andmemudeli versioon.

    Jootraha

    Saidi URL ja visuaalne kujundus ei muutu ainult seetõttu, et aktiivset andmemudelit on muudetud. Migreerimise kontrollimiseks kasutage neid kontrolle, mitte saidi ilmet.

4. etapp: migreeritud saidi valideerimine

Enne tootmissaidi uuesti avamist kasutajatele kinnitamine lõpule viia. Kasutage iga olulise kasutajatüübi ja veebirolli jaoks testkontosid ning salvestage iga kriitilise testi tulemus.

Valdkond Mida valideerida?
Lehed ja sisu Avaleht, esinduslikud sisulehed, veebimallid, sisulõiked, veebifailid, navigeerimine, ümbersuunamised ja mitmekeelne sisu.
Autentimine Sisselogimine, väljalogimine, registreerimine, kutsed, välised identiteedipakkujad ja juurdepääsu keelamise funktsioonid.
Autoriseerimine Veebirollid, tabeliõigused, veeruõigused ja lehepääsureeglid lubavad ja keelavad eeldatud toimingud.
Vormid ja loendid Saidi kasutatavad põhivormid, mitmekordsed vormid, loendid, vormi metaandmed, edastused, seotud kirjed ja veebivormiseansid.
Dynamics 365 malliteekonnad Peamine klient, töötaja, kogukond või partneri reisid, mida teie juurutamine kasutab (sh mallikohased lehed ja juurdepääsumustrid).
Kohandatud kood Kohandamisaruandes määratletud vedelikud, FetchXML, JavaScript, lisandmoodulid, töövood ja integratsioonid.
Saidi sätted ja failid Saidisätted, pildid, manused, SVG-failid ja muud veebifailid laaditakse õigesti.
Andmed ja viited Olulised kirjete arv ja toetatud seotud kirjed osutavad õigetele migreeritud saidikomponentidele.
Haldus ja ALM Sait avatakse Power Pages halduse aknas ning seda saab lisada, eksportida ja lahendustest importida ootuspäraselt.

Brauseri diagnostika kontrollimine

Avage esinduslehtede testimisel brauseri arendusriistad. Uurige:

  • Konsoolitõrked, mis mainivad adx\_, olemeid, Vedelat või FetchXML-i.
  • HTTP 401 või 403 vastused ilt \_api, mis võivad viidata õiguste või veebirolli probleemile.
  • HTTP 500 vastused, mis võivad viidata vedeliku, FetchXML-i, lisandmooduli või integreerimise nurjumisele.

Migreerimise lõpuleviimise kriteeriumid

Võtke arvesse, et migreerimine on lõpule viidud ainult siis, kui saidil kuvatakse täiustatud andmemudel, kriitilise tähtsusega äriteekonnad läbivad, oodatav turbekäitumine kinnitatakse ja kõik suure mõjuga kohanduste leidmised on lahendatud või aktsepteeritud.

Tootmise migreerimise järjestus

Kasutage migreerimisriski vähendamiseks järgmist tootmisjärjestust:

  1. Saate luua harjutamiseks tootmiskeskkonnast täieliku koopia.
  2. Kinnitage kopeeritud keskkonnas CLI, paketi ja mallilahenduse eeltingimused.
  3. Kohandamisaruande loomine ja läbivaatamine.
  4. Migreerige konfiguratsioon kopeeritud arenduskeskkonnas.
  5. Kohandage kohandused ja jäädvustage hallatavas lahenduses valideeritud saidikonfiguratsioon.
  6. Importige lahendus harjutuskeskkonda, migreerige toetatud seotud kirjed, aktiveerige täiustatud andmemudel ja täitke täielik valideerimise kontroll-loend.
  7. Korrake parandust ja harjutamist, kuni kõik kriitilised testid läbivad.
  8. Saate ajastada tootmishoolduse akna, edastada valideerimis- ja tagasipööramisotsuse punktid ning varundada tootmise.
  9. Kinnitage uuesti tootmispaketi ja mallilahenduse eeltingimused.
  10. Importige valideeritud hallatav lahendus tootmisse.
  11. Käivitage configurationDataReferences, kontrollige migreerimise olekut, aktiveerige aktiivne andmemudel ja taaskäivitage sait.
  12. Käivitage tootmise valideerimise kontroll-loend ja tagastage sait tavakasutuseks alles pärast kriitiliste testide läbimist.

Migreeritud saidi ennistatakse standardandmemudel

Kui valideerimine tuvastab pärast aktiveerimist kriitilise probleemi, kasutage standardse andmemudeli veebisaidi kirje uuesti aktiveerimiseks järgmist käsku:

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

Kui käsk on valmis, tehke järgmist.

  1. Taaskäivitage sait Power Platformi halduskeskuse kaudu.
  2. Veenduge, et saidi aktiivse andmemudelina kuvataks standardne .
  3. Käivitage saidi kriitilised valideerimistestid uuesti.
  4. Enne uue migreerimise proovimist säilitage migreerimisaruanne, tõrke üksikasjad ja parandusmärkmed.

Oluline

Enne tootmise migreerimist plaanige tagasipööramise otsus. Enne ennistamist vaadake üle pärast täiustatud andmemudeli lülitit tehtud muudatused, kuna standardsed ja täiustatud veebisaidikirjed on eraldi kirjed.

Tõrkeotsing

Sõnum või sümptom Tõenäoline põhjus Toiming
pac powerpages migrate-datamodel pole tuvastatav Käsk kasutab vale nimeruumi või aegunud CLI-t. Power PlatformI CLI värskendamine ja kasutamine pac pages migrate-datamodel.
CDSBasePortal või PowerPages_Core pole loendis Süsteemilahendusi ei kaasatud käsuväljundisse või paketti pole installitud. Käivitage pac solution list --includeSystemSolutions. Installige või täiendage puuduv pakett Power Platformi halduskeskuse kaudu.
Veebisaiti ei toetata migreerimisel Algset malli ei toetata, paketiversioonid pole piisavad või puudub vastav EDM-malli lahendus. Kinnitage malli nõuetele vastavus, paketi versioonid ja mallilahenduse viites loetletud EDM-lahendus.
Edastati tundmatu argument --webSiteIdpac pages upload Üleslaadimiskäsk ei aktsepteeri veebisaidi ID-argumenti. Jätta argument välja. Sait tuvastatakse asukohas website.yml.
Üleslaadimine sihib vale saiti või ei leia saiti Tee osutab saidikausta asemel ümbrise kaustale. Kasutage tütarkausta, mis sisaldab otse website.yml.
Portaali ID kuvatakse Unknown või N/A Sait on passiivne või installitud CLI ei tagasta väärtust. Hankige portaali ID Power Platformi halduskeskusest või saidi lehelt /_services/about . Ärge kasutage rakenduse ID-d.
Migreerimisaruanded Completed , kuid sait kuvatakse endiselt Standard Aktiivset andmemudelit ei vahetatud või kasutati vale portaali ID-d. Käivitage aktiveerimiskäsk koos veebisaidi ID-ga ja parandage portaali ID, seejärel taaskäivitage sait ja kinnitage sait.
Olek jääb alles Running Migreerimine töötleb suurt hulka andmeid või on blokeeritud. Jätka oleku kontrollimist. Enne kasutajatoe poole pöördumist koguge keskkonda, paketti, CLI-t, algusaega ja käsuteavet. Ärge alustage teist migreerimist.
Olek on Failed Pakett, mall, kohandamine, andmed või teenusetõrge peatas toimingu. Salvestage täielik käsuväljund, parandage tuvastatud põhjus ja proovige alles pärast nurjunud migreerimisoleku läbivaatamist uuesti.
Sait avaneb, kuid kasutajad ei pääse oodatud andmetele juurde Veebirollid, tabeliõigused ega kohandatud päringud ei toimi pärast migreerimist ootuspäraselt. Vaadake üle veebirollid, tabeliõigused, veeruõigused, FetchXML, Liquid ja brauseri võrgutõrked.

Saidikohandustega arvestamine

Kohandamisaruanne tuvastab otsesed sõltuvused standardandmemudeli tabelitest. Enne tootmise kasutamist viige vajalik parandus lõpule.

Kohandatud veerud metaandmete tabelites

Kui standardandmemudeli tabel (nt adx_webpage sisaldab kohandatud veergu), looge kohandatud tabel kohandatud andmete talletamiseks ja otsingu powerpagecomponentlisamiseks kohta . Migreerige kohandatud väärtused uude tabelisse ja värskendage koodi, mis loeb või kirjutab veeru.

Kohandatud tabelite ja metaandmete tabelite vahelised seosed

Looge uuesti tabelitele adx_ osutavad kohandatud seosed nii, et need osutaksid asjakohasele täiustatud andmemudeli tabelile (tavaliselt powerpagecomponent). Värskendada sõltuvad vormid, vaated, lisandmoodulid, vood ja integratsioonid.

Vedelikuviited metaandmete tabelitele

Asendage otsepääs entities['adx_*'] toetatud vedelobjektiga, kus see on olemas. Kasutage näiteks objekti Liquid, weblinks mitte otsepäringuid adx_weblinkset või seotud tabeleid. Vaadake iga kasutus läbi, kuna tagastatud objekt ja saadaolevad atribuudid võivad erineda.

Too XML-viited metaandmete tabelitele

Otseolemiviidete adx_ asendamine vastava virtuaaltabeli või -päringuga powerpagecomponent ja filtreerimisalus powerpagecomponenttype

Standardandmemudeli näide:

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

Täiustatud andmemudeli näide:

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

Kohandatud töövood ja lisandmoodulid

Refactor – tabelites adx_ registreeritud kohandatud töövoog ja lisandmooduli loogika. Registreerige värskendatud loogika sobivas täiustatud andmemudeli tabelis ja kasutage täiustatud skeemi ja atribuute. Testida loomis-, värskendamis-, kustutamis- ja turbekäitumist mittetulunduslikus keskkonnas.

Käsuviide

Otstarve Käsk
Kontrolli CLI versiooni pac --version
Loendi autentimisprofiilid pac auth list
Autentimisprofiili loomine pac auth create -u "<ENV_URL>"
Saitide ja identifikaatorite loetlemine pac pages list -v
Süsteemilahenduste loetlemine pac solution list --includeSystemSolutions
Migreerimise oleku kontrollimine pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus
SDM-allika allalaadimine pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"
Laadi EDM-allikas alla pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"
Kohandamisaruande loomine pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"
Konfiguratsiooni migreerimine pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData
Seostuvate kirjete migreerimine pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences
Mõlema kategooria migreerimine pac pages migrate-datamodel --webSiteId "<ID>" --mode all
Saidiallika üleslaadimine pac pages upload --path "<SITE_ROOT>" --modelVersion 1
Aktiveeri EDM pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
Ennistage SDM-iks pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Saidikomponendi tüübi viide

Päringu powerpagecomponentesitamisel kasutage powerpagecomponenttype-filtris järgmisi väärtusi.

Komponent Väärtus Komponent Väärtus
Avaldamisolek 1 Veebileht 2
Veebifail 3 Veebilinkide kogum 4
Veebilink 5 Lehemall 6
Sisulõigend 7 Veebimall 8
Saidi säte 9 Veebilehe juurdepääsukontrolli reegel 10
Veebiroll 11 Veebisaidi juurdepääs 12
Saidimarker 13 Põhivorm sept.
Põhivormi metaandmed 16 Loend 17
Tabeli õigus 18 Täpsem vorm 19
Täpsema vormi etapp 20 Täpsema vormi metaandmed 21
Küsitluse paigutus 24 Reklaami paigutus 26
Roboti kasutaja 27 Veeruõiguse profiil 28
Veeruõigus 29 Suuna ümber 30
Avaldamisoleku üleminekureegel 31 Otsetee 32
Pilvevoog 33 Kasutajaliidese komponent 34

EDM-malli lahenduse viide

Käivitage pac solution list --includeSystemSolutions kinnitamaks, et saidimalli täiustatud andmemudeli lahendus on installitud.

Mall EDM-i lahenduse kordumatu nimi
Paigutus Starter 1 DefaultPortalTemplate_V2
Paigutus Starter 2 PowerPages_BlankDesign002_V2
Paigutus Starter 3 PowerPages_BlankDesign003_V2
Paigutus Starter 4 PowerPages_BlankDesign004_V2
Paigutus Starter 5 PowerPages_BlankDesign005_V2
Tühi leht PowerPages_BlankTemplate_V2
KKK PowerPages_FAQ_V2
Rakenduse töötlemine PowerPages_BuildingPermit_V2
Programmi registreerimine PowerPages_ProgramRegistration_V2
Koosolekute kavandamine ja haldamine PowerPages_BookMeeting_V2
Kogukonnafoorumi portaal (Dynamics 365) PowerPages_CommunityPortal_V2
Kliendi Self-Service portaal (Dynamics 365) PowerPages_CustomerPortal_V2
Töötaja Self-Service portaal (Dynamics 365) PowerPages_ESSPortal_V2
Partneriportaal (Dynamics 365) PowerPages_PartnerPortal_V2

Seotud sisu

  • Last updated on