Salesforce Delete-Aktivität in Jitterbit Studio

Einführung

Eine Salesforce Delete-Aktivität löscht mit ihrer Salesforce-Verbindung Daten in Salesforce und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Erstellen einer Salesforce Delete-Aktivität

Eine Instanz einer Salesforce Delete-Aktivität wird aus einer Salesforce-Verbindung mit ihrem Aktivitätstyp Delete erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Salesforce Delete-Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).

• Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich-Registerkarte „Komponenten").

Konfigurieren einer Salesforce Delete-Aktivität

Führen Sie diese Schritte aus, um eine Salesforce Delete-Aktivität zu konfigurieren:

• Schritt 1: Namen eingeben
  Geben Sie einen Namen für die Aktivität an.

• Schritt 2: Datenschemas überprüfen
  Alle aus dem Endpunkt generierten Request- oder Response-Schemas werden angezeigt.

Schritt 1: Namen eingeben

In diesem Schritt geben Sie einen Namen für die Aktivität an.

• Endpunktmenü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

  • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

• Name: Geben Sie einen Namen ein, um die Salesforce Delete-Aktivität zu identifizieren. Der Name muss für jede Salesforce Delete-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

• Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

In diesem Schritt werden alle aus dem Endpunkt generierten Request- oder Response-Schemas angezeigt:

• Datenschema: Die Request- und Response-Datenschemas werden angezeigt. Innerhalb des Knotens ids auf der Request-Seite der Struktur befindet sich ein Textwert, der durch ein Feld dargestellt wird und dazu bestimmt ist, die Salesforce-Datensatz-ID(s) bereitzustellen. Später können Sie während des Transformationszuordnungsprozesses die ids auf der Zielseite zuordnen, um die zu löschenden Salesforce-Datensatz-ID(s) bereitzustellen.

  Die verwendete Version der Salesforce-API hängt von der Jitterbit-Agent-Version ab, die Sie verwenden. Siehe Voraussetzungen und unterstützte API-Versionen für Links zur Dokumentation der Schemafelder.

• Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Salesforce-Aktivität Löschen können Sie diese in einem Vorgang wie unten beschrieben verwenden. Nach dem Ausführen eines Vorgangs, der eine Salesforce-Aktivität auf einem privaten Agent enthält, können Sie die Erfolgs- und Fehlerdateien des Vorgangs herunterladen.

Schließen Sie den Vorgang ab

Nach der Konfiguration einer Salesforce-Aktivität Löschen schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Designoberfläche verfügbar. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Salesforce-Aktivitäten Löschen können mit diesen Vorgangsmustern verwendet werden:

• Transformationsmuster (als Ziel)
• Zwei-Ziel-Archivierungsmuster (nur als erstes Ziel)
• Zwei-Transformationsmuster (als erstes oder zweites Ziel)

Ein Vorgang kann nur eine Salesforce-Aktivität enthalten. Die Aktivität, die Daten für eine Salesforce-Aktivität Löschen bereitstellt, kann mit einem beliebigen Endpunkttyp verknüpft werden. Wenn der Vorgang die Salesforce-Antwort direkt an eine andere Zielaktivität übergibt, wie im Zwei-Ziel-Archivierungsmuster, muss diese Zielaktivität mit dem Connector API, Datenbank, Dateifreigabe, FTP, HTTP, Lokaler Speicher, Temporärer Speicher oder Variable verknüpft sein. Im Zwei-Transformationsmuster durchläuft die Salesforce-Antwort eine zweite Transformation, bevor sie die zweite Zielaktivität erreicht, sodass diese Zielaktivität mit einem beliebigen Endpunkttyp verknüpft werden kann.

Eine Salesforce-Aktivität kann nur in einem einzelnen Vorgang als Vorgangsschritt verwendet werden. Das heißt, Sie können nicht auf dieselbe Aktivität mehrmals in anderen Vorgängen verweisen. Stattdessen können Sie eine Kopie einer Salesforce-Aktivität zur Verwendung an anderer Stelle erstellen (siehe Komponentenwiederverwendung).

Andere Muster sind mit Salesforce-Aktivitäten Löschen nicht gültig. Weitere Informationen finden Sie in den Validierungsmustern auf der Seite Vorgangsgültigkeit.

Wenn Sie in einer Transformation die Option zum Spiegeln eines Schemas verwenden, das von einer nicht-Bulk-Salesforce-Aktivität bereitgestellt wird, wird das resultierende gespiegelte Schema automatisch mit einem zusätzlichen Stammknoten namens records mit untergeordneten Knoten erstellt, die das Schema spiegeln. Wenn Felder innerhalb der untergeordneten Knoten zugeordnet werden, wird der Knoten zu einem Schleifenknoten, um alle Datensätze durchlaufen zu können (siehe Schleifenknoten unter Datenstrukturen).

Operationen, die Salesforce-Aktivitäten verwenden, können auch mit Operationsaktionen konfiguriert werden, um bei einem SOAP-Fehler ausgelöst zu werden – ein Fehler, der sich aus einem falschen Nachrichtenformat, einer Kopfzeilenverarbeitung oder einer Inkompatibilität ergibt. Operationsaktionen können so konfiguriert werden, dass sie eine Operation ausführen oder eine E-Mail senden, nachdem ein SOAP-Fehler auftritt. Anweisungen zum Auslösen einer Aktion bei SOAP-Fehler finden Sie unter Operationsaktionen.

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn Sie bereit sind, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Operationsprotokolle überprüfen.

Erfolgs- und Fehlerdateien anzeigen

Wenn Sie eine Operation mit einer Salesforce-Aktivität auf einem privaten Agent ausführen, stehen Erfolgs- und Fehlerdateien zum Download auf der Runtime-Seite der Management Console zur Verfügung. Wählen Sie die relevante Operation in der Tabelle Runtime aus und klicken Sie auf die Registerkarte Activity Logs im unteren Bereich des Bildschirms, um Download-Links für die Dateien anzuzeigen, falls verfügbar:

• Erfolgsdatei herunterladen: Wenn Sie die Operation auf einem privaten Agent ausführen, klicken Sie auf den Link Download, um die erfolgreichen Datensätze als CSV-Datei zu speichern.

• Fehlerdatei herunterladen: Wenn Sie die Operation auf einem privaten Agent ausführen, klicken Sie auf den Link Download, um die fehlgeschlagenen Datensätze als CSV-Datei zu speichern.