Pour interagir avec des données dans Salesforce® dans le cadre d'une chaîne, ajoutez une étape avec une commande de connexion Salesforce. Par exemple :
- Charger, extraire et supprimer des données via SOQL et des opérations en masse
- Créer et gérer des objets Salesforce
- Mise à jour et création d'enregistrements
Pour activer ces commandes, un administrateur informatique crée d'abord un connecteur Salesforce. Le connecteur interagit avec toutes les versions de Salesforce Sales Cloud - Salesforce Essentials®, Lightning® Professional, Lightning Enterprise et Lightning Unlimited - via l'API REST.
Suppression en bloc
Pour supprimer un grand nombre d'enregistrements à partir d'un fichier de valeurs séparées par des virgules (CSV), utilisez la commande Bulk delete.
Remarque : Si la suppression d'un enregistrement échoue, la commande renvoie un fichier CSV répertoriant les numéros de ligne des enregistrements ayant échoué, ainsi que la raison de l'échec. Vous pouvez utiliser le branchement pour effectuer des actions lorsque la commande échoue, ou charger les échecs sur Google® Drive en vue d'une analyse ultérieure.
Propriétés
| Propriété |
Détail |
| Mode de concomitance |
Choisissez de traiter les enregistrements en même temps ou de manière séquentielle.
- Pour traiter les enregistrements en même temps, sélectionnez Parallèle.
- Pour traiter les enregistrements de manière séquentielle, sélectionnez Série.
Remarque : Pour un travail très volumineux, sélectionnez Serial, car le volume des connexions à la base de données pourrait faire échouer le travail en mode Parallel. Toutefois, le mode série peut entraîner des délais de traitement beaucoup plus longs. |
| Nom de l'objet |
Saisir le type d'objet sur lequel l'opération doit être effectuée. |
| Fichier d'entrée |
Saisissez le fichier qui contient les enregistrements à supprimer. |
| Format de fichier |
Choisissez si le fichier d'entrée est CSV, JSON ou XML. |
| Taille du lot |
Saisissez le nombre d'enregistrements à traiter par lot. Nous vous recommandons de laisser la valeur par défaut. |
| Attendre l'achèvement |
Pour interroger Salesforce et ne passer à la commande suivante que lorsque tous les enregistrements ont été traités, cochez cette case. Pour déclencher la commande et passer immédiatement à l'étape suivante, décochez cette case. |
Sorties
| Sortie |
Type de sortie |
| Suppression en bloc du journal des erreurs |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Insertion en vrac
Pour insérer un grand nombre d'enregistrements à partir d'un fichier CSV, utilisez la commande Bulk insert.
Remarque : Si l'insertion d'un enregistrement échoue, la commande renvoie un fichier CSV répertoriant les numéros de ligne des enregistrements ayant échoué, ainsi que la raison de l'échec. Vous pouvez utiliser le branchement pour effectuer des actions lorsque la commande échoue, ou charger les échecs sur Google® Drive en vue d'une analyse ultérieure.
Propriétés
| Propriété |
Détail |
| Mode de concomitance |
Choisissez de traiter les enregistrements en même temps ou de manière séquentielle.
- Pour traiter les enregistrements en même temps, sélectionnez Parallèle.
- Pour traiter les enregistrements de manière séquentielle, sélectionnez Série.
Remarque : Pour un travail très volumineux, sélectionnez Serial, car le volume des connexions à la base de données pourrait faire échouer le travail en mode Parallel. Toutefois, le mode série peut entraîner des délais de traitement beaucoup plus longs. |
| Nom de l'objet |
Saisir le type d'objet sur lequel l'opération doit être effectuée. |
| Fichier d'entrée |
Saisissez le fichier qui contient les enregistrements à insérer. |
| Format de fichier |
Choisissez si le fichier d'entrée est CSV, JSON ou XML. |
| Taille du lot |
Saisissez le nombre d'enregistrements à traiter par lot. Nous vous recommandons de laisser la valeur par défaut. |
| Attendre l'achèvement |
Pour interroger Salesforce et ne passer à la commande suivante que lorsque tous les enregistrements ont été traités, cochez cette case. Pour déclencher la commande et passer immédiatement à l'étape suivante, décochez cette case. |
Sorties
| Sortie |
Type de sortie |
| Journal des erreurs d'insertion en bloc |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Requête en bloc
Pour interroger un grand nombre d'enregistrements, utilisez la commande Bulk query.
Propriétés
| Propriété |
Détail |
| Mode de concomitance |
Choisissez de traiter les enregistrements en même temps ou de manière séquentielle.
- Pour traiter les enregistrements en même temps, sélectionnez Parallèle.
- Pour traiter les enregistrements de manière séquentielle, sélectionnez Série.
Remarque : Pour un travail très volumineux, sélectionnez Serial, car le volume des connexions à la base de données pourrait faire échouer le travail en mode Parallel. Toutefois, le mode série peut entraîner des délais de traitement beaucoup plus longs. |
| Nom de l'objet |
Saisir le type d'objet sur lequel l'opération doit être effectuée. |
| Requête SOQL |
Saisissez la requête SOQL à exécuter. |
Sorties
| Sortie |
Type de sortie |
| Résultats de l'interrogation en bloc CSV |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Mise à jour en masse
Pour mettre à jour un grand nombre d'enregistrements, utilisez la commande Bulk update.
Remarque : Si la mise à jour d'un enregistrement échoue, la commande renvoie un fichier CSV contenant les numéros de ligne des enregistrements ayant échoué, ainsi que la raison de l'échec. Vous pouvez utiliser le branchement pour effectuer des actions lorsque la commande échoue, ou charger les échecs sur Google® Drive en vue d'une analyse ultérieure.
Propriétés
| Propriété |
Détail |
| Mode de concomitance |
Choisissez de traiter les enregistrements en même temps ou de manière séquentielle.
- Pour traiter les enregistrements en même temps, sélectionnez Parallèle.
- Pour traiter les enregistrements de manière séquentielle, sélectionnez Série.
Remarque : Pour un travail très volumineux, sélectionnez Serial, car le volume des connexions à la base de données pourrait faire échouer le travail en mode Parallel. Toutefois, le mode série peut entraîner des délais de traitement beaucoup plus longs. |
| Nom de l'objet |
Saisir le type d'objet sur lequel l'opération doit être effectuée. |
| Fichier d'entrée |
Saisissez le fichier qui contient les enregistrements à mettre à jour. |
| Format de fichier |
Choisissez si le fichier d'entrée est CSV, JSON ou XML. |
| Taille du lot |
Saisissez le nombre d'enregistrements à traiter par lot. Nous vous recommandons de laisser la valeur par défaut. |
| Attendre l'achèvement |
Pour interroger Salesforce et ne passer à la commande suivante que lorsque tous les enregistrements ont été traités, cochez cette case. Pour déclencher la commande et passer immédiatement à l'étape suivante, décochez cette case. |
Sorties
| Sortie |
Type de sortie |
| Journal des erreurs de la mise à jour en bloc |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Insertion en bloc
Pour effectuer un upsert - c'est-à-dire mettre à jour les enregistrements existants ou en créer de nouveaux sur la base d'un identifiant externe - sur un grand nombre d'enregistrements, utilisez la commande Bulk upsert.
Remarque : Si l'insertion d'un enregistrement échoue, la commande renvoie un fichier CSV répertoriant les numéros de ligne des enregistrements ayant échoué, ainsi que la raison de l'échec. Vous pouvez utiliser le branchement pour effectuer des actions lorsque la commande échoue, ou charger les échecs sur Google® Drive en vue d'une analyse ultérieure.
Propriétés
| Propriété |
Détail |
| Mode de concomitance |
Choisissez de traiter les enregistrements en même temps ou de manière séquentielle.
- Pour traiter les enregistrements en même temps, sélectionnez Parallèle.
- Pour traiter les enregistrements de manière séquentielle, sélectionnez Série.
Remarque : Pour un travail très volumineux, sélectionnez Serial, car le volume des connexions à la base de données pourrait faire échouer le travail en mode Parallel. Toutefois, le mode série peut entraîner des délais de traitement beaucoup plus longs. |
| Nom de l'objet |
Saisir le type d'objet sur lequel l'opération doit être effectuée. |
| Fichier d'entrée |
Saisissez le fichier qui contient les enregistrements à transférer. |
| Format de fichier |
Choisissez si le fichier d'entrée est CSV, JSON ou XML. |
| Taille du lot |
Saisissez le nombre d'enregistrements à traiter par lot. Nous vous recommandons de laisser la valeur par défaut. |
| Attendre l'achèvement |
Pour interroger Salesforce et ne passer à la commande suivante que lorsque tous les enregistrements ont été traités, cochez cette case. Pour déclencher la commande et passer immédiatement à l'étape suivante, décochez cette case. |
| ID externe |
Pour déterminer si un enregistrement existe déjà ou doit être créé, saisissez le champ ID externe requis pour l'objet concerné par la conversion. |
Sorties
| Sortie |
Type de sortie |
| Journal d'erreur de l'insertion en bloc |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Créer un enregistrement
Pour créer un nouvel enregistrement dans Salesforce, utilisez la commande Créer un enregistrement.
Propriétés
| Propriété |
Détail |
| Nom |
Saisir le nom de l'objet sous lequel l'enregistrement doit être créé. |
| Champs |
Saisissez les champs de l'enregistrement à mettre à jour, dans le format suivant : FIELD_NAME:VALUE. |
Sorties
| Sortie |
Type de sortie |
| ID du nouvel enregistrement |
Chaîne |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Supprimer l’enregistrement
Pour supprimer un enregistrement dans Salesforce en fonction de son ID, utilisez la commande Delete record.
Propriétés
| Propriété |
Détail |
| ID |
Saisir l'identifiant de l'enregistrement à supprimer. Si l'identifiant est inconnu, saisissez un identifiant externe au format EXTERNAL_ID_NAME:VALUE, tel que Name:John. |
| Nom |
Saisir le nom de l'objet sous lequel l'enregistrement doit être supprimé. |
Sorties
Aucun
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Télécharger le rapport
Pour télécharger un rapport personnalisé sous la forme d'un fichier de valeurs séparées par des virgules (CSV), utilisez la commande Download report.
Propriétés
| Propriété |
Détail |
| ID de rapport |
Saisissez l'ID du rapport personnalisé à télécharger. |
Sorties
| Sortie |
Type de sortie |
| Rapport personnalisé CSV |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Obtenir les métadonnées de l'objet
Pour récupérer les champs et les métadonnées associés à un objet Salesforce, utilisez la commande Get object metadata.
Propriétés
| Propriété |
Détail |
| Objet |
Saisissez le nom de l'objet pour lequel vous souhaitez récupérer des métadonnées. |
Sorties
| Sortie |
Type de sortie |
| Métadonnées de l'objet |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Obtenir un enregistrement
Pour récupérer un enregistrement dans Salesforce en fonction de son ID, utilisez la commande Get record.
Propriétés
| Propriété |
Détail |
| ID |
Saisir l'identifiant de l'enregistrement à extraire. |
| Nom |
Saisir le nom de l'objet sous lequel l'enregistrement doit être récupéré. |
| Champs |
Saisissez les champs du rapport à inclure (facultatif). |
Sorties
| Sortie |
Type de sortie |
| Obtenir l'enregistrement JSON |
JSON |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Liste des connexions
Pour répertorier les logins dans l'environnement Salesforce, utilisez la commande List logins.
Propriétés
Aucune
Sorties
| Sortie |
Type de sortie |
| Liste des connexions CSV |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Liste d'objets
Pour répertorier les objets de Salesforce, utilisez la commande List objects.
Propriétés
Aucune
Sorties
| Sortie |
Type de sortie |
| Liste des objets CSV |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Liste des rapports
Pour répertorier les rapports de Salesforce, utilisez la commande List reports.
Propriétés
Aucune
Sorties
| Sortie |
Type de sortie |
| Rapports de liste CSV |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Requête SOQL
Pour exécuter une requête SOQL et générer ses résultats sous forme de fichier CSV, utilisez la commande SOQL query.
Note : La syntaxe SOQL est très similaire à SQL. La commande SOQL Query permet d'extraire de grands volumes de données et de renvoyer des ensembles de données contenant 1 million d'enregistrements ou plus à la fois. Si la commande échoue parce que la requête est incorrecte ou qu'elle fait référence à des objets qui n'existent pas, les résultats de la commande vous en informent.
Propriétés
| Propriété |
Détail |
| Requête |
Saisissez la requête SOQL à exécuter. |
| Commande d'interrogation |
Choisissez d'inclure ou non les enregistrements supprimés.
- Pour exclure les enregistrements supprimés de, sélectionnez Requête.
- Pour inclure les enregistrements supprimés de, sélectionnez QueryAll.
|
Sorties
| Sortie |
Type de sortie |
| Sortie de la requête SOQL |
Fichier |
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
SObject - créer
Pour créer un nouveau SObject dans Salesforce, utilisez la commande SOjbect- create.
Propriétés
| Propriété |
Détail |
| Nom |
Saisissez le nom du nouvel objet SObject. Pour indiquer qu'il s'agit d'un objet personnalisé, Salesforce ajoute automatiquement __c. |
| Champs |
Saisissez les champs d'enregistrement à créer, au format FIELD_NAME:TYPE, où TYPE correspond à un type de champ Salesforce. |
Sorties
Aucun
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
SObject - supprimer
Pour supprimer des SObjects dans Salesforce, utilisez une commande SObject - delete.
Propriétés
| Propriété |
Détail |
| Nom |
Saisir le nom de l'objet à créer. |
Sorties
Aucun
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
Mise à jour de l'enregistrement
Pour mettre à jour les valeurs des champs d'un enregistrement dans Salesforce, utilisez la commande Update record.
Propriétés
| Propriété |
Détail |
| ID |
Saisissez l'identifiant de l'enregistrement à mettre à jour. |
| Nom |
Saisir le nom de l'objet sous lequel l'enregistrement doit être mis à jour. |
| Champs |
Saisissez les champs de l'enregistrement à mettre à jour, dans le format suivant : FIELD_NAME:VALUE. |
Sorties
Aucun
Codes de sortie
| Code |
Type |
Détail |
| 0 |
Réussite |
Réussite |
| 1 |
Erreur |
Échec général |
<!--## Recipes
### Extract Data from Salesforce to Anaplan
To extract data from Salesforce as a CSV file and upload it directly to Anaplan®:
1. Create the chain:
1. In **Chains**, click **Add**.
2. Enter a unique name to identify the chain.
3. Click **Save**.
2. To execute a SOQL query to extract data from Salesforce as the first step of the chain:
3. Click **Add a command**.
4. Select **Salesforce**, **SOQL Query**.
4. Select the Salesforce connector.
5. Enter the query and its parameters.
6. Click **Save**.
3. To load the CSV output into Anaplan as the second step:
1. Click **Add a command**, and in **Run Condition**, select Success.
2. Select **Anaplan**, **Upload file**.
3. Select the Anaplan connector.
4. Enter the properties of the command. For **Source File**, select **SOQL Query Output**.
5. Click **Save**.
4. Click **Publish**.
-->