Um mit Daten in Salesforce® als Teil einer Kette zu interagieren, fügen Sie einen Schritt mit einem Salesforce-Verbindungsbefehl hinzu. Hier einige Beispiele:
- Laden, Extrahieren und Löschen von Daten über SOQL und Massenoperationen
- Salesforce-Objekte erstellen und verwalten
- Aktualisieren und Erstellen von Datensätzen
Um diese Befehle zu aktivieren, erstellt ein IT-Administrator zunächst einen Salesforce-Connector. Der Connector interagiert mit allen Versionen von Salesforce Sales Cloud - Salesforce Essentials®, Lightning® Professional, Lightning Enterprise und Lightning Unlimited - über die REST API.
Massenhaftes Löschen
Um eine große Anzahl von Datensätzen auf der Grundlage einer CSV-Datei (Comma-Separated Values) zu löschen, verwenden Sie den Befehl Bulk delete .
Hinweis: Wenn das Löschen eines Datensatzes fehlschlägt, gibt der Befehl eine CSV-Datei zurück, in der die Zeilennummern der fehlgeschlagenen Datensätze zusammen mit dem Grund für den Fehler aufgeführt sind. Sie können Verzweigungen verwenden, um Aktionen auszuführen, wenn der Befehl fehlschlägt, oder die Fehlermeldungen zur späteren Analyse in Google® Drive laden.
Eigenschaften
| Eigentum |
Einzelheiten |
| Gleichzeitigkeitsmodus |
Wählen Sie, ob die Datensätze gleichzeitig oder nacheinander verarbeitet werden sollen.
- Um Datensätze gleichzeitig zu verarbeiten, wählen Sie Parallel.
- Um Datensätze sequentiell zu verarbeiten, wählen Sie Seriell.
Hinweis: Wählen Sie bei einem sehr großen Auftrag die Option Seriell, da die Menge der Datenbankverbindungen den Auftrag im parallelen Modus zum Scheitern bringen könnte. Der serielle Modus kann jedoch zu wesentlich längeren Bearbeitungszeiten führen. |
| SObjektname |
Geben Sie den Typ des SObjekts an, für das die Operation durchgeführt werden soll. |
| Eingabedatei |
Geben Sie die Datei an, die die zu löschenden Datensätze enthält. |
| Dateiformat |
Wählen Sie, ob Eingabedatei CSV, JSON oder XML ist. |
| Größe der Charge |
Geben Sie die Anzahl der zu verarbeitenden Datensätze pro Stapel ein. Wir empfehlen Ihnen, die Standardeinstellung beizubehalten. |
| Warten auf Fertigstellung |
Aktivieren Sie dieses Kontrollkästchen, um Salesforce abzufragen und erst dann zum nächsten Befehl überzugehen, wenn alle Datensätze verarbeitet wurden. Um den Befehl auszulösen und sofort zum nächsten Schritt überzugehen, deaktivieren Sie dieses Kontrollkästchen. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Fehlerprotokoll massenhaft löschen |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Bulk-Einsatz
Um eine große Anzahl von Datensätzen auf der Grundlage einer CSV-Datei einzufügen, verwenden Sie den Befehl Bulk insert .
Hinweis: Wenn das Einfügen eines Datensatzes fehlschlägt, gibt der Befehl eine CSV-Datei mit den Zeilennummern der fehlgeschlagenen Datensätze und dem Grund für den Fehler zurück. Sie können Verzweigungen verwenden, um Aktionen auszuführen, wenn der Befehl fehlschlägt, oder die Fehlermeldungen zur späteren Analyse in Google® Drive laden.
Eigenschaften
| Eigentum |
Einzelheiten |
| Gleichzeitigkeitsmodus |
Wählen Sie, ob die Datensätze gleichzeitig oder nacheinander verarbeitet werden sollen.
- Um Datensätze gleichzeitig zu verarbeiten, wählen Sie Parallel.
- Um Datensätze sequentiell zu verarbeiten, wählen Sie Seriell.
Hinweis: Wählen Sie bei einem sehr großen Auftrag die Option Seriell, da die Menge der Datenbankverbindungen den Auftrag im parallelen Modus zum Scheitern bringen könnte. Der serielle Modus kann jedoch zu wesentlich längeren Bearbeitungszeiten führen. |
| SObjektname |
Geben Sie den Typ des SObjekts an, für das die Operation durchgeführt werden soll. |
| Eingabedatei |
Geben Sie die Datei an, die die einzufügenden Datensätze enthält. |
| Dateiformat |
Wählen Sie, ob Eingabedatei CSV, JSON oder XML ist. |
| Größe der Charge |
Geben Sie die Anzahl der zu verarbeitenden Datensätze pro Stapel ein. Wir empfehlen Ihnen, die Standardeinstellung beizubehalten. |
| Warten auf Fertigstellung |
Aktivieren Sie dieses Kontrollkästchen, um Salesforce abzufragen und erst dann zum nächsten Befehl überzugehen, wenn alle Datensätze verarbeitet wurden. Um den Befehl auszulösen und sofort zum nächsten Schritt überzugehen, deaktivieren Sie dieses Kontrollkästchen. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Masseneinfüge-Fehlerprotokoll |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Bulk-Abfrage
Um eine große Anzahl von Datensätzen abzufragen, verwenden Sie den Befehl Bulk query .
Eigenschaften
| Eigentum |
Einzelheiten |
| Gleichzeitigkeitsmodus |
Wählen Sie, ob die Datensätze gleichzeitig oder nacheinander verarbeitet werden sollen.
- Um Datensätze gleichzeitig zu verarbeiten, wählen Sie Parallel.
- Um Datensätze sequentiell zu verarbeiten, wählen Sie Seriell.
Hinweis: Wählen Sie bei einem sehr großen Auftrag die Option Seriell, da die Menge der Datenbankverbindungen den Auftrag im parallelen Modus zum Scheitern bringen könnte. Der serielle Modus kann jedoch zu wesentlich längeren Bearbeitungszeiten führen. |
| SObjektname |
Geben Sie den Typ des SObjekts an, für das die Operation durchgeführt werden soll. |
| SOQL-Abfrage |
Geben Sie die SOQL-Abfrage ein, die ausgeführt werden soll. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Bulk-Abfrageergebnisse CSV |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Massenweise Aktualisierung
Um eine große Anzahl von Datensätzen zu aktualisieren, verwenden Sie den Befehl Bulk update .
Hinweis: Wenn die Aktualisierung eines Datensatzes fehlschlägt, gibt der Befehl eine CSV-Datei mit den Zeilennummern der fehlgeschlagenen Datensätze und dem Grund für den Fehler zurück. Sie können Verzweigungen verwenden, um Aktionen auszuführen, wenn der Befehl fehlschlägt, oder die Fehlermeldungen zur späteren Analyse in Google® Drive laden.
Eigenschaften
| Eigentum |
Einzelheiten |
| Gleichzeitigkeitsmodus |
Wählen Sie, ob die Datensätze gleichzeitig oder nacheinander verarbeitet werden sollen.
- Um Datensätze gleichzeitig zu verarbeiten, wählen Sie Parallel.
- Um Datensätze sequentiell zu verarbeiten, wählen Sie Seriell.
Hinweis: Wählen Sie bei einem sehr großen Auftrag die Option Seriell, da die Menge der Datenbankverbindungen den Auftrag im parallelen Modus zum Scheitern bringen könnte. Der serielle Modus kann jedoch zu wesentlich längeren Bearbeitungszeiten führen. |
| SObjektname |
Geben Sie den Typ des SObjekts an, für das die Operation durchgeführt werden soll. |
| Eingabedatei |
Geben Sie die Datei an, die die zu aktualisierenden Datensätze enthält. |
| Dateiformat |
Wählen Sie, ob Eingabedatei CSV, JSON oder XML ist. |
| Größe der Charge |
Geben Sie die Anzahl der zu verarbeitenden Datensätze pro Stapel ein. Wir empfehlen Ihnen, die Standardeinstellung beizubehalten. |
| Warten auf Fertigstellung |
Aktivieren Sie dieses Kontrollkästchen, um Salesforce abzufragen und erst dann zum nächsten Befehl überzugehen, wenn alle Datensätze verarbeitet wurden. Um den Befehl auszulösen und sofort zum nächsten Schritt überzugehen, deaktivieren Sie dieses Kontrollkästchen. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Fehlerprotokoll der Massenaktualisierung |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Massenhafte Einfügung
Um ein Upsert durchzuführen, d. h. entweder vorhandene Datensätze zu aktualisieren oder neue Datensätze auf der Grundlage einer externen ID zu erstellen, verwenden Sie den Befehl Bulk upsert .
Hinweis: Wenn das Hochladen eines Datensatzes fehlschlägt, gibt der Befehl eine CSV-Datei mit den Zeilennummern der fehlgeschlagenen Datensätze und dem Grund für den Fehler zurück. Sie können Verzweigungen verwenden, um Aktionen auszuführen, wenn der Befehl fehlschlägt, oder die Fehlermeldungen zur späteren Analyse in Google® Drive laden.
Eigenschaften
| Eigentum |
Einzelheiten |
| Gleichzeitigkeitsmodus |
Wählen Sie, ob die Datensätze gleichzeitig oder nacheinander verarbeitet werden sollen.
- Um Datensätze gleichzeitig zu verarbeiten, wählen Sie Parallel.
- Um Datensätze sequentiell zu verarbeiten, wählen Sie Seriell.
Hinweis: Wählen Sie bei einem sehr großen Auftrag die Option Seriell, da die Menge der Datenbankverbindungen den Auftrag im parallelen Modus zum Scheitern bringen könnte. Der serielle Modus kann jedoch zu wesentlich längeren Bearbeitungszeiten führen. |
| SObjektname |
Geben Sie den Typ des SObjekts an, für das die Operation durchgeführt werden soll. |
| Eingabedatei |
Geben Sie die Datei ein, die die hochzusetzenden Datensätze enthält. |
| Dateiformat |
Wählen Sie, ob Eingabedatei CSV, JSON oder XML ist. |
| Größe der Charge |
Geben Sie die Anzahl der zu verarbeitenden Datensätze pro Stapel ein. Wir empfehlen Ihnen, die Standardeinstellung beizubehalten. |
| Warten auf Fertigstellung |
Aktivieren Sie dieses Kontrollkästchen, um Salesforce abzufragen und erst dann zum nächsten Befehl überzugehen, wenn alle Datensätze verarbeitet wurden. Um den Befehl auszulösen und sofort zum nächsten Schritt überzugehen, deaktivieren Sie dieses Kontrollkästchen. |
| Externe ID |
Um festzustellen, ob ein Datensatz bereits vorhanden ist oder neu angelegt werden muß, geben Sie das Feld Externe ID ein, das für das am Upsert beteiligte Objekt erforderlich ist. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Bulk-Upsert-Fehlerprotokoll |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Datensatz erstellen
Um einen neuen Datensatz in Salesforce zu erstellen, verwenden Sie den Befehl Datensatz erstellen .
Eigenschaften
| Eigentum |
Einzelheiten |
| Name |
Geben Sie den Namen des SObjekts ein, unter dem der Datensatz erstellt werden soll. |
| Felder |
Geben Sie die zu aktualisierenden Datensatzfelder im Format FIELD_NAME:VALUEein. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Neue Datensatz-ID |
Zeichenfolge |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Datensatz löschen
Um einen Datensatz in Salesforce auf der Grundlage seiner ID zu löschen, verwenden Sie den Befehl Datensatz löschen .
Eigenschaften
| Eigentum |
Einzelheiten |
| ID |
Geben Sie die ID des zu löschenden Datensatzes ein. Wenn die ID unbekannt ist, geben Sie eine externe ID im Format EXTERNAL_ID_NAME:VALUEein, z. B. Name:John. |
| Name |
Geben Sie den Namen des SObjekts ein, unter dem der Datensatz gelöscht werden soll. |
Ausgaben
Keine
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Bericht herunterladen
Um einen benutzerdefinierten Bericht als CSV-Datei (Comma-Separated Values) herunterzuladen, verwenden Sie den Befehl Download report .
Eigenschaften
| Eigentum |
Einzelheiten |
| Bericht-ID |
Geben Sie die ID des herunterzuladenden benutzerdefinierten Berichts ein. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Benutzerdefinierter Bericht CSV |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Objekt-Metadaten abrufen
Um die mit einem Salesforce-Objekt verbundenen Felder und Metadaten abzurufen, verwenden Sie den Befehl Get object metadata .
Eigenschaften
| Eigentum |
Einzelheiten |
| Objekt |
Geben Sie den Namen des Objekts ein, für das Metadaten abgerufen werden sollen. |
Ausgänge
| Ausgabe |
Art der Ausgabe |
| Objekt-Metadaten |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Datensatz holen
Um einen Datensatz aus Salesforce anhand seiner ID abzurufen, verwenden Sie den Befehl Get record .
Eigenschaften
| Eigentum |
Einzelheiten |
| ID |
Geben Sie die ID des abzurufenden Datensatzes ein. |
| Name |
Geben Sie den Namen des SObjekts ein, unter dem der Datensatz abgerufen werden soll. |
| Felder |
Geben Sie die einzubeziehenden Felder des Berichts ein (optional). |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Datensatz abrufen JSON |
JSON |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Anmeldungen auflisten
Um Anmeldungen in der Salesforce-Umgebung aufzulisten, verwenden Sie den Befehl Anmeldungen auflisten .
Eigenschaften
Keine
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Logins auflisten CSV |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Objekte auflisten
Um SObjects aus Salesforce aufzulisten, verwenden Sie den Befehl List objects .
Eigenschaften
Keine
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Objekte auflisten CSV |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Berichte auflisten
Um Berichte aus Salesforce aufzulisten, verwenden Sie den Befehl Berichte auflisten .
Eigenschaften
Keine
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Berichte auflisten CSV |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
SOQL-Abfrage
Um eine SOQL-Abfrage auszuführen und ihre Ergebnisse als CSV-Datei zu erzeugen, verwenden Sie den Befehl SOQL-Abfrage .
Hinweis: Die SOQL-Syntax ist der von SQL sehr ähnlich. Der Befehl SOQL Query kann große Datenmengen extrahieren und Datensätze mit 1 Million oder mehr Datensätzen auf einmal zurückgeben. Wenn der Befehl fehlschlägt, weil die Abfrage falsch ist oder auf Objekte verweist, die nicht existieren, werden Sie durch die Ausgaben des Befehls darauf hingewiesen.
Eigenschaften
| Eigentum |
Einzelheiten |
| Abfrage |
Geben Sie die SOQL-Abfrage ein, die ausgeführt werden soll. |
| Befehl abfragen |
Legen Sie fest, ob gelöschte Datensätze berücksichtigt werden sollen.
- Um gelöschte Datensätze auszuschließen, wählen Sie Abfrage.
- Um gelöschte Datensätze einzuschließen, wählen Sie QueryAll.
|
Ausgaben
| Ausgabe |
Art der Ausgabe |
| SOQL-Abfrage-Ausgabe |
Datei |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
SObject - erstellen
Um ein neues SObjekt in Salesforce zu erstellen, verwenden Sie einen SOjbect- create Befehl.
Eigenschaften
| Eigentum |
Einzelheiten |
| Name |
Geben Sie den Namen des neuen SObjects ein. Um anzuzeigen, dass es sich um ein benutzerdefiniertes Objekt handelt, fügt Salesforce automatisch __chinzu. |
| Felder |
Geben Sie die zu erstellenden Datensatzfelder im Format FIELD_NAME:TYPEein, wobei TYPE einem Salesforce-Feldtyp entspricht. |
Ausgaben
Keine
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
SObject - löschen
Um SObjects in Salesforce zu löschen, verwenden Sie den Befehl SObject - delete .
Eigenschaften
| Eigentum |
Einzelheiten |
| Name |
Geben Sie den Namen des zu erstellenden SObjects ein. |
Ausgaben
Keine
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
Datensatz aktualisieren
Um die Feldwerte eines Datensatzes in Salesforce zu aktualisieren, verwenden Sie einen Datensatz aktualisieren Befehl.
Eigenschaften
| Eigentum |
Einzelheiten |
| ID |
Geben Sie die ID des zu aktualisierenden Datensatzes ein. |
| Name |
Geben Sie den Namen des SObjekts ein, unter dem der Datensatz aktualisiert werden soll. |
| Felder |
Geben Sie die zu aktualisierenden Datensatzfelder im Format FIELD_NAME:VALUEein. |
Ausgaben
Keine
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 1 |
Fehler |
Allgemeines Versagen |
<!--## 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**.
-->