Um mit Daten in Salesforce® als Teil einer Kette zu interagieren, fügen Sie einen Schritt mit einem Salesforce-Verbindungsbefehl hinzu. Zum Beispiel:
- Laden, Extrahieren und Löschen von Daten über SOQL und Massenoperationen
- Salesforce-Objekte erstellen und verwalten
- Datensätze aktualisieren und erstellen
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
| Eigenschaft |
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 |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
Massenhafte Einfügung
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
| Eigenschaft |
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 |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
Bulk-Abfrage
Um eine große Anzahl von Datensätzen abzufragen, verwenden Sie den Befehl Bulk query.
Eigenschaften
| Eigenschaft |
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 |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 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
| Eigenschaft |
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 |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 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
| Eigenschaft |
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 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. |
| 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 |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
Datensatz erstellen
Um einen neuen Datensatz in Salesforce zu erstellen, verwenden Sie den Befehl Datensatz erstellen.
Eigenschaften
| Eigenschaft |
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:VALUE ein. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Neue Datensatz-ID |
Zeichenfolge |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 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
| Eigenschaft |
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:VALUE ein, z. B. Name:John. |
| Name |
Geben Sie den Namen des SObjekts ein, unter dem der Datensatz gelöscht werden soll. |
Ausgaben
Keine
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
Bericht herunterladen
Um einen benutzerdefinierten Bericht als CSV-Datei (Comma-Separated Values) herunterzuladen, verwenden Sie den Befehl Bericht herunterladen.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Berichts-ID |
Geben Sie die ID des herunterzuladenden benutzerdefinierten Berichts ein. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Benutzerdefinierter Bericht CSV |
Datei |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 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
| Eigenschaft |
Einzelheiten |
| Objekt |
Geben Sie den Namen des Objekts ein, für das Metadaten abgerufen werden sollen. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Objekt-Metadaten |
Datei |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
Datensatz abrufen
Um einen Datensatz aus Salesforce anhand seiner ID abzurufen, verwenden Sie den Befehl Get record.
Eigenschaften
| Eigenschaft |
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 JSON abrufen |
JSON |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 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 |
| Anmeldungen als CSV-Datei auflisten |
Datei |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 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 |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 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 |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 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
| Eigenschaft |
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 |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
SObject - erstellen
Um ein neues SObjekt in Salesforce zu erstellen, verwenden Sie einen SOjbect- create-Befehl.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Name |
Geben Sie den Namen des neuen SObjects ein. Um anzuzeigen, dass es sich um ein benutzerdefiniertes Objekt handelt, fügt Salesforce automatisch __c hinzu. |
| Felder |
Geben Sie die zu erstellenden Datensatzfelder im Format FIELD_NAME:TYPE ein, wobei TYPE einem Salesforce-Feldtyp entspricht. |
Ausgaben
Keine
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
SObject - löschen
Um SObjects in Salesforce zu löschen, verwenden Sie den Befehl SObject - delete.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Name |
Geben Sie den Namen des zu erstellenden SObjects ein. |
Ausgaben
Keine
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
Datensatz aktualisieren
Um die Feldwerte eines Datensatzes in Salesforce zu aktualisieren, verwenden Sie einen Datensatz aktualisieren Befehl.
Eigenschaften
| Eigenschaft |
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:VALUE ein. |
Ausgaben
Keine
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 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**.
-->