Action Exécuter SOQL dans Salesforce

Pour rechercher des informations spécifiques dans vos données Salesforce, exécutez la commande Salesforce Object Query Language (SOQL) via Automation 360 en utilisant l'action Exécuter SOQL dans Salesforce.

Le langage SOQL est similaire au langage SQL (Structured Query Language), mais est adapté aux données Salesforce. Pour en savoir plus sur SOQL, consultez la page Exécuter SOQL dans Salesforce.

Pour obtenir des informations spécifiques à partir des données Salesforce, exécutez une requête depuis Automation 360.

Pour envoyer une requête SOQL à Salesforce en utilisant l'action Exécuter SOQL, procédez comme suit :
Remarque : Assurez-vous de vous être authentifié avant d'appeler une action Salesforce. Pour en savoir plus sur l'authentification, consultez la rubrique action Authentification Salesforce.

Procédure

  1. Dans le volet Actions, sélectionnez l'action Salesforce > Exécuter SOQL et placez-la dans le canevas.
    Action Exécuter SOQL dans Salesforce
  2. Renseignez les champs suivants :
    1. Saisissez la requête SOQL à exécuter, par exemple, Sélectionner Statut De Cas Id = '5004W000026rD4HQAU'.
      Remarque : Pour les objets personnalisés Salesforce, assurez-vous de fournir le nom de l'API au lieu du nom d'affichage de l'objet. Par exemple, fournissez le nom de l'API : AAIRPA__Salesforce_Connection__c et non le nom d'affichage : Connexion à Salesforce » Pour plus d'informations sur la manière de trouver le nom de l'API, consultez https://help.salesforce.com/s/articleView?id=000327123&type=1.
    2. Sélectionnez l'une des options suivantes :
      • Si vous souhaitez inclure les enregistrements supprimés, sélectionnez Oui.
      • Si vous ne souhaitez pas inclure les enregistrements supprimés, sélectionnez Non.
    3. Saisissez Par défaut comme nom de session.
    4. Enregistrez le résultat dans une variable. Par exemple, tous les champs des enregistrements peuvent être stockés dans une liste (List_SOQL)
  3. Vérifiez que vous pouvez exécuter le robot en mode Débogage avec un point d'arrêt défini sur une action en regard de Exécuter SOQL. Par exemple, dans l'exemple fourni précédemment, il existe une action Zone de message. Ouvrez la variable List_SOQL pour afficher les résultats.
    Salesforce - Vérifier l'action Exécuter SOQL
    L'ensemble des résultats est renvoyé en tant que réponse à l'action Exécuter SOQL de Salesforce et le nombre d'enregistrements renvoyés n'est pas limité.
    Remarque : La réponse peut contenir un volume important de données, ce qui risque de dégrader les performances de votre automatisation.
    Remarque : La sortie est récupérée sous la forme d'une liste de type Dictionnaire. Pour lire un enregistrement individuel (ligne) dans cette liste, vous devez parcourir tous les éléments du dictionnaire à l'aide de l'action Boucle et lire ou extraire les enregistrements (lignes) individuellement. Par exemple, le résultat de l'extraction de plusieurs enregistrements est enregistré dans la variable list_of_records_any. Si la variable contient cinq enregistrements, chaque enregistrement est transmis à l'action Boucle pour être traité un par un.Action Boucle pour obtenir plusieurs enregistrements