Overføre websteder i standarddatamodeller til forbedret datamodel (eksempel)
[Dette emne er en foreløbig udgivelse af dokumentationen, og der kan forekomme ændringer.]
I denne artikel kan du få mere at vide om, hvordan du overfører eksisterende standarddatamodelwebsted til den forbedrede datamodel.
Vigtigt!
- Denne funktion er en forhåndsversion af funktionen.
- Forhåndsversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
Forudsætninger
- Du skal installere Microsoft Power Platform CLI med version 1.31.6 eller nyere for at overføre webstederne til en forbedret datamodel. Se flere oplysninger i: Installer seneste Power Platform CLI
- Dataverse basisportalpakke 9.3.2307.x eller nyere.
- Power Pages Kernepakke 1.0.2309.63 eller højere. Flere oplysninger: Opdater Power Pages-løsning
- Du skal forstå, hvordan du kan bruge Power Platform CLI i Power Pages til at fuldføre overførselstrinnene. Hvis du ikke kender Power Platform CLI i Power Pages, kan du gennemgå dette Power Platform CLI selvstudium og referere til PAC CLI-kommandoer for at arbejde med Power Pages.
Trin 1. Hente og kontrollere tilpasning for eksisterende standardmetadata om webstedet
Åbn et kommandoprompt.
Brug følgende kommando til at godkende Dataverse-organisationen for Power Platform-miljøet for at hente webstedsposten, der skal overføres.
pac auth create -u [Dataverse URL]
Eksempel
pac auth create -u https://contoso-org.crm.dynamics.com
Du kan finde flere oplysninger i: pac auth create
Brug følgende kommando til at oprette en liste over websteder i den aktuelle organisation.
pac powerpages list
Flere oplysninger: pac powerpages-liste
Brug følgende kommando til at downloade tilpasningsrapporten.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]
Eksempel
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"
Hvis du finder tilpasninger i den hentede rapport, skal du følge vejledningen i rapporten for at rette den efter overflytningen til en forbedret datamodel. Flere oplysninger: Overvejelser om tilpasning af websteder ved overførsel af websteder fra standard til forbedret datamodel
Trin 2. Overføre webstedsdata fra standard- til forbedret datamodel
Brug følgende kommando til at overføre webstedsdata til den forbedrede datamodel.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]
Tilstanden kan have 3 værdier:
configurationData: Overfør metadataene for webstedet. Flere oplysninger: Liste over tabeller til opbevaring af konfigurationsdata
configurationDataReferences: overfør transaktionsdataene for webstedet. Flere oplysninger: Liste over tabeller til opbevaring af ikke-konfigurationsdata
alle: Overfør begge datatyper.
Eksempel
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all
Løsningerne kontrolleres af overførselsværktøjet. Hvis der findes en standarddatamodelløsning uden en respektive forbedret datamodelløsning til den nævnte skabelon, vises der en advarsel: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template
Der findes specifikke skabeloner, f.eks. Programtilmelding og Planlæg og Administrer møder, som kræver tilsvarende forbedrede datamodelpakker for at sikre, at det overførte websted fungerer korrekt. Hvis du vil hente disse pakker med forbedrede datamodeller, skal du oprette et nyt websted til den tilknyttede skabelon (miljøet skal være aktiveret for den forbedrede datamodel) for at levere forbedrede datamodel kompatible løsninger til overførsel.
Understøttede skabeloner til overførsel
Websteder med følgende skabeloner understøttes i forbindelse med overflytning:
- Startlayout 1-5
- Programbehandling
- Tom side
- Programregistrering
- Planlæg og administrer møder
Trin 3. Kontrollér overførselsstatus
Brug følgende kommando til at kontrollere webstedets overførselsstatus:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus
Eksempel
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus
Bemærk
Hvis det tager længere tid end forventet at overflytningen af webstedet, kan det skyldes mængden af data. Hvis kommandoprompten lukkes, skal du åbne en ny kommandoprompt og bruge kommandoen i dette trin til at kontrollere webstedets status.
Trin 4. Opdater webstedsdatamodelversion efter vellykket dataoverførsel
Brug følgende version af webstedsdatamodellen for kommandoopdateringer:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]
Bemærk
- Du kan finde portal-id'et ved at gå til webstedet, hvor '/_services/about' er vedhæftet webadressen til webstedet. Hvis du vil have vist disse indstillinger, skal brugeren have en webrolle, hvor alle adgangstilladelser til websteder er tildelt.
- Når versionen af webstedsdatamodellen er opdateret, deaktiveres den webstedspost, der er knyttet til standarddatamodellen. Webstedet vil i stedet nu referere til den webstedspost, der er knyttet til den forbedrede datamodel.
- Brugeren skal have en af følgende roller for at udføre overførselskommandoen med
updateDatamodelVersion
ellerrevertToStandardDataModel
argumenter. Derved udføres der en handling fra administrator side for at skifte dit websted for at forbedre datamodellen eller omvendt.
Eksempel
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e
Genindlæs overført websted fra udvidet til standarddatamodel
Brug følgende kommando til at genindlæse et websted i standarddatamodellen til en forbedret datamodel efter overflytningen:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]
Bemærk
Når du skifter et overført websted fra den forbedrede datamodel tilbage til standarddatamodellen, deaktiveres den webstedspost, der er knyttet til den forbedrede datamodel, og webstedsposten for standarddatamodellen aktiveres igen.
Eksempel
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e
Overføre et produktionswebsted fra standard- til forbedret datamodel
Inden du overfører et produktionssted, anbefales det, at du opretter en komplet kopi af produktionswebstedet. Det anbefales også, at overførslen af et produktionssted foretages i løbet af timer, hvor der ikke er forretning.
Brug disse trin til at overføre dit produktionswebsted til den forbedrede datamodel:
- Prøv at udføre overførslen på webstedet i det kopierede miljø ved hjælp af kommandoen PAC CLI
migrate-datamodel
. - Du kan føje konfigurationsdata for webstedet administreret løsning og importere dets produktionsmiljø.
- Brug PAC CLI-kommandoer til at overføre ikke-konfigurerede data og afslutte dem ved at opdatere datamodelversionen for produktionen.
Bemærk
For migration er kilde og produktionswebsted-id det samme.
Overvejelser om tilpasning af websteder ved overførsel af websteder fra standard til forbedret datamodel
Dette afsnit indeholder en vejledning i, hvordan du reparerer tilpasninger i forbindelse med overførsel af websteder fra standard til forbedret datamodel.
Der findes fem typer tilpasninger af websteder i tabeller med adx-metadata:
- Brugerdefinerede kolonner i tabeller med adx-metadata
- Relation mellem brugerdefinerede tabeller og adx-tabeller
- Adx-tabelreferencer i liquid-kodestykke
- Referencer til adx-tabel i Fetch xml
- Brugerdefinerede arbejdsprocesser og plug-ins på adx-tabeller
Bemærk
Alle tilpasningsrelaterede rettelser foretages efter overflytningen til den forbedrede datamodel.
Brugerdefinerede kolonner i tabeller med adx-metadata
Du kan rette denne tilpasning i en forbedret datamodel ved at oprette en relation mellem systemtabeller og en ny brugerdefineret tabel og overføre dataene til den nye tabel.
Standarddatamodel: Tabellen adx_webpage
indeholder en brugerdefineret kolonne som contoso_pagetype
.
Forbedret datamodel: Opret en ny tabel med navnet contoso_webpage
. Dette omfatter en kolonne, der kaldes contoso_pagetype
, og en opslagskolonne contoso_webpage_id
, der er knyttet til powerpagescomponent
. Brug arbejdsområdet Data til at oprette tabeller.
Relation mellem brugerdefinerede tabeller og adx-tabeller
Du kan rette denne tilpasning i en forbedret datamodel ved at oprette en relation mellem tilpassede tabeller og systemtabeller.
Standarddatamodel: Tabellen adx_webpage
har en relation, der er navngivet adx_webpage_contoso_pagelogs
med contoso_pagelogs
tabellen.
Forbedret datamodel: Opret en ny tabel med navnet powerpagecomponent_contoso_pagelogs
med contoso_webpage
-tabellen. Brug arbejdsområdet Data til at oprette tabeller.
Adx-tabelreferencer i liquid-kodestykke
Du kan løse problemet med denne tilpasning i en forbedret datamodel ved at erstatte referencerne til adx-tabellen i kode for ekstra koder for kode til virtuelle datamodeller ved hjælp af mspp-referencer. Du kan også bruge tabellen Webstedskomponent (logisk navn powerpagecomponent
) sammen med attributten Komponenttype (logisk navn powerpagecomponenttype
) til at hente de tilsvarende referencer.
Standarddatamodel:entities
liquid tag bruges for at få adgang til weblinksværdier i {% assign app_weblinks= entities['adx_weblinks'] %}
kode.
Forbedret datamodel: I stedet for at bruge weblinks via entities
liquid tag, skal du bruge de respektive liquid objekter.
entities[adx_weblinks]
Direkte. I dette tilfælde kan entities['adx_weblinks']
erstattes med en objekt, der gør det nemt at weblinks
bruge objektet.
Referencer til adx-tabel i Fetch xml
Du kan løse problemet med denne tilpasning i en forbedret datamodel ved at erstatte referencerne til fetch-tabellen i kode for ekstra koder for kode til virtuelle datamodeller ved hjælp af direkte referencer. Du kan også bruge tabellen Webstedskomponent (logisk navn powerpagecomponent
) sammen med attributten Komponenttype (logisk navn powerpagecomponenttype
) til at hente de tilsvarende referencer.
Standarddatamodel: Tabelnavnet adx_webrole
bruges i fetch xml-forespørgslen.
{% fetchxml app_webroles %}
<fetch>
<entity name='adx_webrole'>
<attribute name='adx_name'/>
<entity>
</fetch>
{% endfetchxml %}
udvidet datamodel: Brug Webstedskomponent (logisk navn powerpagecomponent
) sammen med Komponenttype (logisk navn powerpagecomponenttype
)-attributten til at hente de tilsvarende referencer.
{% fetchxml app_webroles %}
<fetch>
<entity name='powerpagecomponent'>
<attribute name='adx_name'/>
<filter type='and'>
<condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
<entity>
</fetch>
{% endfetchxml %}
Komponenttype og værdier for websted
Komponenttype | Værdi |
---|---|
Publiceringstilstand | 0 |
Webside | 2 |
Webfil | 3 |
Weblinksæt | 4 |
Weblink | 5 |
Sideskabelon | 6 |
Indholdskodestykke | 7 |
Webskabelon | 8 |
Indstilling for websted | 9 |
Access Control-regel til webside | 10 |
Webrolle | 11 |
Adgang til websted | 12 |
Webstedsmærke | 13 |
Basisformular | 15 |
Metadata i basic formular | 16 |
List | 17 |
Tabeltilladelse | 18 |
Avanceret formular | 19 |
Avanceret formulartrin | 20 |
Metadata i avanceret formular | 21 |
Afstemningssted | 24 |
Reklameplacering | 26 |
Robotforbruger | 27 |
Kolonnetilladelsesprofil | 28 |
Kolonnetilladelse | 29 |
Omdiriger | 30 |
Regel for publiceringstilstandsovergang | 31 |
Genvej | 32 |
Cloudflow | 33 |
UX-komponent | 34 |
Brugerdefinerede arbejdsprocesser og plug-ins på adx-tabeller
Hvis du vil rette denne tilpasning i en forbedret datamodel, skal arbejdsproces- og plug-in-logikken ændres og registreres igen i tabellen for webstedet.
Hvis en bruger f.eks. har registreret arbejdsprocessen/plug-in'en til det primære objekt som Webside (logisk navn adx_webpage
) tabel i standarddatamodellen, skal koden i arbejdsprocessen/plug-in ændres til Webstedskomponent (logisk navn powerpagecomponent
) tabel og attributterne for den forbedrede datamodel.
Kendte problemer
Overførselskommandoen behandler kun en batch af 5K-poster fra standarddatamodellen til den forbedrede datamodel.