Dynamics CRM configureren in een kopieeractiviteit
In dit artikel wordt beschreven hoe u de kopieeractiviteit in een gegevenspijplijn gebruikt om gegevens van en naar Dynamics CRM te kopiëren.
Vereisten
Als u deze connector wilt gebruiken met Entra ID-service-principalverificatie, moet u server-naar-serververificatie (S2S) instellen in Dynamics CRM. Registreer eerst de toepassingsgebruiker (service-principal) in Microsoft Entra. Zie Een Microsoft Entra-toepassing en service-principal maken die toegang hebben tot resources voor meer informatie.
Tijdens de registratie van de toepassing moet u die gebruiker maken in Dynamics CRM en machtigingen verlenen. Deze machtigingen kunnen direct of indirect worden verleend door de toepassingsgebruiker toe te voegen aan een team waaraan machtigingen zijn verleend in Dynamics CRM. Zie Server-naar-serververificatie met één tenant gebruiken voor meer informatie over het instellen van een toepassingsgebruiker voor verificatie met Dynamics CRM.
Ondersteunde configuratie
Voor de configuratie van elk tabblad onder kopieeractiviteit gaat u respectievelijk naar de volgende secties.
Algemeen
Ga voor de configuratie van het tabblad Algemeen naar Algemene instellingen.
Bron
Ga naar het tabblad Bron om de bron van de kopieeractiviteit te configureren. Zie de volgende inhoud voor de gedetailleerde configuratie.
De volgende eigenschappen zijn vereist:
- Gegevensarchieftype: Selecteer Extern.
- Verbinding: Selecteer een bestaande Dynamics CRM-verbinding in de lijst met verbindingen. Als er geen verbinding bestaat, maakt u een nieuwe Dynamics CRM-verbinding door Nieuw te selecteren.
- Verbindingstype: Selecteer Dynamics CRM.
- Query gebruiken: geef de manier op waarop gegevens worden gelezen. U kunt entiteitsnaam kiezen om gegevens te lezen met behulp van de entiteitsnaam of Query om query te gebruiken om gegevens te lezen.
Entiteitsnaam: Selecteer uw entiteitsnaam in de vervolgkeuzelijst of selecteer Bewerken om deze handmatig in te voeren. Dit is de logische naam van de entiteit die moet worden opgehaald.
Query: FetchXML gebruiken om gegevens uit Dynamics CRM te lezen. FetchXML is een eigen querytaal die wordt gebruikt in Dynamics Online en on-premises. Zie het volgende voorbeeld. Zie Query's bouwen met FetchXML voor meer informatie.
Voorbeeld van FetchXML-query:
<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>
Onder Geavanceerd kunt u de volgende velden opgeven:
- Aanvullende kolommen: voeg extra gegevenskolommen toe om het relatieve pad of de statische waarde van bronbestanden op te slaan. Expressie wordt ondersteund voor de laatste.
Bestemming
Ga naar het tabblad Bestemming om de bestemming van uw kopieeractiviteit te configureren. Zie de volgende inhoud voor de gedetailleerde configuratie.
De volgende eigenschappen zijn vereist:
- Gegevensarchieftype: Selecteer Extern.
- Verbinding: Selecteer een bestaande Dynamics CRM-verbinding in de lijst met verbindingen. Als er geen verbinding bestaat, maakt u een nieuwe Dynamics CRM-verbinding door Nieuw te selecteren.
- Verbindingstype: Selecteer Dynamics CRM.
- Entiteitsnaam: Geef de naam op van de entiteit om gegevens te schrijven. Selecteer de naam van uw entiteit in de vervolgkeuzelijst of selecteer Bewerken om deze handmatig in te voeren. Dit is de logische naam van de entiteit die moet worden opgehaald.
Onder Geavanceerd kunt u de volgende velden opgeven:
- Schrijfgedrag: het schrijfgedrag van de bewerking. Deze eigenschap is vereist en u moet Upsert selecteren. Als u dynamische inhoud toevoegen gebruikt, geeft u de waarde op voor Upsert.
- Alternatieve sleutelnaam: geef de alternatieve sleutelnaam op die is gedefinieerd op uw entiteit om records te upsert.
- Null-waarden negeren: hiermee wordt aangegeven of null-waarden van invoergegevens tijdens de schrijfbewerking moeten worden genegeerd. Deze optie is standaard niet geselecteerd.
- Wanneer deze optie is geselecteerd: laat de gegevens in het doelobject ongewijzigd wanneer u een upsert-/updatebewerking uitvoert en voeg gedefinieerde standaardwaarde in wanneer u de invoegbewerking uitvoert.
- Wanneer deze optie niet is geselecteerd: werk de gegevens in het doelobject bij naar NULL bij het uitvoeren van upsert-/bijwerkbewerkingen en voeg NULL-waarde in wanneer u de invoegbewerking uitvoert.
- Grootte van schrijfbatch: Geef in elke batch het aantal gegevens op dat naar Dynamics CRM is geschreven.
- Maximum aantal gelijktijdige verbindingen: de bovengrens van gelijktijdige verbindingen die tijdens de uitvoering van de activiteit tot stand zijn gebracht met het gegevensarchief. Geef alleen een waarde op wanneer u gelijktijdige verbindingen wilt beperken.
Toewijzing
Voor de configuratie van het tabblad Toewijzing gaat u naar De toewijzingen configureren onder het tabblad Toewijzing.
Instellingen
Ga voor de configuratie van het tabblad Instellingen naar Uw andere instellingen configureren op het tabblad Instellingen.
Tabelsamenvatting
Zie de volgende tabel voor de samenvatting en meer informatie over de kopieeractiviteit van Dynamics CRM.
Brongegevens
Name | Beschrijving | Waarde | Vereist | JSON-scripteigenschap |
---|---|---|---|---|
Gegevensarchieftype | Het gegevensarchieftype. | External | Ja | / |
Verbinding | Uw verbinding met het brongegevensarchief. | < uw Dynamics CRM-verbinding > | Ja | verbinding |
Verbindingstype | Uw verbindingstype. | Dynamics CRM | Ja | type (onder typeProperties ->source ->datasetSettings ):DynamicsCrmEntity |
Query gebruiken | De manier om gegevens te lezen uit Dynamics CRM | *Tabellen *Vraag |
Ja | / |
Naam entiteit | De logische naam van de entiteit die moet worden opgehaald. | < uw entiteitsnaam > | Ja | entityName |
Query | Gebruik FetchXML om gegevens uit Dynamics CRM te lezen. FetchXML is een eigen querytaal die wordt gebruikt in Dynamics Online en on-premises. Zie Query's bouwen met FetchXML voor meer informatie. | < uw query > | Ja | query |
Aanvullende kolommen | Voeg extra gegevenskolommen toe om het relatieve pad of de statische waarde van bronbestanden op te slaan. Expressie wordt ondersteund voor de laatste. | *Naam *Waarde |
Nee | additionalColumns: *naam *waarde |
Doelgegevens
Name | Beschrijving | Waarde | Vereist | JSON-scripteigenschap |
---|---|---|---|---|
Gegevensarchieftype | Het gegevensarchieftype. | External | Ja | / |
Verbinding | Uw verbinding met de doel-Dynamics CRM. | < uw verbinding > | Ja | verbinding |
Verbindingstype | Uw verbindingstype. | Dynamics CRM | Ja | type (onder typeProperties ->sink ->datasetSettings ):DynamicsCrmEntity |
Naam entiteit | De logische naam van de entiteit die moet worden opgehaald. | < uw entiteit > | Ja | entityName |
Schrijfgedrag | Het schrijfgedrag van de bewerking. De waarde moet Upsert zijn. | Upsert | Ja | writeBehavior: upsert |
Alternatieve sleutelnaam | De alternatieve sleutelnaam die voor uw entiteit is gedefinieerd voor upsert-records. | < alternatieve sleutelnaam > | Nee | alternateKeyName |
Null-waarden negeren | Hiermee wordt aangegeven of null-waarden van invoergegevens tijdens de schrijfbewerking moeten worden genegeerd. - Geselecteerd (true): laat de gegevens in het doelobject ongewijzigd wanneer u een upsert-/updatebewerking uitvoert en voeg gedefinieerde standaardwaarde in wanneer u de invoegbewerking uitvoert. - Niet geselecteerd (onwaar): Werk de gegevens in het doelobject bij naar NULL bij het uitvoeren van upsert-/bijwerkbewerkingen en voeg NULL-waarde in bij het uitvoeren van de invoegbewerking. |
geselecteerd of niet geselecteerd (standaard) | Nee | ignoreNullValues: waar of onwaar (standaard) |
Grootte van schrijfbatch | Het aantal rijen van gegevens dat in elke batch naar Dynamics CRM is geschreven. | < de grootte van uw schrijfbatch > De standaardwaarde is 10 |
Nee | writeBatchSize |
Maximum aantal gelijktijdige verbindingen | De bovengrens van gelijktijdige verbindingen die tijdens de uitvoering van de activiteit tot stand zijn gebracht met het gegevensarchief. Geef alleen een waarde op wanneer u gelijktijdige verbindingen wilt beperken. | < maximum aantal gelijktijdige verbindingen > | Nee | maxConcurrentConnections |