Sådan konfigurerer du Dynamics CRM i en kopiaktivitet
I denne artikel beskrives det, hvordan du bruger kopiaktiviteten i en datapipeline til at kopiere data fra og til Dynamics CRM.
Forudsætninger
Hvis du vil bruge denne connector med entra-id-tjenesteprincipalgodkendelse, skal du konfigurere server-til-server-godkendelse (S2S) i Dynamics CRM. Registrer først programbrugeren (tjenesteprincipal) i Microsoft Entra. Du kan få flere oplysninger under Opret et Microsoft Entra-program og en tjenesteprincipal, der kan få adgang til ressourcer.
Under programregistreringen skal du oprette den pågældende bruger i Dynamics CRM og tildele tilladelser. Disse tilladelser kan enten tildeles direkte eller indirekte ved at føje programbrugeren til et team, der har fået tildelt tilladelser i Dynamics CRM. Du kan få flere oplysninger om, hvordan du konfigurerer en programbruger til godkendelse med Dynamics CRM, under Brug server til server-godkendelse med en enkelt lejer.
Understøttet konfiguration
Hvis du vil konfigurere hver fane under kopiaktivitet, skal du gå til henholdsvis følgende afsnit.
Generelt
Gå til Generelle indstillinger for konfiguration af fanen Generelt.
Kilde
Gå til fanen Kilde for at konfigurere din kopiaktivitetskilde. Se følgende indhold for at få den detaljerede konfiguration.
Følgende egenskaber er påkrævet:
- Datalagertype: Vælg ekstern.
- Forbindelse: Vælg en eksisterende Dynamics CRM-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny Dynamics CRM-forbindelse ved at vælge Ny.
- Forbindelsestype: Vælg Dynamics CRM.
- Brug forespørgsel: Angiv, hvordan data skal læses. Du kan vælge Objektnavn for at læse data ved hjælp af objektnavn eller Forespørgsel for at bruge forespørgslen til at læse data.
Objektnavn: Vælg dit objektnavn på rullelisten, eller vælg Rediger for at angive det manuelt. Det er det logiske navn på det objekt, der skal hentes.
Forespørgsel: Brug af FetchXML til at læse data fra Dynamics CRM. FetchXML er et beskyttet forespørgselssprog, der bruges i Dynamics online og i det lokale miljø. Se følgende eksempel. Du kan få mere at vide under Opret forespørgsler med FetchXML.
Eksempel på FetchXML-forespørgsel:
<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 Avanceret kan du angive følgende felter:
- Flere kolonner: Tilføj flere datakolonner for at gemme kildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte.
Destination
Gå til fanen Destination for at konfigurere destinationen for kopiaktiviteten. Se følgende indhold for at få den detaljerede konfiguration.
Følgende egenskaber er påkrævet:
- Datalagertype: Vælg ekstern.
- Forbindelse: Vælg en eksisterende Dynamics CRM-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny Dynamics CRM-forbindelse ved at vælge Ny.
- Forbindelsestype: Vælg Dynamics CRM.
- Objektnavn: Angiv navnet på den enhed, der skal skrive data. Vælg dit objektnavn på rullelisten, eller vælg Rediger for at angive det manuelt. Dette er det logiske navn på det objekt, der skal hentes.
Under Avanceret kan du angive følgende felter:
- Skrivefunktion: Handlingens skrivefunktionsmåde. Denne egenskab er påkrævet, og du skal vælge Upsert. Hvis du bruger Tilføj dynamisk indhold, skal du angive værdien til Upsert.
- Alternativt nøglenavn: Angiv det alternative nøglenavn, der er defineret i objektet, for at oprette poster.
- Ignorer null-værdier: Angiver, om null-værdier fra inputdata skal ignoreres under skrivehandlingen. Den er som standard ikke markeret.
- Når den er valgt: Lad dataene i destinationsobjektet være uændrede, når du udfører handlingen upsert/update, og indsæt den definerede standardværdi, når du udfører indsætningshandlingen.
- Når den ikke er markeret: Opdater dataene i destinationsobjektet til NULL, når du udfører upsert/update-handling, og indsæt NULL-værdi, når du udfører indsætningshandlingen.
- Skriv batchstørrelse: Angiv rækkeantallet af data, der skrives til Dynamics CRM i hvert batch.
- Maksimalt antal samtidige forbindelser: Den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser.
Tilknytning
For Konfiguration af fanen Tilknytning skal du gå til Konfigurer dine tilknytninger under fanen Tilknytning.
Indstillinger
For konfigurationen af fanen Indstillinger skal du gå til Konfigurer dine andre indstillinger under fanen Indstillinger.
Tabeloversigt
Se følgende tabel for at få en oversigt og flere oplysninger om kopieringsaktiviteten i Dynamics CRM.
Kildeoplysninger
| Navn | Beskrivelse | Værdi | Obligatorisk | JSON-scriptegenskab |
|---|---|---|---|---|
| Datalagertype | Datalagertypen. | Eksternt | Ja | / |
| Forbindelse | Din forbindelse til kildedatalageret. | < din Dynamics CRM-forbindelse > | Ja | forbindelse |
| Forbindelsestype | Din forbindelsestype. | Dynamics CRM | Ja | type (under typeProperties ->source ->datasetSettings):DynamicsCrmEntity |
| Brug forespørgsel | Måden at læse data fra Dynamics CRM på | *Tabeller *Forespørgsel |
Ja | / |
| Enhedsnavn | Det logiske navn på det objekt, der skal hentes. | < dit enhedsnavn > | Ja | entityName |
| Forespørgsel | Brug FetchXML til at læse data fra Dynamics CRM. FetchXML er et beskyttet forespørgselssprog, der bruges i Dynamics online og i det lokale miljø. Du kan få mere at vide under Opret forespørgsler med FetchXML. | < din forespørgsel > | Ja | query |
| Flere kolonner | Tilføj yderligere datakolonner for at gemme kildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte. | *Navn *Værdi |
Nr. | additionalColumns: *Navn *værdi |
Destinationsoplysninger
| Navn | Beskrivelse | Værdi | Obligatorisk | JSON-scriptegenskab |
|---|---|---|---|---|
| Datalagertype | Datalagertypen. | Eksternt | Ja | / |
| Forbindelse | Din forbindelse til dynamics CRM-destinationen. | < din forbindelse > | Ja | forbindelse |
| Forbindelsestype | Din forbindelsestype. | Dynamics CRM | Ja | type (under typeProperties ->sink ->datasetSettings):DynamicsCrmEntity |
| Enhedsnavn | Det logiske navn på det objekt, der skal hentes. | < din enhed > | Ja | entityName |
| Skrivefunktionsmåde | Handlingens skrivefunktionsmåde. Værdien skal være Upsert. | Upsert | Ja | writeBehavior: upsert |
| Alternativt nøglenavn | Det alternative nøglenavn, der er defineret i objektet til upsert-poster. | < alternativt nøglenavn > | Nr. | alternateKeyName |
| Ignorer null-værdier | Angiver, om null-værdier skal ignoreres fra inputdata under skrivehandlingen. – Markeret (sand): Lad dataene i destinationsobjektet være uændrede, når du udfører handlingen upsert/update, og indsæt den definerede standardværdi, når du udfører indsætningshandlingen. – Ikke markeret (falsk): Opdater dataene i destinationsobjektet til NULL, når du udfører upsert/update-handling, og indsæt NULL-værdi, når du udfører indsætningshandlingen. |
markeret eller ikke markeret (standard) | Nr. | ignoreNullValues: true eller false (standard) |
| Skriv batchstørrelse | Rækkeantallet af data, der skrives til Dynamics CRM i hvert batch. | < din skrivebatchstørrelse > Standardværdien er 10 |
Nr. | writeBatchSize |
| Maks. antal samtidige forbindelser | Den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser. | < maks. antal samtidige forbindelser > | Nr. | maxConcurrentConnections |