Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Lettura dalle entità Salesforce Marketing Cloud Account Engagement
<a name="salesforce-marketing-cloud-account-engagement-reading-from-entities"></a>

**Prerequisito**

Un oggetto di Salesforce Marketing Cloud Account Engagement da cui si desidera leggere. È necessario il nome dell'oggetto.

**Entità supportate come origine Sync**:


| Entità | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento | 
| --- | --- | --- | --- | --- | --- | 
| Campagna | Sì  | Sì | Sì | Sì | Sì | 
| Contenuti dinamici | Sì  | Sì | Sì | Sì | Sì | 
| Email | Sì  | Sì | Sì | Sì | Sì | 
| Modello e-mail | Sì  | Sì | Sì | Sì | Sì | 
| Engagement Studio Program | Sì  | Sì | Sì | Sì | Sì | 
| Contenuti della cartella | Sì  | Sì | Sì | Sì | Sì | 
| Pagina di destinazione | Sì  | Sì | Sì | Sì | Sì | 
| Cronologia del ciclo di vita | Sì  | Sì | Sì | Sì | Sì | 
| Stadio del ciclo di vita | Sì  | Sì | Sì | Sì | Sì | 
| List | Sì  | Sì | Sì | Sì | Sì | 
| Elenco e-mail | Sì  | Sì | Sì | Sì | Sì | 
| Elenco iscrizioni | Sì  | Sì | Sì | Sì | Sì | 
| Opportunità | Sì  | Sì | Sì | Sì | Sì | 
| Prospect | Sì  | Sì | Sì | Sì | Sì | 
| Account Prospect | Sì  | Sì | Sì | Sì | Sì | 
| Utente | Sì  | Sì | Sì | Sì | Sì | 

**Esempio**:

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

**Entità supportate come origine Async**:


| Entità | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento | 
| --- | --- | --- | --- | --- | --- | 
| Campagna | Sì | No | No | Sì | No | 
| Contenuti dinamici | Sì | No | No | Sì | No | 
| Modello e-mail | Sì | No | No | Sì | No | 
| Pagina di destinazione | Sì | No | No | Sì | No | 
| Cronologia del ciclo di vita | Sì | No | No | Sì | No | 
| Stadio del ciclo di vita | Sì | No | No | Sì | No | 
| List | Sì | No | No | Sì | No | 
| Elenco e-mail | Sì | No | No | Sì | No | 
| Elenco iscrizioni | Sì | No | No | Sì | No | 
| Opportunità | Sì | No | No | Sì | No | 
| Prospect | Sì | No | No | Sì | No | 
| Account Prospect | Sì | No | No | Sì | No | 
| Utente | Sì | No | No | Sì | No | 

**Esempio**:

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

**Dettagli dell'entità e del campo di Salesforce Marketing Cloud Account Engagement**:

Per visualizzare i dettagli dei campi per le seguenti entità, accedere all'[API Salesforce Marketing Cloud Account Engagement](https://developer.salesforce.com/docs/marketing/pardot), scegliere **Guide**, scorrere verso il basso fino a **Wrapper API Open Source**, espandere la **versione 5 Docs** dal menu e scegliere un'entità.

Elenco delle entità:
+ Campagna
+ Contenuti dinamici
+ Email
+ Modello e-mail
+ Engagement Studio Program
+ Contenuto della cartella
+ Pagina di destinazione
+ Cronologia del ciclo di vita
+ Stadio del ciclo di vita
+ List
+ Elenco e-mail
+ Elenco iscrizioni
+ Opportunità
+ Prospect
+ Account Prospect
+ Utente

Oltre ai campi sopra menzionati, la modalità asincrona supporta campi filtrabili specifici per ciascuna entità, come mostrato nella tabella seguente.


| Entità | Campi filtrabili aggiuntivi supportati in modalità asincrona | 
| --- | --- | 
| Campagna | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Contenuti dinamici | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Modello e-mail | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Engagement Studio Program | - | 
| Pagina di destinazione | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Cronologia del ciclo di vita | createdAfter, createdBefore | 
| Stadio del ciclo di vita | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| List | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Elenco e-mail | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Elenco iscrizioni | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Opportunità | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Prospect | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Account Prospect | createdAfter, createdBefore, deleted | 
| Utente | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 

Per ulteriori informazioni sui campi aggiuntivi, consultare l'[API Salesforce Export](https://developer.salesforce.com/docs/marketing/pardot/guide/export-v5.html#procedures)

Prendere nota di quanto segue per il connettore:
+ Il valore del campo `delete` nelle entità può essere `false` (impostazione predefinita), `true` o `all`.

## Query di partizionamento
<a name="salesforce-marketing-cloud-account-engagement-reading-partitioning-queries"></a>

**Partizionamento basato su filtri**:

È possibile fornire le opzioni Spark aggiuntive `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` e `NUM_PARTITIONS` se si desidera utilizzare la simultaneità in Spark. Con questi parametri, la query originale viene suddivisa in `NUM_PARTITIONS` query secondarie che possono essere eseguite contemporaneamente dalle attività Spark.
+ `PARTITION_FIELD`: il nome del campo da utilizzare per partizionare la query.
+ `LOWER_BOUND`: un valore limite inferiore **inclusivo** del campo di partizione scelto.

  Per il campo Datetime, accettiamo il formato timestamp Spark utilizzato nelle query SQL. SPark 

  Esempi di valori validi:

  ```
  "2022-01-01T01:01:01.000Z"
  ```
+ `UPPER_BOUND`: un valore limite superiore **esclusivo** del campo di partizione scelto.
+ `NUM_PARTITIONS`: il numero di partizioni.
+ `PARTITION_BY`: il tipo di partizionamento da eseguire. “FIELD” deve essere passato in caso di partizionamento basato sul campo.

Esempio:

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