Salesforce Marketing Cloud

Exemple : Lister tous les composants

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Assets dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause en fonction des exigences du client.

Vous devez placer la valeur d'une clause de filtre entre des guillemets simples (') et la transmettre directement, par exemple CategoryName='Content Builder'. Ici, "CategoryName" correspond au nom de la colonne et "Content Builder" à la valeur.

Vous pouvez utiliser la clause de filtre pour filtrer les enregistrements en fonction des colonnes. Par exemple, pour filtrer les enregistrements, utilisez les clauses de filtre suivantes : Location='US' et region='us-east1'.

Dans certains cas, la transmission d'un ID d'entité peut générer une erreur. Dans ce cas, vous pouvez utiliser la clause de filtre, par exemple id=172.

Exemple : Récupérer un enregistrement Assets

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Assets dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Définissez l'ID d'entité sur 49851.0, qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez 49851.0 dans le champ Valeur par défaut.

   La valeur de l'ID d'entité doit être transmise directement, par exemple Id= 49851.0. Ici, "49851.0" est la valeur de clé primaire unique qui doit être transmise.

Exemple : Supprimer un enregistrement "Assets"

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Assets dans la liste Entity.
3. Sélectionnez l'opération Delete, puis cliquez sur OK.
4. Définissez l'ID d'entité sur 49851.0, qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez 49851.0 dans le champ Valeur par défaut.

   La valeur de l'ID d'entité doit être transmise directement, par exemple ID= 49851.0. Ici, "49851.0" est la valeur de clé primaire unique qui doit être transmise.

Exemple : Créer un enregistrement DataExtensionObject_Custom

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez DataExtensionObject_Custom dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "StudentName":"Cruz",
   "StudentID":"1",
   "Rank":"1"}
   

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
     "StudentID": 1
   } 

Exemple : Créer un enregistrement Assets

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Assets dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
     "Name": "Googlecloud_Created_HTMLEmail_Testing_V1",
     "TypeName": "htmlemail",
     "TypeId": 208.0
   }

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
     "Id": 60188.0
   }

Exemple : Créer un enregistrement Campaigns

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Campaigns dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
     "Name": "Campaigns - Tested via Googlecloud",
     "CampaignCode": "annual2023",
     "Color": "0000ff",
     "Favorite": false
   }

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
     "Id": 247.0
   } 

Exemple : Créer un enregistrement Journeys

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Journeys dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
     "Version": 1.0,
     "Name": "API_Journey_Googlecloud_Retest_1",
     "CreatedDate": "2023-04-26 04:20:29.87",
     "ModifiedDate": "2023-05-10 07:45:06.04",
     "LastPublishedDate": "2023-04-26 04:37:18.0",
     "Description": "API_Journey_Googlecloud_Retest_1",
     "WorkFlowApiVersion": 1.0,
     "Tags": null,
     "Goals": "",
     "Triggers": "[{\"id\": \"c79154a3-a0d2-435e-a6ad-bed46474620a\", \"key\": \"TRIGGER\", \"name\": \"API_Journey_Googlecloud\", \"description\": \"\", \"type\": \"APIEvent\", \"outcomes\": [], \"arguments\": {\"startActivityKey\": \"{Context.StartActivityKey}\", \"dequeueReason\": \"{Context.DequeueReason}\", \"lastExecutedActivityKey\": \"{Context.LastExecutedActivityKey}\", \"filterResult\": \"true\"}, \"configurationArguments\": {\"schemaVersionId\": 0, \"criteria\": \"\", \"filterDefinitionId\": \"00000000-0000-0000-0000-000000000000\"}, \"metaData\": {\"sourceInteractionId\": \"00000000-0000-0000-0000-000000000000\", \"eventDefinitionId\": \"8153cf00-ebf6-4c18-b52f-573eb724df87\", \"eventDefinitionKey\": \"APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c\", \"chainType\": \"None\", \"configurationRequired\": false, \"iconUrl\": \"/images/icon_journeyBuilder-event-api-blue.svg\", \"title\": \"\", \"entrySourceGroupConfigUrl\": \"jb:///data/entry/api-event/entrysourcegroupconfig.json\"}}",
     "Defaults": "[{\"email\": [\"{Event.APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c.\"Email"}\"], \"properties\": {\"analyticsTracking\": {\"enabled\": false, \"analyticsType\": \"google\", \"urlDomainsToTrack\": []}}}]"
   }

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
     "Id": "aa03afe4-6a28-481f-bec4-564712127414"
   }

Exemple : Créer un enregistrement List

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez List dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
     "ID": "04052023.0",
     "ObjectID": "82349658-b482-404f-8c67-e555aadee0f4",
     "PartnerKey": "null",
     "CreatedDate": "2023-03-16 10:52:48.097",
     "ModifiedDate": "2023-03-17 10:30:34.497",
     "Client_ID": "5.14012689E8",
     "Client_PartnerClientKey": null,
     "ListName": "Googlecloud_Created_Subscriber_List",
     "Description": "null",
     "Category": "15449.0",
     "Type": "Public",
     "CustomerKey": "Googlecloud_BCONE",
     "ListClassification": "ExactTargetList",
     "AutomatedEmail_ID": "null"
   }

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
     "Id": 4052023.0
   }

Exemple : Créer un enregistrement Subscriber

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Subscriber dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
     "EmailAddress": "baklavainthebalkans@gmail.com",
     "SubscriberKey": "KB1"
   }

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
     "Success": true
   }

Exemple : Mettre à jour un enregistrement DataExtensionObject_Custom

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez DataExtensionObject_Custom dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "StudentName":"Charlie",
   "Rank":"1"
   }
   

5. Définissez l'ID d'entité sur, par exemple, 103032, qui est la clé primaire à transmettre. Pour définir l'ID d'entité, dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez 10 dans le champ Valeur par défaut.

   Si l'entité comporte des clés métier ou clés primaires composites, vous pouvez définir la filterClause sur Rank='1' and StudentID='10' au lieu de spécifier l'entityId.

Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

{
    "StudentID": 1
}

Exemple : Mettre à jour un enregistrement Assets

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Composants" dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
     "Description": "June2023-Updated"
   }
   

5. Définissez l'ID d'entité sur l'entité Assets . Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez 52080 dans le champ Valeur par défaut.

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
     "Id": 52080.0
   }
   

Exemple : Mettre à jour un enregistrement Journeys

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez Journeys dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
     "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
   }
   

5. Définissez l'ID d'entité sur l'entité Journeys . Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez 0868BF36-3107-460E-9EF1-09633A0592E8 dans le champ Valeur par défaut.

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
     "Id": "0868bf36-3107-460e-9ef1-09633a0592e8"
   }
   

Exemple : Mettre à jour un enregistrement List

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez List dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
     "Description": "UpdatedDescription"
   }
   

5. Définissez l'ID d'entité sur l'entité List . Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez 1234 dans le champ Valeur par défaut.

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
     "ID": 1234.0
   }