Salesforce

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion.

Type de connexion avec nom d'utilisateur et mot de passe

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Actions

Ce connecteur vous permet d'effectuer des opérations d'insertion, de suppression, de mise à jour et de lecture sur des données Salesforce. Pour exécuter des requêtes SQL personnalisées, le connecteur fournit l'action Exécuter une requête personnalisée.

Pour créer une requête personnalisée, procédez comme suit :

1. Suivez les instructions détaillées pour ajouter une tâche "Connecteurs".
2. Lorsque vous configurez la tâche "Connecteurs", sélectionnez Actions dans le type d'action à effectuer.
3. Dans la liste Action, sélectionnez Exécuter une requête personnalisée, puis cliquez sur OK.

   

4. Développez la section Entrée de la tâche, puis procédez comme suit :
   1. Dans le champ Délai d'inactivité après, saisissez le nombre de secondes d'attente jusqu'à l'exécution de la requête.

      Valeur par défaut : 180 secondes.

   2. Dans le champ Nombre maximal de lignes, saisissez le nombre maximal de lignes à renvoyer à partir de la base de données.

      Valeur par défaut : 25

   3. Pour mettre à jour la requête personnalisée, cliquez sur Modifier le script personnalisé. La boîte de dialogue Éditeur de script s'ouvre.

      

   4. Dans la boîte de dialogue Éditeur de script, saisissez la requête SQL, puis cliquez sur Enregistrer.

      Vous pouvez utiliser un point d'interrogation (?) dans une instruction SQL pour représenter un seul paramètre devant être spécifié dans la liste des paramètres de requête. Par exemple, la requête SQL suivante sélectionne toutes les lignes de la table Employees correspondant aux valeurs spécifiées pour la colonne LastName :

      SELECT * FROM Employees where LastName=?

   5. Si vous avez utilisé des points d'interrogation dans votre requête SQL, vous devez ajouter le paramètre en cliquant sur + Ajouter un nom de paramètre pour chaque point d'interrogation. Lors de l'exécution de l'intégration, ces paramètres remplacent les points d'interrogation (?) de la requête SQL de manière séquentielle. Par exemple, si vous avez ajouté trois points d'interrogation (?), vous devez ajouter trois paramètres dans l'ordre de séquence.

      

      Pour ajouter des paramètres de requête, procédez comme suit :

      1. Dans la liste Type, sélectionnez le type de données du paramètre.
      2. Dans le champ Valeur, saisissez la valeur du paramètre.
      3. Pour ajouter plusieurs paramètres, cliquez sur + Ajouter un paramètre de requête.

Le connecteur Salesforce n'accepte pas les valeurs paramétrées pour la clause OFFSET et ne peut pas être remplacé de manière dynamique à l'aide de paramètres de requête. Toutefois, les paramètres de requête sont acceptés dans la clause WHERE.

Cette section liste les actions compatibles avec le connecteur Salesforce. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action CreateJobv2

Utilisez cette action pour créer un job.

Paramètres d'entrée de l'action CreateJobV2

Pour obtenir des exemples de configuration de l'action CreateJobV2, consultez Exemples.

Action UploadJobDataV2

Utilisez cette action pour importer un fichier de job au format CSV dans Salesforce.

Paramètres d'entrée de l'action UploadJobDataV2

Pour obtenir des exemples de configuration de l'action UploadJobDataV2, consultez Exemples.

Action CreateBatch

Cette action crée un lot Salesforce.

Paramètres d'entrée de l'action CreateBatch

Paramètres de sortie de l'action CreateBatch

Pour obtenir des exemples de configuration de l'action CreateBatch, consultez Exemples.

Action CreateJob

Cette action ajoute une entrée d'objet Salesforce.

Paramètres d'entrée de l'action CreateJob

Paramètres de sortie de l'action CreateJob

Pour obtenir des exemples de configuration de l'action CreateJob, consultez Exemples.

Action GetBatch

Cette action permet d'obtenir des informations sur un lot Salesforce.

Paramètres d'entrée de l'action GetBatch

Paramètres de sortie de l'action GetBatch

Pour obtenir des exemples de configuration de l'action GetBatch, consultez Exemples.

Action GetJob

Cette action permet d'obtenir des informations sur un job Salesforce.

Paramètres d'entrée de l'action GetJob

Paramètres de sortie de l'action GetJob

Pour obtenir des exemples de configuration de l'action GetJob, consultez Exemples.

Action UploadAttachment

Cette action importe une pièce jointe et l'associe à une entité dans Salesforce.

Paramètres d'entrée de l'action UploadAttachment

Paramètres de sortie de l'action UploadAttachment

Pour obtenir des exemples de configuration de l'action UploadAttachment, consultez Exemples.

Action GetBatchResults

Cette action permet d'obtenir les résultats d'un lot Salesforce.

Paramètres d'entrée de l'action GetBatchResults

Paramètres de sortie de l'action GetBatchResults

Pour obtenir des exemples de configuration de l'action GetBatchResults, consultez Exemples.

Exemples d'actions

Exemple : CreateJobV2

Cet exemple crée un job.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CreateJobV2, puis cliquez sur OK.
3. 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 :

    {
     "ObjectName": "Contact",
     "Action": "insert"
    }

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

 
  [{
  "ID": "750dM000005HjdnQAC",
  "State": "Open",
  "JobType": null,
  "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches",
  "ContentType": "CSV",
  "CreatedDate": "2024-08-07T09:16:16.000+0000",
  "CreatedById": "005dM0000061WSFQA2",
  "ConcurrencyMode": "Parallel",
  "SystemModStamp": "2024-08-07T09:16:16.000+0000"
  }] 

Exemple : UploadJobDataV2

Cet exemple importe un fichier de job dans Salesforce.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action UploadJobDataV2, puis cliquez sur OK.
3. 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 :

    {
     "Content":   "FirstName,LastName,Email,MobilePhone,External_Id__c\\nGinelle,Merioth,gmerioth0@example.com,851-555-8435,4d13cac0-2c11-48e9-891d-49ee9508a6c7\\nDalli,Tumilson,dtumilson1@example.com,881-555-6742,38bcb24b-247f-498b-9502-c98995a1e04b\\nRobbin,Purveys,rpurveys2@example.com,732-555-6909,35d96c7a-3856-4809-8c49-35ddb9fa7dd9\\nLothaire,Ivanchenkov,livanchenkov3@example.com,144-555-1959,75f63f26-6f4a-406f-a9f4-807f4a8a7b51",
     "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches"
    }

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

 
  [{
  "Uploaded": "true"
  }]

Exemple : CreateBatch

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CreateBatch, puis cliquez sur OK.
3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input :

   {
   "JobId": "750dL000007EipxQAC",
   "Aggregate": "\n    Walter\n    White\n  \n  \n    Rob\n    Brown\n  \n",
   "ContentType": "XML"
   }

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

 
[{
  "ID": "751dL000003ziC5QAI",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-03T04:48:53.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Queued",
  "StateMessage": null,
  "SystemModstamp": "2024-09-03T04:48:53.000Z",
  "TotalProcessingTime": "0"
}]

Exemple : CreateJob

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CreateJob, puis cliquez sur OK.
3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input :

   {
     "ObjectName": "Campaign",
     "Action": "insert"
   }

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

 
 [{
  "ID": "750dL000007GgD7QAK",
  "JobID": "750dL000007GgD7QAK",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-03T05:31:41.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "0",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "0",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-03T05:31:41.000Z",
  "TotalProcessingTime": "0"
}]

Exemple : GetBatch

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action GetBatch, puis cliquez sur OK.
3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input :

   {
     "BatchId": "751dL000003yKlJQAU",
     "JobId": "750dL000007EipxQAC"
   }

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

 
[{
  "ID": "751dL000003yKlJQAU",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-02T11:44:15.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Failed",
  "StateMessage": "InvalidBatch : Failed to parse XML. Unexpected XML element 'sObject' found at  START_TAG seen ... @1:9 it should be 'sObjects'",
  "SystemModstamp": "2024-09-02T11:44:15.000Z",
  "TotalProcessingTime": "0"
}]

Exemple : GetJob

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action GetJob , puis cliquez sur OK.
3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input :

   {
     "JobId": "750dL000007EipxQAC"
   } 

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

 
[{
  "ID": "750dL000007EipxQAC",
  "JobID": "750dL000007EipxQAC",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-02T11:17:42.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "2",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "2",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-02T11:17:42.000Z",
  "TotalProcessingTime": "0"
}]

Exemple : UploadAttachment

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action UploadAttachment, puis cliquez sur OK.
3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input :

   {
     "ObjectId": "001dL00000SC6j7QAD",
     "FileName": "My files/salesforce/con.csv",
     "Base64Data": "Y29ubmVjdG9ycyBpcyBiYWNr"
   }

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

 
[{
  "Id": "00PdL000000EJUDUA4"
}]

Exemple : GetBatchResults

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action GetBatchResults, puis cliquez sur OK.
3. Dans la section Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input :

   {
     "BatchId": "751dL000004D17FQAS",
     "JobId": "750dL000007XKUhQAO",
     "ContentType": "XML"
   }

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

 
[{
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}, {
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}]

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Créer une pièce jointe

La création d'une pièce jointe par l'entité ne crée qu'une pièce jointe sans fichier de contenu. Pour ajouter un fichier, nous devons effectuer l'action UploadAttachment en indiquant un contexte de fichier dans l'entrée.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Pièce jointe" dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche, cliquez sur l'éditeur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le field:

   {
     "Name": "New Attachment",
     "Description": "New created attachment",
     "ParentId": "001dL00000SC6j7QAD",
     "Body": "Body"
   }
   

5. L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

   {
     "Id": "00PdL000000EJKXUA4"
   }
   

Exemple : Mettre à jour une pièce jointe

La mise à jour d'une pièce jointe par l'entité ne modifie que le nom ou la description de l'élément joint. Pour ajouter un fichier, nous devons effectuer l'action UploadAttachment en indiquant un contexte de fichier dans l'entrée.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Pièce jointe" dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "Mettre à jour une pièce jointe". Pour définir l'ID d'entité, dans la section Data Mapper des tâches, cliquez sur EntityID, puis saisissez 00PdL000000EJKXUA4 dans le champ indiqué.
5. Dans la section Data Mapper de la tâche, cliquez sur l'éditeur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le field:

   {
     "Name": "New Attachment",
     "Description": "New updated attachment",
     "Body": "Body"
   }
   

Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 00PdL000000EJKXUA4.

6. L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

   {
     "Id": "00PdL000000EJKXUA4"
   }