Konfigurieren von Dynamics CRM in einer Copy-Aktivität

In diesem Artikel wird beschrieben, wie Sie die Copy-Aktivität in einer Datenpipeline verwenden, um Daten von und nach Dynamics CRM zu kopieren.

Voraussetzungen

Wenn Sie sich mit diesem Connector bei einem Entra ID-Dienstprinzipal authentifizieren möchten, müssen Sie die Server-zu-Server-Authentifizierung (S2S) in Dynamics CRM einrichten. Registrieren Sie zunächst den Anwendungsbenutzer (Dienstprinzipal) in Microsoft Entra. Weitere Informationen finden Sie unter Erstellen einer Microsoft Entra-Anwendung und eines Dienstprinzipals mit Zugriff auf Ressourcen.

Während der Anwendungsregistrierung müssen Sie diesen Benutzer in Dynamics CRM erstellen und Berechtigungen erteilen. Diese Berechtigungen können entweder direkt oder indirekt gewährt werden, indem der Anwendungsbenutzer einem Team hinzugefügt wird, dem Berechtigungen in Dynamics CRM erteilt wurden. Weitere Informationen zum Einrichten eines Anwendungsbenutzers für die Authentifizierung bei Dynamics CRM finden Sie unter Verwenden der Server-zu-Server-Authentifizierung für einen einzelnen Mandanten.

Unterstützte Konfiguration

Die Konfiguration der einzelnen Registerkarten unter der Kopieraktivität finden Sie in den folgenden Abschnitten.

• Allgemein
• Quelle
• Ziel
• Zuordnung
• Einstellungen

Allgemein

Wechseln Sie für die Konfiguration der Registerkarte Allgemein zu Allgemeine Einstellungen.

`Source`

Wechseln Sie zur Registerkarte Quelle, um die Quelle der Kopieraktivität zu konfigurieren. Die ausführliche Konfiguration finden Sie im Folgenden.

Die folgenden Eigenschaften sind erforderlich:

• Datenspeichertyp: Wählen Sie Extern aus.
• Verbindung: Wählen Sie eine bestehende Dynamics CRM-Verbindung in der Verbindungsliste aus. Wenn keine Verbindung existiert, erstellen Sie eine neue Dynamics CRM-Verbindung, indem Sie Neu auswählen.
• Verbindungstyp: Wählen Sie Dynamics CRM aus.
• Abfrage verwenden: Geben Sie die Methode zum Lesen von Daten an. Sie können Entitätsname auswählen, um Daten mithilfe des Entitätsnamens zu lesen, oder Abfrage, um Abfragen zum Lesen von Daten zu verwenden.

  • Entitätsname: Wählen Sie in der Dropdownliste Ihren Entitätsnamen aus, oder wählen Sie Bearbeiten aus, um ihn manuell einzugeben. Es handelt sich um den logischen Namen der abzurufenden Entität.

  • Abfrage: Verwenden von FetchXML zum Lesen von Daten aus Dynamics CRM. FetchXML ist eine proprietäre Abfragesprache, die in Dynamics (online und lokal) verwendet wird. Siehe folgendes Beispiel. Weitere Informationen finden Sie unter Erstellen von Abfragen mit FetchXML.

    FetchXML-Beispielabfrage:

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

Unter Erweitert können Sie die folgenden Felder angeben:

• Zusätzliche Spalten: Fügen Sie zusätzliche Datenspalten hinzu, um den relativen Pfad oder statischen Wert der Quelldateien zu speichern. Für Letzteres wird ein Ausdruck unterstützt.

Destination

Wechseln Sie zur Registerkarte Ziel, um das Ziel der Kopieraktivität zu konfigurieren. Die ausführliche Konfiguration finden Sie im Folgenden.

Die folgenden Eigenschaften sind erforderlich:

• Datenspeichertyp: Wählen Sie Extern aus.
• Verbindung: Wählen Sie eine bestehende Dynamics CRM-Verbindung in der Verbindungsliste aus. Wenn keine Verbindung existiert, erstellen Sie eine neue Dynamics CRM-Verbindung, indem Sie Neu auswählen.
• Verbindungstyp: Wählen Sie Dynamics CRM aus.
• Entitätsname: Geben Sie den Namen der Entität an, die Daten schreiben soll. Wählen Sie in der Dropdownliste Ihren Entitätsnamen aus, oder wählen Sie Bearbeiten aus, um ihn manuell einzugeben. Es handelt sich um den logischen Namen der abzurufenden Entität.

Unter Erweitert können Sie die folgenden Felder angeben:

• Verhalten bei Schreibvorgang: Das Schreibverhalten des Vorgangs. Diese Eigenschaft ist erforderlich, und Sie müssen Upsert auswählen. Wenn Sie Dynamischen Inhalt hinzufügen verwenden, geben Sie den Wert für den Upsertvorgang an.
• Name des Alternativschlüssels: Geben Sie den alternativen Schlüsselnamen an, der in Ihrer Entität für Upsertvorgänge von Datensätzen definiert ist.
• NULL-Werte ignorieren: gibt an, ob NULL-Werte aus Eingabedaten beim Schreibvorgang ignoriert werden sollen. Standardmäßig ist sie deaktiviert.
  • Bei aktivierter Option: keine Änderung an den Daten im Zielobjekt, wenn ein Upsert- oder Aktualisierungsvorgang stattfindet, und Einfügen eines definierten Standardwerts, wenn ein Einfügevorgang stattfindet.
  • Bei deaktivierter Option: Aktualisieren der Daten im Zielobjekt in NULL, wenn ein Upsert- oder Aktualisierungsvorgang stattfindet, und Einfügen von NULL, wenn ein Einfügevorgang stattfindet.
• Schreibbatchgröße: Geben Sie die Zeilenanzahl der Daten an, die in jedem Batch in Dynamics CRM geschrieben werden.
• Maximale Anzahl gleichzeitiger Verbindungen: Die Obergrenze der gleichzeitigen Verbindungen zum Datenspeicher, die während des Ausführens der Aktivität hergestellt werden. Geben Sie diesen Wert nur an, wenn Sie die Anzahl der gleichzeitigen Verbindungen begrenzen möchten.

Zuordnung

Wechseln Sie für die Konfiguration der Registerkarte Zuordnung zu Konfigurieren der Zuordnungen auf der Registerkarte „Zuordnung“.

Einstellungen

Wechseln Sie für die Konfiguration der Registerkarte Einstellungen zu Konfigurieren der anderen Einstellungen auf der Registerkarte „Einstellungen“.

Tabellenzusammenfassung

Eine Zusammenfassung und weitere Informationen zur Dynamics CRM-Copy-Aktivität finden Sie in der folgenden Tabelle.

Quellinformationen

Name	Beschreibung	Wert	Erforderlich	JSON-Skripteigenschaft
Datenspeichertyp	Ihr Datenspeichertyp	Extern	Ja	/
Verbindung	Ihre Verbindung mit dem Quelldatenspeicher	< Ihre Dynamics CRM-Verbindung >	Ja	Verbindung
Verbindungstyp	Ihr Verbindungstyp.	Dynamics CRM	Ja	Typ (unter typeProperties ->source ->datasetSettings): DynamicsCrmEntity
Verwendungsabfrage	Die Art des Lesens von Daten aus Dynamics CRM	* Tabellen * Abfrage	Ja	/
Entitätsname	Der logische Name der abzurufenden Entität.	<Entitätsname>	Ja	entityName
Abfrage	Verwendung von FetchXML zum Lesen von Daten aus Dynamics CRM. FetchXML ist eine proprietäre Abfragesprache, die in Dynamics (online und lokal) verwendet wird. Weitere Informationen finden Sie unter Erstellen von Abfragen mit FetchXML.	<Abfrage>	Ja	Abfrage
Zusätzliche Spalten	Fügen Sie zusätzliche Datenspalten hinzu, um den relativen Pfad oder statischen Wert der Quelldateien zu speichern. Für Letzteres wird ein Ausdruck unterstützt.	* Name * Wert	Nein	additionalColumns: * Name * Wert

Zielinformationen

Name	Beschreibung	Wert	Erforderlich	JSON-Skripteigenschaft
Datenspeichertyp	Ihr Datenspeichertyp	Extern	Ja	/
Verbindung	Ihre Verbindung zu Dynamics CRM als Ziel.	< Ihre Verbindung >	Ja	Verbindung
Verbindungstyp	Ihr Verbindungstyp.	Dynamics CRM	Ja	Typ (unter typeProperties ->sink ->datasetSettings): DynamicsCrmEntity
Entitätsname	Der logische Name der abzurufenden Entität.	<Entität>	Ja	entityName
Verhalten bei Schreibvorgang	Das Schreibverhalten des Vorgangs. Der Wert muss Upsert lauten.	Upsert	Ja	writeBehavior: Upsert
Name des Alternativschlüssels	Der Name des Alternativschlüssels, der in Ihrer Entität für Upsertvorgänge von Datensätzen definiert ist.	<Name des Alternativschlüssels>	Nein	alternateKeyName
NULL-Werte ignorieren	Gibt an, ob Nullwerte aus Eingabedaten während des Schreibvorgangs ignoriert werden sollen. Aktiviert (TRUE): keine Änderung an den Daten im Zielobjekt, wenn ein Upsert- oder Aktualisierungsvorgang stattfindet, und Einfügen eines definierten Standardwerts, wenn ein Einfügevorgang stattfindet. Deaktiviert (FALSE): Aktualisieren der Daten im Zielobjekt in NULL, wenn ein Upsert- oder Aktualisierungsvorgang stattfindet, und Einfügen von NULL, wenn ein Einfügevorgang stattfindet.	Aktiviert oder deaktiviert (Standardwert)	Nein	ignoreNullValues: TRUE oder FALSE (Standardwert)
Schreibbatchgröße	Die Zeilenanzahl der Daten, die in jedem Batch in Dynamics CRM geschrieben werden.	<Schreibbatchgröße> Der Standardwert ist 10.	Nein	writeBatchSize
Maximal zulässige Anzahl paralleler Verbindungen	Die Obergrenze gleichzeitiger Verbindungen mit dem Datenspeicher während der Aktivitätsausführung. Geben Sie diesen Wert nur an, wenn Sie die Anzahl der gleichzeitigen Verbindungen begrenzen möchten.	<Maximal zulässige Anzahl gleichzeitiger Verbindungen>	Nein	maxConcurrentConnections

Zugehöriger Inhalt

• Dynamics CRM-Connector – Übersicht