Salesforce Service Cloud Delete Activity in Jitterbit Studio
Einführung
Eine Salesforce Service Cloud Delete-Aktivität verwendet ihre Salesforce Service Cloud-Verbindung zum Löschen von Daten in Salesforce Service Cloud und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
Erstellen einer Salesforce Service Cloud Delete Activity
Eine Instanz einer Salesforce Service Cloud Delete-Aktivität wird aus einer Salesforce Service Cloud-Verbindung mit ihrem Delete-Aktivitätstyp 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äts- oder Tool-Instanz in Komponentenwiederverwendung.
Eine vorhandene Salesforce Service Cloud 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 Service Cloud Delete Activity
Führen Sie diese Schritte aus, um eine Salesforce Service Cloud 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 vom 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.
-
Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, 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 Service Cloud Delete-Aktivität zu identifizieren. Der Name muss für jede Salesforce Service Cloud Delete-Aktivität eindeutig sein und darf keine Schrägstriche (
/) oder Doppelpunkte (:) enthalten. -
Speichern und beenden: Falls 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 die Schaltfläche Fertig im letzten Schritt 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 Änderungen verwerfen möchten.
Schritt 2: Datenschemas überprüfen
In diesem Schritt werden alle vom Endpunkt generierten Request- oder Response-Schemas angezeigt:
- Datenschema: Die Request- und Response-Datenschemas werden angezeigt. Innerhalb des Knotens
idsauf 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 dieidsauf der Zielseite zuordnen, um die zu löschenden Salesforce-Datensatz-ID(s) bereitzustellen.
Die Version der Salesforce API, die verwendet wird, hängt von der Jitterbit Agent-Version ab, die Sie verwenden. Unter Voraussetzungen und unterstützte API-Versionen finden Sie Links zur Dokumentation zu den Schemafeldern.
Hinweis
Um ein Datenschema in einer vorhandenen Aktivität zu aktualisieren, müssen Sie alle Konfigurationsschritte der Aktivität erneut durchlaufen und mindestens eine Änderung vornehmen (z. B. ein Zeichen am Ende des Aktivitätsnamens hinzufügen und entfernen), um eine Schemaaktualisierung zu erzwingen.
-
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 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 Service Cloud-Aktivität Löschen können Sie diese in einem Vorgang wie unten beschrieben verwenden. Nach dem Ausführen eines Vorgangs, der eine Salesforce Service Cloud-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 Service Cloud-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 über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.
Salesforce Service Cloud-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 Service Cloud-Aktivität enthalten. Die Aktivität, die Daten für eine Salesforce Service Cloud-Aktivität Löschen bereitstellt, kann mit einem beliebigen Endpunkttyp verknüpft werden. Wenn der Vorgang die Salesforce Service Cloud-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 Service Cloud-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 Service Cloud-Aktivität kann in nur einem 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 bei Salesforce Service Cloud Delete-Aktivitäten nicht zulässig. Siehe die Validierungsmuster auf der Seite Operation validity.
Wenn Sie in einer Transformation die Option zum Spiegeln eines Schemas verwenden, das von einer nicht-Bulk-Salesforce Service Cloud-Aktivität bereitgestellt wird, wird das resultierende gespiegelte Schema automatisch mit einem zusätzlichen Root-Knoten namens records erstellt, wobei die untergeordneten Knoten das Schema spiegeln. Wenn Felder innerhalb der untergeordneten Knoten zugeordnet werden, wird der Knoten zu einem Loop-Knoten, um alle Datensätze zu durchlaufen (siehe Loop nodes unter Data structures).
Operationen, die Salesforce Service Cloud-Aktivitäten verwenden, können auch Operationsaktionen konfigurieren, die bei einem SOAP-Fehler ausgelöst 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 Operation actions.
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 Service Cloud-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 Runtime-Tabelle 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:
-
Download Success File: Wenn Sie die Operation auf einem privaten Agent ausführen, klicken Sie auf den Download-Link, um die erfolgreichen Datensätze als CSV-Datei zu speichern.
-
Download Failure File: Wenn Sie die Operation auf einem privaten Agent ausführen, klicken Sie auf den Download-Link, um die fehlgeschlagenen Datensätze als CSV-Datei zu speichern.
Hinweis
Standardmäßig werden Erfolgs- und Fehlerdateien nach 14 Tagen automatisch vom privaten Agent durch den Jitterbit File Cleanup Service gelöscht. Die Anzahl der Tage, für die die Dateien gespeichert werden, kann durch Bearbeitung des Abschnitts [Resultfiles] in der Datei jitterbit.conf geändert werden. Sie können auch die Aufbewahrungsregeln für Erfolgs- und Fehlerdateien ändern, indem Sie die Jitterbit-Datenbereinigungs-Service-Regeln für private Agents bearbeiten.
Activity Log-Downloads sind für Cloud Agents deaktiviert. Wenn die Links sichtbar sind, erhalten Sie eine Fehlermeldung, wenn Sie versuchen, einen Download durchzuführen.