Salesforce Aktivität „Löschen“
Einführung
Eine Salesforce Aktivität Delete löscht Daten in einem Salesforce Endpoint und soll als Ziel zum Verbrauchen von Daten in einem Operation verwendet werden. Nachdem Sie eine Salesforce-Verbindung konfiguriert haben, können Sie für jede Salesforce-Verbindung beliebig viele Salesforce-Aktivitäten konfigurieren.
Erstellen einer Salesforce Aktivität
Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität erstellt.
Um eine Instanz einer Aktivität 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ätsinstanz in Komponentenwiederverwendung.
Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:
- Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
- Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
Konfigurieren einer Salesforce Löschaktivität
Befolgen Sie diese Schritte, um eine Salesforce Aktivität Löschen zu konfigurieren:
- Schritt 1: Geben Sie einen Namen ein Geben Sie einen Namen für die Aktivität an.
- Schritt 2: Überprüfen Sie die Datenschemata Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt.
Schritt 1: Geben Sie einen Namen ein
In diesem Schritt geben Sie der Aktivität einen Namen.
- Name: Geben Sie einen Namen ein, der zur Identifizierung der Salesforce-Aktivität Löschen verwendet werden soll. Der Name muss für jede Salesforce-Aktivität Löschen eindeutig sein und darf keine Schrägstriche enthalten (
/
) oder Doppelpunkte (:
). - Speichern und beenden: Klicken Sie, wenn aktiviert, 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 mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.
- Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 2: Überprüfen der Datenschemata
In diesem Schritt werden alle vom Endpoint generierten Anforderungs- oder Antwortschemata angezeigt:
-
Datenschema: Die Anforderungs- und Antwortdatenschemata werden angezeigt. Innerhalb des Knotens
ids
Auf der Anforderungsseite der Struktur befindet sich ein Textwert, der durch ein Feld dargestellt wird und zur Bereitstellung der Salesforce Datensatz-ID(s) verwendet werden soll. Später, während der Transformation-Prozess können Sie eine Zuordnung zumids
auf der Zielseite, um die zu löschenden Salesforce Datensatz-IDs bereitzustellen.Die verwendete Version der Salesforce REST API hängt von der von Ihnen verwendeten Jitterbit-Agent-Version ab. Siehe Voraussetzungen und unterstützte API Versionen für Links zur Dokumentation der Schema.
Notiz
Um ein Schema in einer vorhandenen Aktivität zu aktualisieren, müssen Sie jeden Aktivitätskonfigurationsschritt erneut durchlaufen und dabei mindestens eine Änderung vornehmen (z. B. ein Zeichen am Ende des Aktivitätsnamens hinzufügen oder entfernen), um eine Aktualisierung des Schema zu erzwingen.
-
Zurück: Klicken Sie hier, 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 hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Nächste Schritte
Nachdem Sie eine Salesforce-Aktivität Delete konfiguriert haben, können Sie sie wie unten beschrieben in einem Operation verwenden. Nachdem Sie einen Operation mit einer Salesforce Aktivität auf einem privaten Agenten ausgeführt haben, können Sie die Erfolgs- und Fehlerdateien des Vorgangs herunterladen.
Schließen Sie den Operation ab
Nachdem Sie eine Salesforce Aktivität Delete konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation eines Vorgangs konfigurieren, darunter die Möglichkeit, Vorgänge zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.
Sobald eine Salesforce Aktivität Löschen erstellt wurde, sind Menüaktionen für diese Aktivität über den Projektbereich entweder auf den Registerkarten Workflows oder Komponenten sowie über die Design-Canvas zugänglich. Siehe Aktionsmenü für weitere Einzelheiten.
Salesforce -Lösch-Aktivitäten können mit diesen Operation als Ziel verwendet werden:
- Transformation
- Zwei-Ziel-Archivmuster (nur als erstes Ziel)
- Zwei-Transformationsmuster (entweder als erstes oder zweites Ziel)
Vorgänge, die eine Salesforce Aktivität enthalten, können nur eine Salesforce Aktivität haben und können keine anderen Aktivitäten enthalten, mit Ausnahme derjenigen, die mit der API verknüpft sind, Datenbank, Dateifreigabe, FTP, HTTP, Lokaler Speicher, Temporärer Speicher oder Variable-Anschlüsse.
Eine Salesforce-Aktivität kann nur in einer einzigen Operation als Operation Schritt verwendet werden. Das heißt, Sie können nicht mehrere Male in anderen Operationen auf dieselbe Aktivität verweisen. Stattdessen können Sie eine Kopie einer Salesforce Aktivität erstellen, um sie an anderer Stelle zu verwenden (siehe Komponentenwiederverwendung).
Andere Muster sind bei Verwendung von Salesforce -Delete-Aktivitäten nicht gültig. Siehe die Validierungsmuster unter Operationsgültigkeit Seite.
Wenn Sie innerhalb einer Transformation die Option zum Spiegeln eines Schema verwenden, das von einer nicht-massenbasierten Salesforce Aktivität bereitgestellt wird, wird das resultierende gespiegelte Schema automatisch mit einem zusätzlichen Stammknoten namens records
wobei die untergeordneten Knoten das Schema widerspiegeln. Wenn Felder innerhalb der untergeordneten Knoten zugeordnet werden, wird der Knoten zu einem Schleifenknoten, der das Durchlaufen aller Datensätze ermöglicht (siehe Schleifenknoten unter Datenstrukturen).
Bei Vorgängen, die Salesforce Aktivitäten verwenden, können auch Operation so konfiguriert werden, dass sie bei einem SOAP Fehler ausgelöst werden - einem Fehler, der durch ein falsches Nachrichtenformat, eine falsche Header-Verarbeitung oder eine Inkompatibilität verursacht wird. Vorgangsaktionen können so konfiguriert werden, dass nach Auftreten eines SOAP -Fehlers eine Operation Durchführen oder eine Email gesendet wird. Anweisungen zum Auslösen einer Aktion bei einem SOAP Fehler finden Sie unter Vorgangsaktionen.
Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.
Wenn Sie bereit sind, führen Sie den Operation aus und validieren Sie das Verhalten, indem Sie die Operation überprüfen.
Anzeigen von Erfolgs- und Fehlerdateien
Wenn Sie einen Operation ausführen, der eine Salesforce Aktivität auf einem privaten Agenten enthält stehen Erfolgs- und Fehlerdateien auf der Seite Runtime Operations der Management Console zum Download bereit. Wählen Sie den entsprechenden Operation in der Tabelle Runtime-Vorgänge aus und klicken Sie im unteren Bereich des Bildschirms auf die Tab Aktivitätsprotokolle, um Download-Links für die Dateien anzuzeigen, sofern verfügbar:
-
Datei erfolgreich heruntergeladen: Wenn Sie den Operation auf einem privaten Agenten ausführen, klicken Sie auf den Link Herunterladen, um die Erfolgsaufzeichnungen als CSV-Datei zu speichern.
-
Download-Fehlerdatei: Wenn Sie den Operation auf einem privaten Agenten ausführen, klicken Sie auf den Link Herunterladen, um die Fehleraufzeichnungen als CSV-Datei zu speichern.
Hinweis
Standardmäßig werden Erfolgs- und Fehlerdateien nach 14 Tagen automatisch vom Jitterbit File Cleanup Service aus dem privaten Agenten gelöscht. Die Anzahl der Tage, für die die Dateien gespeichert werden, kann durch Bearbeiten des [Resultfiles]
im Abschnitt jitterbit.conf
Datei. Sie können die Aufbewahrungsregeln für erfolgreiche und fehlgeschlagene Dateien auch ändern, indem Sie [die Jitterbit-Dateibereinigungsdienstregeln für private Agenten bearbeiten]/agent/cleanuprules/).
Aktivitätsprotokoll-Downloads sind für Cloud-Agenten deaktiviert. Wenn die Links sichtbar sind, erhalten Sie beim Versuch eines Downloads eine Fehlermeldung.