Översikt över migrering av standard till förbättrad datamodell

Migreringsverktyget Microsoft Power Platform CLI flyttar en befintlig Power Pages platskonfiguration och relaterade poster från standarddatamodellen till den förbättrade datamodellen och växlar sedan platsen för att använda den migrerade konfigurationen.

Standarddatamodellen lagrar Power Pages platskonfiguration mellan tabeller som använder prefixet adx_. Den förbättrade datamodellen lagrar platskonfigurationen i tabellen Platskomponent (powerpagecomponent) och identifierar varje komponent efter komponenttyp. Att förstå hur migreringsverktyget fungerar, vilka mallar det stöder och vilka anpassningar som inte uppdateras automatiskt hjälper dig att bestämma när och hur du flyttar en webbplats.

Om du granskar fördelarna med den förbättrade datamodellen förklaras varför du kan överväga att migrera en webbplats.

Det är viktigt att observera att inte alla adx_* tabeller flyttas till powerpagecomponent. Endast metadata adx_* tabeller – de som beskriver webbplatsens struktur och redigeringsyta, till exempel adx_webpage, adx_webtemplate, adx_contentsnippet, adx_sitesetting, adx_pagetemplate, adx_weblink, adx_entityformoch adx_entitylist – konsolideras till powerpagecomponent (med deras egenskaper per rad flyttade till JSON-kolumnen innehåll).

Tabellerna transactional/runtime adx_* – de som samlar in slutanvändaraktivitet vid körning, till exempel adx_invitation, adx_inviteredemption, adx_portalcomment, adx_externalidentityoch entitetsformuläret/avancerade inlämnings- och loggtabeller – migreras inte till powerpagecomponent; de finns kvar i sina befintliga scheman och fortsätter att lagra körningsdata som tidigare. Vad som ändras för dessa transaktionstabeller är att deras sökningar till metadataposter kopplas om under referensmigreringen så att de pekar på de nya powerpagecomponent raderna i stället för de äldre metadata adx_* raderna.

Befintliga webbplatser som skapats med standarddatamodellen fortsätter att köras på adx_* tabeller, så varje plats måste migreras för att kunna dra nytta av den förbättrade datamodellen. Migreringen flyttar webbplatsens konfigurationsmetadata till strukturen powerpagecomponent i den förbättrade datamodellen, kopplar om transaktionsreferenserna till de nya metadataposterna och ändrar webbplatsposten så att webbplatsen använder den förbättrade datamodellen. Det är också där anpassningar – anpassade adx_* kolumner, Liquid som läser adx_*-attribut, FetchXML över adx_* tabeller, plugin-program och arbetsflöden – visas och repareras, eftersom dessa anpassningar inte överförs automatiskt och måste skrivas om eller omstruktureras för att fungera mot förbättrad datamodell.

Förutsättningar

• Microsoft Power Platform CLIversion 2.11.2 eller senare, som kör kommandona nedladdning, migrering, status, aktivering och återställning. Mer information finns i Installera senaste Power Platform CLI.
• Dataverse-basportalpaketet CDSBasePortal9.3.2607.x eller senare, som tillhandahåller nödvändiga basportalkomponenter.
• Power Pages Core-paketet PowerPages_Core1.0.2605.x eller senare, som tillhandahåller nödvändiga Power Pages körningskomponenter. Uppdatera den Power Pages lösningen.
• Rollen Systemadministratör, Dynamics 365 administratör eller Power Platform-administratör, som krävs för att växla eller återställa den aktiva datamodellen.
• Kunskaper om Power Platform CLI för Power Pages.
• Bakgrundsåtgärder aktiverade om miljön är i administrationsläge.

Migreringsverktygsfunktioner

Migreringsverktyget kopierar konfigurationer för webbplatser som stöds och relaterade poster till den förbättrade datamodellen. När migreringen är klar växlar den aktiva platsen till den förbättrade datamodellen och verifieras innan den återgår till normal användning.

Migreringsverktyget:

• Genererar en rapport med anpassningar som kan kräva manuella ändringar.
• Migrerar webbplatskonfiguration som stöds och relaterade poster.
• Gör att du kan kontrollera migreringsstatusen innan du växlar den aktiva datamodellen.
• Gör att du kan återställa platsen till standarddatamodellen om valideringen identifierar ett kritiskt problem.

Mallar som stöds

Du kan migrera befintliga standarddatamodellwebbplatser som har skapats från följande mallar:

• Startlayout 1-5
• Appen bearbetas
• Tom sida
• Programregistrering
• Schemalägg och hantera möten
• FAQ
• Community Portal (Dynamics 365)
• Kundens Self-Service-portal (Dynamics 365)
• Self-Service Portal för anställda (Dynamics 365)
• Partnerportal (Dynamics 365)

Innan du börjar

Ytterligare planeringsöverväganden:

• Inställningen Växla till förbättrad datamodellmiljö styr den datamodell som används för nya platser. Om du aktiverar inställningen migreras inte befintliga platser.
• Kör migreringen först i en fullständig kopia av produktionsmiljön. Slutför anpassningsreparation och validering innan du migrerar.
• Använd organisationens standardprocess för säkerhetskopiering och återställning för att säkerhetskopiera produktionsmiljön.
• Planera ett underhållsfönster för den slutliga produktionsövergången och validering.
• Registrera webbplats-ID, portal-ID, miljö-URL, CLI-version, paketversioner, starttid för migrering och kommandoutdata som en del av migreringsposten.

Planera miljösekvensen

Migrering stöder olika miljöer med olika lägen för varje miljö.

Skapa en arbetsmapp

Använd en tom arbetsmapp för att lagra rapporter, nedladdad webbplatskälla och jämförelsefiler. I följande exempel används \<OUTPUT\> för den här platsen.

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

Migreringsfaser

Migreringsprocessen består av fyra faser:

1. Förkontroller – Verifiera webbplatsen, ID:t, CLI, paket, malllösning och migreringsstatus.
2. Konfiguration – Migrera konfiguration under utveckling eller import av testad konfiguration i underordnade miljöer.
3. Migrera och aktivera – Migrera relaterade poster, bekräfta slutförande, växla modeller och starta om.
4. Verifiera – Testa beteende, behörigheter, anpassad kod och mallresor.

Fas 1 (platsidentifiering och förkontroller) och fas 4 (validering efter migrering) körs på samma sätt för varje plats.

Fas 2 och fas 3 förgrenas efter spår – deras struktur beror på migreringsläget, som i sin tur fastställer spåret utifrån miljötypen.

Redigeringsspåret (läget configurationData eller all) används för utvecklings- och konfigurationer med en enda miljö. Själva metadata migreras lokalt och anpassningar genomsöks och åtgärdas mot standarddatamodellkällan innan transaktionsreferenserna flyttas.

Nedströmsspåret (läge configurationDataReferences) används för test-, UAT- och produktionsmiljöer där konfigurationsmetadata antas ha anlänt via ALM-lösningsimport från Dev. Endast transaktionsreferenser migreras i det här spåret. Eventuella anpassningsrelaterade iakttagelser tyder på en brist tidigare i ALM-processen snarare än något du bör åtgärda lokalt.

Fas 1: Förkontroller

1. Kontrollera din Power Platform CLI-version med pac --version. Om din version är tidigare än den version som krävs installerar eller uppdaterar du Microsoft Power Platform CLI innan du fortsätter.

2. Autentisera dig mot målmiljön.

   1. Kör pac auth list.
   2. Kör pac auth who.

3. Bekräfta att den aktiva autentiseringsprofilen pekar på miljön som innehåller platsen. Om du vill välja en annan profil eller skapa en profil använder du pac auth select eller pac auth create -u "https://contoso.crm.dynamics.com".

4. Installera lösningar för förbättrad datamodell för mallen med någon av följande metoder:

   1. Etablera en webbplats för mallen med flaggan för förbättrad datamodell (EDM) aktiverad i administrationscentret.
   2. Använd CLI för att installera med kommandot pac application install --application-name "<template package name>"

   Anmärkning

   Om pac application install misslyckas med att installera den förbättrade datamodellösningen skapar du en tillfällig plats med samma mall i Power Pages designstudio. När du skapar webbplatsen installeras den malllösning som krävs. Anvisningar finns i Skapa en Power Pages webbplats.

5. Hitta webbplatsen och registrera dess identifierare med pac pages list -v.

6. Registrera de värden som visas i följande tabell.

   Värde	Används för
   Webbplats-ID	Alla migrate-datamodel kommandon.
   Portal-ID	Växla till den förbättrade datamodellen och återgå till standarddatamodellen.
   Eget namn och URL	Bekräftar att du har valt rätt webbplats i administrationscentret.
   Version för datamodell	Måste vara Standard. Om det redan är Utökat krävs inte migrering.

   Important

   Portal-ID:t är inte Power Pages app-ID. Om CLI inte visar portal-ID:t är det tillgängligt i administrationscentret för Power Platform under Resurser>Power Pages platsinformation>, eller läggs till/_services/about i webbplats-URL:en när den är inloggad med de behörigheter som krävs för åtkomst till webbplatsen.

7. Sök efter en tidigare eller pågående migrering med följande kommando:

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

   Status	Betydelse	Action
   NotStarted eller ingen spårning	Ingen migrering har startats.	Fortsätt med paketkontrollerna.
   Återställd	En tidigare migrering återställdes.	Granska varför den återställdes och fortsätt sedan när du är redo.
   Har slutförts	Migreringen har slutförts, men webbplatsen kanske inte har växlats över.	Bekräfta den aktiva datamodellen. Om det fortfarande är Standard fortsätter du med aktiveringen.
   Körs	Migreringen bearbetas fortfarande.	Fortsätt att kontrollera status. Starta inte någon annan migrering för samma webbplats.
   Misslyckades	Migreringen påträffade ett fel.	Samla in kommandoutdata och miljöinformation, korrigera orsaken och försök igen först efter att felet har förståtts.

   Anmärkning

   Om en migrering fortfarande körs längre än förväntat behöver du webbplats-ID, miljö-ID, CLI-version, paketversioner, kommandoutdata och starttid för migrering innan du kontaktar Microsoft support. En aktiv migrering ska inte återställas om inte supporten eller en godkänd runbook instruerar dig att göra det.

8. Verifiera nödvändiga paket från första part med pac solution list --includeSystemSolutions.

   1. Bekräfta att CDSBasePortal, PowerPages_Coreoch EDM-lösningarna för webbplatsens mall är installerade i de versioner som krävs.

9. Om ett paket saknas eller är inaktuellt uppdaterar du det från administrationscentret för Power Platform:

   1. Öppna målmiljön.
   2. Gå till Resources>Dynamics 365 apps.
   3. Hitta det nödvändiga paketet.
   4. Välj Installera eller uppgradera.
   5. Vänta tills åtgärden har slutförts och kör pac solution list --includeSystemSolutions sedan igen.

   Anmärkning

   Om EDM-malllösningen inte är tillgänglig för direkt installation installerar du den matchande EDM-lösningen genom att skapa en tillfällig förbättrad datamodellplats i samma miljö med samma mall. Du kan ta bort den tillfälliga webbplatsen när lösningen har bekräftats.

10. Generera anpassningsrapporten med pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". När rapporten genereras ändras inte webbplatsen.

11. Öppna den genererade CSV-filen och granska varje objekt som refererar till standarddatamodelltabeller. Tilldela en ägare och valideringssteg för varje nödvändig reparation före produktionsmigrering.

    Anpassningskategori	Plan
    Anpassade kolumner i adx_ metadatatabeller	Flytta anpassade data till en anpassad tabell som stöds som är relaterad till powerpagecomponent.
    Relationer till adx_ metadatatabeller	Återskapa relationen mot den förbättrade datamodelltabellen som stöds.
    Liquid- eller FetchXML-referenser till adx_-tabeller	Uppdatera koden för att använda flytande objekt, virtuella tabeller eller powerpagecomponent som stöds.
    Arbetsflöden och plugin-program i adx_ tabeller	Omstrukturera och registrera logiken mot förbättrade datamodelltabeller som stöds.

    Anmärkning

    En anpassningsrapport bevisar inte att allt webbplatsbeteende fungerar efter migreringen. verifiering krävs fortfarande.

12. Välj migreringsläget för att avgöra vad verktyget migrerar i en enda åtgärd.

    Mode	Det som migreras	När den ska användas
    configurationData	Webbplatskonfigurationsmetadata som stöds, till exempel sidor, webbmallar, kodfragment, inställningar, formulär, listor, webbroller och tabellbehörigheter.	Utveckling, där du justerar konfigurationen och flyttar den mellan lösningar.
    configurationDataReferences	Poster som stöds som refererar till migrerad platskonfiguration.	Test, UAT och produktion efter att webbplatskonfigurationen levereras via en lösningsimport.
    all	Både konfiguration och stödda relaterade poster.	En enskild miljö eller en enkel migrering som inte använder den lösningsbaserade miljösekvensen.

Fas 2: Platskonfiguration

Redigeringsspår: Utveckling eller en enda miljö

1. Ladda ned en SDM-baslinje genom att köra pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Kommandot skapar en underordnad mapp med namnet för platsen. Registrera mappen som innehåller direkt website.yml.

2. Migrera platskonfiguration genom att köra pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Om du vill ha sökvägen med en enda åtgärd ersätter du configurationData med all.

3. Kontrollera migreringsstatus genom att köra pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Använd följande PowerShell-loop för att kontrollera status en gång per minut i upp till 30 minuter:

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

   Om loopen avslutas medan statusen fortfarande är Running fortsätter kontrollen med --checkMigrationStatus. En tidskrävande åtgärd är inte nödvändigtvis en misslyckad åtgärd.

4. Åtgärda rapporterade anpassningar med hjälp av anpassningsrapporten och vägledningen i den här artikeln för att uppdatera berörda FetchXML, Liquid, anpassade kolumner, relationer, arbetsflöden och plugin-program. Testa varje ändrad komponent igen. Om du uppdaterar den nedladdade källan laddar du upp webbplatsmappen som innehåller direkt website.yml genom att köra pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.

Nedströmsspår: test, UAT eller produktion

1. Importera lösningen som innehåller den migrerade och reparerade platskonfigurationen. Använd administrationscentret för Power Platform eller din etablerade distributionspipeline.

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

2. Bekräfta att platskonfigurationen finns genom att öppna appen Power Pages Management i målmiljön. Platsposten och den förväntade konfigurationen måste finnas på plats innan de relaterade posterna migreras.

Fas 3: Relaterade poster och aktivering

1. Migrera relaterade poster som stöds. Om du redan har använt --mode allhoppar du över det här steget. Kontrollera status tills den rapporterar Slutförd.

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

2. När migreringsstatusen visar att migreringen har slutförts byter du den aktiva webbplatsen till den förbättrade datamodellen. Webbplatsposten för standarddatamodellen inaktiveras och motsvarande webbplatspost för den utökade datamodellen aktiveras.

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

3. Starta om webbplatsen.

   1. Öppna administratörscentret för Power Platform.
   2. Gå till miljön och välj sedan Resurser>Power Pages webbplatser.
   3. Välj webbplatsen.
   4. Välj Starta om. Om Omstart inte är tillgängligt inaktiverar du och aktiverar sedan webbplatsen.
   5. Vänta tills åtgärden har slutförts innan valideringen.

4. Bekräfta den aktiva datamodellen med hjälp av en eller flera av följande metoder:

   1. I administrationscentret för Power Platform väljer du platsen och bekräftar att Datamodellen visar Utökad.
   2. Öppna webbplatsens installationsarbetsyta i Power Pages designstudion och bekräfta den datamodell som visas.
   3. Bekräfta att den avancerade konfigurationen öppnas i appen Power Pages Management.
   4. Kör pac pages list -v och bekräfta datamodellversionen.

   Tip

   Webbplatsens URL och visuella design ändras inte bara för att den aktiva datamodellen har ändrats. För att verifiera migreringen använder du dessa kontroller – inte webbplatsens utseende.

Fas 4: Verifiera den migrerade webbplatsen

Slutför valideringen innan du öppnar en produktionsplats för användarna igen. Använd testkonton för varje viktig användartyp och webbroll och registrera resultatet av varje kritiskt test.

Kontrollera webbläsardiagnostik

Öppna utvecklarverktyg för webbläsare när representativa sidor testas. Undersök:

• Konsolfel som nämner adx\_, entiteter, Liquid eller FetchXML.
• HTTP 401- eller 403-svar från \_api, vilket kan tyda på ett behörighets- eller webbrollsproblem.
• HTTP 500-svar, vilket kan tyda på ett liquid-, FetchXML-, plugin-program- eller integrationsfel.

Villkor för slutförande av migrering

Överväg att migreringen endast slutförs när webbplatsen visar den förbättrade datamodellen, kritiska affärsresor passerar, förväntat säkerhetsbeteende bekräftas och varje anpassningssökning med hög påverkan löses eller accepteras.

Produktionsmigreringssekvens

Använd följande produktionssekvens för att minska migreringsrisken:

1. Skapa en fullständig kopia av produktionsmiljön för repetition.
2. Bekräfta kraven för CLI-, paket- och malllösningen i den kopierade miljön.
3. Generera och granska anpassningsrapporten.
4. Migrera konfigurationen i den kopierade utvecklingsmiljön.
5. Åtgärda anpassningar och avbilda den verifierade platskonfigurationen i en hanterad lösning.
6. Importera lösningen till repetitionsmiljön, migrera relaterade poster som stöds, aktivera den förbättrade datamodellen och slutför den fullständiga verifieringschecklistan.
7. Upprepa åtgärder och övningar tills alla kritiska tester har klarats.
8. Schemalägg fönstret för produktionsunderhåll, kommunicera beslutspunkterna för validering och återställning och säkerhetskopiera produktionen.
9. Bekräfta kraven för produktionspaketet och malllösningen igen.
10. Importera den verifierade hanterade lösningen till produktion.
11. Kör configurationDataReferences, kontrollera migreringsstatus, växla den aktiva datamodellen och starta om platsen.
12. Kör checklistan för produktionsverifiering och återställ platsen till normal användning endast efter att kritiska tester har godkänts.

Återställ en migrerad plats till standarddatamodellen

Om valideringen upptäcker ett kritiskt problem efter aktivering använder du följande kommando för att återaktivera webbplatsposten för standarddatamodellen:

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

När kommandot är klart:

1. Starta om webbplatsen från administrationscentret för Power Platform.
2. Bekräfta att webbplatsen visar Standard som aktiv datamodell.
3. Kör webbplatsens kritiska valideringstester igen.
4. Bevara migreringsrapporten, felinformationen och reparationsanteckningarna innan du försöker utföra en ny migrering.

Felsökning

Överväganden för webbplatsanpassningar

Anpassningsrapporten identifierar direkta beroenden för standarddatamodelltabeller. Slutför nödvändig reparation före produktionsanvändning.

Anpassade kolumner i metadatatabeller

Om en standarddatamodelltabell, till exempel adx_webpage innehåller en anpassad kolumn, skapar du en anpassad tabell för att lagra anpassade data och lägger till en sökning i powerpagecomponent. Migrera de anpassade värdena till den nya tabellen och uppdatera koden som läser eller skriver kolumnen.

Relationer mellan anpassade tabeller och metadatatabeller

Återskapa anpassade relationer som pekar på adx_ tabeller så att de pekar på lämplig förbättrad datamodelltabell, vanligtvis powerpagecomponent. Uppdatera beroende formulär, vyer, plugin-program, flöden och integreringar.

Flytande referenser till metadatatabeller

Ersätt direktåtkomst entities['adx_*'] med ett Liquid-objekt som stöds där det finns ett. Använd till exempel Liquid-objektet weblinks i stället för att göra direkta frågor mot adx_weblinkset eller relaterade tabeller. Granska varje användning eftersom det returnerade objektet och tillgängliga attribut kan skilja sig åt.

HämtaXML-referenser till metadatatabeller

Ersätt direkta adx_ entitetsreferenser med motsvarande virtuella tabell eller fråga powerpagecomponent och filtrera efter powerpagecomponenttype

Exempel på standarddatamodell:

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

Exempel på förbättrad datamodell:

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

Anpassade arbetsflöden och plugin-program

Omstrukturera anpassat arbetsflöde och plugin-logik som registrerats i adx_ tabeller. Registrera den uppdaterade logiken i lämplig förbättrad datamodelltabell och använd det förbättrade schemat och attributen. Testa beteendet vid skapande, uppdatering, borttagning och säkerhet i en icke-produktionsmiljö.

Referens för kommandon

Referens för webbplatskomponenttyp

När du frågar powerpagecomponentanvänder du följande värden i powerpagecomponenttype-filtret .

Lösningsreferens för EDM-mall

Kör pac solution list --includeSystemSolutions för att bekräfta att den förbättrade datamodelllösningen för webbplatsens mall är installerad.

Relaterat innehåll

• Förbättrad datamodell
• Power Platform CLI-referens för Power Pages
• Använda Power Platform CLI med Power Pages
• Uppdatera Power Pages lösningar