Creare mapping di dati per l'importazione
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Per importare i dati in Microsoft Dynamics 365, è necessario fornire i mapping dei dati appropriati.
Gli esempi di mapping di dati è disponibile nel percorso seguente dell'SDK: SDK\Resources\DataImportMaps\.Scarica il pacchetto SDK di Microsoft Dynamics CRM.
Utilizzare i mapping dei dati per mappare i dati contenuti nel file di origine agli attributi di entità di Microsoft Dynamics 365. È necessario eseguire il mapping di ogni colonna nel file di origine a un attributo appropriato. I dati nelle colonne non mappate vengono esclusi dall'operazione di importazione dati.
Il mapping dei dati è rappresentato da un'entità di mapping per l'importazione (mapping di dati). È possibile creare un nuovo mapping tramite il messaggio CreateRequest o aggiornare un mapping esistente utilizzando il metodo IOrganizationService.Update. Il mapping è un nome univoco che è contenuto nell'attributo ImportMap.Name. È possibile specificare il nome dell'origine dell'importazione per cui il mapping si dati è stato creato tramite l'attributo ImportMap.Source.
In questo argomento
Mapping di colonna, valore di elenco e ricerca
Mapping dei proprietari
Note e allegati
Importare ed esportare mapping di dati
Mapping di colonna, valore di elenco e ricerca
Per eseguire il mapping di una colonna, un valore elenco o un valore di ricerca nel file di origine a un attributo di Microsoft Dynamics 365, utilizzare i mapping seguenti:
Mapping colonna
Esegue il mapping di una colonna di un file di origine a un attributo di entità di Microsoft Dynamics 365. Per il mapping di colonna, utilizzare l'entità mapping di colonna (ColumnMapping). È possibile utilizzare relazioni 1:1 (uno-a-uno) o 1:N (uno-a-molti) tra gli attributi di origine e di destinazione. È ad esempio possibile eseguire il mapping delle informazioni di indirizzo di un account all'indirizzo di fatturazione e all'indirizzo di spedizione di un ordine.
Mapping valori di elenco
Esegue il mapping di un valore di elenco in un file di origine a un attributo di Microsoft Dynamics 365 di tipo OptionSetValue. Per il mapping di valore di elenco, utilizzare l'entità mapping di valore di elenco (PicklistMapping).
Se un valore specificato nella colonna del file di origine è un valore di elenco, ad esempio OptionSetValue, Status, State e Boolean, è necessario specificare un mapping di valore di elenco aggiuntivo a un mapping di colonna. Ad esempio, eseguire il mapping dei valori di elenco "bill" e "ship" nel file di origine ai valori di fattura e di spedizione di tipo OptionSetValue.
Mapping di attributi di tipo lookup
Esegue il mapping di un valore di ricerca in un file di origine a un attributo di Microsoft Dynamics 365 di tipo EntityReference. Per il mapping di ricerca, utilizzare l'entità mapping di ricerca (LookupMapping).
Se il valore specificato nel file di origine fa riferimento a un'entità, è necessario fornire un mapping di ricerca per il valore. Utilizzare l'attributo LookupMapping.LookupSourceCode per specificare se ricercare l'entità di riferimento nel file di origine o all'interno di Microsoft Dynamics 365. Se si utilizzano tipi con associazione anticipata, è possibile utilizzare l'enumerazione LookupSourceType per impostare i valori di ricerca. Per eseguire la ricerca nel file di origine, utilizzare il valore LookupSourceType.Source. Per cercare all'interno di Microsoft Dynamics 365, utilizzare il valore LookupSourceType.System. Per un elenco dei valori di LookupSourceCode, vedere valori di elenco a discesa per questa entità.Per visualizzare i metadati di entità per l'organizzazione, installa la soluzione Browser di metadati descritta in Visualizzazione dei metadati per l'organizzazione. Puoi inoltre visualizzare i metadati per un'organizzazione non personalizzata nel file Excel EntityMetadata.xlsx incluso nella cartella di livello superiore di Download degli SDK. È possibile specificare più mapping di ricerca. Il processo di trasformazione asincrono elabora tutti i mapping disponibili. Cerca i record di riferimento e aggiorna la tabella di analisi con gli identificatori univoci di record. Per ulteriori informazioni, vedere Eseguire l'importazione dei dati.
Mapping dei proprietari
Utilizzare il mapping dei proprietari per eseguire il mapping di un utente specificato nel file di origine a un utente in Microsoft Dynamics 365. Per le informazioni di registrazione, utilizzare il nome di accesso utente di Microsoft Dynamics 365. Per il mapping dei proprietari, utilizzare l'entità mapping dei proprietari (OwnerMapping).
Note e allegati
Il mapping per le note e gli allegati viene gestito in modo diverso da altre entità. Le note e gli allegati vengono utilizzati per aggiungere ulteriori informazioni a un record in Microsoft Dynamics 365. Le note vengono archiviate come testo e gli allegati vengono archiviati come file nel database di Microsoft Dynamics 365.
Per creare una nota in Microsoft Dynamics 365, impostare l'attributo Annotation.IsDocument nell'entità annotazione (nota) su false. Per creare un allegato, impostare IsDocument su true.
Utilizzare le impostazioni seguenti per il mapping di note e allegati:
Impostare l'attributo ColumnMapping.SourceAttributeName su "true" o "false". Il valore "true" indica un allegato. Il valore "false" indica una nota.
Impostare l'attributo ColumnMapping.TargetAttributeName su IsDocument.
Impostare l'attributo ColumnMapping.ProcessCode sul valore ImportProcessCode.Internal dell'enumerazione ImportProcessCode, se si utilizzano tipi con associazione anticipata. Per un elenco dei valori di ProcessCode, vedere valori di elenco a discesa per questa entità.
Se i dati di origine rappresentano una nota, eseguire il mapping del testo della nota all'attributo Annotation.NoteText. Se si utilizzano file Salesforce, in genere sono memorizzati nel disco sotto i numeri ID univoci. Per importare un allegato, è necessario eseguire il mapping di un numero di identificazione file contenuto nel file di origine all'attributo Annotation.DocumentBody. L'attributo DocumentBody archivia il contenuto dell'allegato.
Il processo di importazione asincrono cerca i mapping con il nome di attributo di origine impostato su true e false per individuare le note e gli allegati. Se viene individuato un mapping di allegato, cerca i file specificati nel disco e carica il contenuto del file come allegato in Microsoft Dynamics 365. Se un file non viene trovato, viene visualizzato un errore.
Se non si fornisce il mapping per un'entità annotazione (nota), il processo di importazione genera un mapping predefinito per la nota.
Nota
Le dimensioni massime dei file che è possibile caricare sono determinate dalla proprietà Organization.MaxUploadFileSize. Questa proprietà viene impostata nella scheda Posta elettronica in Impostazioni di sistema nell'applicazione Dynamics 365. Tramite questa impostazione è possibile limitare le dimensioni dei file che è possibile allegare ai messaggi di posta elettronica, alle note e alle risorse Web. L'impostazione predefinita è 5 MB. Tuttavia, la dimensione dell'allegato non può superare la dimensione massima di richiesta HTTP (impostazione predefinita: 16 MB). Per rendere effettiva la modifica, reimpostare Internet Information Services (IIS). A tale scopo, fare clic sul pulsante Start, scegliere Esegui, digitare iisreset, quindi fare clic su OK.
Importare ed esportare mapping di dati
È possibile esportare un mapping dei dati esistente in un file XML e importare mapping di dati XML in Microsoft Dynamics 365. Per esportare un mapping di dati da Microsoft Dynamics 365, utilizzare il messaggio ExportMappingsImportMapRequest. Per importare i mapping di dati XML e creare un mapping di dati in Microsoft Dynamics 365, utilizzare il messaggio ImportMappingsImportMapRequest.
Vedere anche
Importa dati
Aggiungere i mapping di trasformazione per l'importazione
Aggiungere i mapping di trasformazione per l'importazione
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright