Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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
- Microsoft Power Platform CLIversie 2.11.2 of hoger, waarop de opdrachten voor het downloaden, migreren, status, activeren en terugdraaien van de site worden uitgevoerd. Zie De nieuwste Versie van Power Platform CLI installeren voor meer informatie.
- Dataverse-basisportalpakket
CDSBasePortal9.3.2607.x of hoger, dat de vereiste basisportalonderdelen biedt. - Power Pages Core-pakket
PowerPages_Core1.0.2605.x of hoger, dat de vereiste Power Pages runtime-onderdelen biedt. Werk de Power Pages-oplossing bij. - De rol Systeembeheerder, Dynamics 365 Administrator of Power Platform-beheerder, die vereist is om het actieve gegevensmodel over te schakelen of terug te zetten.
- Bekendheid met Power Platform CLI voor Power Pages.
- Achtergrondbewerkingen ingeschakeld als de omgeving zich in de beheermodus bevindt.
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:
- Voorafgaande controles — controleer de site, ID's, CLI, pakketten, oplossingssjabloon en migratiestatus.
- Configuratie — Migreer configuratie in ontwikkelomgevingen of importeer geteste configuratie in downstreamomgevingen.
- Migreren en activeren : gerelateerde records migreren, voltooiing bevestigen, modellen wisselen en opnieuw opstarten.
- Valideren : testgedrag, machtigingen, aangepaste code en sjabloontrajecten.
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
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.Meld u aan bij de doelomgeving.
- Voer
pac auth listuit. - Voer
pac auth whouit.
- Voer
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 selectofpac auth create -u "https://contoso.crm.dynamics.com".Installeer verbeterde gegevensmodeloplossingen voor uw sjabloon met behulp van een van de volgende methoden:
- Maak in het beheercentrum een site aan op basis van uw sjabloon met de vlag voor enhanced data model (EDM) ingeschakeld.
- De CLI gebruiken om te installeren met de opdracht
pac application install --application-name "<template package name>"
Note
Als
pac application installde 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.Zoek de site en noteer de id's met
pac pages list -v.Noteer de waarden die worden weergegeven in de volgende tabel.
Value Gebruikt voor Website-id Alle migrate-datamodelopdrachten.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/aboutterwijl u bent aangemeld met de vereiste machtigingen voor websitetoegang.Controleer met de volgende opdracht op een eerdere of actieve migratie:
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatusStatus 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.
Controleer de vereiste pakketten van derden met
pac solution list --includeSystemSolutions.- Controleer of
CDSBasePortal,PowerPages_Coreen de EDM-oplossingen voor de sjabloon van de site zijn geïnstalleerd op de vereiste versies.
- Controleer of
Als een pakket ontbreekt of verouderd is, werkt u het bij vanuit het Power Platform-beheercentrum:
- Open de doelomgeving.
- Ga naar Resources>Dynamics 365 apps.
- Zoek het vereiste pakket.
- Selecteer Installeren of upgraden.
- 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.
Genereer het aanpassingsrapport met
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Als u het rapport genereert, wordt de site niet gewijzigd.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.
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
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 bevatwebsite.yml.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 uconfigurationDatadoorall.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.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.ymlbevat doorpac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1uit te voeren.
Stroomafwaartse track: test, UAT of productie
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 trueControleer 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.
Fase 3: Gerelateerde records en activering
Ondersteunde gekoppelde records migreren. Als u
--mode allal 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>" --checkMigrationStatusZodra 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>"Start de site opnieuw.
- Power Platform-beheercentrum openen.
- Ga naar de omgeving en selecteer resources>Power Pages sites.
- Selecteer de site.
- Selecteer Opnieuw starten. Als opnieuw opstarten niet beschikbaar is, moet u de site deactiveren en vervolgens activeren.
- Wacht tot de bewerking is voltooid voordat de validatie is voltooid.
Bevestig het actieve gegevensmodel met behulp van een of meer van deze methoden:
- Selecteer in het Power Platform-beheercentrum de site en bevestig dat het gegevensmodelUitgebreid wordt weergegeven.
- Open de werkruimte Setup van de site in Power Pages ontwerpstudio en bevestig het weergegeven gegevensmodel.
- Controleer of de geavanceerde configuratie wordt geopend in de Power Pages Beheer-app.
- Voer
pac pages list -vuit 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:
- Maak een volledige kopie van de productieomgeving om te oefenen.
- Controleer de vereisten voor de CLI, het pakket en de oplossingssjabloon in de gekopieerde omgeving.
- Genereer en controleer het aanpassingsrapport.
- Configuratie migreren in de gekopieerde ontwikkelomgeving.
- Herstel aanpassingen en leg de gevalideerde siteconfiguratie vast in een beheerde oplossing.
- Importeer de oplossing in de oefenomgeving, migreer ondersteunde gerelateerde records, activeer het verbeterde gegevensmodel en voltooi de volledige validatiecontrolelijst.
- Herhaal het herstel en de repetitie totdat alle kritieke tests zijn geslaagd.
- Plan het onderhoudsvenster voor productie, communiceer de beslissingspunten voor validatie en terugdraaien en maak een back-up van de productie.
- Bevestig opnieuw de vereisten voor het productiepakket en de sjabloonoplossing.
- Importeer de gevalideerde beheerde oplossing in productie.
- Voer
configurationDataReferencesuit, controleer de migratiestatus, schakel over naar het actieve gegevensmodel en start de site opnieuw op. - 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:
- Start de site opnieuw vanuit het Power Platform-beheercentrum.
- Controleer of op de site Standard wordt weergegeven als het actieve gegevensmodel.
- Voer de kritieke validatietests van de site opnieuw uit.
- 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 |