Condividi tramite

Come configurare Dynamics CRM in un'attività di copia

Questo articolo illustra come usare l'attività di copia in una pipeline 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à:

  • 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.

Sono richieste le seguenti proprietà:

  • 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
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
*Quesito		 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 la seconda opzione. *Nome
* Valore		 No additionalColumns:
*nome
* valore

Informazioni sulla destinazione

Nome Descrizione valore Richiesto Proprietà script JSON
Collegamento 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ì comportamento di scrittura: 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

Contenuto correlato

  • Last updated on