Oversikt over overføring av standard til forbedret datamodell

Det Microsoft Power Platform CLI-overføringsverktøyet flytter en eksisterende Power Pages områdets støttede konfigurasjon og relaterte poster fra standard datamodell til den forbedrede datamodellen, og bytter deretter nettstedet til å bruke den overførte konfigurasjonen.

Standard datamodell lagrer Power Pages områdekonfigurasjon på tvers av tabeller som bruker prefikset adx_. Den forbedrede datamodellen lagrer områdekonfigurasjon i områdekomponenttabellen (powerpagecomponent) og identifiserer hver komponent etter komponenttypen. Å forstå hvordan overføringsverktøyet fungerer, hvilke maler det støtter, og hvilke tilpasninger det ikke oppdateres automatisk, hjelper deg med å bestemme når og hvordan du flytter et nettsted.

Gjennomgang av de forbedrede datamodellfordelene forklarer hvorfor du kan vurdere å overføre et nettsted.

Det er viktig å være oppmerksom på at ikke alle adx_* tabeller flyttes til powerpagecomponent. Bare metadataene adx_* tabeller – de som beskriver strukturen og redigeringsoverflaten for området, for eksempel adx_webpage, , adx_webtemplate, adx_contentsnippetadx_sitesetting, adx_pagetemplate, adx_weblink, adx_entityformog adx_entitylist – konsolideres til powerpagecomponent (med egenskapene per rad flyttet inn i JSON-kolonnen for innhold).

Transaksjons- og kjøretidstabellene adx_* – de som registrerer sluttbrukeraktivitet under kjøring, for eksempel adx_invitation, , adx_inviteredemptionadx_portalcomment, adx_externalidentityog enhetsskjemaet / innsending av avansert skjema og loggtabeller – overføres ikke til powerpagecomponent. de forblir på eksisterende skjemaer og fortsetter å lagre kjøretidsdata som før. Hvilke endringer for disse transaksjonstabellene er at oppslagene til metadatapostene blir koblet på nytt under referanseoverføringen, slik at de peker på de nye powerpagecomponent radene i stedet for de eldre metadataene adx_* rader.

Eksisterende nettsteder som er forfattet på standard datamodell, fortsetter å kjøre på adx_*-tabeller, så hvert område må overføres for å dra nytte av forbedret datamodell. Migreringen flytter nettstedets konfigurasjonsmetadata til formen til den forbedrede datamodellen powerpagecomponent, knytter transaksjonsreferanser om til disse nye metadatapostene og oppdaterer nettstedsposten slik at den bruker den forbedrede datamodellen. Det er også her tilpasninger – egendefinerte adx_*-kolonner, Væske som leser adx_*-attributter, FetchXML over adx_*-tabeller, plugin-moduler og arbeidsflyter – vises og utbedres, fordi disse tilpasningene ikke overføres automatisk og må skrives om eller omstruktureres for å fungere mot forbedret datamodell.

Forutsetninger

  • Microsoft Power Platform CLIversjon 2.11.2 eller nyere, som kjører kommandoene nedlasting, overføring, status, aktivering og tilbakerulling av nettstedet. Hvis du vil ha mer informasjon, kan du se Installere nyeste Power Platform CLI.
  • Datavers baseportalpakke CDSBasePortal9.3.2607.x eller nyere, som gir de nødvendige grunnportalkomponentene.
  • Power Pages Core-pakke PowerPages_Core1.0.2605.x eller nyere, som gir de nødvendige Power Pages kjøretidskomponentene. Oppdater løsningen Power Pages.
  • Systemansvarlig, Dynamics 365 administrator eller administratorrolle for Power Platform, som kreves for å bytte eller tilbakestille den aktive datamodellen.
  • Kjennskap til Power Platform CLI for Power Pages.
  • Bakgrunnsoperasjoner aktivert hvis miljøet er i administrasjonsmodus.

Funksjoner for overføringsverktøy

Overføringsverktøyet kopierer støttet områdekonfigurasjon og relaterte poster til den forbedrede datamodellen. Når overføringen er fullført, bytter det aktive området til den forbedrede datamodellen og valideres før den går tilbake til normal bruk.

Overføringsverktøyet:

  • Genererer en rapport med tilpassinger som kan kreve manuelle endringer.
  • Overfører støttet områdekonfigurasjon og relaterte poster.
  • Lar deg kontrollere overføringsstatusen før du bytter den aktive datamodellen.
  • Lar deg tilbakestille området til standard datamodell hvis validering identifiserer et kritisk problem.

Viktig!

Overføringsverktøyet oppdaterer ikke automatisk alle tilpasninger som er direkte avhengige av standard datamodelltabeller. Se gjennom tilpassingsrapporten, korriger berørt egendefinert kode, og test det overførte området før produksjonsbruk.

Støttede maler

Du kan overføre eksisterende standard datamodellområder som ble opprettet fra følgende maler:

  • Startoppsett 1–5
  • Programbehandling
  • Tom side
  • Programregistrering
  • Planlegg og administrer møter
  • vanlige spørsmål
  • Fellesskapsportal (Dynamics 365)
  • Customer Self-Service Portal (Dynamics 365)
  • Employee Self-Service Portal (Dynamics 365)
  • Partnerportal (Dynamics 365)

Notat

Oppretting av nye områder med den forbedrede datamodellen og overføring av eksisterende områder er separate funksjoner. Hvis et nettsteds opprinnelige mal ikke er oppført her, må du ikke kjøre migreringsverktøyet for dette nettstedet.

Før du begynner

Flere planleggingshensyn:

  • Innstillingen Bytt til forbedret miljø for datamodell styrer datamodellen som brukes for nye områder. Når du aktiverer innstillingen, overføres ikke eksisterende områder.
  • Kjør overføringen først i en fullstendig kopi av produksjonsmiljøet. Fullfør tilpassingsutbedring og validering før overføring.
  • Bruk organisasjonens standard sikkerhetskopierings- og gjenopprettingsprosess for å sikkerhetskopiere produksjonsmiljøet.
  • Planlegg et vedlikeholdsvindu for den endelige produksjonsbryteren og valideringen.
  • Registrer nettsteds-ID, portal-ID, nettadresse for miljø, CLI-versjon, pakkeversjoner, starttidspunkt for overføring og kommandoutdataskjema som en del av overføringsposten.

Planlegge miljøsekvensen

Overføring støtter ulike miljøer, med forskjellig modus for hvert miljø.

Miljø Anbefalt modus Hva du gjør
Utvikling configurationData Overfør konfigurasjon, se gjennom tilpassingsrapporten, utbedr tilpasninger, valider og oppfang konfigurasjonen i en løsning.
Test eller UAT configurationDataReferences Importer den testede løsningen fra utvikling, overfør støttede relaterte poster, aktiver den forbedrede datamodellen og valider.
Produksjon configurationDataReferences Importer den validerte administrerte løsningen, overfør støttede relaterte poster, aktiver under vedlikeholdsvinduet og fullfør produksjonsvalidering.
Enkelt miljø eller enkelt nettsted all Overfør konfigurasjon og relaterte poster bare i én operasjon når du forstår tilpassingsinnvirkningen og ikke bruker løsningsbanen for flere miljøer.

Opprette en arbeidsmappe

Bruk en tom arbeidsmappe til å holde rapporter, nedlastede nettstedskilder og sammenligningsfiler. Eksemplene nedenfor brukes \<OUTPUT\> for denne plasseringen.

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

Migrasjonsfaser

Overføringsprosessen består av fire faser:

  1. Forhåndskontroller – kontroller området, ID-ene, CLI-en, pakkene, malløsningen og overføringsstatusen.
  2. Konfigurasjon – Overfør konfigurasjon i utvikling eller importtestet konfigurasjon i nedstrømsmiljøer.
  3. Overfør og aktiver – Overfør relaterte poster, bekreft fullføring, bytt modeller og start på nytt.
  4. Valider – Test virkemåte, tillatelser, egendefinert kode og malreiser.

Skjermbilde av et flytskjema som viser standarden for forbedret overføringsprosess for datamodell.

Fase 1 (områdeoppdagelse og forhåndskontroller) og fase 4 (validering etter overføring) kjører på samme måte for hvert område.

Fase 2 og fase 3 er sporforgrenede – figuren avhenger av overføringsmodusen, som henter sporet fra miljøtypen.

Redigeringsspor (modus configurationData eller all) brukes til utvikling og enkeltmiljøoppsett. Selve metadataene overføres lokalt, og tilpasninger skannes og løses mot standard datakilden før transaksjonsreferansene flyttes.

Nedstrømsspor (modusconfigurationDataReferences) brukes for test-, UAT- og produksjonsmiljøer der konfigurasjonsmetadata antas å ha kommet via ALM-løsningsimport fra Utvikling. Bare transaksjonsreferanser overføres i dette sporet. Eventuelle tilpasningsfunn indikerer et oppstrøms ALM-gap i stedet for arbeid du bør gjøre lokalt.

Fase 1: Forhåndskontroller

  1. Kontroller Power Platform CLI-versjonen med pac --version. Hvis din versjon er tidligere enn den nødvendige versjonen, må du installere eller oppdatere Microsoft Power Platform CLI før du fortsetter.

  2. Autentiser mot målmiljøet.

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

  3. Bekreft at den aktive godkjenningsprofilen peker til miljøet som inneholder området. Hvis du vil velge en annen profil eller opprette en profil, bruker pac auth select du eller pac auth create -u "https://contoso.crm.dynamics.com".

  4. Installer løsninger for forbedret datamodell for malen ved hjelp av én av følgende metoder:

    1. Klargjør et område av malen med utvidet datamodellflagg (EDM) aktivert i administrasjonssenteret.
    2. Bruk CLI til å installere med kommandoen pac application install --application-name "PowerPages_PartnerPortal_V2"

  5. Finn området og registrer identifikatorene med pac pages list -v.

  6. Registrer verdiene som vises i tabellen nedenfor.

    Verdi Brukes til
    Nettsteds-ID Alle migrate-datamodel kommandoer.
    Portal-ID Bytte til den forbedrede datamodellen og gå tilbake til standard datamodell.
    Egendefinert navn og URL-adresse Bekrefter at du valgte riktig område i administrasjonssenteret.
    Datamodellversjon Må være Standard. Hvis den allerede er forbedret, er ikke overføring nødvendig.

    Viktig!

    Portal-ID-en er ikke Power Pages app-ID. Hvis cli ikke viser portal-ID-en, er den tilgjengelig i administrasjonssenteret for Power Platform under Ressurser>Power Pages områdedetaljer>, eller føy/_services/about til nettadressen for nettstedet mens den er logget på med de nødvendige tilgangstillatelsene for nettstedet.

  7. Se etter en tidligere eller pågående overføring med følgende kommando:

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus
    Status Betydning Aksjon
    NotStarted eller ingen sporingsenhet Ingen overføring har startet. Fortsett med pakkekontrollene.
    Tilbakeført En tidligere overføring ble rullet tilbake. Se gjennom hvorfor den ble gjenopprettet, og fortsett deretter når du er klar.
    Fullført Overføringen er fullført, men området er kanskje ikke byttet. Bekreft den aktive datamodellen. Hvis det fremdeles er Standard, fortsetter du med aktivering.
    Kjører Overføringen behandles fortsatt. Fortsett å sjekke statusen. Ikke start en ny overføring for samme område.
    Mislyktes Det oppstod en feil under overføringen. Samle inn informasjon om kommandoutdata og miljø, rett årsaken, og prøv på nytt først etter at feilen er forstått.

    Notat

    Hvis en overføring fremdeles kjører lenger enn forventet, trenger du nettsteds-ID, miljø-ID, CLI-versjon, pakkeversjoner, kommandoutdata og overføringsstarttidspunkt før du kontakter Microsoft kundestøtte. En aktiv migrering bør ikke tilbakestilles med mindre brukerstøtte eller en godkjent runbook ber om det.

  8. Kontroller nødvendige førstepartspakker med pac solution list --includeSystemSolutions.

    1. Bekreft at CDSBasePortal, PowerPages_Coreog EDM-løsningene for områdets mal er installert i de nødvendige versjonene.

  9. Hvis en pakke mangler eller er utdatert, kan du oppdatere den fra administrasjonssenteret for Power Platform:

    1. Åpne målmiljøet.
    2. Gå til Ressurser>Dynamics 365 apper.
    3. Finn den nødvendige pakken.
    4. Velg Installer eller oppgrader.
    5. Vent til operasjonen er fullført, og kjør deretter på pac solution list --includeSystemSolutions nytt.

    Notat

    Hvis malløsningen EDM ikke er tilgjengelig for direkte installasjon, installerer oppretting av et midlertidig forbedret datamodellområde i samme miljø med samme mal den samsvarende EDM-løsningen. Du kan slette det midlertidige området etter at løsningen er bekreftet.

  10. Generer tilpassingsrapporten med pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Generering av rapporten endrer ikke området.

  11. Åpne den genererte CSV-filen, og se gjennom hvert element som refererer til standard datamodelltabeller. Tilordne et eier- og valideringstrinn for alle nødvendige utbedringer før produksjonsoverføring.

    Tilpassingskategori Plan
    Egendefinerte kolonner i adx_ metadatatabeller Flytt de egendefinerte dataene til en egendefinert tabell som støttes, relatert til powerpagecomponent.
    Relasjoner til adx_ metadatatabeller Opprett relasjonen på nytt mot den støttede, forbedrede datamodelltabellen.
    Liquid- eller FetchXML-referanser til adx_ tabeller Oppdater kode for å bruke støttede flytende objekter, virtuelle tabeller eller powerpagecomponent.
    Arbeidsflyter og plugin-moduler på adx_ tabeller Refaktorer og registrer logikken mot støttede forbedrede datamodelltabeller.

    Notat

    En tilpassingsrapport beviser ikke at all virkemåte for området fungerer etter overføringen. validering kreves fortsatt.

  12. Velg overføringsmodus for å finne ut hva verktøyet overfører i én enkelt operasjon.

    Modus Hva den overfører Når du bør bruke den
    konfigurasjonsdata Støttede metadata for områdekonfigurasjon, for eksempel sider, nettmaler, snutter, innstillinger, skjemaer, lister, nettroller og tabelltillatelser. Utvikling, der du utbedrer konfigurasjonen og flytter den gjennom løsninger.
    konfigurasjonsdatareferanser Støttede poster som refererer til overført områdekonfigurasjon. Test, UAT og produksjon etter at områdekonfigurasjonen kommer gjennom en løsningsimport.
    alt Både konfigurasjon og relaterte poster som støttes. Et enkelt miljø eller en enkel overføring som ikke bruker den løsningsbaserte miljøsekvensen.

Fase 2: Områdekonfigurasjon

Redigeringsspor: Utvikling eller ett enkelt miljø

  1. Last ned en SDM-grunnlinje ved å kjøre pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Kommandoen oppretter en underordnet mappe med navnet på området. Registrer mappen som inneholder website.ymldirekte.

  2. Overfør områdekonfigurasjon ved å kjøre pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Hvis du vil bruke stien med én operasjon, erstatter du configurationData med all.

  3. Kontroller overføringsstatus ved å kjøre pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Bruk følgende PowerShell-løkke til å kontrollere status én gang per minutt i opptil 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 statusen fremdeles kjører, fortsetter kontrollen med --checkMigrationStatus. En langvarig operasjon er ikke nødvendigvis en mislykket operasjon.

  4. Utbedr rapporterte tilpasninger ved hjelp av tilpassingsrapporten og veiledningen i denne artikkelen for å oppdatere berørte FetchXML, Liquid, egendefinerte kolonner, relasjoner, arbeidsflyter og plugin-moduler. Test hver endret komponent på nytt. Hvis du oppdaterer den nedlastede kilden, laster du opp områdemappen som inneholder website.yml direkte ved å kjøre pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.

Nedstrøms spor: Test, UAT eller produksjon

  1. Importer løsningen som inneholder den overførte og utbedrede områdekonfigurasjonen. Bruk administrasjonssenteret for Power Platform eller det etablerte datasamlebåndet for distribusjon.

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

  2. Bekreft at områdekonfigurasjonen finnes ved å åpne Power Pages Management-appen i målmiljøet. Områdeposten og den forventede konfigurasjonen må være til stede før relaterte poster overføres.

  1. Overfør relaterte oppføringer som støttes. Hvis du allerede har brukt --mode all, kan du hoppe over dette trinnet. Kontroller statusen til den er fullført.

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

  2. Når overføringsstatusen er fullført, bytter du det aktive området til den forbedrede datamodellen. Standardoppføringen for datamodellnettstedet deaktiveres, og den tilsvarende forbedrede nettstedsposten for datamodellen blir aktiv.

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

  3. Start nettstedet på nytt.

    1. Åpne Power Platform-administrasjonssenteret.
    2. Gå til miljøet, og velg deretter Ressurser>Power Pages områder.
    3. Velg området.
    4. Velg Start på nytt. Hvis Omstart ikke er tilgjengelig, deaktiverer du og aktiverer deretter området.
    5. Vent til operasjonen er fullført før validering.

  4. Bekreft den aktive datamodellen ved hjelp av én eller flere av disse metodene:

    1. Velg nettstedet i administrasjonssenteret for Power Platform, og bekreft at datamodellen viser Forbedret.
    2. Åpne arbeidsområdet for installasjon av området i Power Pages utformingsstudio, og bekreft den viste datamodellen.
    3. Bekreft at avansert konfigurasjon åpnes i Power Pages Management-appen.
    4. Kjør pac pages list -v og bekreft datamodellversjonen.

    Tips

    Nettadressen for nettstedet og utformingen av visualobjektet endres ikke bare fordi den aktive datamodellen ble endret. Hvis du vil bekrefte overføringen, bruker du disse kontrollene , ikke nettstedets utseende.

Fase 4: Validere det overførte området

Fullfør valideringen før du åpner et produksjonsnettsted på nytt for brukere. Bruk testkontoer for hver viktige brukertype og nettrolle, og registrer resultatet av hver kritiske test.

Område Hva du skal validere
Sider og innhold Hjemmeside, representative innholdssider, nettmaler, innholdssnutter, nettfiler, navigasjon, omadresseringer og flerspråklig innhold.
Authentication Pålogging, avlogging, registrering, invitasjoner, eksterne identitetsleverandører og opplevelser ved nektet tilgang.
Autorisasjon Nettroller, tabelltillatelser, kolonnetillatelser og sidetilgangsregler tillater og avslår de forventede handlingene.
Skjemaer og lister Grunnleggende skjemaer, skjemaer med flere trinn, lister, skjemametadata, innsendinger, relaterte poster og nettskjemaøkter som brukes av området.
Dynamics 365 malreiser Hovedkunde-, ansatt-, fellesskaps- eller partnerreisene som brukes av implementeringen, inkludert malspesifikke sider og tilgangsmønstre.
Egendefinert kode Væske, FetchXML, JavaScript, plugin-moduler, arbeidsflyter og integreringer identifisert i tilpassingsrapporten.
Innstillinger og filer for nettsted Nettstedsinnstillinger, bilder, vedlegg, SVG-filer og andre nettfiler lastes inn på riktig måte.
Data og referanser Viktige antall oppføringer og støttede relaterte oppføringer peker til de riktige migrerte nettstedskomponentene.
Administrasjon og ALM Nettstedet åpnes i Power Pages Management og kan legges til, eksporteres inn og importeres fra løsninger som forventet.

Kontrollere nettleserdiagnose

Åpne utviklerverktøyene for nettleseren mens du tester representative sider. Undersøk:

  • Konsollfeil som nevner adx\_, enheter, væske eller FetchXML.
  • HTTP 401- eller 403-svar fra \_api, som kan indikere et tillatelses- eller nettrolleproblem.
  • HTTP 500-svar, som kan indikere en væske-, FetchXML-, plugin-modul- eller integreringsfeil.

Fullføringskriterier for migrering

Vurder overføringen bare når nettstedet viser den forbedrede datamodellen, kritiske forretningsreiser passerer, forventet sikkerhetsatferd bekreftes, og alle tilpasningsfunn med høy effekt løses eller godtas.

Produksjonsoverføringssekvens

Bruk følgende produksjonssekvens for å redusere overføringsrisikoen:

  1. Opprett en fullstendig kopi av produksjonsmiljøet for innøving.
  2. Bekreft forutsetninger for CLI, pakke og malløsning i det kopierte miljøet.
  3. Generer og se gjennom tilpassingsrapporten.
  4. Overfør konfigurasjon i det kopierte utviklingsmiljøet.
  5. Utbedr tilpassinger og oppfang den validerte områdekonfigurasjonen i en administrert løsning.
  6. Importer løsningen til innøvingsmiljøet, overfør støttede relaterte poster, aktiver den forbedrede datamodellen og fullfør den fullstendige valideringskontrollisten.
  7. Gjenta utbedring og innøving til alle kritiske tester består.
  8. Planlegg vedlikeholdsvinduet for produksjon, kommuniser beslutningspunkter for validering og tilbakerulling og sikkerhetskopier produksjon.
  9. Bekreft forutsetningene for produksjonspakken og malløsningen på nytt.
  10. Importer den validerte administrerte løsningen til produksjon.
  11. Kjør configurationDataReferences, kontroller overføringsstatus, bytt den aktive datamodellen, og start området på nytt.
  12. Kjør sjekklisten for produksjonsvalidering, og returner området til normal bruk bare etter at kritiske tester består.

Tilbakestille et overført område til standard datamodell

Hvis validering identifiserer et kritisk problem etter aktivering, bruker du følgende kommando til å aktivere standardoppføringen for datamodellnettstedet på nytt:

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

Etter at kommandoen er fullført:

  1. Start nettstedet på nytt fra administrasjonssenteret for Power Platform.
  2. Bekreft at nettstedet viser Standard som den aktive datamodellen.
  3. Kjør områdets kritiske valideringstester på nytt.
  4. Behold overføringsrapporten, feildetaljene og utbedringsnotatene før du prøver en annen overføring.

Viktig!

Planlegg tilbakerullingsbeslutningen før produksjonsoverføring. Se gjennom endringer som er gjort etter den forbedrede datamodellbryteren før du går tilbake, fordi standard- og forbedrede nettstedsposter er separate poster.

Troubleshooting

Melding eller symptom Sannsynlig årsak Aksjon
pac powerpages migrate-datamodel gjenkjennes ikke Kommandoen bruker feil navneområde eller en utdatert CLI. Oppdater Power Platform CLI og bruk pac pages migrate-datamodel.
CDSBasePortal eller PowerPages_Core er ikke oppført Systemløsninger ble ikke inkludert i kommandoutdataene, eller pakken er ikke installert. Kjør pac solution list --includeSystemSolutions. Installer eller oppgrader den manglende pakken fra administrasjonssenteret for Power Platform.
Nettstedet støttes ikke for overføring Den opprinnelige malen støttes ikke, pakkeversjoner er utilstrekkelige, eller den samsvarende EDM-malløsningen mangler. Bekreft malkvalifisering, pakkeversjoner og EDM-løsningen som er oppført i malløsningsreferansen.
Et ukjent argument --webSiteId ble sendt for pac pages upload Opplastingskommandoen godtar ikke argumentet for nettsteds-ID. Utelate argumentet. Området identifiseres fra website.yml.
Opplasting er rettet mot feil område eller finner ikke området Banen peker til wrapper-mappen i stedet for områdemappen. Bruk den underordnede mappen som inneholder website.yml direkte.
Portal-ID-en viser Unknown eller N/A Området er inaktivt, eller den installerte CLI returnerer ikke verdien. Få portal-ID-en fra administrasjonssenteret /_services/about for Power Platform eller siden til nettstedet. Ikke bruk app-ID-en.
Migreringsrapportene Completed, men nettstedet viser fortsatt Standard Den aktive datamodellen ble ikke byttet, eller feil portal-ID ble brukt. Kjør aktiveringskommandoen med nettsteds-ID-en og riktig portal-ID, og start deretter på nytt og bekreft området.
Statusen forblir Running Overføringen behandler et stort datavolum eller blokkeres. Fortsett å sjekke statusen. Samle inn miljø-, pakke-, CLI-, start- og kommandodetaljer før du kontakter kundestøtte. Ikke start en ny overføring.
Status er Failed En pakke-, mal-, tilpassings-, data- eller tjenestefeil stoppet operasjonen. Lagre hele kommandoutdataene, korriger den identifiserte årsaken, og prøv på nytt bare etter å ha gjennomgått den mislykkede overføringstilstanden.
Området åpnes, men brukere får ikke tilgang til forventede data Nettroller, tabelltillatelser eller egendefinerte spørringer fungerer ikke som forventet etter overføring. Se gjennom nettroller, tabelltillatelser, kolonnetillatelser, FetchXML-, Liquid- og nettlesernettverksfeil.

Vurdering for områdetilpasninger

Tilpassingsrapporten identifiserer direkte avhengigheter for standard datamodelltabeller. Fullfør nødvendig utbedring før produksjonsbruk.

Egendefinerte kolonner i metadatatabeller

Hvis en standard datamodelltabell, for eksempel adx_webpage inneholder en egendefinert kolonne, oppretter du en egendefinert tabell for å lagre de egendefinerte dataene og legge til et oppslag i powerpagecomponent. Overfør de egendefinerte verdiene til den nye tabellen, og oppdater kode som leser eller skriver kolonnen.

Relasjoner mellom egendefinerte tabeller og metadatatabeller

Opprett egendefinerte relasjoner som peker til adx_ tabeller, slik at de peker til riktig forbedret datamodelltabell, vanligvis powerpagecomponent. Oppdater avhengige skjemaer, visninger, plugin-moduler, flyter og integreringer.

Flytende referanser til metadatatabeller

Erstatt direkte entities['adx_*'] tilgang med et støttet liquid-objekt der det finnes. Bruk for eksempel weblinks Liquid-objektet i stedet for direkte spørring adx_weblinkset eller relaterte tabeller. Se gjennom hver bruk fordi det returnerte objektet og tilgjengelige attributter kan variere.

FetchXML-referanser til metadatatabeller

Erstatt direkte adx_ enhetsreferanser med den tilsvarende virtuelle tabellen eller spørringen powerpagecomponent og filtrer etter powerpagecomponenttype

Eksempel på standard datamodell:

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

Eksempel på forbedret 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>

Egendefinerte arbeidsflyter og plugin-moduler

Refaktorer egendefinert arbeidsflyt og plugin-logikk registrert i adx_ tabeller. Registrer den oppdaterte logikken i riktig forbedret datamodelltabell, og bruk det forbedrede skjemaet og attributtene. Test funksjonaliteten for oppretting, oppdatering, sletting og sikkerhet i et ikke-produksjonsmiljø.

Kommandoreferanse

Formål Kommando
Kontroller CLI-versjon pac --version
Liste over godkjenningsprofiler pac auth list
Opprette en godkjenningsprofil pac auth create -u "<ENV_URL>"
List opp nettsteder og identifikatorer pac pages list -v
Listesystemløsninger pac solution list --includeSystemSolutions
Sjekk migreringsstatus pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus
Last ned SDM-kilde pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"
Last ned EDM-kilde pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"
Generer tilpassingsrapport pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"
Overfør konfigurasjon pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData
Migrere relaterte oppføringer pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences
Overføre begge kategoriene pac pages migrate-datamodel --webSiteId "<ID>" --mode all
Last opp områdekilde pac pages upload --path "<SITE_ROOT>" --modelVersion 1
Aktiver EDM pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
Gå tilbake til SDM pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Referanse for komponenttyper på nettsted

Når du spør powerpagecomponent, bruker du følgende verdier i powerpagecomponenttype-filteret .

Komponent Verdi Komponent Verdi
Publiseringsstatus 1 Nettside 2
Webfil 3 Weblenkesett 4
Nettkobling 5 Sidemal 6
Innholdssnutt 7 Webmal 8
Nettstedinnstilling 9 Tilgangskontrollregel for nettside 10
Webrolle 11 Nettstedstilgang 12
Områdemarkør 13 Standardskjema 15
Metadata for standardskjema 16 Liste 17
Tabelltillatelse 18 Avansert skjema 19
Avansert skjematrinn 20 Metadata for avansert skjema 21
Avspørringsplassering 24 Annonseplassering 26
Robotforbruker 27 Kolonnetillatelsesprofil 28
Kolonnetillatelse 29 Omdiriger 30
Overgangsregel for publiseringsstatus 31 Snarvei 32
Skyflyt 33 Brukeropplevelseskomponent 34

Løsningsreferanse for EDM-mal

Kjør pac solution list --includeSystemSolutions for å bekrefte at den forbedrede datamodellløsningen for områdets mal er installert.

Mal Unikt navn på EDM-løsning
Startoppsett 1 DefaultPortalTemplate_V2
Startoppsett 2 PowerPages_BlankDesign002_V2
Startoppsett 3 PowerPages_BlankDesign003_V2
Startoppsett 4 PowerPages_BlankDesign004_V2
Startoppsett 5 PowerPages_BlankDesign005_V2
Tom side PowerPages_BlankTemplate_V2
vanlige spørsmål PowerPages_FAQ_V2
Programbehandling PowerPages_BuildingPermit_V2
Programregistrering PowerPages_ProgramRegistration_V2
Planlegg og administrer møter PowerPages_BookMeeting_V2
Fellesskapsportal (Dynamics 365) PowerPages_CommunityPortal_V2
Customer Self-Service Portal (Dynamics 365) PowerPages_CustomerPortal_V2
Employee Self-Service Portal (Dynamics 365) PowerPages_ESSPortal_V2
Partnerportal (Dynamics 365) PowerPages_PartnerPortal_V2

Relatert innhold

  • Last updated on