Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Lecture à partir des entités Salesforce Marketing Cloud Account Engagement
<a name="salesforce-marketing-cloud-account-engagement-reading-from-entities"></a>

**Prérequis**

Un objet Salesforce Marketing Cloud Account Engagement à partir duquel vous souhaitez lire. Vous aurez besoin du nom de l’objet.

**Entités prises en charge pour la source de synchronisation** :


| Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge | 
| --- | --- | --- | --- | --- | --- | 
| Campaign | Oui | Oui | Oui | Oui | Oui | 
| Contenu dynamique | Oui | Oui | Oui | Oui | Oui | 
| E-mail | Oui | Oui | Oui | Oui | Oui | 
| Email Template | Oui | Oui | Oui | Oui | Oui | 
| Engagement Studio Program | Oui | Oui | Oui | Oui | Oui | 
| Folder Contents | Oui | Oui | Oui | Oui | Oui | 
| Landing Page | Oui | Oui | Oui | Oui | Oui | 
| Lifecycle History | Oui | Oui | Oui | Oui | Oui | 
| Lifecycle Stage | Oui | Oui | Oui | Oui | Oui | 
| List | Oui | Oui | Oui | Oui | Oui | 
| List Email | Oui | Oui | Oui | Oui | Oui | 
| List Membership | Oui | Oui | Oui | Oui | Oui | 
| Opportunity | Oui | Oui | Oui | Oui | Oui | 
| Prospect | Oui | Oui | Oui | Oui | Oui | 
| Prospect Account | Oui | Oui | Oui | Oui | Oui | 
| Utilisateur | Oui | Oui | Oui | Oui | Oui | 

**Exemple :**

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

**Entités prises en charge pour la source asynchrone** :


| Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge | 
| --- | --- | --- | --- | --- | --- | 
| Campaign | Oui | Non | Non | Oui | Non | 
| Contenu dynamique | Oui | Non | Non | Oui | Non | 
| Email Template | Oui | Non | Non | Oui | Non | 
| Landing Page | Oui | Non | Non | Oui | Non | 
| Lifecycle History | Oui | Non | Non | Oui | Non | 
| Lifecycle Stage | Oui | Non | Non | Oui | Non | 
| List | Oui | Non | Non | Oui | Non | 
| List Email | Oui | Non | Non | Oui | Non | 
| List Membership | Oui | Non | Non | Oui | Non | 
| Opportunity | Oui | Non | Non | Oui | Non | 
| Prospect | Oui | Non | Non | Oui | Non | 
| Prospect Account | Oui | Non | Non | Oui | Non | 
| Utilisateur | Oui | Non | Non | Oui | Non | 

**Exemple :**

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

**Détails des entités et des champs Salesforce Marketing Cloud Account Engagement** :

Pour afficher les détails des champs pour les entités suivantes, accédez à [API Salesforce Marketing Cloud Account Engagement](https://developer.salesforce.com/docs/marketing/pardot), choisissez **Guides**, faites défiler la page vers le bas jusqu’à **Open Source API Wrappers**, développez **Version 5 Docs** dans le menu et choisissez une entité.

Liste des entités :
+ Campaign
+ Contenu dynamique
+ E-mail
+ Email Template
+ Engagement Studio Program
+ Folder Content
+ Landing Page
+ Lifecycle History
+ Lifecycle Stage
+ List
+ List Email
+ List Membership
+ Opportunity
+ Prospect
+ Prospect Account
+ Utilisateur

Outre les champs mentionnés ci-dessus, le mode asynchrone prend en charge des champs filtrables spécifiques pour chaque entité, comme indiqué dans le tableau ci-dessous.


| Entité | Champs filtrables supplémentaires pris en charge en mode asynchrone | 
| --- | --- | 
| Campaign | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Contenu dynamique | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Email Template | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Engagement Studio Program | - | 
| Landing Page | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Lifecycle History | createdAfter, createdBefore | 
| Lifecycle Stage | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| List | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| List Email | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| List Membership | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Opportunity | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Prospect | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Prospect Account | createdAfter, createdBefore, deleted | 
| Utilisateur | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 

Pour plus d’informations sur les champs supplémentaires, consultez [API Salesforce Export](https://developer.salesforce.com/docs/marketing/pardot/guide/export-v5.html#procedures).

Notez les considérations à prendre en compte pour le connecteur :
+ La valeur du champ `delete` dans les entités peut être `false` (par défaut), `true` ou `all`.

## Requêtes de partitionnement
<a name="salesforce-marketing-cloud-account-engagement-reading-partitioning-queries"></a>

**Partitionnement basé sur des filtres** :

Vous pouvez indiquer les options Spark supplémentaires `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` et `NUM_PARTITIONS` si vous souhaitez utiliser la simultanéité dans Spark. Avec ces paramètres, la requête d’origine serait divisée en `NUM_PARTITIONS` nombres de sous-requêtes pouvant être exécutées simultanément par les tâches Spark.
+ `PARTITION_FIELD` : le nom du champ à utiliser pour partitionner la requête.
+ `LOWER_BOUND` : une valeur limite inférieure **inclusive** du champ de partition choisi.

  Pour le champ Datetime, nous acceptons le format d'horodatage Spark utilisé dans SPark les requêtes SQL.

  Exemples de valeurs valides :

  ```
  "2022-01-01T01:01:01.000Z"
  ```
+ `UPPER_BOUND` : une valeur limite supérieure **exclusive** du champ de partition choisi.
+ `NUM_PARTITIONS` : le nombre de partitions.
+ `PARTITION_BY` : le type de partitionnement à effectuer. « FIELD » doit être transmis en cas de partitionnement basé sur des champs.

Exemple :

```
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"
    }
   )
```