Come configurare Dynamics CRM in un'attività di copia
Questo articolo illustra come usare l'attività di copia in Azure Data Factory per copiare dati da e in Dynamics CRM.
Prerequisiti
Per utilizzare questo connettore con l'autenticazione del service-principal Entra ID, è necessario impostare l'autenticazione server-to-server (S2S) in Dynamics CRM. Registrare prima l'utente dell'applicazione (entità servizio) in Microsoft Entra. Per altre informazioni, vedere Creare un'applicazione Microsoft Entra e un'entità servizio in grado di accedere alle risorse.
Durante la registrazione dell'applicazione, sarà necessario creare l'utente in Dynamics CRM e concedere le autorizzazioni. Queste autorizzazioni possono essere concesse direttamente o indirettamente aggiungendo l'utente dell'applicazione a un team a cui sono state concesse le autorizzazioni in Dynamics CRM. Per altre informazioni su come configurare un utente dell'applicazione per l'autenticazione con Dynamics CRM, vedere Usare l'autenticazione da server a server con singolo tenant.
Configurazione supportata
Per la configurazione di ogni scheda nell'attività Copy, leggere le rispettive sezioni seguenti.
Generali
Per configurazione della scheda Generale, passare a Impostazioni generali.
Origine
Passare alla scheda Origine per configurare l'origine dell'attività Copy. Per la configurazione dettagliata, vedere il contenuto seguente.
Sono richieste le seguenti proprietà:
- Tipo di archivio dati: selezionare Esterno.
- Connessione: seleziona una connessione Dynamics CRM esistente dall’elenco connessioni. Se non esiste alcuna connessione, creare una nuova connessione Dynamics CRM selezionando Nuovo.
- Tipo di connessione: selezionare Dynamics CRM.
- Usare query: specificare il modo usato per leggere i dati. È possibile scegliere Nome entità per leggere i dati usando il nome dell'entità o Query per usare la query per leggere i dati.
Nome entità: selezionare il nome dell'entità dall'elenco a discesa oppure selezionare Modifica per immetterlo manualmente. È il nome logico dell'entità da richiamare.
Query: usare FetchXML per leggere i dati da Dynamics CRM. FetchXML è un linguaggio di query proprietario usato in Dynamics online e locale. Vedi l'esempio seguente. Per altre informazioni, vedere Creare query con FetchXML.
Esempio di query FetchXML:
<fetch> <entity name="account"> <attribute name="accountid" /> <attribute name="name" /> <attribute name="marketingonly" /> <attribute name="modifiedon" /> <order attribute="modifiedon" descending="false" /> <filter type="and"> <condition attribute ="modifiedon" operator="between"> <value>2017-03-10 18:40:00z</value> <value>2017-03-12 20:40:00z</value> </condition> </filter> </entity> </fetch>
Sotto Avanzate, è possibile specificare i campi seguenti:
- Colonne aggiuntive: aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per la seconda opzione.
Destinazione
Passare alla scheda Destinazione per configurare la destinazione dell'attività Copy. Per la configurazione dettagliata, vedere il contenuto seguente.
Per ogni oggetto sono necessarie le proprietà seguenti:
- Tipo di archivio dati: selezionare Esterno.
- Connessione: seleziona una connessione Dynamics CRM esistente dall’elenco connessioni. Se non esiste alcuna connessione, creare una nuova connessione Dynamics CRM selezionando Nuovo.
- Tipo di connessione: selezionare Dynamics CRM.
- Nome entità: specificare il nome dell'entità per scrivere i dati. Selezionare il nome dell'entità dall'elenco a discesa oppure selezionare Modifica per immetterlo manualmente. Questo è il nome logico dell'entità da richiamare.
Sotto Avanzate, è possibile specificare i campi seguenti:
- Comportamento di scrittura: comportamento dell'azione di scrittura dell'operazione. Questa proprietà è obbligatoria ed è necessario selezionare Upsert. Se si usa Aggiungi contenuto dinamico, specificare il valore di Upsert.
- Nome chiave alternativo: specificare il nome di chiave alternativo definito nell'entità per eseguire l'upsert dei record.
- Ignora valori nulli: indica se ignorare i valori null dai dati di input durante l'operazione di scrittura. Per impostazione predefinita, non è selezionato.
- Quando è selezionato: lascia invariati i dati nell'oggetto di destinazione durante l'operazione di upsert/aggiornamento e inserisce il valore predefinito durante l'operazione di inserimento.
- Quando non è selezionato: aggiorna i dati nell'oggetto di destinazione impostandoli su NULL durante l'operazione di upsert/aggiornamento e inserisce il valore NULL durante l'operazione di inserimento.
- Dimensioni batch di scrittura: specificare il numero di righe dei dati scritti in Dynamics CRM in ogni batch.
- Connessioni massime simultanee: il limite massimo di connessioni simultanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee.
Mapping
Per la configurazione della scheda Mapping, accedere a Configurare i mapping nella scheda Mapping.
Impostazione
Per la configurazione della scheda Impostazioni, vedere Configurare le altre impostazioni nella scheda Impostazioni.
Tabella di riepilogo
Vedere la tabella seguente per il riepilogo e altre informazioni per l'attività di copia di Dynamics CRM.
Informazioni sull'origine
| Nome | Descrizione | valore | Richiesto | Proprietà script JSON |
|---|---|---|---|---|
| Tipo di archivio dati | Tipo di archivio dati in uso. | Esterno | Sì | / |
| Collegamento | Connessione all'archivio dei dati di origine. | < connessione dynamics CRM > | Sì | connection |
| Tipo di connessione | Il tuo tipo di connessione. | Dynamics CRM | Sì | tipo (in typeProperties ->source ->datasetSettings):DynamicsCrmEntity |
| Usa query | Modo per leggere i dati da Dynamics CRM | * Tabelle * Query |
Sì | / |
| Nome entità | Il nome logico dell'entità da recuperare. | < nome entità > | Sì | entityName |
| Query | Usare FetchXML per leggere i dati da Dynamics CRM. FetchXML è un linguaggio di query proprietario usato in Dynamics online e locale. Per altre informazioni, vedere Creare query con FetchXML. | < query > | Sì | query |
| Colonne aggiuntive | Aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per quest'ultima. | * Name * Valore |
No | additionalColumns: * name * valore |
Informazioni sulla destinazione
| Nome | Descrizione | valore | Richiesto | Proprietà script JSON |
|---|---|---|---|---|
| Tipo di archivio dati | Tipo di archivio dati in uso. | Esterno | Sì | / |
| Connessione | Connessione a Dynamics CRM di destinazione. | < Connessione personale > | Sì | connection |
| Tipo di connessione | Il tuo tipo di connessione. | Dynamics CRM | Sì | tipo (in typeProperties ->sink ->datasetSettings):DynamicsCrmEntity |
| Nome entità | Il nome logico dell'entità da recuperare. | < entità > | Sì | entityName |
| Comportamento di scrittura | Comportamento dell'azione di scrittura dell'operazione. Il valore deve essere Upsert. | Upsert | Sì | writeBehavior: upsert |
| Nome chiave alternativa | Il nome della chiave alternativa definito nell'entità per eseguire l'upsert dei record. | < nome chiave alternativa > | No | alternateKeyName |
| Ignora i valori Null | Indica se ignorare i valori null dai dati di input durante l'operazione di scrittura. - Selezionato (true): lascia invariati i dati nell'oggetto di destinazione durante l'operazione di upsert/aggiornamento e inserisce il valore predefinito durante l'operazione di inserimento. - Non selezionato (falso): aggiorna i dati nell'oggetto di destinazione impostandoli su NULL durante l'operazione di upsert/aggiornamento e inserisce il valore NULL durante l'operazione di inserimento. |
selezionato o non selezionato (impostazione predefinita) | No | ignoreNullValues: true o false (valore predefinito) |
| Dimensioni batch di scrittura | Conteggio delle righe di dati scritti da Dynamics CRM in ogni batch. | < dimensioni batch di scrittura > Il valore predefinito è 10 |
No | writeBatchSize |
| Numero massimo di connessioni simultanee | Limite massimo di connessioni simultanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee. | < numero massimo di connessioni simultanee > | No | maxConcurrentConnections |