Oversigt over migrering af standard til forbedret datamodel

Microsoft Power Platform CLI-overførselsværktøjet flytter en eksisterende Power Pages websteds understøttede konfiguration og relaterede poster fra standarddatamodellen til den forbedrede datamodel og skifter derefter webstedet til at bruge den migrerede konfiguration.

Standarddatamodellen gemmer Power Pages webstedskonfiguration på tværs af tabeller, der bruger præfikset adx_. Den forbedrede datamodel gemmer webstedskonfigurationen i tabellen Webstedskomponent (powerpagecomponent) og identificerer hver komponent efter komponenttype. Hvis du forstår, hvordan overførselsværktøjet fungerer, hvilke skabeloner det understøtter, og hvilke tilpasninger det ikke opdateres automatisk, hjælper det dig med at beslutte, hvornår og hvordan du flytter et websted.

Gennemgang af fordelene ved den forbedrede datamodel forklarer, hvorfor du måske overvejer at migrere et websted.

Det er vigtigt at bemærke, at ikke alle adx_* tabeller flyttes til powerpagecomponent. Kun metadataene adx_* tabeller – dem, der beskriver webstedets struktur og oprettelsesoverflade, f.eks adx_webpage. , adx_webtemplate, adx_contentsnippet, adx_sitesetting, adx_pagetemplate, adx_weblink, , adx_entityformog adx_entitylist – konsolideres i powerpagecomponent (med deres egenskaber pr. række flyttet til kolonnen JSON for indhold).

De transaktions-/kørsels-adx_* tabeller – dem, der henter slutbrugeraktivitet på kørselstidspunktet, f.eks adx_invitation. , adx_inviteredemption, adx_portalcomment, adx_externalidentityog indsendelses- og logtabellerne for objektformularen/avanceret formular – migreres ikke til powerpagecomponent, de forbliver i deres eksisterende skemaer og opbevarer kørselsdata som før. Ændringerne for disse transaktionstabeller er, at deres opslag i metadataposter bliver tilknyttet igen under migreringen af referencer, så de peger på de nye powerpagecomponent rækker i stedet for de ældre metadata adx_* rækker.

Eksisterende websteder, der er oprettet på en standarddatamodel, kører fortsat på adx_* tabeller, så hvert websted skal migreres for at kunne drage fordel af den forbedrede datamodel. Migreringen flytter webstedets konfigurationsmetadata til den forbedrede datamodelstruktur powerpagecomponent, omdirigerer de transaktionelle referencer til disse nye metadataposter og skifter webstedsposten, så den betjenes fra den forbedrede datamodel. Det er også her, tilpasninger – brugerdefinerede adx_* kolonner, Liquid, der læser adx_* attributter, FetchXML over adx_* tabeller, plug-ins og arbejdsprocesser – vises og afhjælpes, fordi disse tilpasninger ikke overføres automatisk og skal omskrives eller omstruktureres for at fungere i forhold til den forbedrede datamodel.

Forudsætninger

• Microsoft Power Platform kommandolinjegrænsefladenversion 2.11.2 eller nyere, som kører kommandoerne til download, overførsel, status, aktivering og annullering af opdatering. Du kan få flere oplysninger under Installér den nyeste kommandolinjegrænseflade til Power Platform.
• Dataverse Base Portal Package CDSBasePortal9.3.2607.x eller nyere, som indeholder de påkrævede basisportalkomponenter.
• Power Pages Core-pakke PowerPages_Core1.0.2605.x eller nyere, som leverer de påkrævede Power Pages-kørselskomponenter. Opdater Power Pages-løsningen.
• Rollen Systemadministrator, Dynamics 365 administrator eller Power Platform-administrator, som kræves for at skifte eller gendanne den aktive datamodel.
• Kendskab til power platform-kommandolinjegrænsefladen til Power Pages.
• Handlinger i baggrunden er aktiveret, hvis miljøet er i administrationstilstand.

Egenskaber for overførselsværktøj

Overførselsværktøjet kopierer understøttet webstedskonfiguration og relaterede poster til den forbedrede datamodel. Når overførslen er fuldført, skifter det aktive websted til den forbedrede datamodel og valideres, før det vender tilbage til normal brug.

Overførselsværktøjet:

• Genererer en rapport over tilpasninger, der kan kræve manuelle ændringer.
• Overfører understøttet webstedskonfiguration og relaterede poster.
• Giver dig mulighed for at kontrollere overførselsstatus, før du skifter den aktive datamodel.
• Giver dig mulighed for at gendanne webstedet til standarddatamodellen, hvis valideringen identificerer et kritisk problem.

Understøttede skabeloner

Du kan overføre eksisterende standardwebsteder for datamodeller, der er oprettet ud fra følgende skabeloner:

• Startlayout 1-5
• Programbehandling
• Den tomme side
• Programregistrering
• Planlæg og administrer møder
• ofte stillede spørgsmål
• CommunityPortal (Dynamics 365)
• Dynamics 365 (customer Self-Service Portal)
• Medarbejder-selvbetjeningsportal (Dynamics 365)
• Partnerportal (Dynamics 365)

Inden du går i gang

Yderligere planlægningsovervejelser:

• Indstillingen Skift til udvidet datamodelmiljø styrer den datamodel, der bruges til nye websteder. Hvis du aktiverer indstillingen, overføres eksisterende websteder ikke.
• Kør overførslen først i en komplet kopi af produktionsmiljøet. Fuldfør tilpasningsafhjælpning og validering, før du migrerer.
• Brug organisationens standardproces til sikkerhedskopiering og gendannelse til at sikkerhedskopiere produktionsmiljøet.
• Planlæg et vedligeholdelsesvindue for den endelige produktionsafbryder og validering.
• Registrer websteds-id'et, portal-id'et, miljø-URL-adressen, CLI-versionen, pakkeversioner, starttidspunktet for migrering og kommandooutput som en del af overførselsposten.

Planlæg miljøsekvensen

Migrering understøtter forskellige miljøer med forskellige tilstande for hvert miljø.

Opret en arbejdsmappe

Brug en tom arbejdsmappe til at indeholde rapporter, downloadet webstedskilde og sammenligningsfiler. Følgende eksempler bruges \<OUTPUT\> til denne placering.

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

Migrationsfaser

Migreringsprocessen består af fire faser:

1. Forhåndskontroller – Kontrollér webstedet, id'er, kommandolinjegrænsefladen, pakker, skabelonløsning og overførselsstatus.
2. Konfiguration – Overfør konfiguration i udviklings- eller importtestet konfiguration i downstreammiljøer.
3. Overfør og aktivér – Overfør relaterede poster, bekræft fuldførelse, skift modeller, og genstart.
4. Validate – testfunktionsmåde, tilladelser, brugerdefineret kode og skabelonforløb.

Fase 1 (webstedsregistrering og forhåndskontroller) og fase 4 (validering efter migrering) kører på samme måde for hvert websted.

Fase 2 og fase 3 er sporforgrenede – deres form afhænger af overførselstilstanden, som henter sporet fra miljøtypen.

Oprettelsessporet (tilstand configurationData eller all) bruges til konfigurationer af udvikling og enkeltmiljøer. Selve metadataene migreres lokalt, og tilpasninger scannes og rettes i forhold til standarddatamodelkilden, før transaktionsreferencer flyttes.

Downstream Track (tilstandconfigurationDataReferences) bruges til test-, UAT- og produktionsmiljøer, hvor konfigurationsmetadata antages at være ankommet via ALM-løsningsimport fra Dev. Det er kun transaktionsreferencer, der overføres i dette spor. Eventuelle tilpasningsresultater angiver et upstream ALM-hul i stedet for arbejde, du skal udføre lokalt.

Fase 1: Forhåndskontroller

1. Bekræft din Power Platform CLI-version med pac --version. Hvis din version er tidligere end den påkrævede version, skal du installere eller opdatere Microsoft Power Platform kommandolinjegrænsefladen, før du fortsætter.

2. Autentificer dig i målmiljøet.

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

3. Bekræft, at den aktive godkendelsesprofil peger på det miljø, der indeholder webstedet. Hvis du vil vælge en anden profil eller oprette en profil, skal du bruge pac auth select eller pac auth create -u "https://contoso.crm.dynamics.com".

4. Installér løsninger med udvidede datamodeller til skabelonen ved hjælp af en af følgende metoder:

   1. Klargør et websted ud fra din skabelon med flaget for forbedret datamodel (EDM) aktiveret i administrationscenteret.
   2. Brug kommandolinjegrænsefladen til at installere med kommandoen pac application install --application-name "PowerPages_PartnerPortal_V2"

5. Find webstedet, og registrer dets id'er med pac pages list -v.

6. Registrer de værdier, der vises i følgende tabel.

   Værdi	Bruges til
   Websteds-id	Alle migrate-datamodel kommandoer.
   Portal-id	Skift til den forbedrede datamodel og vend tilbage til standarddatamodellen.
   Brugervenligt navn og URL-adresse	Bekræfter, at du har valgt det korrekte websted i Administration.
   version af datamodellen	Skal være Standard. Hvis den allerede er udvidet, er migrering ikke påkrævet.

   Vigtigt!

   Portal-id'et er ikke det Power Pages app-id. Hvis portal-id'et ikke vises på kommandolinjegrænsefladen, er det tilgængeligt i Power Platform Administration under Ressourcer>Power Pages oplysningerom webstedswebsted> eller føje /_services/about til webstedets URL-adresse, mens du er logget på med de påkrævede tilladelser til webstedsadgang.

7. Kontrollér, om der er en tidligere eller igangværende migrering med følgende kommando:

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

   Status	Betydning	Aktion
   NotStarted eller ingen tracker	Der er ikke startet nogen overførsel.	Fortsæt med pakkekontrollerne.
   Gendannet	En tidligere migrering blev annulleret.	Gennemgå, hvorfor den blev rullet tilbage, og fortsæt derefter, når du er klar.
   Fuldført	Overførslen er fuldført, men webstedet er muligvis ikke blevet ændret.	Bekræft den aktive datamodel. Hvis det stadig er Standard, skal du fortsætte med aktiveringen.
   Kører	Migreringen behandles stadig.	Fortsæt med at kontrollere status. Start ikke en anden migrering for det samme websted.
   Mislykket	Overførslen stødte på en fejl.	Indsaml oplysninger om kommandooutput og miljø, ret årsagen, og prøv først igen, når fejlen er forstået.

   Bemærkning

   Hvis en migrering fortsat kører længere end forventet, skal du have starttidspunktet for websteds-id, miljø-id, CLI-version, pakkeversioner, kommandooutput og overførsel, før du kontakter Microsoft support. En aktiv migrering bør ikke nulstilles, medmindre support eller en godkendt runbook instruerer den.

8. Bekræft påkrævede førstepartspakker med pac solution list --includeSystemSolutions.

   1. Bekræft, at CDSBasePortal, PowerPages_Coreog EDM-løsningerne for webstedets skabelon er installeret i de påkrævede versioner.

9. Hvis en pakke mangler eller er forældet, skal du opdatere den fra Power Platform Administration:

   1. Åbn målmiljøet.
   2. Gå til Ressourcer>Dynamics 365 apps.
   3. Find den påkrævede pakke.
   4. Vælg Installér eller Opgrader.
   5. Vent, indtil handlingen er fuldført, og kør pac solution list --includeSystemSolutions derefter igen.

   Bemærkning

   Hvis EDM-skabelonløsningen ikke er tilgængelig til direkte installation, installeres den tilsvarende EDM-løsning, når du opretter et midlertidigt websted med forbedret datamodel i det samme miljø med den samme skabelon. Du kan slette det midlertidige websted, når løsningen er bekræftet.

10. Generér tilpasningsrapporten med pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Oprettelse af rapporten ændrer ikke webstedet.

11. Åbn den genererede CSV-fil, og gennemse hvert element, der refererer til standardtabeller for datamodeller. Tildel et ejer- og valideringstrin for hver påkrævet afhjælpning før produktionsoverførsel.

    Tilpasningskategori	Plan
    Brugerdefinerede kolonner i adx_ metadatatabeller	Flyt de brugerdefinerede data til en understøttet brugerdefineret tabel, der er relateret til powerpagecomponent.
    Relationer til adx_ metadatatabeller	Genopret relationen i forhold til den understøttede tabel med forbedrede datamodeller.
    Liquid- eller FetchXML-referencer til adx_-tabeller	Opdater kode for at bruge understøttede Flydende objekter, virtuelle tabeller eller powerpagecomponent.
    Arbejdsprocesser og plug-ins i adx_ tabeller	Refactor, og registrer logikken i forhold til understøttede forbedrede datamodeltabeller.

    Bemærkning

    En tilpasningsrapport beviser ikke, at alle webstedets funktionsmåder fungerer efter migreringen. validering er stadig påkrævet.

12. Vælg overførselstilstanden for at bestemme, hvad hjælpeprogrammet overfører i en enkelt handling.

    Tilstand	Det migrerer	Anvendelse
    configurationData	Understøttede metadata for webstedskonfiguration, f.eks. sider, webskabeloner, kodestykker, indstillinger, formularer, lister, webroller og tabeltilladelser.	Udvikling, hvor du afhjælper konfiguration og flytter den gennem løsninger.
    configurationDataReferences	Understøttede poster, der refererer til konfigurationen af det migrerede websted.	Test, UAT og produktion, når webstedskonfigurationen ankommer via en løsningsimport.
    alle	Både konfigurationsposter og understøttede relaterede poster.	Et enkelt miljø eller en simpel migrering, der ikke bruger den løsningsbaserede miljøsekvens.

Fase 2: Konfiguration af websted

Oprettelsesspor: Udvikling eller et enkelt miljø

1. Download en SDM-oprindelig plan ved at køre pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Kommandoen opretter en underordnet mappe med navnet på webstedet. Registrer den mappe, der indeholder website.ymldirekte .

2. Overfør webstedskonfiguration ved at køre pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Hvis du vil have stien til en enkelt handling, skal du erstatte configurationData med all.

3. Kontrollér overførselsstatus ved at køre pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Brug følgende PowerShell-løkke til at kontrollere status én gang pr. minut i op til 30 minutter:

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

   Hvis løkken slutter, mens status stadig kører, fortsætter kontrollen med --checkMigrationStatus. En handling, der kører i lang tid, er ikke nødvendigvis en mislykket handling.

4. Afhjælp rapporterede tilpasninger ved hjælp af tilpasningsrapporten og vejledningen i denne artikel til at opdatere berørte FetchXML, Liquid, brugerdefinerede kolonner, relationer, arbejdsprocesser og plug-ins. Prøv igen for hver ændret komponent. Hvis du opdaterer den downloadede kilde, skal du overføre den webstedsmappe, der indeholder website.yml direkte, ved at køre pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.

Downstream Track: Test, UAT eller produktion

1. Importér den løsning, der indeholder den migrerede og afhjælpede webstedskonfiguration. Brug Power Platform Administration eller din etablerede udrulningspipeline.

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

2. Bekræft, at webstedskonfigurationen findes ved at åbne appen Power Pages management i destinationsmiljøet. Webstedsposten og den forventede konfiguration skal være til stede, før relaterede poster overføres.

Fase 3: Relaterede poster og aktivering

1. Overfør understøttede relaterede poster. Hvis du allerede har brugt --mode all, skal du springe dette trin over. Kontrollér status, indtil den rapporterer Fuldført.

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

2. Når statusrapporterne for overførsel er fuldført, skal du skifte det aktive websted til den forbedrede datamodel. Webstedsposten for standarddatamodellen er deaktiveret, og den tilsvarende udvidede webstedspost for datamodellen bliver aktiv.

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

3. Genstart webstedet.

   1. Åbn Power Platform Administration.
   2. Gå til miljøet, og vælg derefter Ressourcer>Power Pages websteder.
   3. Vælg webstedet.
   4. Vælg Genstart. Hvis Genstart ikke er tilgængelig, skal du deaktivere og derefter aktivere webstedet.
   5. Vent på, at handlingen afsluttes, før valideringen udføres.

4. Bekræft den aktive datamodel ved hjælp af en eller flere af disse metoder:

   1. I Power Platform Administration skal du vælge webstedet og bekræfte, at Datamodel viser Udvidet.
   2. Åbn webstedets konfigurationsarbejdsområde i Power Pages designstudie, og bekræft den viste datamodel.
   3. Bekræft, at avanceret konfiguration åbnes i appen Power Pages Management.
   4. Kør pac pages list -v og bekræft datamodelversionen.

   Tip

   Webstedets URL-adresse og visuelle design ændres ikke, blot fordi den aktive datamodel er ændret. Hvis du vil bekræfte migreringen, skal du bruge disse kontroller – ikke webstedets udseende.

Fase 4: Valider det migrerede websted

Fuldfør valideringen, før du åbner et produktionswebsted igen for brugerne. Brug testkonti for hver vigtig brugertype og webrolle, og registrer resultatet af hver kritisk test.

Kontrollér browserdiagnostik

Åbn browserudviklerværktøjer, mens du tester repræsentative sider. Undersøg:

• Konsolfejl, der nævner adx\_, enheder, Liquid eller FetchXML.
• HTTP 401- eller 403-svar fra \_api, som kan angive en tilladelse eller et problem med webrollen.
• HTTP 500-svar, hvilket kan indikere en liquid-, FetchXML-, plug-in- eller integrationsfejl.

Kriterier for fuldførelse af migrering

Overvej kun, at migreringen er fuldført, når webstedet viser den forbedrede datamodel, vigtige forretningsrejser passerer, den forventede sikkerhedsfunktion bekræftes, og alle tilpasninger med stor indvirkning er løst eller accepteret.

Produktionsoverførselssekvens

Brug følgende produktionssekvens til at reducere overførselsrisikoen:

1. Opret en komplet kopi af produktionsmiljøet til afprøvning.
2. Bekræft forudsætninger for kommandolinjegrænsefladen, pakken og skabelonløsningen i det kopierede miljø.
3. Opret og gennemse tilpasningsrapporten.
4. Overfør konfigurationen i det kopierede udviklingsmiljø.
5. Afhjælp tilpasninger, og hent den validerede webstedskonfiguration i en administreret løsning.
6. Importér løsningen i afprøvningsmiljøet, overfør understøttede relaterede poster, aktivér den forbedrede datamodel, og udfyld den fulde valideringstjekliste.
7. Gentag afhjælpning og afprøvning, indtil alle kritiske test består.
8. Planlæg vinduet produktionsvedligeholdelse, kommuniker validerings- og annulleringsbeslutningspunkterne og sikkerhedskopiér produktionen.
9. Bekræft forudsætningerne for produktionspakken og skabelonløsningen igen.
10. Importér den validerede administrerede løsning til produktion.
11. Kør configurationDataReferences, kontrollér overførselsstatus, skift den aktive datamodel, og genstart webstedet.
12. Kør kontrollisten for produktionsvalidering, og tag først webstedet tilbage i normal brug, når de kritiske test er bestået.

Genindlæs et overflyttet websted til standarddatamodellen

Hvis valideringen identificerer et kritisk problem efter aktiveringen, skal du bruge følgende kommando til at genaktivere webstedsposten for standarddatamodellen:

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

Når kommandoen er afsluttet:

1. Genstart webstedet fra Power Platform Administration.
2. Bekræft, at Standard vises som den aktive datamodel på webstedet.
3. Kør webstedets kritiske valideringstest igen.
4. Bevar overførselsrapporten, fejldetaljerne og afhjælpningsbemærkningerne, før du forsøger en anden migrering.

Fejlfinding

Overvejelser i forbindelse med webstedstilpasninger

Tilpasningsrapporten identificerer direkte afhængigheder af standardtabeller for datamodeller. Fuldfør den påkrævede afhjælpning før produktionsbrug.

Brugerdefinerede kolonner i metadatatabeller

Hvis en standarddatamodeltabel, f.eks adx_webpage . indeholder en brugerdefineret kolonne, skal du oprette en brugerdefineret tabel for at gemme de brugerdefinerede data og føje et opslag til powerpagecomponent. Overfør de brugerdefinerede værdier til den nye tabel, og opdater kode, der læser eller skriver kolonnen.

Relationer mellem brugerdefinerede tabeller og metadatatabeller

Opret brugerdefinerede relationer, der peger på adx_ tabeller, så de peger på den relevante udvidede datamodeltabel, ofte powerpagecomponent. Opdater afhængige formularer, visninger, plug-ins, flow og integrationer.

Flydende referencer til metadatatabeller

Erstat direkte entities['adx_*'] adgang med et understøttet Liquid-objekt, hvor der findes et. Du kan f.eks. bruge weblinks objektet Liquid i stedet for direkte at forespørge adx_weblinkset eller relaterede tabeller. Gennemse hver brug, fordi det returnerede objekt og de tilgængelige attributter kan variere.

FetchXML-referencer til metadatatabeller

Erstat direkte adx_ objektreferencer med den tilsvarende virtuelle tabel eller forespørgsel powerpagecomponent , og filtrer med powerpagecomponenttype

Eksempel på standarddatamodel:

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

Eksempel på udvidet datamodel:

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

Brugerdefinerede arbejdsprocesser og plug-ins

Omfaktorer brugerdefineret arbejdsproces og plug-in-logik, der er registreret på adx_ tabeller. Registrer den opdaterede logik i den relevante tabel med forbedrede datamodeller, og brug det forbedrede skema og de forbedrede attributter. Test funktionsmåden oprettelse, opdatering, sletning og sikkerhed i et ikke-produktionsmiljø.

Kommandoreference

Reference til komponenttype for websted

Når du forespørger powerpagecomponentom , skal du bruge følgende værdier i filteret powerpagecomponenttype .

Reference til EDM-skabelonløsning

Kør pac solution list --includeSystemSolutions for at bekræfte, at den forbedrede datamodelløsning for webstedets skabelon er installeret.

Relateret indhold

• Forbedret datamodel
• Power Platform CLI-reference til Power Pages
• Brug power platform-kommandolinjegrænsefladen med Power Pages
• Opdater Power Pages løsninger