Verschieben von Konfigurationsdaten über Instanzen und Organisationen hinweg mit dem Configuration Migration-Tool

Dieser Inhalt gilt auch für die lokale Version

Mit dem Configuration Migration Tool können Sie Konfigurationen zu Dynamics 365 for Customer Engagement-Instanzen und -Organisationen verschieben. Konfigurationsdaten werden verwendet, um benutzerdefinierte Funktionen in Customer Engagement Apps zu definieren und sind 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 for 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, siehe Unified Service Desk-Handbuch.

Mit dem Configuration Migration 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. Sind keine entsprechenden Werten vorhanden, wird ein eindeutiger Datensatz auf dem Zielsystem erstellt. Wird kein übereinstimmender Datensatz gefunden, wird der Datensatz auf dem Zielsystem aktualisiert.

    Hinweis

    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 Dynamics 365 for Customer Engagement Apps Package Deployer mit anderen Lösungsdateien und -daten verwenden, um die Datenpakete auf einer Customer Engagement-Instanz zu erstellen und bereitzustellen Weitere Informationen: Bereitstellen von Paketen mithilfe von Dynamics 365 for Customer Engagement apps Package Deployer und Windows PowerShell

Wichtig

Das Configuration Migration Tool unterstützt nicht das Filtern von Datensätzen in einer Entität. Standardmäßig werden alle Datensätze in der ausgewählten Entität exportiert.

Informationen zum Herunterladen des MIgrationskonfigurationstools vgl. Informationen unter Tools von NuGet herunterladen.

Wie funktioniert das Configuration Migration-Tool?

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

Configuration migration Prozessflussdiagramm

Schritt 1-Symbol 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

Schritt 2-Symbol 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

Schritt 3-Symbol Importieren der exportierten Daten: Verwenden Sie die exportierten Daten (.zip file), um sie in die Customer Engagement-Instanz 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: Konfigurationsdaten importieren

Problembehandlung bei Konfigurations-Datenmigrationsprobleme mithilfe von Protokolldateien

Das Configuration Migration Tool stellt Protokollierungssupport bereit, um ausführliche Informationen zu Fehlern zu erhalten, die bei der Anmeldung in der Customer Engagement-Instanz mit dem Tool auftraten, und um Informationen zu mit dem Tool ausgeführten Aktivitäten während der Schemadefinition und dem Export/Import von Konfigurationsdaten zu erhalten und um Auskunft über die Daten zu erhalten, 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 das Tool verwenden: c:\Users\<UserName> \AppData\Roaming\Microsoft\DataMigrationUtility\<Version>.

  • Login_ErrorLog.log: Dadurch werden Informationen zu Problemen angegeben, die während der Verwendung des Tools zur Anmeldung bei der Customer Engagement 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.

Siehe auch

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