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

# Scrivere alle entità Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-writing-to-entities"></a>

**Prerequisiti**
+ Un oggetto di Salesforce Marketing a cui si desidera scrivere. È necessario specificare il nome dell'oggetto, come ad esempio `List` o `Campaigns` una qualsiasi delle altre entità descritte nella tabella seguente.
+ Il connettore Salesforce Marketing Cloud supporta tre operazioni di scrittura:
  + INSERT
  + UPSERT
  + UPDATE

  Quando si utilizzano le operazioni di scrittura `UPDATE` e `UPSERT`, è necessario indicare l'opzione `ID_FIELD_NAMES` per specificare il campo ID esterno per i record. 

**Entità supportate come destinazione**:


| Entità | Priorità | Interfaccia (REST, SOAP, ecc.) | Può essere Inserted | Può essere Updated | Può essere Upserted | 
| --- | --- | --- | --- | --- | --- | 
| Campagne | P0 | REST | Y- Singolo | Y- Singolo | N | 
| Risorse di contenuti | P0 | REST | Y- Singolo, bulk | Y- Singolo | N | 
| Contatti | P1 | REST | Y- Singolo | Y- Singolo | N | 
| Verifica del dominio | P1 | REST | Y- Singolo | Y- Singolo, bulk | N | 
| Callback di notifiche di eventi | P1 | REST | Y- Singolo | Y- Singolo | N | 
| Iscrizione alle notifiche di eventi | P1 | REST | Y- Singolo | Y- Singolo | N | 
| Messaggistica | P1 | REST | Y- Singolo | N | N | 
| Oggetto tag nidificato | P2 | REST | Y- Singolo | Y- Singolo | N | 
| Seed-List | P1 | REST | Y- Singolo | Y- Singolo | N | 
| Configurazione | P1 | REST | Y- Singolo | Y- Singolo | N | 
| Estensione di dati | P0 | SOAP | Y- Singolo | Y- Singolo | Y- Singolo | 
| Email | P0 | SOAP | Y- Singolo | Y- Singolo | N | 
| List | P0 | SOAP | Y- Singolo | Y- Singolo | N | 
| Invia | P0 | SOAP | Y- Singolo | N | N | 
| Abbonato | P0 | SOAP | Y- Singolo | Y- Singolo | N | 

**Esempio di operazione INSERT per 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"
    }
)
```

**Esempio di operazione INSERT per 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"
    }
)
```

**Esempio di operazione UPDATE per 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"
    }
)
```

**Esempio di operazione UPDATE per 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"
    }
)
```

**Esempio di operazione UPSERT per 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"
    }
)
```