Verschieben von Konfigurationsdaten über Umgebungen und Organisationen hinweg mit dem Konfigurationsmigrations-Tool

Mit dem Konfigurationsmigrations-Tool können Sie Konfigurationen über Umgebungen und Organisationen hinweg verschieben. Konfigurationsdaten werden verwendet, um benutzerdefinierte Funktionalität in Apps zur Kundeninteraktion (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing und Dynamics 365 Project Service Automation) zu definieren, und werden normalerweise in benutzerdefinierten Entitäten gespeichert. Konfigurationsdaten unterscheiden sich von Endbenutzerdaten (Konten, Kontakte usw.), Ein typisches Beispiel von Konfigurationsdaten ist das, was Sie in Unified Service Desk für Dynamics 365 definieren, um eine benutzerdefinierte Callcenteragent-Anwendung zu konfigurieren. Die Unified Service Desk-Entitäten, zusammen mit den Konfigurationsdaten, die in den Entitäten gespeichert sind, definieren eine Agent-Anwendung. Weitere Informationen zu Unified Service Desk finden Sie unter Verwaltungshandbuch für Unified Service Desk.

Mit dem Konfigurationsmigration Tool können Sie:

• Wählen Sie die Entitäten und Felder aus, aus denen Sie die Konfigurationsdaten exportieren möchten.

• Vermeiden Sie doppelte Datensätze auf dem Zielsystem, indem Sie eine Eindeutigkeitsbedingung für die einzelnen Entitäten auf einer Kombination der Felder aus der Entität definieren, die verwendet wird, um sie mit den Werten im Zielsystem zu vergleichen. Wenn keine übereinstimmenden Werte vorhanden sind, wird auf dem Zielsystem ein eindeutiger Datensatz erstellt. Wird kein übereinstimmender Datensatz gefunden, wird der Datensatz auf dem Zielsystem aktualisiert.

  Notiz

  Wenn keine Duplikaterkennungsbedingung (Eindeutigkeit) für eine Entität angegeben ist, die exportiert wird, verwendet das Tool den Hauptfeldnamen der Entität, die mit den vorhandenen Daten auf dem Zielsystem zu vergleichen ist.

• Deaktivieren von Plug-Ins, bevor Sie Daten exportieren, und reaktivieren Sie diese anschließend erneut auf dem Zielsystem, nachdem der Import für alle Entitäten oder für ausgewählte Entitäten abgeschlossen ist.

• Überprüfen Sie das Schema für die ausgewählten Entitäten, die exportiert werden sollen, um sicherzustellen, dass alle erforderlichen Informationen/Daten vorhanden sind.

• Verwenden Sie ein vorhandenes Schema erneut, um Daten aus einem Quellsystem zu exportieren.

• Verschieben Sie due DateTime-Felder beim Import für Demoumgebungen automatisch vorwärts.

• Betten Sie die exportierten Module ein, die von diesem Tool in anderen Programmen erstellt wurden (Schema- und Datendateien). Sie können z. B. die exportierten Daten in Package Deployer mit anderen Lösungsdateien und -daten verwenden, um die Datenpakete auf einer Umgebung zu erstellen und bereitzustellen Mehr Informationen: Bereitstellen von Paketen mit Package Deployer

Das Konfigurationsmigrationstool ist als NuGet Paket verfügbar oder Sie können das Tool mithilfe von Power Platform herunterladen.

Wie funktioniert das Configuration Migration-Tool?

Das folgende Diagramm zeigt, wie das Configuration Migration Tool für die Migration von Konfigurationsdaten verwendet wird.

Definieren Sie das Schema der Quelldaten, die exportiert werden sollen: Die Schemadatei (XML-Dateien) enthält Informationen zu den Daten, die Sie exportieren möchten, wie die Entitäten, Attribute, Geschäftsbeziehungen, definition der Eindeutigkeit der Daten, und ob die Plug-Ins deaktiviert werden sollen, bevor Sie die Daten exportieren. Weitere Informationen: Festlegen eines Schemas zum Exportieren von Konfigurationsdaten

Verwenden Sie das Schema, um Daten zu exportieren: Verwenden Sie die Schemadatei, um die Daten in eine ZIP-Datei zu exportieren, die Daten und das Schema der exportierten Daten enthält. Weitere Informationen: Festlegen eines Schemas zum Exportieren von Konfigurationsdaten

Importieren der exportierten Daten: Verwenden Sie die exportierten Daten (ZIP-Datei), um sie in die Zielumgebung zu importieren. 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. Dadurch wird ein sauberer Datenimport sichergestellt. Weitere Informationen: Portalkonfigurationsdaten importieren

Problembehandlung bei Konfigurations-Datenmigrationsprobleme mithilfe von Protokolldateien

Das Konfigurationsmigrations-Tool stellt Protokollierungssupport bereit, um ausführliche Informationen zu erhalten zu Fehlern, die bei der Anmeldung an der Umgebung mit dem Tool auftraten, zu mit dem Tool ausgeführten Aktivitäten während der Schemadefinition sowie dem Export/Import der Konfigurationsdaten und zu Daten, die mit dem Tool importiert wurden. Es gibt drei Protokolldateien, die durch das Tool generiert werden und unter dem folgenden Speicherort auf dem Computer verfügbar sind, auf dem Sie folgendes Tool verwenden: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Version>.

• Login_ErrorLog.log: Enthält Informationen zu Problemen, die während der Verwendung des Tools zur Anmeldung an der Umgebung aufgetreten sind. Wenn es Probleme gibt während der Anmeldung gibt, wird auf dem Anmeldungsbildschirm des Tools eine Meldung mit einem Link zu dieser Protokolldatei angezeigt. Die Meldung besagt, dass ein Fehler beim Verarbeiten der Anmeldeanforderung aufgetreten ist und der Benutzers kann das Fehlerprotokoll anzeigen. Sie können auf den Link in der Meldung klicken, um diese Protokolldatei anzuzeigen. Die Protokolldatei wird erstellt, wenn zum ersten Mal Anmeldungsprobleme in dem Tool auftreten. Danach wird die Protokolldatei verwendet, um Informationen über ein Anmeldungsproblem aufzuzeichnen, wann immer es auftritt.

• DataMigrationUtility.log: Stellt ausführliche Informationen zur jeweiligen Aufgabe bereit, die im Tool während der letzten Ausführung durchgeführt wurden. Sie können die Protokolldatei im Tool anzeigen, indem Sie im Menü Protokolle auf dem Hauptbildschirm klicken, und auf Ausgeführter Datensatz klicken.

• ImportDataDetail.log: Bietet detaillierte Informationen zu den Daten, die bei dem letzten Importjob mithilfe der Tools importiert wurden. Bei jeder Ausführung eines Importjobs unter Verwendung dieses Tools werden die vorhandenen Details der Protokolldatei in eine Datei namens ImportDataDetail._old.log in demselben Verzeichnis verschoben und die ImportDataDetail.log-Datei zeigt Informationen über die aktuellen, mit dem Tool vorgenommenen Importvorgänge an. Sie können diese Protokolldatei im Tool anzeigen, indem Sie im Menü Protokolle auf dem Hauptbildschirm klicken, und auf Letztes Importprotokoll klicken.

Bewährte Methoden zum Migrieren der Konfigurationsdaten mithilfe des Tools

Nachfolgend sind Dinge, die Sie während der Verwendung dieses Tools beachten sollten, um die Konfigurationsdaten zu migrieren:

• Beim Erstellen des Exportdatenschemas müssen Sie Eindeutigkeitsregeln für jede Entität entsprechend definieren, um unbeabsichtigte Aktualisierungen im Zielsystem zu vermeiden.

• Importieren Sie die exportierten Daten in einer Vorproduktionsumgebung (vorzugsweise enem Spiegelbild der Produktionsumgebung), um sicherzustellen, dass die Datenimportergebnisse so sind, wie Sie beabsichtigen.

• Sichern Sie Ihre Produktionsumgebung, bevor Sie die Daten importieren.

Einschränkungen

• Migration der Kalenderentität wird nicht unterstützt.
• Migration der Bildspalte wird nicht unterstützt.

Siehe auch

Herunterladen von Tools von NuGet
Festlegen eines Schemas zum Exportieren von Konfigurationsdaten
Ändern eines Konfigurationsdatenschemas
Konfigurationsdaten importieren
Verwalten von Produktkatalogkonfiguration