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.

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

**Voraussetzung**

Ein Salesforce-Marketing-Cloud-Account-Engagement-Objekt, aus dem Sie lesen möchten. Sie benötigen den Objektnamen.

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


| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung | 
| --- | --- | --- | --- | --- | --- | 
| Kampagne | Ja | Ja | Ja | Ja | Ja | 
| Dynamischer Inhalt | Ja | Ja | Ja | Ja | Ja | 
| Email | Ja | Ja | Ja | Ja | Ja | 
| E-Mail-Vorlage | Ja | Ja | Ja | Ja | Ja | 
| Engagement-Studio-Programm | Ja | Ja | Ja | Ja | Ja | 
| Ordnerinhalt | Ja | Ja | Ja | Ja | Ja | 
| Landingpage | Ja | Ja | Ja | Ja | Ja | 
| Lebenszyklusverlauf | Ja | Ja | Ja | Ja | Ja | 
| Lebenszyklusphase | Ja | Ja | Ja | Ja | Ja | 
| Auflisten | Ja | Ja | Ja | Ja | Ja | 
| E-Mail-Liste | Ja | Ja | Ja | Ja | Ja | 
| Mitgliedschaftsliste | Ja | Ja | Ja | Ja | Ja | 
| Gelegenheit | Ja | Ja | Ja | Ja | Ja | 
| Interessent | Ja | Ja | Ja | Ja | Ja | 
| Konto Interessent | Ja | Ja | Ja | Ja | Ja | 
| Benutzer | Ja | Ja | Ja | Ja | Ja | 

**Beispiel:**

```
salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="SalesforcePardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5"
    }
   )
```

**Unterstützte Entitäten für die Async-Quelle:**


| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung | 
| --- | --- | --- | --- | --- | --- | 
| Kampagne | Ja | Nein | Nein | Ja | Nein | 
| Dynamischer Inhalt | Ja | Nein | Nein | Ja | Nein | 
| E-Mail-Vorlage | Ja | Nein | Nein | Ja | Nein | 
| Landingpage | Ja | Nein | Nein | Ja | Nein | 
| Lebenszyklusverlauf | Ja | Nein | Nein | Ja | Nein | 
| Lebenszyklusphase | Ja | Nein | Nein | Ja | Nein | 
| Auflisten | Ja | Nein | Nein | Ja | Nein | 
| E-Mail-Liste | Ja | Nein | Nein | Ja | Nein | 
| Mitgliedschaftsliste | Ja | Nein | Nein | Ja | Nein | 
| Gelegenheit | Ja | Nein | Nein | Ja | Nein | 
| Interessent | Ja | Nein | Nein | Ja | Nein | 
| Konto Interessent | Ja | Nein | Nein | Ja | Nein | 
| Benutzer | Ja | Nein | Nein | Ja | Nein | 

**Beispiel:**

```
salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="SalesforcePardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5",
        "TRANSFER_MODE": "ASYNC"
    }
   )
```

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

Um die Felddetails für die folgenden Entitäten anzuzeigen, navigieren Sie zu [Salesforce Marketing Cloud Account Engagement API](https://developer.salesforce.com/docs/marketing/pardot), wählen Sie **Guides** aus, scrollen Sie nach unten zu **Open Source API Wrappers**, erweitern Sie **Version 5 Docs** im Menü und wählen Sie eine Entität aus.

Liste der Entitäten:
+ Kampagne
+ Dynamischer Inhalt
+ Email
+ E-Mail-Vorlage
+ Engagement-Studio-Programm
+ Ordnerinhalt
+ Landingpage
+ Lebenszyklusverlauf
+ Lebenszyklusphase
+ Auflisten
+ E-Mail-Liste
+ Mitgliedschaftsliste
+ Gelegenheit
+ Interessent
+ Konto Interessent
+ Benutzer

Zusätzlich zu den oben genannten Feldern unterstützt der asynchrone Modus spezifische filterbare Felder für jede Entität, wie in der Tabelle unten dargestellt.


| Entität | Zusätzliche filterbare Felder werden im asynchronen Modus unterstützt | 
| --- | --- | 
| Kampagne | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Dynamischer Inhalt | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| E-Mail-Vorlage | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Engagement-Studio-Programm | - | 
| Landingpage | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Lebenszyklusverlauf | createdAfter, createdBefore | 
| Lebenszyklusphase | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Auflisten | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| E-Mail-Liste | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Mitgliedschaftsliste | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Gelegenheit | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Interessent | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Konto Interessent | createdAfter, createdBefore, deleted | 
| Benutzer | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 

Weitere Informationen zu den zusätzlichen Feldern finden Sie unter [Salesforce Export API](https://developer.salesforce.com/docs/marketing/pardot/guide/export-v5.html#procedures).

Beachten Sie folgende Überlegungen zum Connector:
+ Der Wert des Felds `delete` in den Entitäten kann `false` (Standard), `true` oder `all` sein.

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

**Filterbasierte 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 Datetime-Feld akzeptieren wir das Spark-Zeitstempelformat, das in SPark SQL-Abfragen verwendet wird.

  Beispiele für gültigen Wert:

  ```
  "2022-01-01T01:01:01.000Z"
  ```
+ `UPPER_BOUND`: ein **exklusiver** Obergrenzwert des ausgewählten Partitionsfelds.
+ `NUM_PARTITIONS`: Die Anzahl an Partitionen.
+ `PARTITION_BY`: der Typ der durchzuführenden Partitionierung. Bei feldbasierter Partitionierung ist „FIELD“ zu übergeben.

Beispiel:

```
salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcepardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5",
        "PARTITION_FIELD": "createdAt"
        "LOWER_BOUND": "2022-01-01T01:01:01.000Z"
        "UPPER_BOUND": "2024-01-01T01:01:01.000Z"
        "NUM_PARTITIONS": "10",
        "PARTITION_BY": "FIELD"
    }
   )
```