Spostare i dati di configurazione tra gli ambienti e le organizzazioni con lo strumento Migrazione della configurazione

Lo Strumento Migrazione della configurazione consente di spostare i dati di configurazione tra ambienti e le organizzazioni . I dati di configurazione vengono utilizzati per definire funzionalità personalizzate nelle app di interazione con i clienti (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing e Dynamics 365 Project Service Automation) e in genere sono archiviati in entità personalizzate. I dati di configurazione sono diversi dai dati dell'utente finale (account, contatti e così via). Un esempio tipico di dati di configurazione sono quelli che vengono definiti in Unified Service Desk per Dynamics 365 per configurare un'applicazione personalizzata dell'agente di un call center. Le entità di Unified Service Desk, insieme ai dati di configurazione archiviati nelle entità, definiscono un'applicazione dell'agente. Per ulteriori informazioni su Unified Service Desk, consulta Guida di Unified Service Desk.

Lo Strumento Configuration Migration consente di:

• Selezionare le entità e i campi da cui si desidera esportare i dati di configurazione.

• Evitare i record duplicati nel sistema di destinazione definendo una condizione di unicità per ogni entità in base a una combinazione di campi nell'entità, che viene utilizzata per il confronto con i valori nel sistema di destinazione. Se non sono presenti valori corrispondenti, viene creato un record univoco nel sistema di destinazione. Se viene trovato un record corrispondente, il record viene aggiornato nel sistema di destinazione.

  Nota

  Se non viene specificata alcuna condizione di rilevamento duplicati (unicità) per un'entità che deve essere esportata, viene utilizzato il nome del campo primario dell'entità per il confronto con i dati esistenti nel sistema di destinazione.

• Disabilitare i plug-in prima di esportare i dati, quindi riabilitarli nel sistema di destinazione al completamento dell'importazione per tutte le entità o le entità selezionate.

• Convalidare lo schema per le entità selezionate da esportare per garantire la presenza di tutte le informazioni e i dati richiesti.

• Riutilizzare uno schema esistente per esportare i dati da un sistema di origine.

• Spostare automaticamente i campi di DateTime in avanti all'importazione per ambienti dimostrativi.

• Importare in altri programmi i moduli esportati creati con questo strumento (file di dati e di schema). Ad esempio, è possibile utilizzare i dati esportati nello strumento Package Deployer e altri file delle soluzioni per creare e distribuire pacchetti in un ambiente. Ulteriori informazioni:Distribuire pacchetti tramite Package Deployer

Lo strumento di migrazione della configurazione è disponibile come pacchetto NuGet oppure puoi scaricare lo strumento utilizzando l'interfaccia della riga di cmando Power Platform.

Come funziona lo Strumento Configuration Migration?

Nel seguente diagramma viene illustrato in che modo viene utilizzato lo Strumento Configuration Migration per eseguire la migrazione dei dati di configurazione.

Definisci lo schema dei dati di origine da esportare: il file di schema (con estensione XML) contiene informazioni sui dati che vuoi esportare come le entità, gli attributi, le relazioni, la definizione di unicità dei dati e sulla necessità di disabilitare i plug-in prima di esportare i dati. Ulteriori informazioni: Creare uno schema per esportare i dati di configurazione

Utilizzare lo schema per esportare i dati: utilizzare il file di schema per esportare i dati in un file ZIP che contiene i dati e lo schema dei dati esportati. Ulteriori informazioni: Creare uno schema per esportare i dati di configurazione

Importare o dati esportati: utilizzare i dati esportati (file con estensione zip) da importare nell'istanza di destinazione. L'importazione dei dati viene eseguita in più passaggi per importare prima i dati di base e mettendo in coda i dati dipendenti, quindi reimportando i dati dipendenti nei passaggi successivi per gestire eventuali dipendenze o correlazioni dei dati. In questo modo viene garantita un'importazione pulita. Ulteriori informazioni: Importare dati di configurazione

Risolvere i problemi relativi alla migrazione dei dati di configurazione tramite file di registro

Nello Strumento Migrazione della configurazione è presente la funzionalità di registrazione che consente di ottenere informazioni dettagliate sugli errori che possono verificarsi durante l'accesso all'ambiente tramite lo strumento, sulle attività effettuate dallo strumento durante la definizione dello schema e l'esportazione/ importazione dei dati di configurazione e sui dati importati utilizzando lo strumento. Lo strumento genera tre file di registro che sono disponibili nel percorso seguente nel computer in cui viene eseguito lo strumento: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Version>.

• Login_ErrorLog.log: fornisce informazioni sui problemi che si verificano quando si utilizza lo strumento per accedere all'ambiente. Se durante l'accesso si verificano dei problemi, verrà visualizzato un messaggio nella schermata di accesso dello strumento contenente un collegamento a questo file di registro. Il messaggio indica che si è verificato un errore durante l'elaborazione della richiesta di accesso e che l'utente può visualizzare il registro errori. È possibile fare clic sul collegamento nel messaggio per visualizzare il file di registro. Il file di registro viene creato la prima volta che si verifica un problema di accesso nello strumento. Questo file di registro viene quindi utilizzato per registrare le informazioni su un problema di accesso in qualunque momento si verifichi.

• DataMigrationUtility.log: contiene informazioni dettagliate sulle singole attività dello strumento durante l'ultima esecuzione. È possibile visualizzare il file di registro dallo strumento facendo clic sul menu Log nella schermata principale e facendo clic su Esecuzione registro.

• ImportDataDetail.log: contiene informazioni dettagliate sui dati importati nell'ultimo processo di importazione eseguito con lo strumento. Ogni volta che si esegue un processo di importazione utilizzando questo strumento, i dettagli esistenti del file di registro vengono spostati in un file denominato ImportDataDetail._old.log nella stessa directory, mentre il file ImportDataDetail.log contiene informazioni sull'ultimo processo di importazione eseguito utilizzando lo strumento. È possibile visualizzare questo file di registro dallo strumento facendo clic sul menu Log nella schermata principale e facendo clic su Registro ultima importazione.

Procedure consigliate per la migrazione dei dati di configurazione tramite lo strumento

Di seguito sono indicate alcune operazioni da considerare quando si utilizza questo strumento per la migrazione dei dati di configurazione:

• Durante la creazione dello schema dei dati per l'esportazione, è necessario definire delle regole di unicità in modo appropriato per ogni entità al fine di evitare aggiornamenti involontari dei dati nel sistema di destinazione.

• Importare i dati esportati in un ambiente di preproduzione (preferibilmente un'immagine speculare l'ambiente di produzione) per assicurarsi che l'importazione dei dati produca i risultati desiderati.

• Eseguire il backup dell'ambiente di produzione prima di importare i dati.

Limiti

• La migrazione dell'entità Calendario non è supportata.
• La migrazione della colonna Immagine non è supportata.

Vedi anche

Scaricare gli strumenti da NuGet
Creare uno schema per esportare i dati di configurazione
Modificare uno schema dei dati di configurazione
Importare dati di configurazione
Gestire la configurazione del catalogo prodotti