Overzicht van migratie van Standard naar uitgebreid gegevensmodel

Het Microsoft Power Platform CLI-migratiehulpprogramma verplaatst de ondersteunde configuratie en gerelateerde records van een bestaande Power Pages-site van het standaardgegevensmodel naar het verbeterde gegevensmodel en schakelt vervolgens over naar de site om de gemigreerde configuratie te gebruiken.

In het standaardgegevensmodel wordt Power Pages siteconfiguratie opgeslagen in tabellen die gebruikmaken van het voorvoegsel adx_. Het verbeterde gegevensmodel slaat siteconfiguratie op in de tabel Siteonderdeel (powerpagecomponent) en identificeert elk onderdeel op basis van het onderdeeltype. Als u begrijpt hoe het migratiehulpprogramma werkt, welke sjablonen worden ondersteund en welke aanpassingen niet automatisch worden bijgewerkt, kunt u bepalen wanneer en hoe u een site verplaatst.

Als u de voordelen van het verbeterde gegevensmodel bekijkt, wordt uitgelegd waarom u een site kunt migreren.

Het is belangrijk te weten dat niet alle adx_* tabellen worden verplaatst naar powerpagecomponent. Alleen de metagegevens-tabellen adx_* — de tabellen die de structuur en de authoring-omgeving van de site beschrijven, zoals adx_pagetemplate, adx_weblink, adx_entityform, adx_entitylist, powerpagecomponent, adx_sitesetting, adx_contentsnippet en adx_webtemplate — worden samengevoegd in adx_webpage (waarbij hun eigenschappen per rij naar de JSON-inhoudskolom worden verplaatst).

De transactionele/runtime-adx_*-tabellen, de tabellen waarmee de activiteit van eindgebruikers tijdens runtime wordt vastgelegd, zoals adx_invitation, adx_inviteredemption, adx_portalcomment, , adx_externalidentityen de entiteitsformulieren / geavanceerde-formulierverzending en logboektabellen , worden niet gemigreerd naar powerpagecomponent; ze blijven in hun bestaande schema's staan en blijven runtimegegevens opslaan zoals voorheen. Wat er voor deze transactionele tabellen verandert, is dat hun zoekopdrachten naar metagegevensrecords opnieuw worden gekoppeld tijdens de migratie van verwijzingen, zodat ze verwijzen naar de nieuwe powerpagecomponent rijen in plaats van de verouderde metagegevens adx_* rijen.

Bestaande sites die zijn geschreven in het standaardgegevensmodel, blijven worden uitgevoerd op adx_*-tabellen, dus elke site moet worden gemigreerd om te profiteren van een verbeterd gegevensmodel. De migratie verplaatst de configuratiemetadata van de site naar de vorm van het verbeterde gegevensmodel powerpagecomponent, koppelt transactionele referenties opnieuw aan die nieuwe metadatarecords en zet vervolgens de siterecord om zodat deze vanuit het verbeterde gegevensmodel wordt bediend. Het is ook waar aanpassingen, aangepaste adx_* kolommen, Liquid die adx_* kenmerken leest, FetchXML over adx_* tabellen, invoegtoepassingen en werkstromen, worden weergegeven en hersteld, omdat deze aanpassingen niet automatisch worden overgedragen en moeten worden herschreven of opnieuw worden gestructureerd om te werken met een verbeterd gegevensmodel.

Vereiste voorwaarden

Mogelijkheden voor migratiehulpprogramma's

Het migratiehulpprogramma kopieert ondersteunde siteconfiguratie en gerelateerde records naar het verbeterde gegevensmodel. Nadat de migratie is voltooid, schakelt de actieve site over naar het verbeterde gegevensmodel en wordt gevalideerd voordat deze weer normaal wordt gebruikt.

Het migratiehulpprogramma:

  • Hiermee wordt een rapport gegenereerd met aanpassingen waarvoor mogelijk handmatige wijzigingen zijn vereist.
  • Hiermee worden ondersteunde siteconfiguratie en gerelateerde records gemigreerd.
  • Hiermee kunt u de migratiestatus controleren voordat u overschakelt naar het actieve gegevensmodel.
  • Hiermee kunt u de site terugzetten naar het standaardgegevensmodel als validatie een kritiek probleem identificeert.

Important

Het migratiehulpprogramma werkt niet automatisch elke aanpassing bij die rechtstreeks afhankelijk is van standaardgegevensmodeltabellen. Bekijk het aanpassingsrapport, corrigeer de betreffende aangepaste code en test de gemigreerde site voordat deze wordt gebruikt.

Ondersteunde sjablonen

U kunt bestaande standaardgegevensmodelsites migreren die zijn gemaakt op basis van de volgende sjablonen:

  • Starter-indeling 1-5
  • Toepassingsverwerking
  • Lege pagina
  • Programmaregistratie
  • Vergaderingen plannen en beheren
  • FAQ
  • Communityportal (Dynamics 365)
  • Klantzelfserviceportal (Dynamics 365)
  • Werknemersportal Self-Service (Dynamics 365)
  • Partnerportal (Dynamics 365)

Note

Het maken van nieuwe sites met het verbeterde gegevensmodel en het migreren van bestaande sites zijn afzonderlijke mogelijkheden. Als de oorspronkelijke sjabloon van een site hier niet wordt vermeld, voert u het migratiehulpprogramma voor die site niet uit.

Voordat u begint

Aanvullende planningsoverwegingen:

  • Met de instelling Overschakelen naar de verbeterde omgeving van het gegevensmodel bepaalt u het gegevensmodel dat wordt gebruikt voor nieuwe sites. Als u de instelling inschakelt, worden bestaande sites niet gemigreerd.
  • Voer de migratie eerst uit in een volledige kopie van de productieomgeving. Voltooi het herstel en de validatie van aanpassingen voordat u migreert.
  • Gebruik het standaard back-up- en herstelproces van uw organisatie om een back-up te maken van de productieomgeving.
  • Plan een onderhoudsvenster voor de uiteindelijke productieswitch en validatie.
  • Noteer de website-id, de portal-id, de omgevings-URL, de CLI-versie, de pakketversies, de begintijd van de migratie en het uitvoerformulier van de opdracht als onderdeel van de migratierecord.

De omgevingsvolgorde plannen

Migratie ondersteunt verschillende omgevingen, met een andere modus voor elke omgeving.

Milieu Aanbevolen modus Wat u doet
Ontwikkeling configurationData Migreer de configuratie, controleer het aanpassingsrapport, herstel aanpassingen, valideer en leg de configuratie vast in een oplossing.
Test of UAT configurationDataReferences Importeer de geteste oplossing uit ontwikkeling, migreer ondersteunde gerelateerde records, activeer het verbeterde gegevensmodel en valideer.
Productie configurationDataReferences Importeer de gevalideerde beheerde oplossing, migreer ondersteunde gerelateerde records, activeer tijdens het onderhoudsvenster en voltooi de productievalidatie.
Eén omgeving of eenvoudige site all Migreer configuratie- en gerelateerde records alleen in één bewerking wanneer u de impact van de aanpassing begrijpt en niet het pad naar de multi-omgevingsoplossing gebruikt.

Een werkmap maken

Gebruik een lege werkmap voor het opslaan van rapporten, gedownloade sitebron- en vergelijkingsbestanden. In de volgende voorbeelden wordt voor deze locatie gebruikgemaakt \<OUTPUT\> .

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

Migratiefasen

Het migratieproces bestaat uit vier fasen:

  1. Voorafgaande controles — controleer de site, ID's, CLI, pakketten, oplossingssjabloon en migratiestatus.
  2. Configuratie — Migreer configuratie in ontwikkelomgevingen of importeer geteste configuratie in downstreamomgevingen.
  3. Migreren en activeren : gerelateerde records migreren, voltooiing bevestigen, modellen wisselen en opnieuw opstarten.
  4. Valideren : testgedrag, machtigingen, aangepaste code en sjabloontrajecten.

Schermopname van een stroomdiagram met het standaardmigratieproces voor verbeterde gegevensmodellen.

Fase 1 (sitedetectie en controles vooraf) en fase 4 (validatie na migratie) worden voor elke site op dezelfde manier uitgevoerd.

Fase 2 en fase 3 zijn opgesplitst per track; hun vorm hangt af van de migratiemodus, die het track afleidt uit het omgevingstype.

De Authoring Track (modus configurationData of all) wordt gebruikt voor Dev- en configuraties met één omgeving. De metagegevens zelf worden lokaal gemigreerd en aanpassingen worden gescand en gecorrigeerd op basis van de standaardgegevensmodelbron voordat transactionele verwijzingen worden verplaatst.

De Downstream Track (modus configurationDataReferences) wordt gebruikt voor test-, UAT- en productieomgevingen, waarvan wordt aangenomen dat de configuratiemetadata via het importeren van een ALM-oplossing vanuit Dev is binnengekomen. Alleen transactiereferenties worden in dit track gemigreerd. Vaststellingen van maatwerk duiden op een hiaat in het stroomopwaartse ALM en niet op werk dat u lokaal moet uitvoeren.

Fase 1: Controles vooraf

  1. Controleer uw Power Platform CLI-versie met pac --version. Als uw versie ouder is dan de vereiste versie, installeert of werkt u de Microsoft Power Platform CLI bij voordat u doorgaat.

  2. Meld u aan bij de doelomgeving.

    1. Voer pac auth listuit.
    2. Voer pac auth whouit.
  3. Controleer of het actieve verificatieprofiel verwijst naar de omgeving die de site bevat. Als u een ander profiel wilt selecteren of een profiel wilt maken, gebruikt pac auth select of pac auth create -u "https://contoso.crm.dynamics.com".

  4. Installeer verbeterde gegevensmodeloplossingen voor uw sjabloon met behulp van een van de volgende methoden:

    1. Maak in het beheercentrum een site aan op basis van uw sjabloon met de vlag voor enhanced data model (EDM) ingeschakeld.
    2. De CLI gebruiken om te installeren met de opdracht pac application install --application-name "<template package name>"

    Note

    Als pac application install de verbeterde oplossing voor gegevensmodellen niet kan installeren, maakt u een tijdelijke site met dezelfde sjabloon in Power Pages-ontwerpstudio. Als u de site maakt, wordt de vereiste sjabloonoplossing geïnstalleerd. Zie Een Power Pages-site maken voor instructies.

  5. Zoek de site en noteer de id's met pac pages list -v.

  6. Noteer de waarden die worden weergegeven in de volgende tabel.

    Value Gebruikt voor
    Website-id Alle migrate-datamodel opdrachten.
    Portal-ID Overschakelen naar het verbeterde gegevensmodel en terugkeren naar het standaardgegevensmodel.
    Gebruiksvriendelijke naam en URL Bevestig dat u de juiste site hebt geselecteerd in het beheercentrum.
    Gegevensmodelversie Moet Standaard zijn. Als het al Enhanced is, is migratie niet nodig.

    Important

    De portal-id is niet de Power Pages app-id. Als de CLI de portal-id niet weergeeft, is deze beschikbaar in het Power Platform-beheercentrum onder Resources>Power Pages sitedetails> of voegt u de site-URL toe/_services/about terwijl u bent aangemeld met de vereiste machtigingen voor websitetoegang.

  7. Controleer met de volgende opdracht op een eerdere of actieve migratie:

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus
    
    Status Betekenis Action
    Niet gestart of geen tracker Er is geen migratie gestart. Ga door met de pakketcontroles.
    Teruggedraaid Een vorige migratie is teruggedraaid. Bekijk waarom het is teruggedraaid en ga door wanneer u klaar bent.
    Volbracht De migratie is voltooid, maar de site is mogelijk niet gewijzigd. Bevestig het actieve gegevensmodel. Als het nog steeds Standard is, gaat u verder met de activering.
    Hardlopen Migratie wordt nog steeds verwerkt. Ga door met het controleren van de status. Start geen andere migratie voor dezelfde site.
    Mislukt Er is een fout opgetreden tijdens de migratie. Verzamel de uitvoer- en omgevingsgegevens van de opdracht, corrigeer de oorzaak en probeer het pas opnieuw nadat de fout is begrepen.

    Note

    Als een migratie langer wordt uitgevoerd dan verwacht, hebt u de website-id, omgevings-id, CLI-versie, pakketversies, opdrachtuitvoer en begintijd voor migratie nodig voordat u contact op neemt met Microsoft ondersteuning. Een actieve migratie mag niet worden gereset, tenzij support of een goedgekeurd runbook daartoe opdracht geeft.

  8. Controleer de vereiste pakketten van derden met pac solution list --includeSystemSolutions.

    1. Controleer of CDSBasePortal, PowerPages_Coreen de EDM-oplossingen voor de sjabloon van de site zijn geïnstalleerd op de vereiste versies.
  9. Als een pakket ontbreekt of verouderd is, werkt u het bij vanuit het Power Platform-beheercentrum:

    1. Open de doelomgeving.
    2. Ga naar Resources>Dynamics 365 apps.
    3. Zoek het vereiste pakket.
    4. Selecteer Installeren of upgraden.
    5. Wacht tot de bewerking is voltooid en voer vervolgens opnieuw uit pac solution list --includeSystemSolutions .

    Note

    Als de sjabloon EDM-oplossing niet beschikbaar is voor directe installatie, wordt de overeenkomende EDM-oplossing geïnstalleerd wanneer u een tijdelijke verbeterde gegevensmodelsite maakt in dezelfde omgeving met dezelfde sjabloon. U kunt de tijdelijke site verwijderen nadat de oplossing is bevestigd.

  10. Genereer het aanpassingsrapport met pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Als u het rapport genereert, wordt de site niet gewijzigd.

  11. Open het gegenereerde CSV-bestand en controleer elk item dat verwijst naar standaardgegevensmodeltabellen. Wijs een eigenaar en validatiestap toe voor elk vereist herstel vóór de productiemigratie.

    Aanpassingscategorie Plan
    Aangepaste kolommen in adx_ metagegevenstabellen Verplaats de aangepaste gegevens naar een ondersteunde aangepaste tabel met betrekking tot powerpagecomponent.
    Relaties met adx_ metagegevenstabellen Maak de relatie opnieuw op basis van de ondersteunde tabel met verbeterde gegevensmodellen.
    Liquid- of FetchXML-verwijzingen naar adx_ tabellen Werk code bij voor het gebruik van ondersteunde Liquid-objecten, virtuele tabellen of powerpagecomponent.
    Werkstromen en invoegtoepassingen op adx_-tabellen Herstructureer en registreer de logica voor ondersteunde verbeterde gegevensmodeltabellen.

    Note

    Een aanpassingsrapport bewijst niet dat alle sitegedrag na de migratie werkt; validatie is nog steeds vereist.

  12. Kies de migratiemodus om te bepalen wat het hulpprogramma in één bewerking migreert.

    Mode Wat er wordt gemigreerd Wanneer te gebruiken
    configuratiegegevens Ondersteunde metagegevens van siteconfiguratie, zoals pagina's, websjablonen, fragmenten, instellingen, formulieren, lijsten, webrollen en tabelmachtigingen. Ontwikkeling, waar u de configuratie corrigeert en deze via oplossingen verplaatst.
    configurationDataReferences Ondersteunde records die verwijzen naar de gemigreerde siteconfiguratie. Testen, UAT en productie nadat de siteconfiguratie is binnengekomen via een oplossingsimport.
    all Zowel configuratie als ondersteunde gerelateerde records. Eén omgeving of een eenvoudige migratie die niet gebruikmaakt van de omgevingsreeks op basis van de oplossing.

Fase 2: Siteconfiguratie

Creatietrack: ontwikkeling of één omgeving

  1. Download een SDM-basislijn door pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm" uit te voeren. Met de opdracht maakt u een onderliggende map met de naam van de site. Noteer de map die rechtstreeks bevat website.yml.

  2. Siteconfiguratie migreren door uit te voeren pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Als u het pad met één bewerking wilt gebruiken, vervangt u configurationData door all.

  3. Controleer de migratiestatus door uit te voeren pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Gebruik de volgende PowerShell-lus om de status één keer per minuut gedurende maximaal 30 minuten te controleren:

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

    Als de lus eindigt terwijl de status nog steeds Running is, wordt de controle voortgezet met --checkMigrationStatus. Een langdurige bewerking is niet noodzakelijkerwijs een mislukte bewerking.

  4. Herstel gerapporteerde aanpassingen met behulp van het aanpassingsrapport en de richtlijnen in dit artikel om betrokken FetchXML, Liquid, aangepaste kolommen, relaties, werkstromen en invoegtoepassingen bij te werken. Test elk gewijzigd onderdeel opnieuw. Als u de gedownloade bronbestanden bijwerkt, upload dan de sitemap site die rechtstreeks website.yml bevat door pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1 uit te voeren.

Stroomafwaartse track: test, UAT of productie

  1. Importeer de oplossing die de gemigreerde en herstelde siteconfiguratie bevat. Gebruik het Power Platform-beheercentrum of de bestaande implementatiepijplijn.

    pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true
    
  2. Controleer of de siteconfiguratie aanwezig is door de Power Pages Beheer-app in de doelomgeving te openen. De siterecord en de verwachte configuratie moeten aanwezig zijn voordat gerelateerde records worden gemigreerd.

  1. Ondersteunde gekoppelde records migreren. Als u --mode all al hebt gebruikt, sla deze stap dan over. Controleer de status totdat deze Voltooid weergeeft.

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences
    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus
    
  2. Zodra de migratiestatus is voltooid, schakelt u de actieve site over naar het verbeterde gegevensmodel. De standaardgegevensmodelwebsiterecord wordt gedeactiveerd en de bijbehorende verbeterde gegevensmodelwebsiterecord wordt actief.

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
    
  3. Start de site opnieuw.

    1. Power Platform-beheercentrum openen.
    2. Ga naar de omgeving en selecteer resources>Power Pages sites.
    3. Selecteer de site.
    4. Selecteer Opnieuw starten. Als opnieuw opstarten niet beschikbaar is, moet u de site deactiveren en vervolgens activeren.
    5. Wacht tot de bewerking is voltooid voordat de validatie is voltooid.
  4. Bevestig het actieve gegevensmodel met behulp van een of meer van deze methoden:

    1. Selecteer in het Power Platform-beheercentrum de site en bevestig dat het gegevensmodelUitgebreid wordt weergegeven.
    2. Open de werkruimte Setup van de site in Power Pages ontwerpstudio en bevestig het weergegeven gegevensmodel.
    3. Controleer of de geavanceerde configuratie wordt geopend in de Power Pages Beheer-app.
    4. Voer pac pages list -v uit en bevestig de datamodelversie.

    Tip

    De site-URL en het visuele ontwerp veranderen niet alleen omdat het actieve gegevensmodel is gewijzigd. Als u de migratie wilt controleren, gebruikt u deze controles, niet het uiterlijk van de site.

Fase 4: De gemigreerde site valideren

Voltooi de validatie voordat u een productiesite opnieuw opent voor gebruikers. Gebruik testaccounts voor elk belangrijk gebruikerstype en elke webrol en noteer het resultaat van elke kritieke test.

Gebied Wat moet ik valideren?
Pagina's en inhoud Startpagina, representatieve inhoudspagina's, websjablonen, inhoudsfragmenten, webbestanden, navigatie, omleidingen en meertalige inhoud.
Authentication Aanmelden, afmelden, registratie, uitnodigingen, externe id-providers en ervaringen met geweigerde toegang.
Authorization Webrollen, tabelmachtigingen, kolommachtigingen en regels voor paginatoegang staan de verwachte acties toe en weigeren.
Formulieren en lijsten Basisformulieren, formulieren met meerdere fasen, lijsten, formuliermetagegevens, inzendingen, gerelateerde records en webformuliersessies die door de site worden gebruikt.
Dynamics 365-sjabloonreizen De belangrijkste klant-, werknemer-, community- of partnertrajecten die door uw implementatie worden gebruikt, inclusief sjabloonspecifieke pagina's en toegangspatronen.
Aangepaste code Liquid, FetchXML, JavaScript, invoegtoepassingen, werkstromen en integraties die zijn geïdentificeerd in het aanpassingsrapport.
Site-instellingen en -bestanden Site-instellingen, afbeeldingen, bijlagen, SVG-bestanden en andere webbestanden worden correct geladen.
Gegevens en verwijzingen Belangrijke recordaantallen en ondersteunde gerelateerde records verwijzen naar de juiste gemigreerde siteonderdelen.
Administratie en ALM De site wordt geopend in Power Pages Beheer en kan worden toegevoegd aan, geëxporteerd en geïmporteerd uit oplossingen zoals verwacht.

Browserdiagnose controleren

Open hulpprogramma's voor browserontwikkelaars tijdens het testen van representatieve pagina's. Onderzoeken:

  • Consolefouten met vermelding adx\_, entiteiten, Liquid of FetchXML.
  • HTTP 401- of 403-antwoorden van \_api, waarmee een machtigings- of webrolprobleem kan worden aangegeven.
  • HTTP 500-reacties, die kunnen duiden op een Liquid-, FetchXML-, plug-in- of integratiefout.

Criteria voor voltooiing van migratie

Beschouw de migratie pas als voltooid wanneer de site het verbeterde gegevensmodel toont, kritieke bedrijfsprocessen succesvol worden doorlopen, het verwachte beveiligingsgedrag is bevestigd en elke bevinding met betrekking tot aanpassingen met grote impact is opgelost of geaccepteerd.

Productiemigratiereeks

Gebruik de volgende productiereeks om het migratierisico te verminderen:

  1. Maak een volledige kopie van de productieomgeving om te oefenen.
  2. Controleer de vereisten voor de CLI, het pakket en de oplossingssjabloon in de gekopieerde omgeving.
  3. Genereer en controleer het aanpassingsrapport.
  4. Configuratie migreren in de gekopieerde ontwikkelomgeving.
  5. Herstel aanpassingen en leg de gevalideerde siteconfiguratie vast in een beheerde oplossing.
  6. Importeer de oplossing in de oefenomgeving, migreer ondersteunde gerelateerde records, activeer het verbeterde gegevensmodel en voltooi de volledige validatiecontrolelijst.
  7. Herhaal het herstel en de repetitie totdat alle kritieke tests zijn geslaagd.
  8. Plan het onderhoudsvenster voor productie, communiceer de beslissingspunten voor validatie en terugdraaien en maak een back-up van de productie.
  9. Bevestig opnieuw de vereisten voor het productiepakket en de sjabloonoplossing.
  10. Importeer de gevalideerde beheerde oplossing in productie.
  11. Voer configurationDataReferences uit, controleer de migratiestatus, schakel over naar het actieve gegevensmodel en start de site opnieuw op.
  12. Voer de controlelijst voor productievalidatie uit en retourneer de site alleen voor normaal gebruik nadat kritieke tests zijn geslaagd.

Een gemigreerde site terugzetten naar het standaardgegevensmodel

Als tijdens de validatie een kritiek probleem wordt geïdentificeerd na de activering, gebruikt u de volgende opdracht om de standaardgegevensmodelwebsiterecord opnieuw te activeren:

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

Nadat de opdracht is voltooid:

  1. Start de site opnieuw vanuit het Power Platform-beheercentrum.
  2. Controleer of op de site Standard wordt weergegeven als het actieve gegevensmodel.
  3. Voer de kritieke validatietests van de site opnieuw uit.
  4. Bewaar het migratierapport, foutdetails en herstelnotities voordat u een andere migratie uitvoert.

Important

Plan de beslissing voor terugdraaien vóór de productiemigratie. Controleer de wijzigingen die zijn aangebracht na de schakeloptie voor het verbeterde gegevensmodel voordat u teruggaat, omdat de standaard- en verbeterde websiterecords afzonderlijke records zijn.

Troubleshooting

Bericht of symptoom Waarschijnlijke oorzaak Action
pac powerpages migrate-datamodel wordt niet herkend De opdracht maakt gebruik van de verkeerde naamruimte of een verouderde CLI. Power Platform CLI bijwerken en gebruiken pac pages migrate-datamodel.
CDSBasePortal of PowerPages_Core wordt niet weergegeven Systeemoplossingen zijn niet opgenomen in de opdrachtuitvoer of het pakket is niet geïnstalleerd. Voer pac solution list --includeSystemSolutionsuit. Installeer of upgrade het ontbrekende pakket vanuit het Power Platform-beheercentrum.
Website wordt niet ondersteund voor migratie De oorspronkelijke sjabloon wordt niet ondersteund, pakketversies zijn onvoldoende of de overeenkomende EDM-sjabloonoplossing ontbreekt. Bevestig de geschiktheid van sjablonen, pakketversies en de EDM-oplossing die wordt vermeld in de sjabloonoplossingsreferentie.
Er is een onbekend argument --webSiteId doorgegeven voor pac pages upload De uploadopdracht accepteert het argument website-id niet. Laat het argument weg. De site wordt geïdentificeerd van website.yml.
Upload is gericht op de verkeerde site of kan de site niet vinden Het pad wijst naar de wrappermap in plaats van naar de sitemap. Gebruik de onderliggende map die rechtstreeks website.yml bevat.
Portal-ID toont Unknown of N/A De site is inactief of de geïnstalleerde CLI retourneert de waarde niet. Haal de portal-ID op uit het Power Platform-beheercentrum of van de /_services/about-pagina van de site. Gebruik de app-id niet.
De migratie meldt Completed, maar de site toont nog steeds Standard Het actieve gegevensmodel is niet gewijzigd of de verkeerde portal-id is gebruikt. Voer de activeringsopdracht uit met de website-id en de juiste portal-id, start de site opnieuw op en controleer de site.
Status blijft behouden Running De migratie verwerkt een grote hoeveelheid gegevens of wordt geblokkeerd. Ga door met het controleren van de status. Verzamel de omgeving, het pakket, de CLI, de begintijd en de opdrachtdetails voordat u contact op neemt met de ondersteuning. Start geen tweede migratie.
Status is Failed De bewerking is gestopt door een pakket, sjabloon, aanpassing, gegevens of servicefout. Sla de volledige uitvoer van de opdracht op, corrigeer de geïdentificeerde oorzaak en probeer het pas opnieuw nadat u de status van de mislukte migratie hebt bekeken.
De site wordt geopend, maar gebruikers hebben geen toegang tot verwachte gegevens Webrollen, tabelmachtigingen of aangepaste query's gedragen zich niet zoals verwacht na de migratie. Controleer webrollen, tabelmachtigingen, kolommachtigingen, FetchXML-, Liquid- en browsernetwerkfouten.

Overweging voor siteaanpassingen

Het aanpassingsrapport identificeert directe afhankelijkheden van standaardgegevensmodeltabellen. Voer de vereiste herstelmaatregelen uit vóór gebruik in productie.

Aangepaste kolommen in metagegevenstabellen

Als een standaardgegevensmodeltabel zoals adx_webpage een aangepaste kolom bevat, maakt u een aangepaste tabel om de aangepaste gegevens op te slaan en voegt u een opzoekactie toe aan powerpagecomponent. Migreer de aangepaste waarden naar de nieuwe tabel en werk code bij die de kolom leest of schrijft.

Relaties tussen aangepaste tabellen en metagegevenstabellen

Maak aangepaste relaties die verwijzen naar adx_-tabellen opnieuw, zodat ze verwijzen naar de juiste verbeterde gegevensmodeltabel, meestal powerpagecomponent. Afhankelijke formulieren, weergaven, invoegtoepassingen, stromen en integraties bijwerken.

Liquide verwijzingen naar metagegevenstabellen

Vervang directe entities['adx_*'] toegang door een ondersteund Liquid-object waar er een bestaat. Gebruik bijvoorbeeld het weblinks Liquid-object in plaats van rechtstreeks query's uit te voeren op adx_weblinkset of gerelateerde tabellen. Controleer elk gebruik omdat het geretourneerde object en de beschikbare kenmerken kunnen verschillen.

FetchXML-verwijzingen naar metagegevenstabellen

adx_ Directe entiteitsverwijzingen vervangen door de bijbehorende virtuele tabel of query powerpagecomponent en filteren op powerpagecomponenttype

Voorbeeld van standaardgegevensmodel:

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

Voorbeeld van uitgebreid gegevensmodel:

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

Aangepaste werkstromen en invoegtoepassingen

Aangepaste werkstroom en invoegtoepassingslogica herstructureren die zijn geregistreerd in adx_ tabellen. Registreer de bijgewerkte logica in de juiste tabel met verbeterde gegevensmodellen en gebruik het verbeterde schema en de kenmerken. Test het gedrag rond aanmaken, bijwerken, verwijderen en beveiliging in een niet-productieomgeving.

Opdrachtenoverzicht

Purpose Command
CLI-versie controleren pac --version
Verificatieprofielen weergeven pac auth list
Een verificatieprofiel maken pac auth create -u "<ENV_URL>"
Sites en id's weergeven pac pages list -v
Systeemoplossingen vermelden pac solution list --includeSystemSolutions
Migratiestatus controleren pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus
SDM-bron downloaden pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"
EDM-bron downloaden pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"
Aanpassingsrapport genereren pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"
Configuratie migreren pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData
Gerelateerde records migreren pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences
Beide categorieën migreren pac pages migrate-datamodel --webSiteId "<ID>" --mode all
Sitebron uploaden pac pages upload --path "<SITE_ROOT>" --modelVersion 1
EDM activeren pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
Terugkeren naar SDM pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Naslaginformatie over het type siteonderdeel

Wanneer u een query uitvoert powerpagecomponent, gebruikt u de volgende waarden in het filter powerpagecomponenttype .

Component Value Component Value
Publicatiestatus 1 Webpagina 2
Webbestand 3 Webkoppelingsset 4
Webkoppeling 5 Paginasjabloon 6
Inhoudsfragment 7 Websjabloon 8
Siteinstelling 9 Toegangsbeheerregel voor webpagina's 10
Webrol 11 Websitetoegang 12
Sitemarkering 13 Basisformulier 15
Metagegevens van basisformulier 16 Lijst 17
Tabelmachtiging 18 Geavanceerd formulier 19
Geavanceerde formulierstap 20 Metagegevens van geavanceerd formulier 21
Plaatsing van peiling 24 Plaatsing van advertentie 26
Botgebruiker 27 Profiel voor kolomtoestemming 28
Kolomtoestemming 29 Redirect 30
Overgangsregel voor publicatiestatussen 31 Shortcut 32
Cloudstroom 33 UX-onderdeel 34

Oplossingsreferentie voor EDM-sjabloon

Voer pac solution list --includeSystemSolutions deze opdracht uit om te controleren of de verbeterde gegevensmodeloplossing voor de sjabloon van de site is geïnstalleerd.

Template Unieke naam voor EDM-oplossing
Starterindeling 1 DefaultPortalTemplate_V2
Startindeling 2 PowerPages_BlankDesign002_V2
Startindeling 3 PowerPages_BlankDesign003_V2
Startindeling 4 PowerPages_BlankDesign004_V2
Startindeling 5 PowerPages_BlankDesign005_V2
Lege pagina PowerPages_BlankTemplate_V2
FAQ PowerPages_FAQ_V2
Toepassingsverwerking PowerPages_BuildingPermit_V2
Programmaregistratie PowerPages_ProgramRegistration_V2
Vergaderingen plannen en beheren PowerPages_BookMeeting_V2
Communityportal (Dynamics 365) PowerPages_CommunityPortal_V2
Klantzelfserviceportal (Dynamics 365) PowerPages_CustomerPortal_V2
Werknemersportal Self-Service (Dynamics 365) PowerPages_ESSPortal_V2
Partnerportal (Dynamics 365) PowerPages_PartnerPortal_V2