Freigeben über

Standarddatenmodell-Sites auf erweitertes Datenmodell migrieren (Vorschauversion)

  • Artikel

[Dieses Thema ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]

Dieser Artikel erläutert, wie Sie Ihre vorhandene Standarddatenmodell-Site auf das erweiterte Datenmodell migrieren.

Wichtig

  • Dieses Feature ist eine Previewfunktion.
  • Funktionen in der Vorschauversion sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

Anforderungen

Schritt 1. Anpassung für vorhandene Standard-Site-Metadaten herunterladen und prüfen

  1. Öffnen Sie eine Eingabeaufforderung.

  2. Verwenden Sie den folgenden Befehl, um sich bei der Dataverse-Organisation für Ihre Power Platform-Umgebung zu authentifizieren und den Website-Datensatz für die Migration herunterzuladen.

    pac auth create -u [Dataverse URL]

    Beispiel

    pac auth create -u https://contoso-org.crm.dynamics.com

    Weitere Informationen: pac auth create

  3. Verwenden Sie den folgenden Befehl, um eine Liste der Websites in der aktuellen Organisation zu erstellen.

    pac powerpages list

    Weitere Informationen: pac powerpages list

  4. Verwenden Sie folgenden Befehl zum Herunterladen des Anpassungsberichts.

    pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]

    Beispiel

    pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"

Wenn der heruntergeladene Bericht Anpassungen enthält, befolgen Sie die Anleitung im Bericht, um diese nach der Migration auf das erweiterte Datenmodell zu beheben. Weitere Informationen: Aspekte zur Site-Anpassung bei der Migration von Sites vom Standard- auf das erweiterte Datenmodell

Schritt 2. Site-Daten von Standard- auf erweitertes Datenmodell migrieren

Verwenden Sie folgenden Befehl, um Ihre Site-Daten auf das erweiterte Datenmodell zu migrieren.

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]

Der Modus kann 3 Werte besitzen:

Beispiel

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all

Das Migrationstool überprüft die Lösungen. Wenn für die genannte Vorlage eine Standard-Datenmodelllösung ohne entsprechende erweiterte Datenmodelllösung vorhanden ist, wird eine Warnung angezeigt: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Es gibt bestimmte Vorlagen, z. B. für die Programmregistrierung und für das Planen und Verwalten von Besprechungen, die passende erweiterte Datenmodellpakete erfordern, damit sichergestellt werden kann, dass die migrierte Website ordnungsgemäß funktioniert. Zum Erhalt dieser erweiterten Datenmodellpakete müssen Sie eine neue Site für die entsprechende Vorlage erstellen (die Umgebung sollte für das erweiterte Datenmodell aktiviert sein). Sie können dann mit dem erweiterten Datenmodell kompatible Lösungen für die Migration bereitstellen.

Unterstützte Vorlagen für die Migration

Sites mit folgenden Vorlagen werden für die Migration unterstützt:

  • Starterlayout 1-5
  • Anwendungsverarbeitung
  • Leere Seite
  • Programmregistrierung
  • Besprechungen planen und verwalten

Schritt 3. Migrationsstatus überprüfen

Verwenden Sie folgenden Befehl, um den Migrationsstatus Ihrer Site zu überprüfen:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

Beispiel

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus

Anmerkung

Wenn die Migration Ihrer Site länger dauert als erwartet, kann dies an der Größe der Datenmenge liegen. Wenn Ihre Eingabeaufforderung nicht mehr angezeigt wird, öffnen Sie eine neue Eingabeaufforderung, und überprüfen Sie den Status Ihrer Site mithilfe des Befehls in diesem Schritt.

Schritt 4. Version des Site-Datenmodells nach erfolgreicher Datenmigration aktualisieren

Verwenden Sie folgenden Befehl zum Aktualisieren der Version des Site-Datenmodells:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]

Anmerkung

  • Rufen Sie zum Finden der Portal-ID die Website auf, und hängen Sie an die Website-URL „/_services/about“ an. Damit diese Optionen angezeigt werden, muss der Benutzer über eine Webrolle verfügen, die alle Zugriffsberechtigungen für die Website enthält.
  • Nach Aktualisierung der Version des Site-Datenmodells wird der mit dem Standard-Datenmodell verknüpfte Websitedatensatz deaktiviert. Stattdessen verweist die Site jetzt auf den Websitedatensatz, der dem erweiterten Datenmodell zugeordnet ist.
  • Der Benutzer sollte über eine der folgenden Rollen verfügen, um einen Migrationsbefehl mit updateDatamodelVersion- oder revertToStandardDataModel-Argumenten auszuführen. Dadurch wird eine Administratoraktion ausgeführt, um Ihre Website auf ein erweitertes Datenmodell umzustellen oder umgekehrt.

Beispiel

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

Migrierte Site von erweitertem auf Standard-Datenmodell umstellen

Verwenden Sie folgenden Befehl, um eine Standard-Datenmodell-Site nach der Migration auf ein erweitertes Datenmodell zurückzuführen:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]

Anmerkung

Wenn Sie eine migrierte Site von dem erweiterten Datenmodell zurück auf das Standard-Datenmodell zurückführen, wird der dem erweiterten Datenmodell zugeordnete Website-Datensatz deaktiviert, und der Website-Datensatz des Standard-Datenmodells erneut aktiviert.

Beispiel

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e

Eine Produktions-Site von Standard- auf erweitertes Datenmodell migrieren

Bevor Sie eine Produktions-Site migrieren, empfehlen wir, eine vollständige Kopie der Produktions-Site zu erstellen. Darüber hinaus ist es empfehlenswert, die Migration der Produktions-Site außerhalb der Geschäftszeiten durchzuführen.

Führen Sie folgende Schritte aus, um Ihre Produktions-Site auf das erweiterte Datenmodell zu migrieren:

  1. Testen Sie die Migration der Site in der kopierten Umgebung mithilfe des PAC CLI-migrate-datamodel-Befehls.
  2. Fügen Sie der verwalteten Lösung Site-Konfigurationsdaten hinzu, und importieren Sie sie in die Produktionsumgebung.
  3. Nutzen Sie PAC-CLI-Befehle, um Nicht-Konfigurationsdaten zu migrieren, und schließen Sie den Vorgang ab, indem Sie die Datenmodellversion für die Produktion aktualisieren.

Anmerkung

Für die Migration sind die Quell- und die Produktionswebsite-IDs identisch.

Aspekte zur Site-Anpassung bei der Migration von Sites vom Standard- auf das erweiterte Datenmodell

Dieser Abschnitt enthält Anleitungen zum Korrigieren von Anpassungen für eine Site-Migration vom Standard- zum erweiterten Datenmodell.

Es gibt fünf Typen von Site-Anpassungen für Adx-Metadatentabellen:

Anmerkung

Alle Korrekturen im Zusammenhang mit der Anpassung werden nach der Migration am erweiterten Datenmodell durchgeführt.

Benutzerdefinierte Spalten in Adx-Metadatentabellen

Erstellen Sie zum Beheben dieser Anpassung im erweiterten Datenmodell eine Beziehung zwischen den Systemtabellen und der neuen benutzerdefinierten Tabelle. Migrieren Sie die Daten in die neue Tabelle.

Standarddatenmodell: Die Tabelle adx_webpage enthält eine benutzerdefinierte Spalte als contoso_pagetype.

Erweitertes Datenmodell: Erstellen Sie eine neue Tabelle namens contoso_webpage. Dazu gehören eine Spalte namens contoso_pagetype sowie eine Suchspalte contoso_webpage_id, die powerpagescomponent zugeordnet ist. Verwenden Sie für die Tabellenerstellung den Datenarbeitsbereich.

Erstellen Sie zur Codekorrektur die Tabelle „contoso_webpage“ im erweiterten Datenmodell.

Beziehung zwischen benutzerdefinierten Tabellen und Adx-Tabellen

Erstellen Sie zum Beheben dieser Anpassung im erweiterten Datenmodell eine Beziehung zwischen den benutzerdefinierten Tabellen und den Systemtabellen.

Standarddatenmodell: Tabelle adx_webpage hat eine Beziehung namens adx_webpage_contoso_pagelogs mit Tabelle contoso_pagelogs.

Erweitertes Datenmodell: Erstellen Sie eine neue Beziehung namens powerpagecomponent_contoso_pagelogs mit Tabelle contoso_webpage. Verwenden Sie für die Tabellenerstellung den Datenarbeitsbereich.

Adx-Tabellenverweise im Liquid-Codeausschnitt

Ersetzen Sie zum Beheben dieser Anpassung im erweiterten Datenmodell die ADX-Tabellenverweise in Liquid-Code durch MSPP-Verweise für virtuelle Tabellen im erweiterten Datenmodell. Alternativ können Sie die Tabelle Site-Komponente (logischer Name powerpagecomponent) gemeinsam mit dem Attribut Komponententyp (logischer Name powerpagecomponenttype) verwenden, um die entsprechenden Referenzen abzurufen.

Standarddatenmodell: Das entities-Liquid-Tag wird verwendet, um auf Weblinks-Werte im {% assign app_weblinks= entities['adx_weblinks'] %}-Code zuzugreifen.

Erweitertes Datenmodell: Statt Weblinks über entities-Liquid-Tags zu nutzen, verwenden Sie entsprechende -Liquid-Objekte. entities[adx_weblinks] direkt. In diesem Fall können entities['adx_weblinks'] durch weblinks-Liquid-Objekt ersetzt werden.

Adx-Tabellenverweise in fetch xml

Ersetzen Sie zum Beheben dieser Anpassung im erweiterten Datenmodell die Adx-Tabellenverweise in fetch xml durch Direktverweise für virtuelle Tabellen im erweiterten Datenmodell. Alternativ können Sie die Tabelle Site-Komponente (logischer Name powerpagecomponent) gemeinsam mit dem Attribut Komponententyp (logischer Name powerpagecomponenttype) verwenden, um die entsprechenden Referenzen abzurufen.

Standarddatenmodell: Der Tabellenname adx_webrole wird in der Fetch-XML-Abfrage verwendet.

{% fetchxml app_webroles %}
<fetch>
 <entity name='adx_webrole'>
  <attribute name='adx_name'/>
 <entity>
</fetch>
{% endfetchxml %}

Erweitertes Datenmodell: Verwenden Sie Site-Komponente (logischer Name powerpagecomponent) gemeinsam mit dem Attribut Komponententyp (logischer Name powerpagecomponenttype), um die entsprechenden Referenzen abzurufen.

{% fetchxml app_webroles %}
<fetch>
 <entity name='powerpagecomponent'>
  <attribute name='adx_name'/>
  <filter type='and'>
   <condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
  <entity>
</fetch>
{% endfetchxml %}

Typ und Werte der Site-Komponente

Komponententyp Wert
Veröffentlichungsstatus 1
Webseite 2
Webdatei 3
Weblinksatz 4
Weblink 5
Seitenvorlage 6
Inhaltsausschnitt 7
Web-Vorlage 8
Standort-Einstellung 9
Webseiten-Zugriffssteuerungsregel 10
Webrolle 11
Websitezugriff 12
Websitemarkierung 13
Basisformular 15
Basisformularmetadaten 16
List 17
Tabellenberechtigung 18
Erweitertes Formular 19
Erweiterter Formularschritt 20
Erweiterte Formularmetadaten 21
Umfrageplatzierung 24
Anzeigenplatzierung 26
Botverbraucher 27
Spaltenberechtigungsprofil 28
Spaltenberechtigung 29
Umleiten 30
Übergangsregel für den Veröffentlichungsstatus 31
Verknüpfung 32
Cloud-Flow 33
UX-Komponente 34

Benutzerdefinierter Workflow und Plugins für Adx-Tabellen

Gestalten Sie zum Beheben dieser Anpassung im erweiterten Datenmodell den Workflow und die Plugin-Logik um, und registrieren Sie sie neu in der entsprechenden Site-Tabelle.

Wenn ein Benutzer beispielsweise den Workflow/das Plugin bei der Primären Entität als Tabelle Webseite (logischer Name adx_webpage) im Standard-Datenmodell registriert hat, dann muss der Code im Workflow/Plugin in Tabelle Site-Komponente (logischer Name powerpagecomponent) geändert werden, ebenso wie die Attribute für das erweiterte Datenmodell.

Tabelle „Site-Komponente“ im Workflow und die Attribute für das erweiterte Datenmodell verwenden

Bekannte Probleme

Der Migrationsbefehl verarbeitet nur einen Batch von 5.000 Datensätzen vom Standard- auf das erweiterte Datenmodell.