Aktion „SOQL ausführen“ in Salesforce

Um Ihre Salesforce-Daten nach bestimmten Informationen zu durchsuchen, führen Sie den Salesforce Object Query Language (SOQL)-Befehl von Automation 360 aus, indem Sie die Aktion „SOQL ausführen“ in Salesforce verwenden.

SOQL ähnelt der Structured Query Language (SQL), ist aber auf Salesforce-Daten zugeschnitten. Weitere Informationen zu SOQL finden Sie unter Salesforce Execute SOQL.

Um bestimmte Informationen aus Salesforce-Daten zu erhalten, führen Sie eine Abfrage mit Automation 360 aus.

Um eine SOQL-Abfrage an Salesforce zu senden, indem Sie die Aktion SOQL ausführen verwenden, führen Sie die folgenden Schritte aus:
Anmerkung: Sie müssen authentifiziert sein, bevor Sie eine Salesforce-Aktion aufrufen. Weitere Informationen zur Authentifizierung finden Sie unter Aktion „Authentifizierung“ in Salesforce.

Prozedur

  1. Wählen Sie im Bereich Aktionen Salesforce > SOQL ausführen aus und platzieren Sie das Element auf der Leinwand.
    Aktion „SOQL ausführen“ in Salesforce
  2. Geben Sie Informationen in die folgenden Felder ein:
    1. Geben Sie die Auszuführende SOQL-Abfrageein, zum Beispiel Select Status From Case Where Id = '5004W000026rD4HQAU'.
      Anmerkung: Stellen Sie bei benutzerdefinierten Salesforce-Objekten sicher, dass Sie den API-Namen anstelle des Anzeigenamens des Objekts angeben. Geben Sie zum Beispiel als API-Namen: AAIRPA__Salesforce_Connection__c ein und nicht den Anzeigenamen: Salesforce-Verbindung. Weitere Informationen zur Ermittlung des API-Namens finden Sie unter https://help.salesforce.com/s/articleView?id=000327123&type=1.
    2. Wählen Sie eine der folgenden Optionen aus:
      • Wenn Sie die gelöschten Datensätze einbeziehen möchten, wählen Sie Ja.
      • Wenn Sie die gelöschten Datensätze nicht berücksichtigen möchten, wählen Sie Nein.
    3. Geben Sie Standard als Namen für die Sitzung ein.
    4. Speichern Sie das Ergebnis in einer Variablen. Zum Beispiel können alle Felder der Datensätze in einer Liste gespeichert werden (List_SOQL)
  3. Überprüfen Sie, ob Sie den Bot im Fehlerbehebungsmodus ausführen können, wobei ein Haltepunkt auf eine Aktion neben „SOQL ausführen“ festgelegt ist. So gibt es zum Beispiel in dem zuvor angeführten Beispiel die Aktion Nachrichtenfeld. Öffnen Sie die Variable List_SOQL, um die Ergebnisse zu sehen.
    Aktion „SOQL ausführen“ zur Verifizierung in Salesforce
    Die gesamte Ergebnismenge wird als Antwort auf die Salesforce-Aktion „SOQL ausführen“ zurückgegeben. Es gibt keine Begrenzung für die Anzahl der zurückgegebenen Datensätze.
    Anmerkung: Die Antwort kann ein hohes Datenvolumen aufweisen, das die Leistung Ihrer Automatisierung beeinträchtigen kann.
    Anmerkung: Die Ausgabe wird als Liste vom Typ Wörterbuch abgerufen. Um einen einzelnen Datensatz (Zeile) in dieser Liste zu lesen, müssen Sie mit der Aktion Schleife alle Wörterbucheinträge in einer Schleife durchlaufen und die Datensätze (Zeilen) einzeln lesen oder extrahieren. Zum Beispiel wird die Ausgabe von „Mehrere Datensätze abrufen“ in der Variablen list_of_records_any gespeichert. Wenn die Variable fünf Datensätze enthält, wird jeder Datensatz an die Aktion „Schleife“ übergeben, um einzeln verarbeitet zu werden.Aktion „Schleife“ für „Mehrere Datensätze abrufen“