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.

# Écriture destinée aux entités Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-writing-to-entities"></a>

**Conditions préalables**
+ Un objet Salesforce Marketing auquel vous souhaitez écrire. Vous devrez spécifier le nom de l’objet tel que `List` ou `Campaigns` ou l’une des autres entités décrites dans le tableau ci-dessous.
+ Le connecteur Salesforce Marketing Cloud prend en charge trois opérations d’écriture :
  + INSERT
  + UPSERT
  + UPDATE

  Lorsque vous utilisez les opérations d’écriture `UPDATE` et `UPSERT`, vous devez proposer l’option `ID_FIELD_NAMES` afin de spécifier le champ d’ID externe pour les enregistrements. 

**Entités prises en charge pour la destination** :


| Entité | Priority | Interface (REST, SOAP, etc.) | Peut être inséré | Peut être mis à jour | Peut faire l’objet d’un upsert | 
| --- | --- | --- | --- | --- | --- | 
| Campagnes | P0 | REST | Y- Unique | Y- Unique | N | 
| Content Assets | P0 | REST | Y- Unique, en bloc | Y- Unique | N | 
| Contact | P1 | REST | Y- Unique | Y- Unique | N | 
| Vérification de domaine | P1 | REST | Y- Unique | Y- Unique, en bloc | N | 
| Event Notification Callback | P1 | REST | Y- Unique | Y- Unique | N | 
| Event Notification Subscription | P1 | REST | Y- Unique | Y- Unique | N | 
| Messagerie | P1 | REST | Y- Unique | N | N | 
| Object Nested Tag | P2 | REST | Y- Unique | Y- Unique | N | 
| Seed-List | P1 | REST | Y- Unique | Y- Unique | N | 
| Configuration | P1 | REST | Y- Unique | Y- Unique | N | 
| Data Extension | P0 | SOAP | Y- Unique | Y- Unique | Y- Unique | 
| E-mail | P0 | SOAP | Y- Unique | Y- Unique | N | 
| List | P0 | SOAP | Y- Unique | Y- Unique | N | 
| Envoyer | P0 | SOAP | Y- Unique | N | N | 
| Subscriber | P0 | SOAP | Y- Unique | Y- Unique | N | 

**Exemple d’opération INSERT pour 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"
    }
)
```

**Exemple d’opération INSERT pour 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"
    }
)
```

**Exemple d’opération UPDATE pour 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"
    }
)
```

**Exemple d’opération UPDATE pour 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"
    }
)
```

**Exemple d’opération UPSERT pour 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"
    }
)
```