Portalkonfiguration migrieren

Hinweis

Ab 12. Oktober 2022 ist Power Apps-Portale Power Pages. Weitere Informationen: Microsoft Power Pages ist jetzt allgemein verfügbar (Blog)
Wir werden die in Kürze migrieren und die Dokumentation für Power Apps-Portale mit der Power Pages-Dokumentation zusammenführen.

Die Portalentwicklung umfasst mehrere Konfigurationen und Anpassungen, um eine gewünschte Erfahrung für Portalendbenutzer zu erreichen.

Nachdem Sie die Entwicklung oder Konfiguration Ihrer Portal-Instanz abgeschlossen haben, möchten Sie möglicherweise die aktuelle Portal-Konfiguration aus der Entwicklungs- zur Testumgebung oder zu Produktionsumgebungen migrieren.

Bei der Migration wird die bestehende Konfiguration aus der Quellumgebung Microsoft Dataverse exportiert und anschließend in die Zielumgebung Dataverse importiert.

Vorbereiten der Zielumgebung

Hinweis

• Die Vorbereitung der Zielumgebung ist ein einmaliger Prozess. Sie müssen ein neues Portal bereitstellen, um die verwalteten Portallösungen auf Dataverse zu installieren und die Portal-Webanwendung zu konfigurieren. Bei diesem Prozess werden auch Standard-Portal-Metadaten installiert, die durch Portal-Metadaten aus Ihrer Quellumgebung ersetzt werden.
• Stellen Sie sicher, dass die maximale Anhangsgröße der Zielumgebung auf dieselbe oder eine größere Größe als Ihre Quellumgebung eingestellt ist.
• Die maximale Größe der Dateien wird durch die Einstellung maximale Dateigröße in der Registerkarte Systemeinstelllungen-E-Mail im Dialogfeld für die Umgebungssystemeinstellungen bestimmt.

1. Provisionieren Sie ein neues Portal in Ihrer Zielumgebung. Verwenden Sie die gleiche Portalvorlage, die Sie in Ihrer Quellumgebung bereitgestellt haben. Wenn Sie zum Beispiel das Dynamics 365 Customer Self-Service Portal in Ihrer Quellumgebung bereitgestellt haben, stellen Sie das Dynamics 365 Customer Self-Service Portal in Ihrer Zielumgebung bereit.

2. In der Ziel Umgebung löschen Sie mit der Portalverwaltungs-App den neu erstellten Datensatz der Website. Dadurch werden die Standard-Portalkonfigurationsdaten aus der Zielumgebung entfernt.

   

3. Löschen Sie in der Zielumgebung die Portal App. Dadurch wird die Portal App entfernt, die derzeit für die Darstellung des Standardportals konfiguriert ist.

   Hinweis

   Löschen Sie nicht die Portalverwaltungs-App!

   

4. Übertragen Sie die Portal-Metadaten aus der Quellumgebung mit dem Power Platform CLI oder dem Konfigurationsmigrationstool.

5. Stellen Sie in der Zielumgebung ein neues Portal mithilfe der Option Vorhandene Portal-Website bereit. Bei diesem Prozess wird ein Portal unter Verwendung der Portalkonfiguration konfiguriert, die Sie aus der Quellumgebung übertragen haben.

   

6. Die Portalaktualisierungen aus der Quellumgebung sollten sich in dieser neuen Zielumgebung widerspiegeln. In Zukunft sollten Sie in der Lage sein, die Konfiguration von Ihrer Quell- auf die Zielumgebung zu übertragen, indem Sie die Daten der Portalkonfiguration übertragen.

Übertragung von Portal-Metadaten

Power Platform CLI

Hinweis

Ab 12. Oktober 2022 ist Power Apps-Portale Power Pages. Weitere Informationen: Microsoft Power Pages ist jetzt allgemein verfügbar (Blog)
Wir werden die in Kürze migrieren und die Dokumentation für Power Apps-Portale mit der Power Pages-Dokumentation zusammenführen.

Übertragung der Portalkonfiguration mit Power Platform CLI

Die Microsoft Power Platform CLI bietet viele Funktionen speziell für Portale. Diese Befehle lassen zu, dass Sie die Portalkonfiguration aus einer Quellumgebung herunterladen und in eine Zielumgebung übertragen. Diese Befehle können auch in Ihre ALM-Prozesse eingebunden werden.

1. Erstellen Sie Power Platform CLI-Authentifizierungsprofile, um sich sowohl mit Ihrer Quell- als auch mit Ihrer Zielumgebung zu verbinden. Sie können ihnen einen Namen geben, um die Ziel- und die Quellumgebung leicht zu identifizieren.

   pac auth create --name [name] --url [environment url]
   

   Beispiel

   pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
   

2. Wenn die Authentifizierungsprofile erstellt sind, haben sie einen zugehörigen Index, der mit dem Befehl list ermittelt werden kann.

   pac auth list
   

   

3. Wählen Sie das CLI-Authentifizierungsprofil Power Platform, das mit der Quellumgebung verbunden ist.

   pac auth select --index [source environment index]
   

   Beispiel

   pac auth select --index 1
   

4. Ermitteln Sie die Website-ID für das Quellportal.

   pac paportal list
   

   

5. Laden Sie die Portalkonfigurationsdaten auf Ihre lokale Workstation herunter. Verwenden Sie die Option --overwrite, festgelegt auf true, wenn Sie die Portalkonfiguration zuvor in denselben Pfad heruntergeladen haben.

   pac paportal download --path [path] --webSiteId [website id]
   

   Beispiel

   pac paportal download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
   

6. Wählen Sie das CLI-Authentifizierungsprofil Power Platform, das mit der Zielumgebung verbunden ist.

   pac auth select --index [target environment index]
   

   Beispiel

   pac auth select --index 2
   

7. Laden Sie die Portalkonfigurationsdaten in die Zielumgebung hoch.

   pac paportal upload --path [path]
   

   Beispiel

   pac paportal upload --path "C:\paportals\portaldev"
   

Hinweis

Das CLI Tool Power Platform migriert keine Tabellen oder Tabellenschemata. Die Migration kann mit fehlenden Elementen wie Tabellen und Feldern fehlschlagen, wenn die Konfigurationsdaten nicht mit dem ausgewählten Schema übereinstimmen. Stellen Sie während des Imports sicher, dass in der Umgebung des Ziels derselbe Portaltyp bereits installiert ist und alle zusätzlichen Anpassungen wie Tabellen, Felder, Formulare oder Ansichten separat als Lösungen importiert werden.

Konfigurations-Migrations-Tool

Hinweis

Ab 12. Oktober 2022 ist Power Apps-Portale Power Pages. Weitere Informationen: Microsoft Power Pages ist jetzt allgemein verfügbar (Blog)
Wir werden die in Kürze migrieren und die Dokumentation für Power Apps-Portale mit der Power Pages-Dokumentation zusammenführen.

Übertragen Sie die Portalkonfiguration mit dem Konfigurationsmigrationstool

Hinweis

Die bevorzugte Methode ist die Verwendung der Power Platform CLI zur Übertragung von Portal-Metadaten.

Um Konfigurationsdaten zu exportieren, müssen Sie das Konfigurationsmigrationstool und eine portalspezifische Konfigurationsschema-Datei verwenden. Weitere Informationen zu diesem Tool finden Sie unter Konfigurationsdaten verwalten.

Hinweis

• Wir empfehlen Ihnen, die neueste Version des Tools für die Konfigurationsmigration zu verwenden. Das Tool für die Konfigurationsmigration kann von NuGet heruntergeladen werden. Weitere Informationen zum Herunterladen des Tools: Tools von NuGet herunterladen.
• Die mindestens erforderliche Lösungsversion von Portalen, die von Schemadateien für die Konfigurationsmigration unterstützt wird, ist 8.4.0.275. Es ist jedoch empfehlenswert, die aktuelle Lösungsversion zu verwenden.
• Quell- und Zielorganisationen müssen dieselbe Standardsprache haben, damit die Migration erfolgreich funktioniert.

Schemadateien sind für die folgenden Portaltypen verfügbar:

• In einer Umgebung mit Dataverse erstellte Portale

  • Benutzerdefiniertes Portal (leeres Portal)
  • Benutzerdefiniertes Portal (leeres Portal) (für Version 9.2.2103.x)
  • Benutzerdefiniertes Portal (Leeres Portal) (für Version 9.3.2201.x oder höher)

• Portale, die in einer Umgebung mit Customer Engagement-Apps erstellt werden (z. B. Dynamics 365 Sales und Dynamics 365 Customer Service)

  • Benutzerdefiniertes Portal (leeres Portal)
  • Benutzerdefiniertes Portal (leeres Portal) (für Version 9.2.2103.x)
  • Benutzerdefiniertes Portal (Leeres Portal) (für Version 9.3.2201.x oder höher)
  • Community-Portal
  • Customer Self-Service-Portal
  • Partnerportal
  • Mitarbeiter-Self-Service-Portal

Die standardmäßigen Schemadateien enthalten Informationen zu Portaltabellen, Beziehungen und Eindeutigkeitsdefinitionen für jede Entität. Weitere Informationen: Portalkonfigurationsdaten exportieren

Nach dem Export der Konfigurationsdaten müssen Sie sie in die Zielumgebung importieren. Weitere Informationen: Portalkonfigurationsdaten importieren

Hinweis

Das Konfigurationsmigrationstool verwendet Schemas, um Konfigurationsdaten zu exportieren und zu importieren. Das Tool migriert keine Tabellen oder Tabellenschemata. Die Migration kann mit fehlenden Elementen wie Tabellen und Feldern fehlschlagen, wenn die Konfigurationsdaten nicht mit dem ausgewählten Schema übereinstimmen.

Stellen Sie beim Export sicher, dass die Quellumgebung Portaltabellen enthält, wie in der Schemadatei des Konfigurationsmigrationstools angegeben. Sie können die Schemadateien weiterhin ändern, um Tabellen, Attribute usw. hinzuzufügen, zu entfernen und zu ändern, um Teilmengen von Konfigurationsdaten zu migrieren.

Stellen Sie während des Imports sicher, dass die Zielumgebung denselben Portaltyp enthält, der bereits installiert ist, mit allen zusätzlichen Anpassungen wie Tabellen, Felder, Formulare oder Ansichten, die separat als Lösungen importiert wurden.

Exportieren von Portalkonfigurationsdaten

Sie können Portalkonfigurationsdaten aus einem Quellsystem exportieren, indem Sie portalspezifische Konfigurationsdatenschemadateien verwenden.

1. Laden Sie das Tool für die Konfigurationsmigration herunter und extrahieren Sie es in den gewünschten Ordner.

2. Laden Sie eine Portalkonfigurations-Schemadatei für Ihren Portaltyp mithilfe der oben angegebenen Links herunter.

3. Doppelklicken Sie auf die Datei DataMigrationUtility.exe im Ordner <your_folder>\Tools\ConfigurationMigration, um das Tool für die Konfigurationsmigration auszuführen, wählen Sie auf dem Hauptbildschirm Daten exportieren aus und wählen Sie dann Weiter aus.

   

4. Geben Sie auf dem Bildschirm Anmeldung Authentifizierungsdetails an, um die Verbindung zu Ihrer Dataverse-Umgebung herzustellen, von der Sie Daten exportieren möchten. Wenn Sie mehrere Organisationen in der Dataverse-Umgebung haben, von der Sie die Daten exportieren möchten, aktivieren Sie das Kontrollkästchen Liste der verfügbaren Organisationen anzeigen, und wählen Sie dann Anmelden aus.

   

5. Wenn Sie mehrere Organisationen haben und im vorherigen Schritt das Kontrollkästchen Liste der verfügbaren Organisationen anzeigen ausgewählt haben, können Sie auf dem nächsten Bildschirm die Organisation auswählen, mit der Sie eine Verbindung herstellen möchten. Wählen Sie eine Dataverse-Umgebung für die Verbindung aus.

   Hinweis

   Wenn Sie nicht mehrere Organisationen haben, wird der Bildschirm nicht angezeigt.

6. Suchen Sie in der Schemadatei und wählen Sie die portalspezifische Konfigurationsschemadatei aus, die für den Datenexport verwendet werden soll.

7. Geben Sie unter In Datendatei speichern den Namen und den Ort der zu exportierenden Datendatei an.

   

8. Wählen Sie Daten exportieren aus. Der Bildschirm zeigt den Exportfortschritt und den Speicherort der exportierten Datei unten auf dem Bildschirmrand an, sobald der Import abgeschlossen ist.

   

9. Wählen Sie Schließen, um das Tool zu schließen.

Importieren von Portalkonfigurationsdaten

1. Führen Sie das Tool für die Konfigurationsmigration aus und wählen Sie auf dem Hauptbildschirm Daten importieren aus, und wählen Sie dann Weiter aus.

   

2. Geben Sie auf dem Bildschirm Anmeldung Authentifizierungsdetails an, um die Verbindung zu Ihrer Dataverse-Umgebung herzustellen, von der Sie Daten exportieren möchten. Wenn Sie mehrere Organisationen in der Dataverse-Umgebung haben, von der Sie die Daten exportieren möchten, aktivieren Sie das Kontrollkästchen Liste der verfügbaren Organisationen anzeigen, und wählen Sie dann Anmelden aus.

3. Wenn Sie mehrere Organisationen haben und im vorherigen Schritt das Kontrollkästchen Liste der verfügbaren Organisationen anzeigen ausgewählt haben, können Sie auf dem nächsten Bildschirm die Organisation auswählen, mit der Sie eine Verbindung herstellen möchten. Wählen Sie eine Dataverse-Umgebung für die Verbindung aus.

   Hinweis

   • Wenn Sie nicht mehrere Organisationen haben, wird der Bildschirm nicht angezeigt.
   • Stellen Sie sicher, dass die Portallösung bereits für die Organisation installiert ist, bei der Sie die Konfigurationen importieren möchten.

4. Der folgende Bildschirm fordert Sie auf, die zu importierende Datendatei (.zip) anzugeben. Navigieren Sie zu der Datendatei, wählen Sie sie aus, und wählen Sie dann Daten importieren aus.

   

5. Der nächste Bildschirm zeigt den Importstatus Ihrer Datensätze an. Der Datenimport geschieht in mehreren Durchläufen; zunächst werden die Grundlagendaten importiert, während die abhängigen Daten zusammengestellt werden. Dann werden die abhängigen Daten in den folgenden Durchläufen importiert, um alle Datenabhängigkeiten und Verknüpfungen zu berücksichtigen. Durch diese Aktion wird ein sauberer und konsistenter Datenimport sichergestellt.

6. Wählen Sie Beenden, um das Tool zu schließen.

Neues Portal mit migrierten Daten erstellen

Wenn der Migrationsprozess ein bestehendes Portal aktualisiert, sollten die Aktualisierungen jetzt in der Zielumgebung sichtbar sein. Wenn es sich um eine Migration für ein neues Portal handelt, können Sie jetzt das neue Portal für den importierten Website-Datensatz erstellen, indem Sie die Option Daten aus bestehendem Website-Datensatz verwenden verwenden. Weitere Informationen: Portal erstellen

Migration von Mandant zu Mandant

Power Apps Portale unterstützen keine Migration von Mandant zu Mandant. Um ein Portal von einem Mandanten zu einem anderen zu migrieren, müssen Sie die folgenden Schritte ausführen:

1. Zurücksetzen Ihres Portals im Quellmandanten.

2. Ein neues Portal in einer Umgebung mit Dataverse oder mit Customer Engagement-Apps bereitstellen

3. Migrieren Sie die Portalkonfigurationen und Anpassungen anhand der Schritte, die in diesem Artikel bereits erläutert wurden.

Siehe auch

• Verfolgen Sie die Änderungen an der Power Apps Portale Konfiguration.
• Unterstützung der Portale für Microsoft Power Platform CLI.
• Mandant-zu-Mandant-Migration einer Power Platform-Umgebung.
• Mandant-zu-Mandant-Migration von Modellbasierten Apps in Dynamics 365 wie Sales, Customer Service, Marketing, Field Service und Project Service Automation.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).