Übersicht über die Migration vom Standard- zum erweiterten Datenmodell

Das Microsoft Power Platform CLI-Migrationsprogramm verschiebt die unterstützte Konfiguration und zugehörige Datensätze eines vorhandenen Power Pages Standorts vom Standarddatenmodell in das erweiterte Datenmodell und wechselt dann zur Verwendung der migrierten Konfiguration.

Das Standarddatenmodell speichert Power Pages Standortkonfiguration in Tabellen, die das Präfix adx_ verwenden. Das erweiterte Datenmodell speichert die Standortkonfiguration in der Tabelle " Site Component " (powerpagecomponent) und identifiziert jede Komponente anhand des Komponententyps. Wenn Sie wissen, wie das Migrationshilfsprogramm funktioniert, welche Vorlagen unterstützt werden und welche Anpassungen nicht automatisch aktualisiert werden, können Sie entscheiden, wann und wie eine Website verschoben werden soll.

Wenn Sie die Vorteile des erweiterten Datenmodells überprüfen, wird erläutert, warum Sie die Migration einer Website in Betracht ziehen können.

Es ist wichtig zu beachten, dass nicht alle adx_*-Tabellen nach powerpagecomponent verschoben werden. Nur die adx_*-Metadatentabellen — also diejenigen, die die Struktur und die Authoring-Oberfläche der Website beschreiben, wie adx_webpage, adx_contentsnippet, adx_webtemplate, adx_sitesetting, adx_pagetemplate, adx_weblink, adx_entityform und adx_entitylist — werden in powerpagecomponent konsolidiert (wobei ihre zeilenweisen Eigenschaften in die JSON-Inhaltsspalte verschoben werden).

Die transaktionalen/Laufzeit-Tabellen adx_* – also die Tabellen, die Endbenutzeraktivitäten zur Laufzeit erfassen, wie z. B. adx_invitation, adx_inviteredemption, adx_portalcomment und adx_externalidentity sowie die Übermittlungs- und Protokolltabellen für Entity Forms/Advanced Forms – werden nicht in powerpagecomponent migriert; sie verbleiben in ihren bestehenden Schemas und speichern weiterhin Laufzeitdaten wie zuvor. Bei diesen Transaktionstabellen ändert sich, dass ihre Verweise auf Metadatensätze bei der Referenzmigration umgeleitet werden, sodass sie auf die neuen powerpagecomponent Zeilen statt auf die alten adx_*-Metadatenzeilen verweisen.

Vorhandene Websites, die im Standarddatenmodell erstellt wurden, werden weiterhin auf adx_*-Tabellen ausgeführt, sodass jede Website migriert werden muss, um vom erweiterten Datenmodell zu profitieren. Die Migration verschiebt die Konfigurationsmetadaten der Website in die Struktur des erweiterten Datenmodells powerpagecomponent, stellt transaktionale Verweise auf diese neuen Metadatensätze um und stellt den Websitedatensatz so um, dass die Website aus dem erweiterten Datenmodell bedient wird. Außerdem werden Anpassungen – benutzerdefinierte adx_*-Spalten, Liquid-Code, der adx_*-Attribute ausliest, FetchXML für adx_*-Tabellen, Plug-Ins und Workflows – identifiziert und korrigiert, da diese Anpassungen nicht automatisch übernommen werden und neu geschrieben oder umstrukturiert werden müssen, damit sie mit dem erweiterten Datenmodell funktionieren.

Voraussetzungen

Microsoft Power Platform CLIVersion 2.11.2 oder höher, die den Download-, Migrations-, Status-, Aktivierungs- und Rollbackbefehle der Website ausführt. Weitere Informationen finden Sie unter Installieren der neuesten Power Platform CLI.
Dataverse-Basisportalpaket CDSBasePortal9.3.2607.x oder höher, das die erforderlichen Basisportalkomponenten bereitstellt.
Power Pages Core-Paket PowerPages_Core1.0.2605.x oder höher, das die erforderlichen Power Pages Laufzeitkomponenten bereitstellt. Aktualisieren Sie die Power Pages Lösung.
Die Rolle "Systemadministrator", Dynamics 365 "Administrator" oder "Power Platform-Administrator", die zum Wechseln oder Zurücksetzen des aktiven Datenmodells erforderlich ist.
Vertrautheit mit Power Platform CLI für Power Pages.
Hintergrundvorgänge sind aktiviert, wenn sich die Umgebung im Verwaltungsmodus befindet.

Funktionen des Migrationshilfsprogramms

Das Migrationsprogramm kopiert unterstützte Standortkonfiguration und zugehörige Datensätze in das erweiterte Datenmodell. Nach Abschluss der Migration wechselt die aktive Website zum erweiterten Datenmodell und wird überprüft, bevor sie zur normalen Verwendung zurückkehrt.

Das Migrationsdienstprogramm:

Generiert einen Bericht mit Anpassungen, die möglicherweise manuelle Änderungen erfordern.
Migriert unterstützte Standortkonfiguration und zugehörige Datensätze.
Hiermit können Sie den Migrationsstatus überprüfen, bevor Sie das aktive Datenmodell wechseln.
Hiermit können Sie die Website auf das Standarddatenmodell zurücksetzen, wenn die Überprüfung ein kritisches Problem identifiziert.

Important

Das Migrationsprogramm aktualisiert nicht automatisch jede Anpassung, die direkt von Standarddatenmodelltabellen abhängt. Überprüfen Sie den Anpassungsbericht, beheben Sie den betroffenen benutzerdefinierten Code, und testen Sie die migrierte Website vor der Produktionsverwendung.

Unterstützte Vorlagen

Sie können vorhandene Standarddatenmodellwebsites migrieren, die aus den folgenden Vorlagen erstellt wurden:

Starterlayout 1-5
Anwendungsverarbeitung
Leere Seite
Programmregistrierung
Besprechungen planen und verwalten
FAQ
Communityportal (Dynamics 365)
Kunden-Self-Service-Portal (Dynamics 365)
Mitarbeiter-Self-Service-Portal (Dynamics 365)
Partnerportal (Dynamics 365)

Note

Das Erstellen neuer Websites mit dem erweiterten Datenmodell und das Migrieren vorhandener Websites sind separate Funktionen. Wenn die ursprüngliche Vorlage einer Website hier nicht aufgeführt ist, führen Sie das Migrationshilfsprogramm für diese Website nicht aus.

Bevor Sie anfangen

Zusätzliche Planungsüberlegungen:

Die Einstellung der Einstellung "Zur erweiterten Datenmodellumgebung wechseln" steuert das Datenmodell, das für neue Websites verwendet wird. Wenn Sie die Einstellung aktivieren, werden vorhandene Websites nicht migriert.
Führen Sie die Migration zuerst in einer vollständigen Kopie der Produktionsumgebung aus. Abschließen der Anpassungskorrektur und Überprüfung vor der Migration.
Verwenden Sie den standardmäßigen Sicherungs- und Wiederherstellungsprozess Ihrer Organisation, um die Produktionsumgebung zu sichern.
Planen Sie ein Wartungsfenster für den endgültigen Produktionswechsel und die Validierung.
Notieren Sie die Website-ID, Portal-ID, Umgebungs-URL, CLI-Version, Paketversionen, Startzeit der Migration und Befehlsausgabeformular als Teil des Migrationsdatensatzes.

Die Umgebungssequenz planen

Die Migration unterstützt verschiedene Umgebungen mit einem anderen Modus für jede Umgebung.

Umgebung	Empfohlener Modus	Was Sie tun
Allgemeine Tastaturbelegung	`configurationData`	Migrieren Sie die Konfiguration, überprüfen Sie den Anpassungsbericht, korrigieren Sie Anpassungen, überprüfen und erfassen Sie die Konfiguration in einer Lösung.
Test oder UAT	`configurationDataReferences`	Importieren Sie die getestete Lösung aus der Entwicklung, migrieren Sie unterstützte verwandte Datensätze, aktivieren Sie das erweiterte Datenmodell und überprüfen Sie sie.
Produktion	`configurationDataReferences`	Importieren Sie die überprüfte verwaltete Lösung, migrieren Sie unterstützte verwandte Datensätze, aktivieren Sie während des Wartungsfensters und schließen Sie die Produktionsüberprüfung ab.
Einzelne Umgebung oder einfache Website	`all`	Migrieren Sie Konfigurations- und verwandte Datensätze nur in einem Vorgang, wenn Sie die Auswirkungen der Anpassung verstehen und den Lösungspfad für multienvironment nicht verwenden.

Erstellen eines Arbeitsordners

Verwenden Sie einen leeren Arbeitsordner, um Berichte, heruntergeladene Websitequelle und Vergleichsdateien zu speichern. In den folgenden Beispielen wird für diesen Speicherort verwendet \<OUTPUT\> .

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

Migrationsphasen

Der Migrationsprozess besteht aus vier Phasen:

Vorabüberprüfungen – Überprüfen Sie den Website-, IDs-, CLI-, Paket-, Vorlagenlösungs- und Migrationsstatus.
Konfiguration — Konfiguration in der Entwicklung migrieren oder getestete Konfiguration in nachgelagerten Umgebungen importieren.
Migrieren und aktivieren – Migrieren Sie verwandte Datensätze, bestätigen Sie den Abschluss, wechseln Sie Modelle und starten Sie sie neu.
Validate — Verhalten, Berechtigungen, benutzerdefinierten Code und Vorlagenabläufe testen.

Phase 1 (Standorterkennung und Vorabprüfungen) und Phase 4 (Validierung nach der Migration) laufen bei jeder Website auf die gleiche Weise ab.

Phase 2 und Phase 3 sind spurverzweigt – ihre Form hängt vom Migrationsmodus ab, der die Spur vom Umgebungstyp ableiten soll.

Der Authoring-Track (Modus configurationData oder all) wird für Dev- und Einzelumgebungs-Setups verwendet. Die Metadaten selbst werden lokal migriert, und Anpassungen werden anhand der Standarddatenmodellquelle überprüft und behoben, bevor Transaktionsverweise verschoben werden.

Der Downstream-Track (Modus configurationDataReferences) wird für Test-, UAT- und Produktionsumgebungen verwendet, in denen Konfigurationsmetadaten angenommen werden, dass sie über den ALM-Lösungsimport aus Dev eingegangen sind. Nur transaktionale Referenzen werden in diesem Pfad migriert. Erkenntnisse zu Anpassungen weisen auf eine vorgelagerte ALM-Lücke hin und nicht auf Arbeiten, die Sie lokal durchführen sollten.

Phase 1: Vorabüberprüfungen

Überprüfen Sie Ihre Power Platform CLI-Version mit pac --version. Wenn Ihre Version vor der erforderlichen Version liegt, installieren oder aktualisieren Sie die Microsoft Power Platform CLI, bevor Sie fortfahren.
Authentifizieren sie sich bei der Zielumgebung.
1. Führen Sie pac auth list aus.
2. Führen Sie pac auth who aus.
Vergewissern Sie sich, dass das aktive Authentifizierungsprofil auf die Umgebung verweist, die die Website enthält. Um ein anderes Profil auszuwählen oder ein Profil zu erstellen, verwenden pac auth select oder pac auth create -u "https://contoso.crm.dynamics.com".
Installieren Sie erweiterte Datenmodelllösungen für Ihre Vorlage mit einer der folgenden Methoden:
1. Stellen Sie eine Website Ihrer Vorlage mit aktiviertem EDM-Flag (Enhanced Data Model) im Admin Center bereit.
2. Verwenden Sie die CLI zur Installation mit dem Befehl pac application install --application-name "PowerPages_PartnerPortal_V2"
Suchen Sie die Website, und notieren Sie die zugehörigen Bezeichner mit pac pages list -v.

Notieren Sie die werte, die in der folgenden Tabelle angezeigt werden.

Wert	Verwendet für
Website-ID	Alle `migrate-datamodel` Befehle.
Portal-ID	Wechseln zum erweiterten Datenmodell und Wiederherstellen des Standarddatenmodells.
Anzeigename und URL	Bestätigen, dass Sie die richtige Website im Admin Center ausgewählt haben.
Datenmodellversion	Muss Standard sein. Wenn sie bereits erweitert ist, ist keine Migration erforderlich.

Important

Die Portal-ID ist nicht die Power Pages App-ID. Wenn die CLI die Portal-ID nicht anzeigt, ist sie im Power Platform Admin Center unter Ressourcen>Power Pages-Websites>Websitedetails verfügbar, oder hängen Sie /_services/about an die Website-URL an, während Sie mit den erforderlichen Zugriffsberechtigungen für die Website angemeldet sind.

Prüfen Sie mit dem folgenden Befehl, ob eine frühere oder laufende Migration vorliegt:

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

Status	Bedeutung	Action
NotStarted oder kein Tracker	Es wurde keine Migration gestartet.	Fahren Sie mit den Paketüberprüfungen fort.
Zurückgekehrt	Eine vorherige Migration wurde zurückgesetzt.	Überprüfen Sie, warum es rückgängig gemacht wurde, und fahren Sie dann fort, sobald Sie bereit sind.
Abgeschlossen	Die Migration wurde abgeschlossen, die Website wurde jedoch möglicherweise nicht umgeschaltet.	Bestätigen Sie das aktive Datenmodell. Wenn der Standard noch vorhanden ist, fahren Sie mit der Aktivierung fort.
Laufen	Die Migration wird noch verarbeitet.	Fahren Sie mit der Überprüfung des Status fort. Starten Sie keine weitere Migration für dieselbe Website.
Failed	Bei der Migration ist ein Fehler aufgetreten.	Sammeln Sie die Befehlsausgabe- und Umgebungsdetails, korrigieren Sie die Ursache, und wiederholen Sie den Vorgang erst, nachdem der Fehler verstanden wurde.

Note

Wenn eine Migration länger als erwartet ausgeführt wird, benötigen Sie die Website-ID, Umgebungs-ID, CLI-Version, Paketversionen, Befehlsausgabe und Migrationsstartzeit, bevor Sie Microsoft Support kontaktieren. Eine aktive Migration sollte nicht zurückgesetzt werden, es sei denn, der Support oder ein genehmigtes Runbook fordert dazu auf.

Überprüfen Sie die erforderlichen Erstanbieterpakete mit pac solution list --includeSystemSolutions.
1. Vergewissern Sie sich, dass CDSBasePortal, PowerPages_Core und die EDM-Lösungen für die Websitevorlage in den erforderlichen Versionen installiert sind.
Wenn ein Paket fehlt oder veraltet ist, aktualisieren Sie es über das Power Platform Admin Center:
1. Öffnen Sie die Zielumgebung.
2. Wechseln Sie zu Resources>Dynamics 365 apps.
3. Suchen Sie das erforderliche Paket.
4. Wählen Sie "Installieren " oder "Upgrade" aus.
5. Warten Sie, bis der Vorgang abgeschlossen ist, und führen Sie pac solution list --includeSystemSolutions dann erneut aus.
Note

Wenn die EDM-Lösung der Vorlage nicht für die direkte Installation verfügbar ist, wird durch das Erstellen einer temporären Website für ein erweitertes Datenmodell in derselben Umgebung mit derselben Vorlage die passende EDM-Lösung installiert. Sie können die temporäre Website löschen, nachdem die Lösung bestätigt wurde.
Generieren Sie den Anpassungsbericht mit pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Durch das Generieren des Berichts wird die Website nicht geändert.

Öffnen Sie die generierte CSV-Datei, und überprüfen Sie jedes Element, das auf Standarddatenmodelltabellen verweist. Weisen Sie jeder erforderlichen Abhilfemaßnahme vor der Produktionsmigration einen Verantwortlichen und einen Validierungsschritt zu.

Anpassungskategorie	Planen
Benutzerdefinierte Spalten in adx_ Metadatentabellen	Verschieben Sie die benutzerdefinierten Daten in eine unterstützte benutzerdefinierte Tabelle im Zusammenhang mit powerpagecomponent.
Beziehungen zu adx_ Metadatentabellen	Erstellen Sie die Beziehung mit der unterstützten erweiterten Datenmodelltabelle neu.
Liquid- oder FetchXML-Verweise auf adx_-Tabellen	Aktualisieren Sie Code, um unterstützte Liquid-Objekte, virtuelle Tabellen oder powerpagecomponent zu verwenden.
Workflows und Plug-Ins in adx_ Tabellen	Umgestalten und registrieren Sie die Logik für unterstützte erweiterte Datenmodelltabellen.

Note

Ein Anpassungsbericht beweist nicht, dass das gesamte Websiteverhalten nach der Migration funktioniert; Die Überprüfung ist noch erforderlich.

Wählen Sie den Migrationsmodus aus, um zu bestimmen, was das Hilfsprogramm in einem einzigen Vorgang migriert.

Mode	Was migriert wird	Verwendung
configurationData	Unterstützte Websitekonfigurationsmetadaten wie Seiten, Webvorlagen, Codeausschnitte, Einstellungen, Formulare, Listen, Webrollen und Tabellenberechtigungen.	Entwicklung, bei der Sie die Konfiguration korrigieren und durch Lösungen navigieren.
configurationDataReferences	Unterstützte Datensätze, die auf die migrierte Standortkonfiguration verweisen.	Testen, UAT und Produktion nach Eingang der Standortkonfiguration durch einen Lösungsimport.
alle	Sowohl die Konfiguration als auch die unterstützten zugehörigen Datensätze.	Eine einzelne Umgebung oder eine einfache Migration, die die lösungsbasierte Umgebungssequenz nicht verwendet.

Phase 2: Standortkonfiguration

Erstellungspfad: Entwicklung oder eine einzige Umgebung

Laden Sie einen SDM-Basisplan herunter, indem Sie ausführen pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Mit dem Befehl wird ein untergeordneter Ordner erstellt, der für die Website benannt ist. Notieren Sie den Ordner, der direkt enthält website.yml.
Migrieren Sie die Websitekonfiguration, indem Sie pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData ausführen. Wenn Sie den Pfad für den Einzelvorgang verwenden möchten, ersetzen Sie configurationData durch all.
Überprüfen Sie den Migrationsstatus, indem Sie pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus ausführen. Verwenden Sie die folgende PowerShell-Schleife, um den Status einmal pro Minute für bis zu 30 Minuten zu überprüfen:
```
$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
}
```
Wenn die Schleife endet, während der Status noch „Running“ ist, wird die Überprüfung mit --checkMigrationStatus fortgesetzt. Ein lange laufender Vorgang ist nicht unbedingt ein fehlgeschlagener Vorgang.
Korrigieren Sie gemeldete Anpassungen mithilfe des Anpassungsberichts und der Anleitungen in diesem Artikel, um betroffene FetchXML, Liquid, benutzerdefinierte Spalten, Beziehungen, Workflows und Plug-Ins zu aktualisieren. Testen Sie jede geänderte Komponente erneut. Wenn Sie den heruntergeladenen Quellcode aktualisieren, laden Sie den Site-Ordner hoch, der website.yml direkt enthält, indem Sie pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1 ausführen.

Downstream Track: Test, UAT oder Produktion

Importieren Sie die Lösung, die die migrierte und korrigierte Standortkonfiguration enthält. Verwenden Sie das Power Platform Admin Center oder Ihre etablierte Bereitstellungspipeline.
```
pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true
```
Vergewissern Sie sich, dass die Standortkonfiguration vorhanden ist, indem Sie die Power Pages Verwaltungs-App in der Zielumgebung öffnen. Der Websitedatensatz und die erwartete Konfiguration müssen vorhanden sein, bevor verwandte Datensätze migriert werden.

Migrieren unterstützter verwandter Datensätze. Wenn Sie bereits verwendet haben --mode all, überspringen Sie diesen Schritt. Überprüfen Sie den Status, bis er "Abgeschlossen" meldet.
```
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus
```
Nachdem der Migrationsstatus den erfolgreichen Abschluss gemeldet hat, wechseln Sie die aktive Website zum erweiterten Datenmodell. Der Standarddatenmodell-Website-Datensatz wird deaktiviert und der entsprechende Website-Datensatz des erweiterten Datenmodells wird aktiviert.
```
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
```
Die Website neu starten.
1. Öffnen Sie das Power Platform Admin Center.
2. Wechseln Sie zur Umgebung und wählen Sie dann Ressourcen>Power Pages-Websites aus.
3. Wählen Sie die Website aus.
4. Wählen Sie Neu starten aus. Wenn "Neustart" nicht verfügbar ist, deaktivieren Sie die Website, und aktivieren Sie sie dann.
5. Warten Sie, bis der Vorgang vor der Überprüfung abgeschlossen ist.
Bestätigen Sie das aktive Datenmodell mithilfe einer oder mehrerer dieser Methoden:
1. Wählen Sie im Power Platform Admin Center die Website aus, und bestätigen Sie, dass das Datenmodell"Erweitert" angezeigt wird.
2. Öffnen Sie den Setup-Arbeitsbereich der Website in Power Pages Entwurfsstudio, und bestätigen Sie das angezeigte Datenmodell.
3. Vergewissern Sie sich, dass die erweiterte Konfiguration in der Power Pages-Verwaltungs-App geöffnet wird.
4. Führen Sie pac pages list -v aus, und bestätigen Sie die Datenmodellversion.
Tip

Die Website-URL und das visuelle Design ändern sich nicht nur, weil sich das aktive Datenmodell geändert hat. Um die Migration zu überprüfen, führen Sie diese Prüfungen durch – nicht anhand des Aussehens der Website.

Phase 4: Überprüfen der migrierten Website

Vollständige Überprüfung vor dem erneuten Öffnen einer Produktionswebsite für Benutzer. Verwenden Sie Testkonten für jeden wichtigen Benutzertyp und jede Webrolle, und zeichnen Sie das Ergebnis jedes kritischen Tests auf.

Area	Was zu überprüfen ist
Seiten und Inhalte	Homepage, repräsentative Inhaltsseiten, Webvorlagen, Inhaltsausschnitte, Webdateien, Navigation, Umleitungen und mehrsprachige Inhalte.
Authentication	Anmelden, Abmelden, Registrierung, Einladungen, externe Identitätsanbieter und Abläufe bei verweigertem Zugriff.
Authorization	Webrollen, Tabellenberechtigungen, Spaltenberechtigungen und Seitenzugriffsregeln ermöglichen und verweigern die erwarteten Aktionen.
Formulare und Listen	Grundlegende Formulare, mehrstufige Formulare, Listen, Formularmetadaten, Übermittlungen, verwandte Datensätze und Webformularsitzungen, die von der Website verwendet werden.
Dynamics 365 Vorlagenreisen	Die wichtigsten Kunden-, Mitarbeiter-, Community- oder Partner-Journeys, die in Ihrer Implementierung verwendet werden, einschließlich vorlagenspezifischer Seiten und Zugriffsmuster.
Benutzerdefinierter Code	Liquid, FetchXML, JavaScript, Plug-Ins, Workflows und Integrationen, die im Anpassungsbericht identifiziert wurden.
Websiteeinstellungen und -dateien	Websiteeinstellungen, Bilder, Anlagen, SVG-Dateien und andere Webdateien werden ordnungsgemäß geladen.
Daten und Verweise	Wichtige Datensatzanzahlen und unterstützte zugehörige Datensätze weisen auf die richtigen migrierten Websitekomponenten hin.
Verwaltung und ALM	Die Website wird in Power Pages Verwaltung geöffnet und kann wie erwartet zu Lösungen hinzugefügt, exportiert und aus Lösungen importiert werden.

Überprüfen der Browserdiagnose

Öffnen Sie Browserentwicklertools, während Sie repräsentative Seiten testen. Untersuchen Sie:

Konsolenfehler, in denen adx\_, Entitäten, Liquid oder FetchXML erwähnt werden.
HTTP 401- oder 403-Antworten von \_api, die auf ein Berechtigungs- oder Webrollenproblem hinweisen können.
HTTP 500-Antworten, die auf einen Liquid-, FetchXML-, Plug-In- oder Integrationsfehler hinweisen können.

Migrationsabschlusskriterien

Betrachten Sie die Migration erst dann als abgeschlossen, wenn die Website das erweiterte Datenmodell aufweist, kritische Geschäftsprozesse erfolgreich durchlaufen werden, das erwartete Sicherheitsverhalten bestätigt ist und jeder Befund zu Anpassungen mit hoher Auswirkung behoben oder akzeptiert ist.

Produktionsmigrationssequenz

Verwenden Sie die folgende Produktionssequenz, um das Migrationsrisiko zu reduzieren:

Erstellen Sie eine vollständige Kopie der Produktionsumgebung für die Probe.
Bestätigen Sie die Voraussetzungen für CLI-, Paket- und Vorlagenlösungen in der kopierten Umgebung.
Generieren und überprüfen Sie den Anpassungsbericht.
Migrieren sie die Konfiguration in der kopierten Entwicklungsumgebung.
Korrigieren Sie Anpassungen, und erfassen Sie die überprüfte Websitekonfiguration in einer verwalteten Lösung.
Importieren Sie die Lösung in die Probenumgebung, migrieren Sie unterstützte verwandte Datensätze, aktivieren Sie das erweiterte Datenmodell, und schließen Sie die vollständige Prüfliste für die Überprüfung ab.
Wiederholen Sie die Korrektur und Probe, bis alle kritischen Tests bestehen.
Planen Sie das Wartungsfenster für die Produktion, kommunizieren Sie die Entscheidungspunkte für Validierung und Rollback und sichern Sie die Produktionsumgebung.
Bestätigen Sie die Voraussetzungen für das Produktionspaket und die Vorlagenlösung erneut.
Importieren Sie die validierte verwaltete Lösung in die Produktion.
Führen Sie configurationDataReferences aus, überprüfen Sie den Migrationsstatus, wechseln Sie das aktive Datenmodell und starten Sie die Website neu.
Führen Sie die Prüfliste für die Produktionsüberprüfung aus, und geben Sie die Website erst nach bestandenen kritischen Tests zur normalen Verwendung zurück.

Zurücksetzen einer migrierten Website auf das Standarddatenmodell

Wenn die Validierung nach der Aktivierung ein kritisches Problem ergibt, verwenden Sie den folgenden Befehl, um den Website-Datensatz des Standarddatenmodells erneut zu aktivieren:

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

Nach Abschluss des Befehls:

Starten Sie die Website über das Power Platform Admin Center neu.
Vergewissern Sie sich, dass die Website "Standard " als aktives Datenmodell anzeigt.
Führen Sie die kritischen Überprüfungstests der Website erneut aus.
Bewahren Sie den Migrationsbericht, Fehlerdetails und Korrekturhinweise auf, bevor Sie eine andere Migration versuchen.

Important

Planen Sie die Rollbackentscheidung vor der Produktionsmigration. Überprüfen Sie die Änderungen, die nach dem Wechsel des erweiterten Datenmodells vorgenommen wurden, bevor Sie zurückkehren, da die Standard- und erweiterten Websitedatensätze separate Datensätze sind.

Troubleshooting

Nachricht oder Symptom	Wahrscheinliche Ursache	Action
`pac powerpages migrate-datamodel` wird nicht erkannt.	Der Befehl verwendet den falschen Namespace oder eine veraltete CLI.	Aktualisieren Sie die Power Platform CLI und verwenden Sie `pac pages migrate-datamodel`.
`CDSBasePortal` oder `PowerPages_Core` ist nicht aufgeführt	Systemlösungen waren nicht in der Befehlsausgabe enthalten, oder das Paket ist nicht installiert.	Führen Sie `pac solution list --includeSystemSolutions` aus. Installieren oder aktualisieren Sie das fehlende Paket im Power Platform Admin Center.
Website wird für die Migration nicht unterstützt	Die ursprüngliche Vorlage wird nicht unterstützt, Paketversionen sind nicht ausreichend, oder die entsprechende EDM-Vorlagenlösung fehlt.	Bestätigen Sie die Vorlagenberechtigung, Paketversionen und die im Vorlagenlösungsverweis aufgeführte EDM-Lösung.
Ein unbekanntes Argument `--webSiteId` wurde übergeben für `pac pages upload`	Der Uploadbefehl akzeptiert das Argument "Website-ID" nicht.	Lassen Sie das Argument aus. Die Website wird identifiziert von `website.yml`.
Upload zielt auf die falsche Website ab oder kann die Website nicht finden	Der Pfad verweist auf den Wrapperordner anstelle des Websiteordners.	Verwenden Sie den Unterordner, der die Datei website.yml direkt enthält.
Portal-ID zeigt `Unknown` oder `N/A` an	Die Website ist inaktiv, oder die installierte CLI gibt den Wert nicht zurück.	Rufen Sie die Portal-ID über das Power Platform Admin Center oder die Seite der `/_services/about` Website ab. Verwenden Sie die App-ID nicht.
Migration meldet `Completed`, aber die Website zeigt weiterhin `Standard` an	Das aktive Datenmodell wurde nicht gewechselt, oder die falsche Portal-ID wurde verwendet.	Führen Sie den Aktivierungsbefehl mit der Website-ID und der richtigen Portal-ID aus, starten Sie die Website neu, und überprüfen Sie sie.
Status bleibt `Running`	Die Migration verarbeitet eine große Datenmenge oder ist blockiert.	Fahren Sie mit der Überprüfung des Status fort. Sammeln Sie die Umgebung, das Paket, die CLI, die Startzeit und die Befehlsdetails, bevor Sie sich an den Support wenden. Starten Sie keine zweite Migration.
Status ist `Failed`	Ein Paket-, Vorlagen-, Anpassungs-, Daten- oder Dienstfehler hat den Vorgang beendet.	Speichern Sie die vollständige Befehlsausgabe, korrigieren Sie die identifizierte Ursache, und wiederholen Sie den Vorgang erst nach der Überprüfung des fehlgeschlagenen Migrationsstatus.
Die Website wird geöffnet, benutzer können jedoch nicht auf erwartete Daten zugreifen.	Webrollen, Tabellenberechtigungen oder benutzerdefinierte Abfragen verhalten sich nach der Migration nicht wie erwartet.	Überprüfen Sie Webrollen, Tabellenberechtigungen, Spaltenberechtigungen, FetchXML-, Liquid- und Browsernetzwerkfehler.

Berücksichtigung von Websiteanpassungen

Der Anpassungsbericht identifiziert direkte Abhängigkeiten von Standarddatenmodelltabellen. Schließen Sie die erforderlichen Abhilfemaßnahmen vor dem Produktiveinsatz ab.

Benutzerdefinierte Spalten in Metadatentabellen

Wenn eine Tabelle des Standarddatenmodells wie adx_webpage eine benutzerdefinierte Spalte enthält, erstellen Sie eine benutzerdefinierte Tabelle, um die benutzerdefinierten Daten zu speichern, und fügen Sie powerpagecomponent ein Nachschlagefeld hinzu. Migrieren Sie die benutzerdefinierten Werte zur neuen Tabelle, und aktualisieren Sie Code, der die Spalte liest oder schreibt.

Beziehungen zwischen benutzerdefinierten Tabellen und Metadatentabellen

Erstellen Sie benutzerdefinierte Beziehungen neu, die auf adx_ Tabellen verweisen, sodass sie auf die entsprechende erweiterte Datenmodelltabelle verweisen, häufig powerpagecomponent. Aktualisieren Sie abhängige Formulare, Ansichten, Plug-Ins, Flows und Integrationen.

Flüssige Verweise auf Metadatentabellen

Ersetzen Sie den direkten Zugriff auf entities['adx_*'] durch ein unterstütztes Liquid-Objekt, sofern ein solches vorhanden ist. Zum Beispiel verwenden Sie das weblinks Liquid-Objekt, anstatt adx_weblinkset oder verwandte Tabellen direkt abzufragen. Überprüfen Sie jede Verwendung, da sich das zurückgegebene Objekt und die verfügbaren Attribute unterscheiden können.

FetchXML-Verweise auf Metadatentabellen

Ersetzen sie direkte adx_ Entitätsverweise durch die entsprechende virtuelle Tabelle oder Abfrage powerpagecomponent und filtern Sie nach powerpagecomponenttype

Beispiel für ein Standarddatenmodell:

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

Beispiel für ein erweitertes Datenmodell:

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

Benutzerdefinierte Workflows und Plug-Ins

Umgestalten Sie benutzerdefinierten Workflow und Plug-In-Logik, die in adx_ Tabellen registriert ist. Registrieren Sie die aktualisierte Logik für die entsprechende erweiterte Datenmodelltabelle, und verwenden Sie das erweiterte Schema und die attribute. Testen Sie das Erstellen, Aktualisieren, Löschen und Sicherheitsverhalten in einer Nichtproduktionsumgebung.

Befehlsreferenz

Purpose	Command
CLI-Version überprüfen	`pac --version`
Authentifizierungsprofile auflisten	`pac auth list`
Erstellen eines Authentifizierungsprofils	`pac auth create -u "<ENV_URL>"`
Websites und Bezeichner auflisten	`pac pages list -v`
Auflisten von Systemlösungen	`pac solution list --includeSystemSolutions`
Überprüfen des Migrationsstatus	`pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus`
SDM-Quelle herunterladen	`pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"`
EDM-Quelle herunterladen	`pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"`
Anpassungsbericht generieren	`pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"`
Konfiguration migrieren	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData`
Migrieren verwandter Datensätze	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences`
Migrieren beider Kategorien	`pac pages migrate-datamodel --webSiteId "<ID>" --mode all`
Websitequelle hochladen	`pac pages upload --path "<SITE_ROOT>" --modelVersion 1`
Aktivieren von EDM	`pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"`
Zu SDM zurückkehren	`pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"`

Referenz zu Websitekomponententypen

Verwenden Sie beim Abfragen powerpagecomponentdie folgenden Werte im PowerpageComponenttype-Filter .

Component	Wert	Component	Wert
Veröffentlichungsstatusarten	1	Webseite	2
Webdatei	3	Weblinksatz	4
Weblink	5	Seitenvorlage	6
Inhaltsausschnitt	7	Webvorlage	8
Website-Einstellung	9	Webseiten-Zugriffssteuerungsregel	10
Webrolle	11	Websitezugriff	12
Seitenmarkierung	13	Basisformular	15
Basisformularmetadaten	16	Liste	17
Tabellenberechtigung	18	Erweitertes Formular	19
Erweiterter Formularschritt	20	Erweiterte Formularmetadaten	21
Umfrageplatzierung	24	Anzeigenplatzierung	26
Bot-Nutzer	27	Spaltenberechtigungsprofil	28
Spaltenberechtigung	29	Umleiten	30
Übergangsregel für den Veröffentlichungsstatus	31	Tastenkombination	32
Cloud-Flow	33	UX-Komponente	34

Referenz zur EDM-Vorlagenlösung

Führen Sie pac solution list --includeSystemSolutions aus, um zu bestätigen, dass die erweiterte Datenmodelllösung für die Vorlage der Website installiert ist.

Vorlage	Eindeutiger Name der EDM-Lösung
Starter-Layout 1	DefaultPortalTemplate_V2
Starter-Layout 2	PowerPages_BlankDesign002_V2
Starter-Layout 3	PowerPages_BlankDesign003_V2
Starter-Layout 4	PowerPages_BlankDesign004_V2
Starterlayout 5	PowerPages_BlankDesign005_V2
Leere Seite	PowerPages_BlankTemplate_V2
FAQ	PowerPages_FAQ_V2
Anwendungsverarbeitung	PowerPages_BuildingPermit_V2
Programmregistrierung	PowerPages_ProgramRegistration_V2
Besprechungen planen und verwalten	PowerPages_BookMeeting_V2
Communityportal (Dynamics 365)	PowerPages_CommunityPortal_V2
Kunden-Self-Service-Portal (Dynamics 365)	PowerPages_CustomerPortal_V2
Mitarbeiter-Self-Service-Portal (Dynamics 365)	PowerPages_ESSPortal_V2
Partnerportal (Dynamics 365)	PowerPages_PartnerPortal_V2

Feedback

War diese Seite hilfreich?

Last updated on 2026-09-01

Übersicht über die Migration vom Standard- zum erweiterten Datenmodell

Voraussetzungen

Funktionen des Migrationshilfsprogramms

Unterstützte Vorlagen

Bevor Sie anfangen

Die Umgebungssequenz planen

Erstellen eines Arbeitsordners

Migrationsphasen

Phase 1: Vorabüberprüfungen

Phase 2: Standortkonfiguration

Erstellungspfad: Entwicklung oder eine einzige Umgebung

Downstream Track: Test, UAT oder Produktion

Phase 3: Verwandte Datensätze und Aktivierung

Phase 4: Überprüfen der migrierten Website

Überprüfen der Browserdiagnose

Migrationsabschlusskriterien

Produktionsmigrationssequenz

Zurücksetzen einer migrierten Website auf das Standarddatenmodell

Troubleshooting

Berücksichtigung von Websiteanpassungen

Benutzerdefinierte Spalten in Metadatentabellen

Beziehungen zwischen benutzerdefinierten Tabellen und Metadatentabellen

Flüssige Verweise auf Metadatentabellen

FetchXML-Verweise auf Metadatentabellen

Benutzerdefinierte Workflows und Plug-Ins

Befehlsreferenz

Referenz zu Websitekomponententypen

Referenz zur EDM-Vorlagenlösung

Verwandte Inhalte

Feedback

Zusätzliche Ressourcen