Beispiel für die Verwendung der Salesforce Paket- und Datensatzvariablen

Erstellen Sie einen Bot, der Salesforce-Objekte abfragt und Daten in eine CSV-Datei schreibt. Der Bot verwendet auch eine Datensatzvariable, um Daten aus einzelnen Datensätzen abzurufen, die aus Salesforce abgerufen wurden.

Vorbereitungen

  • Richten Sie eine verbundene App in Salesforce ein, falls Sie noch keine haben.
  • Dieser Bot verwendet die Control Room-OAuth-Verbindungsmethode. Erstellen Sie eine Control Room-OAuth-Verbindung bevor Sie mit dem Aufbau des Bots beginnen. Weitere Informationen finden Sie unter Aktion „Authentifizierung“ in Salesforce.
  • Richten Sie Beispieldaten für Möglichkeiten und Konten in Salesforce ein. Wenn Sie keine Beispieldaten haben, können Sie die Daten aus den folgenden CSV-Dateien in Salesforce importieren:
Angenommen, das Vertriebsteam von Acme Solutions Pvt Ltd. beschließt, den Prozess der Erfassung aller Möglichkeits-Datensätze mit dem Neukundengewinnungs-Status zu automatisieren und sie dann den Vertriebsmitarbeitern zur Weiterverfolgung zuzuweisen. Das Team erstellt einen Bot, der die folgenden Aufgaben erfüllt:
  • Holt alle Möglichkeiten mit dem Status Neukundengewinnung aus dem Möglichkeit-Objekt in Salesforce.
  • Holt den Kontonamen aus dem Konto-Objekt unter Verwendung der Konto-ID, die aus jedem Möglichkeits-Datensatz abgerufen wird.
  • Verwendet einen Datensatz zur Erfassung von Daten aus einzelnen Möglichkeits-Datensätzen.
  • Schreibt die Datensätze in eine CSV-Datei, die weiterverarbeitet werden kann, um Außendienstmitarbeiter zuzuweisen.
Der Beispiel-Bot verwendet Salesforce, Datensatz, Schleife und Datentabelle Pakete zusammen mit Datensatzvariablen, um zu zeigen, wie die folgenden Automatisierungsaufgaben durchgeführt werden:
  • Ein Salesforce-Objekt mit der Funktion Salesforce SOQL ausführen Aktionabfragen
  • Einen einzelnen Datensatz aus einem Salesforce-Objekt mit der Funktion Salesforce Datensatz holen Aktion holen
  • Datensatzvariablen aktualisieren und zurücksetzen
  • Datensätze in eine Datentabellenvariable einfügen
  • Eine Datentabelle in eine CSV-Datei schreiben

Prozedur

  1. Erstellen Sie einen Bot.
    1. Klicken Sie im linken Feld auf Automatisierung. Eine Liste der verfügbaren Bots und Formulare wird angezeigt.
    2. Klicken Sie auf Neu erstellen > TaskBot.
    3. In Name geben Sie Get Sales Opportunities ein.
    4. Klicken Sie auf Erstellen und Bearbeiten.
  2. Authentifizieren Sie sich mit Salesforce. Für dieses Tutorial wird die Control Room-OAuth-Verbindung als Authentifizierungstypverwendet. Die Anweisungen zum Einrichten der OAuth-Verbindung gehen über den Rahmen dieses Tutorials hinaus. Wenn Sie mit der Einrichtung von OAuth-Verbindungen nicht vertraut sind, folgen Sie den Anweisungen auf dieser Seite oder verwenden Sie OAuth 2 – Client-Anmeldedaten als Authentifizierungstypund geben Sie Client-ID, geheimen Clientschlüssel, Salesforce-Nutzername und -Passwort innerhalb der Aktion Salesforce-Authentifizierung an.
    1. Suchen Sie im Bereich Aktionen nach der Aktion Salesforce > Authentifizierung und fügen Sie sie dem Bot Editor hinzu.
    2. Wählen Sie unter Authentifizierungstyp die Option Control Room-OAuth-Verbindung.
    3. Klicken Sie auf Auswählen und wählen Sie die OAuth-Verbindung aus, die Sie mit den folgenden Details eingerichtet haben:
      • Anbieter-Typ: Salesforce
      • Verbindungsname: die Verbindung, die Sie eingerichtet haben.
      • Token-Typ: Freigegeben.
    4. Geben Sie unter API-Versiondie Versionsnummer der API für die mit Salesforce verbundene Anwendung ein. Zum Beispiel 50.0.
    5. Lassen Sie den Sitzungsnamen auf Default.
    6. Klicken Sie unter Zugeordnete Variablen auf Variablen-Zuordnung hinzufügen, und ordnen Sie den Schlüssel IntanceUrl einer Zeichenfolgenvariablen namens InstanceUrl zu.
  3. Um zu prüfen, ob Authentifizierungsfehler vorliegen, bevor andere Aufgaben ausgeführt werden, verwenden Sie die Aktionen Versuchen-Erfassen.
    1. Suchen Sie im Bereich Aktionen den Fehlerhandler > Versuchen Aktion und fügen Sie ihn zum Bot Editor hinzu.
    2. Klicken Sie auf das Blocksymbol Erfassen.
    3. Wählen Sie unter Ausnahme die Option Fehlerhandler.
    4. Klicken Sie unter Ausnahmenachricht zuweisen zuauf (x) und erstellen Sie eine Zeichenfolgenvariable namens ErrorMessage.
    5. Fügen Sie die Aktion Nachrichtenfeld in den Erfassen-Block ein.
    6. Wählen Sie unter Anzuzeigende Nachricht angeben die Variable Fehlermeldung und speichern Sie die Änderungen.
  4. Fragen Sie das Salesforce Möglichkeit-Objekt zum Abrufen von Möglichkeiten-Datensätzen mit dem Status Neukundengewinnung ab.
    1. Suchen Sie im Bereich Aktionen nach der Aktion Salesforce > SOQL ausführen innerhalb des Blocks Versuchen und fügen Sie sie hinzu.
    2. In Auszuführende SOQL-Abfrage geben Sie die folgende Abfrage ein. 
      SELECT Id, Name, AccountId, Amount, CloseDate, StageName, NextStep FROM Opportunity WHERE StageName = 'Prospecting'
    3. Klicken Sie unter Gelöschte Datensätze einbeziehen auf Nein.
    4. Stellen Sie sicher, dass Default als Sitzungsname eingestellt ist.
    5. Klicken Sie unter Ergebnis in einer Variable speichern auf (x) und erstellen Sie eine Listenvariable mit dem Namen list_records_prospecting.
    6. Speichern Sie die Änderungen.
  5. Führen Sie eine Schleife durch die Liste der abgerufenen Möglichkeiten-Datensätze durch.
    1. Suchen Sie im Bereich Aktionen nach der Aktion Schleife > Schleife nach der Aktion SOQL ausführen innerhalb des Versuchen-Blocks und fügen Sie sie hinzu.
    2. Wählen Sie im Iterator die Option Jedes Element in der Liste.
    3. Wählen Sie in Liste die Variable list_records_prospecting.
    4. Klicken Sie unter Aktuellen Wert einer Variablen zuweisen auf (x) , um eine Variable mit dem Namen dict_record_opportunity mit dem Typ Beliebig zu erstellen.
      Es folgt ein Beispiel für einen Datensatz, der als Wörterbuch gespeichert ist. Der Bot ruft nur Werte aus den Feldern Name, Kontoname, Menge, Abschlussdatum, StageName und NextStep ab und lässt den Rest weg.
      {attributes,com.automationanywhere.botcommand.data.impl.DictionaryValue@5d804b9c},{Id,0065j00001Q2ISAAA3},{Name,Opportunity #1},{AccountId,0015j00001BU2hnAAD},{Amount,2000.0},{CloseDate,2023-10-05},{StageName,Prospecting},{NextStep,Call to Discuss}
    5. Speichern Sie die Änderungen.
  6. Bevor Sie Werte aus jedem Feld in einem Datensatz abrufen, erstellen Sie zwei Datensatzvariablen – eine zum Speichern der Werte aus jedem Möglichkeit-Datensatz und eine weitere zum Zurücksetzen der ersten Datensatzvariable am Ende jeder Iteration.
    1. Klicken Sie im Bereich Variablen auf Variable erstellen....
    2. Wählen Sie unter Typ die Option Datensatz.
    3. In Name geben Sie out_record_prospecting ein.
    4. Klicken Sie auf Erstellen.
    5. Wiederholen Sie die Schritte a bis d, um eine weitere Datensatzvariable mit den folgenden Details zu erstellen:
      Typ: Record
      Name: record_empty
  7. Aktualisieren Sie die Datensatzvariable mit dem Namen der Möglichkeit aus dem aktuellen Datensatz.
    1. Suchen Sie im Bereich Aktionen nach der Aktion Datensatz > Spalte hinzufügen innerhalb der Schleife-Aktion und fügen Sie sie hinzu.
    2. Wählen Sie unter Quelldatensatzvariable die Option out_record_prospecting.
    3. Wählen Sie in Spaltentyp die Option Zeichenfolge und geben Sie in Wert $dict_record_opportunity{Name}$ ein.
    4. Klicken Sie auf Spezifischer Index, geben Sie 0 ein.
    5. Wählen Sie unter Ziel-Datensatzvariable die Option out_record_prospecting.
    6. Speichern Sie die Änderungen.
  8. Die aus Salesforce abgerufenen Möglichkeiten-Datensätze enthalten nur die Konto-IDs und keine Kontonamen. Rufen Sie den Kontonamen unter Verwendung der Konto-ID für jeden Datensatz ab.
    1. Suchen Sie im Bedienfeld Aktionen nach der Aktion Salesforce > Datensatz abrufen innerhalb der Schleife-Aktion und fügen Sie sie hinzu.
    2. Geben Sie in Objekt-Name Account ein.
    3. Wählen Sie Datensatz-ID und geben Sie $dict_record_opportunity{AccountId}$ ein.
    4. Wählen Sie unter Felder und Datendie Option Liste und klicken Sie auf Hinzufügen.
    5. Wählen Sie unter Typ die Option Zeichenfolge.
    6. Geben Sie in Wert bei 0 Name ein.
    7. Stellen Sie sicher, dass Default als Salesforce-Sitzungsname festgelegt ist.
    8. Klicken Sie unter Zugeordnete Variablen auf Variablen-Zuordnung hinzufügen, um den Schlüssel Name einer Zeichenfolgenvariablen AccountName zuzuordnen. Der Aufruf Get record ruft den Kontonamen mit dem Schlüssel Name ab und speichert ihn in der Variablen AccountName.
    9. Speichern Sie die Änderungen.
  9. Fügen Sie eine neue Spalte hinzu und aktualisieren Sie die Datensatzvariable mit dem Kontonamen.
    1. Suchen Sie im Bereich Aktionen nach der Aktion Datensatz > Spalte hinzufügen innerhalb der Schleife-Aktion und fügen Sie sie hinzu.
    2. Wählen Sie unter Quelldatensatzvariable die Option out_record_prospecting.
    3. Wählen Sie in Spaltentyp die Option Zeichenfolge und geben Sie in Wert $AccountName$ ein.
    4. Klicken Sie auf Spezifischer Index, geben Sie 1 ein.
    5. Wählen Sie unter Ziel-Datensatzvariable die Option out_record_prospecting.
    6. Speichern Sie die Änderungen.
  10. Fügen Sie eine neue Spalte hinzu und aktualisieren Sie die Datensatzvariable mit der Menge.
    1. Suchen Sie im Bereich Aktionen nach der Aktion Datensatz > Spalte hinzufügen innerhalb der Schleife-Aktion und fügen Sie sie hinzu.
    2. Wählen Sie unter Quelldatensatzvariable die Option out_record_prospecting.
    3. Wählen Sie unter Spaltentypdie Option Ziffer, und geben Sie unter Wert $dict_record_opportunity{Amount}$ ein.
    4. Klicken Sie auf Spezifischer Index, geben Sie 2 ein.
    5. Wählen Sie unter Ziel-Datensatzvariable die Option out_record_prospecting.
    6. Speichern Sie die Änderungen.
  11. Aktualisieren Sie die Datensatzvariable mit CloseDate, StageName und NextStep.
    1. Fügen Sie die Aktion Spalte hinzufügen zur Schleife-Aktion hinzu und geben Sie die folgenden Details ein:
      Feld Wert
      Quelldatensatzvariable out_record_prospecting
      Spaltentyp String
      Wert $dict_record_opportunity{CloseDate}$
      Spezifischer Index 3
    2. Fügen Sie die Aktion Spalte hinzufügen zur Schleife-Aktion hinzu und geben Sie die folgenden Details ein:
      Feld Wert
      Quelldatensatzvariable out_record_prospecting
      Spaltentyp String
      Wert $dict_record_opportunity{StageName}$
      Spezifischer Index 4
    3. Fügen Sie die Aktion Spalte hinzufügen zur Schleife-Aktion hinzu und geben Sie die folgenden Details ein:
      Feld Wert
      Quelldatensatzvariable out_record_prospecting
      Spaltentyp String
      Wert $dict_record_opportunity{NextStep}$
      Spezifischer Index 5
    4. Speichern Sie die Änderungen.
  12. Fügen Sie den Datensatz in eine Datentabelle-Variable ein.
    1. Um die Iterationen zu verfolgen und sie als Zeilenindexnummer zu verwenden, erstellen Sie eine Ziffernvariable mit dem Namen counter und setzen den Standardwert auf 0.
    2. Suchen Sie im Bereich Aktionen nach der Aktion Datentabelle > Zeile einfügen innerhalb der Schleife-Aktion und fügen Sie sie hinzu.
    3. Klicken Sie in Datentabellenname auf (x) und erstellen Sie eine Tabellenvariable namens table_records.
    4. Klicken Sie auf spezifischer Index und geben Sie $counter$ ein.
    5. Wählen Sie in Zeilendatensatznamedie Option out_record_prospecting.
    6. Speichern Sie die Änderungen.
  13. Erhöhen Sie die Variable counter um 1.
    1. Suchen Sie im Bereich Aktionen nach der Aktion Nummer > Erhöhen innerhalb der Schleife-Aktion und fügen Sie sie hinzu.
    2. Geben Sie in Zahl eingeben $counter$ ein.
    3. Geben Sie in Inkrementwert eingeben 1 ein.
    4. Wählen Sie in Die Ausgabe einer Variable zuweisen die Option Zähler.
    5. Speichern Sie die Änderungen.
  14. Setzen Sie die Datensatzvariable out_record_prospecting vor der nächsten Iteration zurück.
    1. Suchen Sie im Bereich Aktionen nach der Aktion Datensatz > Zuweisen innerhalb der Schleife-Aktion und fügen Sie sie hinzu.
    2. Wählen Sie unter Die Quelldatensatzvariable auswählen record_empty aus.
    3. Klicken Sie unter Die Quelldatensatzvariable auswählen auf Datensatz und wählen Sie out_record_prospecting aus. Da die Variable record_empty keinen Wert hat, wird out_record_prospecting zurückgesetzt.
    4. Speichern Sie die Änderungen.
  15. Schreiben Sie die abgerufenen Möglichkeit-Datensätze in eine CSV-Datei.
    1. Suchen Sie im Bereich Aktionen nach der Aktion Datentabelle > In Datei schreiben außerhalb der Schleife-Aktion.
    2. Wählen Sie unter Datentabellennamedie Option Tabelle_Datensätze.
    3. Geben Sie unter Dateiname eingebenden Pfad der CSV-Datei an. Zum Beispiel: C:\bots\opportunities.csv.
    4. Wählen Sie Ordner/Dateien erstellen, falls sie noch nicht vorhanden sind aus.
    5. Klicken Sie auf Vorhandene Datei überschreiben.
    6. Speichern Sie die Änderungen und führen Sie den Bot aus.