Overfør nettsteder for standard datamodell til forbedret datamodell (forhåndsversjon)
[Dette emnet inneholder dokumentasjon for forhåndsversjonen, og kan bli endret.]
Finn ut hvordan du overfører det eksisterende nettstedet for standard datamodell til den forbedrede datamodellen, i denne artikkelen.
Viktig!
- Denne funksjonen er en forhåndsvisningsfunksjon.
- Forhåndsversjonsfunksjonene er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.
Forutsetning
- Du må installere Microsoft Power Platform CLI med versjon 1.31.6 eller nyere for å kunne overføre nettstedene til den forbedrede datamodellen. Mer informasjon: Installer nyeste Power Platform CLI
- Dataverse-basisportalpakke 9.3.2307.x eller nyere.
- Power Pages-kjernepakke 1.0.2309.63 eller nyere. Mer informasjon: Oppdater Power Pages-løsningen
- Du må forstå hvordan du bruker Power Platform CLI i Power Pages, for å kunne fullføre overføringstrinnene. Hvis du ikke har erfaring med Power Platform CLI i Power Pages, kan du gå gjennom denne Power Platform CLI-opplæringen og referere til PAC CLI-kommandoene for arbeid med Power Pages.
Trinn 1. Last ned og se etter eksisterende metadata for standard nettsted i tilpassingen
Åpne en ledetekst.
Bruk følgende kommando til å godkjenne Dataverse-organisasjonen for Power Platform-miljøet for å laste ned webområdeoppføringen for overføring.
pac auth create -u [Dataverse URL]
Eksempel
pac auth create -u https://contoso-org.crm.dynamics.com
Mer informasjon: pac auth create
Bruk følgende kommando til å generere en liste over nettsteder i gjeldende organisasjon.
pac powerpages list
Mer informasjon: pac powerpages list
Bruk følgende kommando til å laste ned tilpassingsrapporten.
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 finner tilpassinger i den nedlastede rapporten, følger du veiledningen i rapporten for å rette den etter overføringen til den forbedrede datamodellen. Mer informasjon: Hensyn ved tilpassing av nettsted når nettsteder overføres fra standard til forbedret datamodell
Trinn 2. Overfør nettstedsdataene fra standard til forbedret datamodell
Bruk kommandoen nedenfor til å overføre nettstedsdataene til den forbedrede datamodellen.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]
Mode kan ha tre verdier:
configurationData: migrer metadataene for nettstedet. Mer informasjon: Liste over tabeller for lagring av konfigurasjonsdata
configurationDataReferences: Overfør transaksjonsdataene for nettstedet. Mer informasjon: Liste over tabeller for lagring av ikke-konfigurasjonsdata
Alle: Overfør begge datatypene.
Eksempel
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all
Overføringsverktøyet verifiserer løsningene. Hvis det finnes en løsning for standard datamodell uten en respektiv løsning for en forbedret datamodell for den nevnte malen, vises en advarsel: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template
Det finnes bestemte maler, for eksempel Programregistrering og Planlegg og administrer møter, som krever samsvarende pakker med forbedret datamodell for å sikre at det overførte nettstedet fungerer som det skal. Hvis du vil hente disse pakkene med forbedret datamodell, må du opprette et nytt nettsted for den tilsvarende malen (miljøet må aktiveres for den forbedrede datamodellen) for å kunne levere løsninger for overføring som er kompatible med den forbedrede datamodellen.
Støttede maler for overføring
Nettsteder med følgende maler støttes for overføring:
- Startoppsett 1–5
- Programbehandling
- Tom side
- Programregistrering
- Planlegg og administrer møter
Trinn 3. Bekreft overføringsstatusen
Bruk følgende kommando til å bekrefte overføringsstatusen for nettstedet:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus
Eksempel
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus
Merk
Hvis områdeoverføringen tar lengre tid enn forventet, kan det skyldes mengden data. Hvis ledeteksten lukkes, åpner du en ny ledetekst og bruker kommandoen i dette trinnet til å bekrefte statusen til nettstedet.
Trinn 4. Oppdater datamodellversjonen for nettstedet etter at dataoverføringen er fullført
Bruk følgende kommando til å oppdatere datamodellversjonen for nettstedet:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]
Merk
- Du finner portal-ID-en ved å gå til nettstedet med «/_services/about» tilføyd i nettadressen til nettstedet. Brukeren må ha en nettrolle med alle tilgangstillatelser for nettsted tilordnet for å kunne vise disse alternativene.
- Etter at datamodellversjonen for nettstedet er oppdatert, deaktiveres nettstedsoppføringen som er koblet til standard datamodell. Nettstedet refererer nå i stedet til nettstedsoppføringen som er knyttet til den forbedrede datamodellen.
- Brukeren må ha en av følgende roller for å kunne kjøre overføringskommandoen med argumentet
updateDatamodelVersion
ellerrevertToStandardDataModel
. Siden dette utfører en administratorhandling for å bytte nettstedet til den forbedrede datamodellen eller omvendt.
Eksempel
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e
Gjenopprett overført nettsted fra forbedret til standard datamodell
Bruk følgende kommando for å gjenopprette et nettsted for forbedret datamodell til en standard datamodell etter overføring:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]
Merk
Når du bytter et overført nettsted fra den forbedrede datamodellen tilbake til standard datamodell, deaktiveres nettstedsoppføringen som er knyttet til den forbedrede datamodellen, og nettstedsoppføringen for standard datamodell aktiveres på nytt.
Eksempel
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e
Overfør et produksjonsnettsted fra standard til forbedret datamodell
Før du overfører et produksjonsnettsted anbefaler vi at du oppretter en fullstendig kopi av produksjonsnettstedet. Vi anbefaler også at overføring av produksjonsnettstedet utføres utenfor arbeidstiden.
Følg disse trinnene for å overføre produksjonsnettstedet til den forbedrede datamodellen:
- Prøv overføringen på nettstedet i det kopierte miljøet ved hjelp av PAC CLI-kommandoen
migrate-datamodel
. - Legg til konfigurasjonsdata for nettsted i administrert løsning, og importer dem i produksjonsmiljøet.
- Bruk PAC CLI-kommandoer til å overføre ikke-konfigurasjonsdata, og fullfør dem ved å oppdatere datamodellversjonen for produksjon.
Merk
Når det gjelder overføring, er ID-en for kilde- og produksjonsnettsted den samme.
Hensyn ved tilpassing av nettsted når nettsteder overføres fra standard til forbedret datamodell
Denne delen inneholder veiledning for hvordan du retter tilpassing for en nettstedsoverføring fra standard til forbedret datamodell.
Det finnes fem typer nettstedstilpassinger for adx-metadatatabeller:
- Egendefinerte kolonner i adx-metadatatabeller
- Relasjon mellom egendefinerte tabeller og adx-tabeller
- Adx-tabellreferanser i flytende kodesnutt
- Adx-tabellreferanser i fetch xml
- Tilpasset arbeidsflyt og plugins på adx-tabeller
Merk
Alle tilpassingsrelaterte rettelser blir gjort etter overføring til den forbedrede datamodellen.
Egendefinerte kolonner i adx-metadatatabeller
Hvis du vil rette denne tilpassingen i en forbedret datamodell, oppretter du en relasjon mellom systemtabeller og en ny egendefinert tabell og overfører dataene til den nye tabellen.
Standard datamodell: Tabellen adx_webpage
inneholder en egendefinert kolonne som contoso_pagetype
.
Forbedret datamodell: Opprett en ny tabell med contoso_webpage
navn. Denne inneholder en kolonne kalt contoso_pagetype
og oppslagskolonnen contoso_webpage_id
som er knyttet til powerpagescomponent
. Bruk dataarbeidsområdet til tabellopprettelse.
Relasjon mellom egendefinerte tabeller og adx-tabeller
For å rette denne tilpassingen i en forbedret datamodell oppretter du en relasjon mellom egendefinerte tabeller og systemtabeller.
Standard datamodell: Tabellen adx_webpage
har en relasjon som er navngitt adx_webpage_contoso_pagelogs
contoso_pagelogs
med tabellen.
Forbedret datamodell: Opprett en ny relasjon med powerpagecomponent_contoso_pagelogs
navnet på contoso_webpage
tabellen. Bruk dataarbeidsområdet til tabellopprettelse.
Adx-tabellreferanser i Liquid-kodesnutt
Du kan rette denne tilpassingen i den forbedrede datamodellen ved å erstatte adx-tabellreferansene i Liquid-koden med mspp-referanser for virtuelle datatabeller i den forbedrede datamodellen. Du kan alternativt bruke tabellen Nettstedskomponent (logisk navn er powerpagecomponent
) sammen med attributtet Komponenttype (logisk navn er powerpagecomponenttype
) til å hente de tilsvarende referansene.
Standard datamodell:entities
flytende tag brukes til å få tilgang til weblinkverdier i {% assign app_weblinks= entities['adx_weblinks'] %}
kode.
Forbedret datamodell: I stedet for å bruke nettlenker via entities
flytende tag, bruk respektive flytende objekter. entities[adx_weblinks]
direkte. I dette tilfellet kan entities['adx_weblinks']
erstattes med Liquid-objektet weblinks
.
Adx-tabellreferanser i FetchXML
Du kan rette denne tilpassingen i den forbedrede datamodellen ved å erstatte adx-tabellreferansene i FetchXML med direkte referanser for virtuelle datatabeller i den forbedrede datamodellen. Du kan alternativt bruke tabellen Nettstedskomponent (logisk navn er powerpagecomponent
) sammen med attributtet Komponenttype (logisk navn er powerpagecomponenttype
) til å hente de tilsvarende referansene.
Standard datamodell: Tabellnavnet adx_webrole
brukes i fetch xml-spørringen.
{% fetchxml app_webroles %}
<fetch>
<entity name='adx_webrole'>
<attribute name='adx_name'/>
<entity>
</fetch>
{% endfetchxml %}
Forbedret datamodell: Bruk Site Component (logisk navn ) sammen med attributtet powerpagecomponent
Komponenttype (logisk navn ) for å hente de powerpagecomponenttype
tilsvarende referansene.
{% fetchxml app_webroles %}
<fetch>
<entity name='powerpagecomponent'>
<attribute name='adx_name'/>
<filter type='and'>
<condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
<entity>
</fetch>
{% endfetchxml %}
Nettstedskomponenttype og -verdier
Komponenttype | Verdi |
---|---|
Publiseringstilstand | 1 |
Nettside | 2 |
Webfil | 3 |
Webkoblingssett | 4 |
Nettkobling | Fem |
Sidemal | 6 |
Innholdssnutt | 7 |
Nettmal | 8 |
Nettstedinnstilling | 9 |
Tilgangskontrollregel for nettside | 10 |
Nettrolle | 11 |
Nettstedstilgang | 12 |
Områdemarkør | 13 |
Standardskjema | 15 |
Metadata for standardskjema | 16 |
List | 17 |
Tabelltillatelse | 18 |
Avansert skjema | 19 |
Avansert skjematrinn | 20 |
Metadata for avansert skjema | 21 |
Avspørringsplassering | 24 |
Annonseplassering | 26 |
Robotforbruker | 27 |
Profil for kolonnetillatelse | 28 |
Kolonnetillatelse | 29 |
Omdiriger | 30 |
Overføringsregel for publiseringstilstand | 31 |
Snarvei | 32 |
Skyflyt | 33 |
Brukeropplevelseskomponent | 34 |
Egendefinert arbeidsflyt og programtillegg i adx-tabeller
For å kunne rette denne tilpassingen i en forbedret datamodell må logikken i arbeidsflyten og programtillegget refaktoreres og registreres på nytt i den respektive tabellen på nettstedet.
Hvis en bruker for eksempel registrerte arbeidsflyten/programtillegget i Hovedenhet som tabellen Nettside (logisk navn er adx_webpage
) i standard datamodell, må koden i arbeidsflyten/programtillegget endres til tabellen Nettstedskomponent (logisk navn er powerpagecomponent
) og attributtene for den forbedrede datamodellen.
Kjente problemer
Overføringskommandoen behandler bare et parti med 5000 oppføringer fra standard datamodell til den forbedrede datamodellen.