

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Herstellen einer Verbindung mit Salesforce Marketing Cloud
<a name="connecting-to-data-salesforce-marketing-cloud"></a>

Salesforce Marketing Cloud ist ein Anbieter von Marketing-Automatisierungs- und Analysesoftware für E-Mail-, Mobil-, Social-Media- und Online-Marketing. Darüber hinaus werden Beratungs- und Implementierungsservices angeboten. Als Salesforce Marketing Cloud-Benutzer können Sie eine Verbindung AWS Glue zu Ihrem Salesforce Marketing Cloud-Konto herstellen. Anschließend können Sie Salesforce Marketing Cloud als Datenquelle oder Ziel in Ihren ETL-Aufträgen verwenden. Führen Sie diese Jobs aus, um Daten zwischen Salesforce Marketing Cloud und AWS Diensten oder anderen unterstützten Anwendungen zu übertragen.

**Topics**
+ [AWS Glue Unterstützung für Salesforce Marketing Cloud](salesforce-marketing-cloud-support.md)
+ [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](salesforce-marketing-cloud-configuring-iam-permissions.md)
+ [Konfigurieren von Salesforce Marketing Cloud](salesforce-marketing-cloud-configuring.md)
+ [Konfigurieren von Verbindungen mit Salesforce Marketing Cloud](salesforce-marketing-cloud-configuring-connections.md)
+ [Lesen aus Salesforce-Marketing-Cloud-Entitäten](salesforce-marketing-cloud-reading-from-entities.md)
+ [Schreiben in Entitäten von Salesforce Marketing Cloud](salesforce-marketing-cloud-writing-to-entities.md)
+ [Verbindungsoptionen für Salesforce Marketing Cloud](salesforce-marketing-cloud-connection-options.md)
+ [Einschränkungen und Hinweise für den Salesforce-Marketing-Cloud-Connector](salesforce-marketing-cloud-connector-limitations.md)

# AWS Glue Unterstützung für Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-support"></a>

AWS Glue unterstützt Salesforce Marketing Cloud wie folgt:

**Als Quelle unterstützt?**  
Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten aus Salesforce Marketing Cloud abzufragen.

**Als Ziel unterstützt?**  
Nein.

**Unterstützte Versionen der API von Salesforce Marketing Cloud**  
Die folgenden Versionen der API von Salesforce Marketing Cloud werden unterstützt:
+ v1

# Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten
<a name="salesforce-marketing-cloud-configuring-iam-permissions"></a>

Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS IAM-Berechtigungen für das Erstellen und Verwenden von Verbindungen. Wenn Sie eine neue Rolle erstellen, erstellen Sie eine Richtlinie, die Folgendes enthält:

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "glue:ListConnectionTypes",
        "glue:DescribeConnectionType",
        "glue:RefreshOAuth2Tokens",
        "glue:ListEntities",
        "glue:DescribeEntity"
      ],
      "Resource": "*"
    }
  ]
}
```

------

Wenn Sie die oben genannte Methode nicht verwenden möchten, verwenden Sie alternativ die folgenden verwalteten IAM-Richtlinien:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Gewährt Zugriff auf Ressourcen, die verschiedene AWS Glue Prozesse benötigen, um in Ihrem Namen ausgeführt zu werden. Zu diesen Ressourcen gehören AWS Glue Amazon S3, IAM, CloudWatch Logs und Amazon EC2. Wenn Sie die in dieser Richtlinie angegebene Benennungskonvention für Ressourcen einhalten, verfügen AWS Glue Prozesse über die erforderlichen Berechtigungen. Diese Richtlinie wird typischerweise mit Rollen verknüpft, die bei der Definition von Crawlern, Aufträgen und Entwicklungsendpunkten angegeben werden.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Gewährt vollen Zugriff auf AWS Glue Ressourcen, wenn eine Identität, der die Richtlinie zugeordnet ist, die AWS Managementkonsole verwendet. Wenn Sie die Namenskonvention für Ressourcen befolgen, die in dieser Richtlinie angegeben sind, haben Benutzer alle Konsolenfunktionalitäten. Diese Richtlinie wird normalerweise Benutzern der AWS Glue Konsole zugewiesen.

# Konfigurieren von Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-configuring"></a>

Bevor Sie Daten aus der Salesforce Marketing Cloud übertragen können, müssen Sie die folgenden Anforderungen erfüllen: AWS Glue 

## Mindestanforderungen
<a name="salesforce-marketing-cloud-configuring-min-requirements"></a>

Die folgenden Anforderungen sind Mindestanforderungen:
+ Sie haben ein Salesforce-Marketing-Konto. Weitere Informationen finden Sie unter [Erstellen eines Salesforce-Marketing-Cloud-Kontos](#salesforce-marketing-cloud-configuring-creating-salesforce-marketing-cloud-account).
+ Ihr Salesforce-Marketing-Cloud-Konto ist für den API-Zugriff aktiviert. Der API-Zugriff ist standardmäßig für die Editionen Enterprise, Unlimited, Developer und Performance aktiviert.

Wenn Sie diese Anforderungen erfüllen, können Sie eine Verbindung AWS Glue zu Ihrem Salesforce Marketing Cloud-Konto herstellen. Für typische Verbindungen müssen Sie in Salesforce Marketing Cloud nichts weiter tun.

## Erstellen eines Salesforce-Marketing-Cloud-Kontos
<a name="salesforce-marketing-cloud-configuring-creating-salesforce-marketing-cloud-account"></a>

Für die Kontoerstellung bei Salesforce Marketing Cloud müssen Sie sich an den Anbieter wenden. Wenn Sie oder Ihr Unternehmen eine Verbindung zu Salesforce haben, wenden Sie sich an Ihren Salesforce-Kundenbetreuer, um eine Salesforce-Marketing-Cloud-Lizenz anzufordern. Andernfalls können Sie wie folgt Kontakt zu einem Salesforce-Mitarbeiter aufnehmen: 

1. Gehen Sie zu https://www.salesforce.com/in/products/marketing-cloud/overview/und wählen Sie **Registrieren** aus.

1. Wählen Sie oben rechts auf der Seite den Link **Mit uns Kontakt aufnehmen** aus.

1. Geben Sie die erforderlichen Informationen ein und wählen Sie **Mich kontaktieren** aus.

Ein Salesforce-Mitarbeiter wird sich mit Ihnen in Verbindung setzen, um Ihre Anforderungen zu besprechen.

## Ein Projekt und OAuth 2.0-Anmeldeinformationen erstellen
<a name="salesforce-marketing-cloud-configuring-creating-salesforce-marketing-cloud-project-oauth"></a>

Um ein Projekt und OAuth 2.0-Anmeldeinformationen zu erhalten:

1. Melden Sie sich mit Ihrem Benutzernamen und Passwort bei Ihrer [Salesforce-Marketing-Cloud-Instance](https://mc.login.exacttarget.com/hub-cas/login) an und authentifizieren Sie sich mit Ihrer registrierten Handynummer.

1. Klicken Sie oben rechts auf Ihr Profil und gehen Sie dann zu **Einrichten**.

1. Wählen Sie unter **Plattformtools** die Option **Apps** und dann **Installierte Pakete** aus.  
![\[\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/sfmc-platform-tools.png)

1. Klicken Sie auf der Seite **Installierte Pakete** oben rechts auf **Neu**. Geben Sie den Namen und die Beschreibung des Pakets ein.

   Speichern Sie das Paket. Nachdem das Paket gespeichert wurde, können Sie die Paketdetails einsehen.

1. Wählen Sie auf der **Detailseite** des Pakets im Abschnitt **Komponente** die Option **Komponente hinzufügen** aus.   
![\[\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/images/sfmc-add-component.png)

1. Wählen Sie als **Komponententyp** die Option „API-Integration“ aus und klicken Sie auf **Weiter**.

1. **Wählen Sie als **Integrationstyp** „Server-to-Server“ (der den OAuth Gewährungstyp für Client-Anmeldeinformationen hat) und klicken Sie auf Weiter.**

1. Fügen Sie die Bereiche entsprechend Ihren Anforderungen hinzu und klicken Sie auf **Speichern**.

# Konfigurieren von Verbindungen mit Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-configuring-connections"></a>

Salesforce Marketing Cloud unterstützt den Zuschusstyp CLIENT CREDENTIALS für OAuth2.
+ Dieser Gewährungstyp gilt als 2-Legged OAuth 2.0, da er von Kunden verwendet wird, um außerhalb des Benutzerkontextes ein Zugriffstoken zu erhalten. AWS Glue ist in der Lage, die Client-ID und das Client-Geheimnis zur Authentifizierung der Salesforce Marketing Cloud zu verwenden APIs , die von benutzerdefinierten Diensten bereitgestellt werden, die Sie definieren.
+ Jeder benutzerdefinierte Service gehört einem Nur-API-Benutzer, der über eine Reihe von Rollen und Berechtigungen verfügt, die den Service zur Ausführung bestimmter Aktionen autorisieren. Ein Zugriffstoken ist einem einzelnen benutzerdefinierten Service zugeordnet.
+ Dieser Gewährungstyp führt zu einem Zugriffstoken, das nur von kurzer Dauer ist und durch Aufrufen eines Identitätsendpunkts erneuert werden kann.
+ Die öffentliche Salesforce Marketing Cloud-Dokumentation für OAuth 2.0 mit Kundenanmeldedaten finden Sie unter [Einrichten Ihrer Entwicklungsumgebung für erweiterte Pakete](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/mc-dev-setup-enhanced.html).

Konfigurieren einer Verbindung mit Salesforce Marketing Cloud:

1. Erstellen Sie in AWS Secrets Manager ein Secret mit den folgenden Details:

   1. Für die kundenseitig verwaltete verbundene App muss das Geheimnis das Verbrauchergeheimnis der verbundenen App mit `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` als Schlüssel enthalten.

   1. Hinweis: Sie müssen einen geheimen Schlüssel für Ihre Verbindungen in erstellen AWS Glue.

1. Erstellen Sie in AWS Glue Glue Studio eine Verbindung unter **Datenverbindungen**, indem Sie die folgenden Schritte ausführen:

   1. Wählen Sie als **Verbindungstyp** Salesforce Marketing Cloud aus.

   1. Geben Sie die `Subdomain Endpoint` der Instance von Salesforce Marketing Cloud an, zu der eine Verbindung hergestellt werden soll.

   1. Wählen Sie die AWS IAM-Rolle aus, die die folgenden Aktionen übernehmen AWS Glue kann und über Berechtigungen verfügt:

------
#### [ JSON ]

****  

      ```
      {
        "Version":"2012-10-17",		 	 	 
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "secretsmanager:DescribeSecret",
              "secretsmanager:GetSecretValue",
              "secretsmanager:PutSecretValue",
              "ec2:CreateNetworkInterface",
              "ec2:DescribeNetworkInterfaces",
              "ec2:DeleteNetworkInterface"
            ],
            "Resource": "*"
          }
        ]
      }
      ```

------

   1. Wählen Sie `secretName` die aus, in die Sie für diese Verbindung die Token einfügen AWS Glue möchten.

   1. Wählen Sie die Netzwerkoptionen aus, wenn Sie Ihr Netzwerk verwenden möchten.

1. Erteilen Sie der mit Ihrem AWS Glue Job verknüpften IAM-Rolle `secretName` Leserechte.

# Lesen aus Salesforce-Marketing-Cloud-Entitäten
<a name="salesforce-marketing-cloud-reading-from-entities"></a>

**Voraussetzung**

Ein Salesforce-Marketing-Cloud-Objekt, aus dem gelesen werden soll. Sie benötigen den Objektnamen wie `Activity` oder `Campaigns`. Die folgende Tabelle zeigt die unterstützten Entitäten.

**Unterstützte Entitäten für Quelle**:


| Entität | Schnittstelle | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 SELECT“ | Unterstützt Partitionierung | 
| --- | --- | --- | --- | --- | --- | --- | 
| Ereignisbenachrichtigung-Callback | REST | Nein | Nein | Nein | Ja | Nein | 
| Seed-Liste | REST | Nein | Ja | Nein | Ja | Nein | 
| Einrichtung | REST | Ja | Ja | Nein | Ja | Nein | 
| Domänenverifizierung | REST | Ja | Ja | Ja | Ja | Nein | 
| Verschachtelte Objekt-Tags | REST | Ja | Nein | Nein | Ja | Nein | 
| Kontakt | REST | Nein | Ja | Nein | Ja | Nein | 
| Abonnement für Ereignisbenachrichtigung | REST | Nein | Nein | Nein | Ja | Nein | 
| Messaging | REST | Nein | Ja | Nein | Ja | Nein | 
| Aktivität | SOAP | Nein | Nein | Nein | Ja | Ja | 
| Bounce-Ereignis | SOAP | Nein | Nein | Nein | Ja | Ja | 
| Klickereignis | SOAP | Nein | Nein | Nein | Ja | Ja | 
| Inhaltsbereich | SOAP | Nein | Nein | Nein | Ja | Ja | 
| Datenerweiterung | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Email | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Weitergeleitete E-Mail | SOAP | Nein | Ja | Nein | Ja | Ja | 
| E-Mail weiterleiten OptInEvent | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Link | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Link senden | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Auflisten | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Liste von Abonnenten | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Nicht gesendet | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Öffnen | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Senden | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Gesendet | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Subscriber | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Umfrage | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Abonnement beenden | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Prüfungsereignisse | REST | Nein | Ja | Ja | Ja | Nein | 
| Kampagnen | REST | Nein | Ja | Ja | Ja | Nein | 
| Interaktionen | REST | Nein | Ja | Ja | Ja | Nein | 
| Inhalts-Assets | REST | Nein | Ja | Ja | Ja | Nein | 

**Beispiel für REST**:

```
salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Campaigns",
        "API_VERSION": "v1",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**Beispiel für SOAP**:

```
salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Activity",
        "API_VERSION": "v1",
        "INSTANCE_URL": "https://**********************.soap.marketingcloudapis.com"
    }
)
```

**Entitäts- und Felddetails zu Salesforce Marketing Cloud**:

In den folgenden Tabellen werden die Salesforce-Marketing-Cloud-Entitäten beschrieben. Es gibt REST-Entitäten mit statischen Metadaten und SOAP-Entitäten mit dynamischen Metadaten.

**REST-Entitäten mit statischen Metadaten**:

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/salesforce-marketing-cloud-reading-from-entities.html)

**SOAP-Entitäten mit dynamischen Metadaten**:

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/salesforce-marketing-cloud-reading-from-entities.html)

## Partitionierung von Abfragen
<a name="salesforce-marketing-cloud-reading-partitioning-queries"></a>

In Salesforce Marketing Cloud unterstützen die Felder Integer und DateTime Datentyp die feldbasierte Partitionierung.

Sie können die zusätzlichen Spark-Optionen `PARTITION_FIELD`,`LOWER_BOUND`, `UPPER_BOUND` und `NUM_PARTITIONS` angeben, wenn Sie Parallelität in Spark nutzen möchten. Mit diesen Parametern wird die ursprüngliche Abfrage in `NUM_PARTITIONS` Unterabfragen aufgeteilt, die von Spark-Aufgaben gleichzeitig ausgeführt werden können.
+ `PARTITION_FIELD`: der Name des Feldes, das zur Partitionierung der Abfrage verwendet werden soll.
+ `LOWER_BOUND`: ein **inklusiver** Untergrenzwert des ausgewählten Partitionsfelds.

  Für das Timestamp-Feld akzeptieren wir das Spark-Zeitstempelformat, das in Spark-SQL-Abfragen verwendet wird.

  Beispiele für gültigen Wert:

  ```
  “2024-05-07T02:03:00.00Z"
  ```
+ `UPPER_BOUND`: ein **exklusiver** Obergrenzwert des ausgewählten Partitionsfelds.
+ `NUM_PARTITIONS`: Die Anzahl an Partitionen.

Beispiel:

```
salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "ListSubscriber",
        "API_VERSION": "v1",
        "PARTITION_FIELD": "CreatedDate",
        "LOWER_BOUND": "2023-09-07T02:03:00.000Z",
        "UPPER_BOUND": "2024-05-07T02:03:00.000Z",
        "NUM_PARTITIONS": "10"
    }
)
```

# Schreiben in Entitäten von Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-writing-to-entities"></a>

**Voraussetzungen**
+ Ein Salesforce-Marketing-Objekt, in das Sie schreiben möchten. Sie müssen den Namen des Objekts angeben, z. B. `List` oder `Campaigns` oder eine der anderen in der Tabelle unten aufgeführten Entitäten.
+ Der Connector von Salesforce Marketing Cloud unterstützt drei Schreibvorgänge:
  + INSERT
  + UPSERT
  + UPDATE

  Wenn Sie die Schreibvorgänge `UPDATE` und `UPSERT` verwenden, muss die Option `ID_FIELD_NAMES` bereitgestellt werden, um das Feld „Externe ID“ für die Datensätze anzugeben. 

**Unterstützte Entitäten für das Ziel**:


| Entität | Priorität | Schnittstelle (REST, SOAP usw.) | Kann eingefügt werden | Kann aktualisiert werden. | Kann aktualisiert/eingefügt werden | 
| --- | --- | --- | --- | --- | --- | 
| Kampagnen | P0 | REST | Y- Einzel | Y- Einzel | N | 
| Inhalts-Assets | P0 | REST | Y- Einzel, Bulk | Y- Einzel | N | 
| Kontakt | P1 | REST | Y- Einzel | Y- Einzel | N | 
| Domänenverifizierung | P1 | REST | Y- Einzel | Y- Einzel, Bulk | N | 
| Ereignisbenachrichtigung-Callback | P1 | REST | Y- Einzel | Y- Einzel | N | 
| Abonnement für Ereignisbenachrichtigung | P1 | REST | Y- Einzel | Y- Einzel | N | 
| Messaging | P1 | REST | Y- Einzel | N | N | 
| Geschachteltes Objekt-Tag | P2 | REST | Y- Einzel | Y- Einzel | N | 
| Seed-Liste | P1 | REST | Y- Einzel | Y- Einzel | N | 
| Einrichtung | P1 | REST | Y- Einzel | Y- Einzel | N | 
| Datenerweiterung | P0 | SOAP | Y- Einzel | Y- Einzel | Y- Einzel | 
| Email | P0 | SOAP | Y- Einzel | Y- Einzel | N | 
| Auflisten | P0 | SOAP | Y- Einzel | Y- Einzel | N | 
| Senden | P0 | SOAP | Y- Einzel | N | N | 
| Subscriber | P0 | SOAP | Y- Einzel | Y- Einzel | N | 

**Beispiel für einen INSERT-Vorgang für REST**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Campaigns",
        "API_VERSION": "v1",
        "writeOperation" : "INSERT",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**Beispiel für einen INSERT-Vorgang für SOAP**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "List",
        "API_VERSION": "v1",
        "writeOperation" : "INSERT",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**Beispiel für einen UPDATE-Vorgang für REST**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Campaigns",
        "API_VERSION": "v1",
        "writeOperation" : "UPDATE",
         "ID_FIELD_NAMES": "id",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**Beispiel für einen UPDATE-Vorgang für SOAP**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "List",
        "API_VERSION": "v1",
        "writeOperation" : "UPDATE",
         "ID_FIELD_NAMES": "id",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**Beispiel für einen UPSERT-Vorgang für SOAP**:

```
salesforcemarketingcloud_write = glueContext.write_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "DataExtension/Insert-***E/6*******3",
        "API_VERSION": "v1",
        "writeOperation" : "UPSERT",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

# Verbindungsoptionen für Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-connection-options"></a>

Im Folgenden sind Verbindungsoptionen für Salesforce Marketing Cloud aufgeführt:
+ `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Der Name Ihres Objekts in Salesforce Marketing Cloud.
+ `API_VERSION` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Die REST- und SOAP-API-Version von Salesforce Marketing Cloud, die Sie verwenden möchten.
+ `SELECTED_FIELDS` (Liste<Zeichenfolge>) – Standard: leer(SELECT \$1). Zum Lesen verwendet. Spalten, die Sie für das Objekt auswählen möchten.
+ `FILTER_PREDICATE`(Zeichenfolge) – Standard: leer. Zum Lesen verwendet. Muss das Spark-SQL-Format aufweisen.
+ `QUERY`(Zeichenfolge) – Standard: leer Zum Lesen verwendet. Vollständige Spark-SQL-Abfrage.
+ `PARTITION_FIELD`(Zeichenfolge) – Zum Lesen verwendet. Feld, das zur Partitionierung der Abfrage verwendet werden soll.
+ `LOWER_BOUND`(Zeichenfolge) – Zum Lesen verwendet. Ein inklusiver Untergrenzwert des ausgewählten Partitionsfelds.
+ `UPPER_BOUND`(Zeichenfolge) – Zum Lesen verwendet. Ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds. 
+ `NUM_PARTITIONS`(Ganzzahl) – Standard: 1. Zum Lesen verwendet. Anzahl der zu lesenden Partitionen.
+ `WRITE_OPERATION`(Zeichenfolge) – Standard: INSERT. Zum Schreiben verwendet. Wert muss INSERT, UPDATE, UPSERT sein.
+ `ID_FIELD_NAMES`(Zeichenfolge) – Standard: null. Erforderlich für UPDATE/UPSERT.

# Einschränkungen und Hinweise für den Salesforce-Marketing-Cloud-Connector
<a name="salesforce-marketing-cloud-connector-limitations"></a>

Die folgenden Einschränkungen gelten für den Salesforce-Connector:
+ Wenn Sie den Filter für ein DateTime Datentypfeld verwenden, müssen Sie den Wert im Format "yyyy-mm-ddthh:mm:ssz“ übergeben.
+ In der Datenvorschau wird der boolesche Datentypwert leer angezeigt.
+ Für SOAP-Entitäten können Sie maximal zwei Filter definieren und für REST-Entitäten können Sie nur einen Filter definieren, wodurch das Testen der Partitionierung mit Filtern eingeschränkt wird.
+ Auf SaaS-Seite wurden mehrere unerwartete Verhaltensweisen beobachtet: Das `Link.Alias`-Feld in der Entität „linksend“ unterstützt den Operator CONTAINS nicht (zum Beispiel: `Link.Alias CONTAINS "ViewPrivacyPolicy"`) und Filteroperatoren für Data-Extension-Entitäten (wie GLEICH und GRÖSSER ALS) geben nicht die erwarteten Ergebnisse zurück.
+ Die SFMC ClickEvent SOAP-API hat eine Verzögerung bei der Wiedergabe neu erstellter Datensätze, sodass die kürzlich erstellten Datensätze möglicherweise nicht sofort in der API-Antwort verfügbar sind.

  Beispiel: Wenn Sie am **2025-01-10T 14:30:00** 5 neue ClickEvent Datensätze erstellen und diese sofort über die SOAP-API abrufen, enthält die Antwort möglicherweise nicht alle 5 Datensätze. Es kann bis zu 5 Minuten dauern, bis die neu erstellten Datensätze in der API-Antwort angezeigt werden. Diese Verzögerung kann sich sowohl auf den Datenabruf als auch auf geplante Datenläufe auswirken.
+ **Zwei verschiedene DateTime Formate: **2025-03-11T 04:46:00 (ohne Millisekunden) und 2025-03-11T 04:46:00.000** Z werden unterstützt, wenn Schreiboperationen in (mit Millisekunden) ausgeführt werden.** AWS Glue 
+ Für die Entität „Event Notification Subscription“ kann ein Abonnement nur für eine verifizierte Rückruf-URL erstellt werden und Sie können bis zu 200 Abonnements pro Rückruf haben.
+ Für die Entität „Event Notification Callback“ können maximal 50 Datensätze pro Konto erstellt werden.