Så här konfigurerar du Dynamics CRM i en kopieringsaktivitet
Den här artikeln beskriver hur du använder kopieringsaktiviteten i en datapipeline för att kopiera data från och till Dynamics CRM.
Förutsättningar
Om du vill använda den här anslutningsappen med Entra ID-tjänstens huvudnamnsautentisering måste du konfigurera S2S-autentisering (server-till-server) i Dynamics CRM. Registrera först programanvändaren (tjänstens huvudnamn) i Microsoft Entra. Mer information finns i Skapa ett Microsoft Entra-program och tjänstens huvudnamn som kan komma åt resurser.
Under programregistreringen måste du skapa den användaren i Dynamics CRM och bevilja behörigheter. Dessa behörigheter kan antingen beviljas direkt eller indirekt genom att lägga till programanvändaren i ett team som har beviljats behörigheter i Dynamics CRM. Mer information om hur du konfigurerar en programanvändare att autentisera med Dynamics CRM finns i Använda server-till-server-autentisering med en klientorganisation.
Konfiguration som stöds
För konfigurationen av varje flik under kopieringsaktivitet går du till följande avsnitt.
Allmänt
För Allmän flikkonfiguration går du till Allmänna inställningar.
Källa
Gå till fliken Källa för att konfigurera kopieringsaktivitetskällan. Se följande innehåll för den detaljerade konfigurationen.
Följande egenskaper krävs:
- Datalagertyp: Välj Extern.
- Anslutning: Välj en befintlig Dynamics CRM-anslutning i anslutningslistan. Om det inte finns någon anslutning skapar du en ny Dynamics CRM-anslutning genom att välja Ny.
- Anslutningstyp: Välj Dynamics CRM.
- Använd fråga: Ange hur data ska läsas. Du kan välja Entitetsnamn för att läsa data med hjälp av entitetsnamn eller Fråga för att använda frågan för att läsa data.
Entitetsnamn: Välj ditt entitetsnamn i listrutan eller välj Redigera för att ange det manuellt. Det är det logiska namnet på entiteten som ska hämtas.
Fråga: Använda FetchXML för att läsa data från Dynamics CRM. FetchXML är ett proprietärt frågespråk som används i Dynamics online och lokalt. Se följande exempel. Mer information finns i Skapa frågor med FetchXML.
Exempel på FetchXML-fråga:
<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>
Under Avancerat kan du ange följande fält:
- Ytterligare kolumner: Lägg till ytterligare datakolumner för att lagra källfilernas relativa sökväg eller statiska värde. Uttrycket stöds för det senare.
Mål
Gå till fliken Mål för att konfigurera kopieringsaktivitetens mål. Se följande innehåll för den detaljerade konfigurationen.
Följande egenskaper krävs:
- Datalagertyp: Välj Extern.
- Anslutning: Välj en befintlig Dynamics CRM-anslutning i anslutningslistan. Om det inte finns någon anslutning skapar du en ny Dynamics CRM-anslutning genom att välja Ny.
- Anslutningstyp: Välj Dynamics CRM.
- Entitetsnamn: Ange namnet på entiteten för att skriva data. Välj ett entitetsnamn i listrutan eller välj Redigera för att ange det manuellt. Det här är det logiska namnet på entiteten som ska hämtas.
Under Avancerat kan du ange följande fält:
- Skrivbeteende: Skrivbeteendet för åtgärden. Den här egenskapen krävs och du måste välja Upsert. Om du använder Lägg till dynamiskt innehåll anger du värdet till Upsert.
- Alternativt nyckelnamn: Ange det alternativa nyckelnamnet som definierats för din entitet till upsert-poster.
- Ignorera null-värden: Anger om nullvärden ska ignoreras från indata under skrivåtgärden. Den är avmarkerad som standard.
- När den är markerad: Lämna data i målobjektet oförändrade när du utför upsert/update-åtgärden och infoga det definierade standardvärdet när du utför infogningsåtgärden.
- När den är avmarkerad: Uppdatera data i målobjektet till NULL när du utför upsert/update-åtgärden och infoga NULL-värdet när du utför infogningsåtgärden.
- Skriv batchstorlek: Ange radantalet data som skrivits till Dynamics CRM i varje batch.
- Maximalt antal samtidiga anslutningar: Den övre gränsen för samtidiga anslutningar som upprättats till datalagret under aktivitetskörningen. Ange endast ett värde när du vill begränsa samtidiga anslutningar.
Mappning
För Konfiguration av fliken Mappning går du till Konfigurera dina mappningar under mappningsfliken.
Inställningar
För flikkonfigurationen Inställningar går du till Konfigurera dina andra inställningar under fliken Inställningar.
Tabellsammanfattning
Se följande tabell för sammanfattningen och mer information om Dynamics CRM-kopieringsaktiviteten.
Källinformation
| Name | Beskrivning | Värde | Obligatoriskt | JSON-skriptegenskap |
|---|---|---|---|---|
| Typ av datalager | Din datalagertyp. | Externt | Ja | / |
| Anslutning | Din anslutning till källdatalagret. | < din Dynamics CRM-anslutning > | Ja | anslutning |
| Anslutningstyp | Din anslutningstyp. | Dynamics CRM | Ja | typ (under typeProperties ->source ->datasetSettings):DynamicsCrmEntity |
| Använda fråga | Sättet att läsa data från Dynamics CRM | *Tabeller *Fråga |
Ja | / |
| Entitetsnamn | Det logiska namnet på den entitet som ska hämtas. | < ditt entitetsnamn > | Ja | entityName |
| Fråga | Använd FetchXML för att läsa data från Dynamics CRM. FetchXML är ett proprietärt frågespråk som används i Dynamics online och lokalt. Mer information finns i Skapa frågor med FetchXML. | < din fråga > | Ja | query |
| Ytterligare kolumner | Lägg till ytterligare datakolumner för att lagra källfilernas relativa sökväg eller statiska värde. Uttrycket stöds för det senare. | *Namn *Värde |
Nej | additionalColumns: *Namn *värde |
Målinformation
| Name | Beskrivning | Värde | Obligatoriskt | JSON-skriptegenskap |
|---|---|---|---|---|
| Typ av datalager | Din datalagertyp. | Externt | Ja | / |
| Anslutning | Din anslutning till dynamics CRM-målet. | < din anslutning > | Ja | anslutning |
| Anslutningstyp | Din anslutningstyp. | Dynamics CRM | Ja | typ (under typeProperties ->sink ->datasetSettings):DynamicsCrmEntity |
| Entitetsnamn | Det logiska namnet på den entitet som ska hämtas. | < din entitet > | Ja | entityName |
| Skrivbeteende | Skrivbeteendet för åtgärden. Värdet måste vara Upsert. | Upsert | Ja | writeBehavior: upsert |
| Alternativt nyckelnamn | Det alternativa nyckelnamnet som definierats för din entitet till upsert-poster. | < alternativt nyckelnamn > | Nej | alternateKeyName |
| Ignorera null-värden | Anger om null-värden ska ignoreras från indata under skrivåtgärden. – Markerat (sant): Lämna data i målobjektet oförändrade när du utför upsert/update-åtgärden och infoga det definierade standardvärdet när du utför infogningsåtgärden. – Omarkerad (falskt): Uppdatera data i målobjektet till NULL när du utför upsert/update-åtgärden och infoga NULL-värdet när du utför infogningsåtgärden. |
markerad eller omarkerad (standard) | Nej | ignoreNullValues: sant eller falskt (standard) |
| Skriv batchstorlek | Radantalet data som skrivits till Dynamics CRM i varje batch. | < din skriv batchstorlek > Standardvärdet är 10 |
Nej | writeBatchSize |
| Maximalt antal samtidiga anslutningar | Den övre gränsen för samtidiga anslutningar som upprättats till datalagret under aktivitetskörningen. Ange endast ett värde när du vill begränsa samtidiga anslutningar. | < maximalt antal samtidiga anslutningar > | Nej | maxConcurrentConnections |