Share via


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 azure AD-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.

Screenshot showing source tab and the list of properties.

De volgende eigenschappen zijn vereist:

  • Gegevensarchieftype: Selecteer Extern.
  • Verbinding maken ion: 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.
  • Verbinding maken iontype: 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.

Doel

Ga naar het tabblad Bestemming om de bestemming van uw kopieeractiviteit te configureren. Zie de volgende inhoud voor de gedetailleerde configuratie.

Screenshot showing destination tab and the list of properties.

De volgende eigenschappen zijn vereist:

  • Gegevensarchieftype: Selecteer Extern.
  • Verbinding maken ion: 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.
  • Verbinding maken iontype: 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 De 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
*Query
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 maxConcurrent Verbinding maken ions