Salesforce-Bulkprozess-Assistent für Abfrage-, Einfüge-, Aktualisierungs-, Lösch- oder Hard-Löschaktionen im Jitterbit Design Studio

Einführung

Diese Seite beschreibt, wie man eine Salesforce-Bulkprozess-Abfrage-, Einfüge-, Aktualisierungs-, Lösch- oder Hard-Löschaktion mit dem Salesforce-Bulkprozess-Assistenten im Jitterbit Design Studio erstellt.

• Eine Salesforce-Bulkabfrageaktion fragt eine große Anzahl von Datensätzen von einem Salesforce-Endpunkt ab.
• Eine Salesforce-Bulkeinfügeaktion fügt neue Daten in einen Salesforce-Endpunkt ein.
• Eine Salesforce-Bulkaktualisierungsaktion aktualisiert vorhandene Daten in einem Salesforce-Endpunkt.
• Eine Salesforce-Bulkdelete- oder Bulk-Hard-Delete-Aktion löscht eine große Anzahl von vorhandenen Datensätzen in einem Salesforce-Endpunkt.

Abfrage-, Einfüge-, Aktualisierungs-, Lösch- oder Hard-Lösch-Bulkprozessaktionen unterscheiden sich leicht von dem Prozess für die Bulkprozess-Upsert-Aktion. Im Gegensatz zur Bulkprozess-Upsert-Aktion erfordern Abfrage-, Einfüge-, Aktualisierungs-, Lösch- und Hard-Lösch-Bulkprozessaktionen kein externes ID-Feld und schließen diesen Schritt nicht ein.

Bevor Sie die folgenden Schritte durchgehen, siehe Salesforce-Bulkprozess-Assistent für Anweisungen zum Starten des Salesforce-Bulkprozess-Assistenten.

Wählen Sie das Salesforce-Objekt

Wählen Sie auf dem Objektbildschirm das Salesforce-Objekt aus, das die Operation verwenden wird.

Klicken Sie auf Weiter, um zu Definieren Sie die Quelle zu gelangen.

Definieren Sie die Quelle

Wählen Sie aus, wo Ihre Quelldaten herkommen

Die Quelle ist der Ort der Daten, die von der Operation verwendet werden sollen. Für den Salesforce Bulk Process Wizard muss die Quelle eine flache Datei mit einem Header sein. Datenbanken werden nicht unterstützt. Wählen Sie für die Dateiquelle Lokale Datei, FTP-Standort, Dateifreigabe oder Temporärer Speicher.

Da Ihre Quelle eine flache Datei für den Salesforce Bulk Process Wizard sein muss, können Sie optional Zeilen- und Feldvalidierung hinzufügen. Wenn Sie möchten, können Sie stattdessen später in der Entwicklung des Projekts eine Quelle hinzufügen. Weitere Informationen zu den verschiedenen Quellen finden Sie in der Dokumentation zu Quellen.

Wählen Sie eine der folgenden Optionen:

• Eine vorhandene Quelle Typ aus dem Dropdown-Menü (eine der Optionen Lokale Datei, FTP-Standort, Dateifreigabe, Temporärer Speicher oder HTTP).
• Wählen Sie Neu erstellen, um eine neue Quelle des derzeit ausgewählten Typs zu erstellen.

Erstellen einer neuen Quelle

Um eine neue Quelle zu erstellen, wählen Sie die Option Neue Quelle aus dem Dropdown-Menü:

Dateiquellen

Für Dateiquellen (Lokale Datei, FTP-Standort, Dateifreigabe oder Temporärer Speicher) wählen Sie eine Quelle aus oder erstellen Sie eine und wählen Sie dann ein Dateiformat aus oder erstellen Sie eines, das mit dieser Quelle verwendet werden soll.

Lokale Datei

Wenn Sie eine Lokale Datei als Quelle auswählen, klicken Sie auf Durchsuchen, um eine Datei auszuwählen. Alternativ, wenn Sie eine lokale Datei verwenden möchten, die zuvor mit Jitterbit Design Studio verwendet wurde, klicken Sie auf Eine vorhandene lokale Dateiquelle auswählen und verwenden Sie das Dropdown-Menü, um eine zuvor verwendete Datei auszuwählen.

Bestätigen Sie die ausgewählte Datei, nachdem Sie die ersten zehn Zeilen der Datei überprüft haben:

Klicken Sie auf Weiter, um zum Bildschirm Mappings zu gelangen.

FTP-Standort, Dateifreigabe oder Temporärer Speicher

Wenn Sie einen vorhandenen FTP-Standort als Quelle verwenden möchten, verwenden Sie das Dropdown-Menü Typ, um Ihren FTP-Standort auszuwählen. Andernfalls wählen Sie Neu erstellen im Dropdown-Menü und füllen Sie die Verbindungsparameter aus.

Beispieldatei auswählen

Durchsuchen Sie Ihren Computer und wählen Sie eine Beispieldatei aus, die dasselbe Format wie die Datei enthält, die Sie an Salesforce senden möchten. Das Design Studio verwendet diese Informationen auf dem Bildschirm Mappings.

Klicken Sie auf Weiter, um zum Bildschirm Mappings zu gelangen.

Transformation Mapping

Ordnen Sie die Header aus der Quelldatei den entsprechenden Salesforce-Feldern zu. Abgesehen von den Headern sind im Bulk-Prozess keine weiteren Zuordnungen erforderlich.

Sie können zuordnen:

• Indem Sie einen Source File Header auf ein Salesforce Field ziehen und ablegen.

• Indem Sie Source- und Salesforce-Felder zusammen auswählen und dann auf die Schaltfläche Map klicken.

• Die Schaltfläche Auto Map ordnet basierend auf übereinstimmenden Namen zwischen den Source File Headers und den Salesforce Fields zu.

• Die Schaltfläche Import Mappings from File importiert ein zuvor gespeichertes Set von Zuordnungen aus einer Datei.

• Die Schaltfläche Save Mappings to File speichert alle Zuordnungen in einer lokalen Datei.

• Die Schaltfläche Map ordnet die ausgewählten Quell- und Ziel-Felder zu.

• Die Schaltfläche Remove entfernt eine ausgewählte Zuordnung.

• Die Schaltfläche Start Over löscht alle Zuordnungen und beginnt von vorne.

• Wenn Sie fertig sind, klicken Sie auf Weiter, um zu Create a schedule and set options zu gelangen.

Erstellen Sie einen Zeitplan und wählen Sie Optionen aus

Das Erstellen oder Festlegen eines Zeitplans ist optional und kann zu einem späteren Zeitpunkt erfolgen. Weitere Informationen zur Planung finden Sie unter Schedules. Sie können einen vorhandenen Zeitplan bearbeiten, indem Sie ihn im Bereich der Projektartikel unter der Kategorie Schedules öffnen und die gewünschten Anpassungen vornehmen. Sie können diesen Wizard-Bildschirm verwenden, um entweder einen Zeitplan für eine nicht geplante Operation hinzuzufügen oder die Operation im Bereich der Projektartikel zu öffnen und die entsprechenden Anpassungen vorzunehmen.

• Legen Sie die Häufigkeit, Tägliche Frequenz (Stunden oder Minuten) und Dauer der Operation fest.
• Beachten Sie beim Festlegen der Dauer, dass die Daten Beginn und Ende in einem Zeitplan einschließlich sind.
• Um diese Optionen anzuzeigen, öffnen Sie die Pfeile neben Häufigkeit, Tägliche Frequenz und Dauer.
• Wenn Sie fertig sind, klicken Sie auf Weiter, um zum Zusammenfassungsbildschirm zu gelangen.

Zusammenfassungsbildschirm

Im Zusammenfassungsbildschirm können Sie den Namen bearbeiten, der dem Assistenten zugewiesen wurde:

Klicken Sie auf Fertigstellen, um den Assistenten abzuschließen.

Abgeschlossener Salesforce-Bulk-Prozess

Nach Abschluss werden Sie zum Zusammenfassungsbildschirm für den neuen Salesforce-Bulk-Prozess weitergeleitet. Sie können zu dieser Zusammenfassungsseite zurückkehren, indem Sie den Namen der Operation unter Jitterbit Connect im Projekt-Element-Panel suchen.

• Sie können jedes der Designelemente in Ihrem Projekt wie Salesforce-Anmeldung, Mappings, Daten lesen von, Operation und Geplant ausführen ändern, indem Sie auf Bearbeiten daneben klicken.
• Die Funktionen der Schaltflächen Bulk ausführen..., Ergebnisverlauf und Löschen werden unten in Projekt bereitstellen und Operation ausführen beschrieben (Die tatsächlichen Bezeichnungen und verfügbaren Schaltflächen variieren je nach verwendetem Bulk-Prozess-Assistenten. Dieses Beispiel zeigt den Bulk Insert-Assistenten).
• Erweiterte Optionen umfassen Betriebsoptionen wie Chunking und Feldtruncation. Diese werden unten in Erweiterte Optionen behandelt.

Erweiterte Optionen

Die folgenden erweiterten Optionen stehen für einen Salesforce Bulk-Prozess zur Verfügung.

Für eine Abfrageaktion:

Für eine Einfüge- oder Aktualisierungsaktion:

Für eine Lösch- oder Hard-Löschaktion (die Datumsoptionen sind deaktiviert):

Dateioptionen

• Als UTF-8 lesen: Wählen Sie diese Option, um die Quelldatei als UTF-8-Zeichencodierung zu lesen.
• Als UTF-8 schreiben: Wählen Sie diese Option, um die Zieldatei als UTF-8-Zeichencodierung zu schreiben.
• Datumsoptionen: Zeigt einen Dialog an, um die Datumsoptionen für die Quelle festzulegen. Siehe die Salesforce advanced Seite.
• Bei Datenzeile beginnen: Gibt die Zeilennummer der ersten Zeile der Quelldatei an, die als Daten betrachtet werden soll.

Betriebsoptionen

• Batch-Einstellungen: Zeigt einen Dialog an, um die Bulk-Einstellungen festzulegen. Siehe die Salesforce advanced Seite.
• Serienmodus: Wenn ausgewählt, erlaubt das Einfügen von Nullwerten in einen Datensatz.
• Daten komprimieren: Standardmäßig ist die Kompression aktiviert.
• Chunking ist für Bulk-Prozessoperationen nicht verfügbar. Siehe stattdessen Batch-Einstellungen auf der Salesforce advanced Seite.

Zusätzliche Betriebsoptionen zum Schreiben von Erfolgs- und Fehlermeldungen sind auf der Salesforce advanced Seite beschrieben.

Projekt bereitstellen und Operation ausführen

Sobald Sie die Bulk-Prozessaktion konfiguriert haben, können Sie die Operation bereitstellen und ausführen. Sie können auch Erfolgs- und Fehlermeldungen anzeigen, wenn Sie private Agenten verwenden.

Projekt bereitstellen

Es ist nicht erforderlich, ein Projekt vor dem Ausführen bereitzustellen, da es automatisch bereitgestellt wird, falls erforderlich.

Um das Projekt bereitzustellen, führen Sie eine der folgenden Aktionen aus:

• Klicken Sie auf das Bereitstellen-Symbol in der Symbolleiste.

• Klicken Sie im Projektartikel-Panel auf den Namen des gerade erstellten Projekts und dann auf Bereitstellen im sich öffnenden Dropdown-Menü.

• Klicken Sie oben im Projektartikel-Panel auf Operationen und dann auf Bereitstellen im sich öffnenden Dropdown-Menü.

Der Bereitstellungsprozess des Projekts beginnt, das Projekt an Harmony zu senden, und eine Fortschrittsnachricht wird angezeigt.

• Um die Fortschrittsnachricht im Hintergrund auszuführen, klicken Sie auf Im Hintergrund ausführen.

• Um den Bereitstellungsprozess abzubrechen, klicken Sie auf Abbrechen, um zum vorherigen Bildschirm zurückzukehren.

Der Vorgang ist jetzt abgeschlossen und bereitgestellt.

Die Operation ausführen

Dieses Bild zeigt die Schaltflächen, die auf den Zusammenfassungsseiten des Salesforce Bulk Process Wizards verfügbar sind. Die Bezeichnungen (wie Bulk-Abfrage ausführen oder Bulk-Einfügen ausführen) variieren je nach dem spezifischen Wizard, den Sie verwenden.

Klicken Sie auf Bulk... ausführen, um die Operation in die Warteschlange zur Ausführung zu stellen.

Wenn das Projekt noch nicht bereitgestellt wurde oder seit der letzten Bereitstellung geändert wurde, wird es automatisch bereitgestellt. Weitere Informationen zum Erstellen, Bereitstellen und Ausführen von Operationen finden Sie unter Eine Operation erstellen.

• Der Betriebsmonitor wird am unteren Bildschirmrand angezeigt und verfolgt den Status, die empfangene Zeit, die gestartete Zeit und die Zeit, zu der die Operation die Verarbeitung abgeschlossen hat.

• Wenn die Operation die Verarbeitung abgeschlossen hat, zeigt der Ergebnis-Dialog die Abschlusszeit, den Status, die Anzahl der erfolgreich verarbeiteten Datensätze und die Anzahl der Datensätze, die nicht verarbeitet werden konnten. Die Schaltflächen Erfolgsdatei anzeigen und Fehlerdatei anzeigen werden unten beschrieben.

Klicken Sie auf die Schaltfläche Ergebnisverlauf, um eine Liste der letzten Aktivitäten anzuzeigen, einschließlich der abgeschlossenen Zeit, des Status, der Anzahl der erfolgreich verarbeiteten Datensätze und der Anzahl der Datensätze, die nicht verarbeitet werden konnten. Wählen Sie ein Ergebnis in der Liste aus, um die Schaltflächen Erfolgsdatei anzeigen und Fehlerdatei anzeigen zu aktivieren, die unten beschrieben sind.

Klicken Sie auf die Schaltfläche Löschen, um die Operation aus dem Projekt zu entfernen.

• Das Dialogfenster Löschen bestätigen wird angezeigt. Klicken Sie auf Löschen, um zu bestätigen und die Operation zu löschen.
• Der Dialog Löschen von Wizard-Elementen zeigt die zugehörigen Komponenten der Operation an.
  • Wählen Sie Ja, um die zugehörigen Wizard-Objekte zusätzlich zur Einfügeoperation zu löschen.
  • Wenn Sie Nein auswählen, bleiben die Wizard-Objekte im Projekt verfügbar. Nur die Einfügeoperation wird gelöscht.
  • Die Auswahl von Abbrechen bricht die Löschung der Einfügeoperation und der zugehörigen Wizard-Objekte ab.

Siehe Eine Operation erstellen für weitere Informationen zum Erstellen, Bereitstellen und Ausführen von Operationen.

Erfolgs- und Fehlerdateien anzeigen

Das Anzeigen von Erfolgs- und Fehlerdateien ist verfügbar, wenn Sie Operationen auf einem privaten Agenten ausführen. Die Schaltflächen Erfolgsdatei anzeigen und Fehlerdatei anzeigen sind verfügbar, nachdem Sie die Schaltfläche Ausführen oder die Schaltfläche Ergebnisverlauf wie oben beschrieben geklickt und dann eines der Ergebnisse ausgewählt haben. Dies ist ein Beispiel für das Dialogfeld Ergebnisverlauf, das die Schaltflächen und ein ausgewähltes Ergebnis zeigt:

• Erfolgsdatei anzeigen: Wenn Sie die Operation auf einem privaten Agenten ausführen, zeigt das Auswählen der Schaltfläche Erfolgsdatei anzeigen die ersten 100 Datensätze an, die erfolgreich in einem Popup-Fenster verarbeitet wurden.
• Fehlerdatei anzeigen: Wenn Sie die Operation auf einem privaten Agenten ausführen, zeigt das Auswählen der Schaltfläche Fehlerdatei anzeigen die ersten 100 Datensätze an, die nicht verarbeitet werden konnten, in einem Popup-Fenster an.

In diesem Beispiel werden drei Datensätze angezeigt:

• Datei kopieren nach: Speichert die Erfolgs- oder Fehlermeldungen in einer CSV-Datei mit dem Standarddateinamen salesforce.csv.
• Externes Programm öffnen: Diese Option ist derzeit nicht verfügbar.