Eseguire l'importazione dei dati
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
L'importazione dei dati viene eseguita direttamente nel server Microsoft Dynamics 365. Per eseguire l'importazione dei dati, configurare i processi asincroni da eseguire in background per effettuare le operazioni indicate di seguito secondo l'ordine indicato:
Analizzare i dati di origine che sono contenuti nel file di importazione.
Trasformare i dati analizzati utilizzando il mapping dei dati.
Caricare i dati convertiti in Microsoft Dynamics 365.
Tutti gli utenti di Microsoft Dynamics 365 che dispongono delle autorizzazioni appropriate possono eseguire l'importazione dei dati.
In questo argomento
Analizzare i dati di origine
Trasformare i dati di analisi
Caricare i dati trasformati nel server di destinazione
Registrare gli errori
Importare dati di controllo
Analizzare i dati di origine
L'analisi dei dati di origine include l'analisi di tutti i file di importazione associati a un'importazione specifica (importazione di dati).
I dati analizzati vengono archiviati nelle tabelle di analisi temporanee create per ogni file importato. Il nome della tabella di analisi è archiviato nell'attributo ImportFile.ParsedTableName. Le intestazioni di colonna del file di origine sono specificate nell'attributo ImportFile.HeaderRow. Se il file di origine non include una prima riga contenente le intestazioni di colonna, questo attributo specifica le intestazioni di colonna predefinite generate dal sistema.
Salvare i dati analizzati nella tabella di analisi utilizzando il messaggio ParseImportRequest. Recuperare i dati dalla tabella di analisi utilizzando i messaggi GetDistinctValuesImportFileRequest e RetrieveParsedDataImportFileRequest.
Nella tabella seguente sono elencati i messaggi utilizzabili per analizzare i file di importazione e per recuperare i dati analizzati dalle tabelle di analisi.
Messaggio |
Descrizione |
|---|---|
Invia un processo asincrono che analizza tutti i file di importazione associati all'importazione specificata (importazione dei dati). Passare l'ID dell'importazione associata (importazione dei dati) nella proprietà ImportId di questa richiesta. L'ID del processo asincrono che viene eseguito in background ed esegue l'analisi dei dati viene restituito nella proprietà AsyncOperationId della risposta del messaggio. |
|
Restituisce valori distinti per una colonna del file di origine contenente i valori di elenco. Passare l'ID del file di importazione associato nella proprietà ImportFileId di questa richiesta. I valori distinti vengono restituiti nella matrice di stringhe, nella proprietà Values della risposta del messaggio. Utilizzare questo messaggio solo dopo aver creato una tabella di analisi utilizzando il messaggio ParseImportRequest. Importante Non utilizzare questo messaggio dopo aver utilizzato il messaggio ImportRecordsImportRequest. Non è possibile accedere alla tabella di analisi dopo che il processo di importazione inviato dal messaggio ImportRecordsImportRequest ha terminato l'esecuzione. |
|
Recupera i dati dalla tabella di analisi. Passare l'ID del file di importazione associato nella proprietà ImportFileId di questa richiesta. I dati analizzati vengono restituiti nella matrice di stringhe bidimensionale, nella proprietà Values della risposta del messaggio. I dati vengono restituiti con lo stesso ordine di colonna dell'ordine di colonna del file di origine. Utilizzare questo messaggio solo dopo aver creato una tabella di analisi utilizzando il messaggio ParseImportRequest. Importante Non utilizzare questo messaggio dopo aver utilizzato il messaggio ImportRecordsImportRequest. Non è possibile accedere alla tabella di analisi dopo che il processo di importazione inviato dal messaggio ImportRecordsMessage ha terminato l'esecuzione. |
Trasformare i dati di analisi
Durante la trasformazione, è possibile modificare i dati analizzati applicando tutti i mapping dei dati e le trasformazioni disponibili che sono associati a una determinata importazione (importazione dei dati) ai dati.
Utilizzare il messaggio TransformImportRequest per inviare un processo asincrono per trasformare i dati analizzati. Passare un identificatore univoco dell'importazione associata (importazione dei dati) nell'attributo Import.ImportId della richiesta. Un identificatore univoco del processo asincrono che viene eseguito in background ed esegue la trasformazione viene restituito nella proprietà AsyncOperationId della risposta del messaggio.
Caricare i dati trasformati nel server di destinazione
Una volta eseguita la trasformazione, i dati sono pronti per essere caricati nel server Microsoft Dynamics 365.
Utilizzare il messaggio ImportRecordsImportRequest per inviare un processo asincrono per caricare i dati trasformati in Microsoft Dynamics 365. L'identificatore univoco dell'importazione associata (importazione dati) deve essere specificato nella proprietà ImportId della richiesta. Un identificatore univoco del processo asincrono che viene eseguito in background e carica i dati in Microsoft Dynamics 365 viene restituito nella proprietà AsyncOperationId della risposta del messaggio. Tutti i file di importazione associati a un'importazione specificata (importazione dei dati) vengono importati.
Ciascun processo di importazione è un numero di sequenza univoco che viene archiviato dal processo nell'attributo ImportSequenceNumber dei record che crea. L'attributo Organization.CurrentImportSequenceNumber contiene un numero di sequenza univoco dell'ultimo processo di importazione che è stato eseguito nel sistema. È possibile utilizzare i numeri di sequenza univoci per tenere traccia dei record appartenenti a un processo di importazione.
Registrare gli errori
Un errore di importazione di un record può verificarsi durante l'analisi, la trasformazione o il caricamento dei dati. I motivi dell'errore e altre informazioni dettagliate sui record che non sono stati importati correttamente vengono acquisiti nell'entità registro di importazione (ImportLog).
Per individuare quanti record non sono stati importati correttamente, recuperare l'attributo ImportFile.FailureCount del record. Per verificare in quanti record si sono verificati degli errori parziali durante l'importazione, recuperare l'attributo ImportData.HasError. Se l'attributo HasError è true, si è verificato un errore parziale; se è false, il record è stato importato correttamente.
Importare dati di controllo
Le entità di Microsoft Dynamics 365 dispongono di quattro attributi predefiniti che sono utilizzati per tenere traccia della data e dell'ora di creazione e di ultima modifica di un record e dell'autore della sua creazione e modifica.
L'attributo createdon specifica la data e l'ora in cui il record è stato creato. Per importare i dati nell'attributo createdon, mappare la colonna di origine contenente tali dati all'attributo overriddencreatedon. Durante l'importazione, l'attributo createdon del record viene aggiornato con il valore che è stato mappato all'attributo overriddencreatedon e l'attributo overriddencreatedon viene impostato sulla data e l'ora dell'importazione dei dati. Se nessun valore di origine è mappato all'attributo overriddencreatedon, l'attributo createdon viene impostato sulla data e l'ora di importazione dei dati e l'attributo overriddencreatedon viene impostato su un valore qualsiasi.
Nota
Per sostituire il valore nell'attributo createdon durante l'importazione, è necessario disporre del privilegio prvOverrideCreatedOnCreatedBy. Si noti che il nome del privilegio implica che è anche possibile sostituire l'attributo createdby durante l'importazione. Tuttavia, questa funzionalità al momento non è supportata.
Non è possibile importare dati negli attributi modifiedon, createdby e modifiedby. Se è necessario archiviare i dati relativi all'autore della creazione e della modifica dei dati e alla data di modifica dei dati, sarà possibile creare degli attributi personalizzati in Microsoft Dynamics 365 e mappare le colonne di origine ai nuovi attributi personalizzati.
Vedere anche
Importa dati
Configurare l'importazione dati
Post di blog: come importare allegati a livello di programmazione
Entità importazione dei dati
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright