Zum Inhalt springen

Salesforce Service Cloud-Aktualisierungsaktivität

Einführung

Eine Salesforce Service Cloud Update-Aktivität unter Verwendung ihrer Salesforce Service Cloud-Verbindung, aktualisiert vorhandene Daten in der Salesforce Service Cloud und soll als Ziel zum Verwenden von Daten in einem Operation verwendet werden.

Die Update-Aktivität wird verwendet, um Datensätze zu aktualisieren, die bereits basierend auf der ID des Objekts in Salesforce Service Cloud vorhanden sind. Wenn Sie stattdessen Datensätze einfügen möchten, die noch nicht vorhanden sind, und Datensätze aktualisieren möchten, die vorhanden sind, verwenden Sie eine Salesforce Service Cloud Upsert-Aktivität.

Erstellen einer Salesforce Service Cloud Updateaktivität

Eine Instanz einer Salesforce Service Cloud Update-Aktivität wird aus einer Salesforce Service Cloud-Verbindung erstellt mithilfe des Aktivitätstyps Update.

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 Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene Salesforce Service Cloud Update-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Salesforce Service Cloud Updateaktivität

Führen Sie die folgenden Schritte aus, um eine Salesforce Service Cloud -Update-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben, Objekt auswählen und Einstellungen festlegen

In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen ein Objekt aus, das beim Aktualisieren der Daten verwendet werden soll.

Salesforce Service Cloud Update-Aktivität 1

  • Name: Geben Sie einen Namen ein, der zur Identifizierung der Salesforce Service Cloud Update-Aktivität verwendet werden soll. Der Name muss für jede Salesforce Service Cloud Update-Aktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Wählen Sie die Objektreferenz: Verwenden Sie die Dropdown-Liste, um ein Salesforce Service Cloud-Standard- oder benutzerdefiniertes Objekt zum Aktualisieren von Daten auszuwählen. Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

    Notiz

    Wenn die Liste nicht mit verfügbaren Objekten gefüllt ist, beachten Sie die folgenden Tipps zur Fehlerbehebung:

    • Die Salesforce Service Cloud-Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

    • Ein Salesforce Passwort, das erweiterte ASCII-Zeichen wie £ verwendet, kann beim Abrufen von Daten während der Aktivitätskonfiguration den folgenden Fehler verursachen:

      Invalid username, password, security token; or user locked out. [INVALID_LOGIN]
      

      In diesem Fall kann der Verbindungstest trotzdem erfolgreich sein. Wenn Sie diesen Fehler während der Aktivitätskonfiguration erhalten und Sonderzeichen im Passwort verwenden, versuchen Sie, das Passwort zu ändern.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol um Objekte vom Salesforce Service Cloud Endpoint neu zu laden. Dies kann nützlich sein, wenn Sie vor Kurzem Objekte zur Salesforce Service Cloud hinzugefügt haben.

  • Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:

    Optionale Einstellungen für Salesforce Service Cloud

    • Vorgangsoptionen: Diese Optionen gelten für einen Operation, in dem eine Salesforce Service Cloud -Update-Aktivität verwendet wird.

      Tipp

      In den Operation einer Operation können zusätzliche Optionen festgelegt werden.

      • Nullwerte einfügen: Aktivieren Sie das Kontrollkästchen, um das Einfügen oder Aktualisieren von Nullwerten zuzulassen. Wenn diese Option nicht ausgewählt ist und ein zugeordneter Wert einen Nullwert hat oder leer ist (eine leere Zeichenfolge aufweist), wird er nicht verarbeitet.
  • Speichern und beenden: Wenn aktiviert, klicken Sie hier, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie hier, 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 hier, 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:

Salesforce Service Cloud Update-Aktivität 2

  • Datenschema: Es werden die Datenschemata für Anfrage und Antwort angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während der Transformation erneut angezeigt-Prozess, bei dem Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können.

    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.

    Warnung

    Für eine Salesforce Service Cloud Update-Aktivität darf die Salesforce Datensatz-ID keine Zuordnung enthalten.

    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 Service Cloud Update-Aktivität konfiguriert haben, können Sie sie wie unten beschrieben in einem Operation verwenden. Nachdem Sie einen Operation ausgeführt haben, der eine Salesforce Service Cloud-Aktivität auf einem privaten Agenten enthält, können Sie die Erfolgs- und Fehlerdateien des Vorgangs herunterladen.

Schließen Sie den Operation ab

Nachdem Sie eine Salesforce Service Cloud -Update-Aktivität 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 konfigurieren, die die Möglichkeit umfassen, Vorgänge zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

Salesforce Service Cloud Update-Aktivitäten können mit diesen Operation als Quelle verwendet werden:

Vorgänge, die eine Salesforce Service Cloud-Aktivität enthalten, können nur eine Salesforce Service Cloud-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 Service Cloud-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 Service Cloud Aktivität erstellen, um sie an anderer Stelle zu verwenden (siehe Komponentenwiederverwendung).

Andere Muster sind bei Verwendung von Salesforce Service Cloud Update-Aktivitäten nicht gültig. Siehe die Validierungsmuster unter Operation validity Seite.

Wenn Sie innerhalb einer Transformation die Option zum Spiegeln eines Schema verwenden, das von einer nicht-massenbasierten Salesforce Service Cloud-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 Service Cloud-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, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.

Anzeigen von Erfolgs- und Fehlerdateien

Wenn Sie einen Operation ausführen, der eine Salesforce Service Cloud-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 Erfolgs- und Fehlerdateien auch ändern, indem Sie die Jitterbit-Dateibereinigungsdienstregeln für private Agenten bearbeiten.

Aktivitätsprotokoll-Downloads sind für Cloud-Agenten deaktiviert. Wenn die Links sichtbar sind, erhalten Sie beim Versuch eines Downloads eine Fehlermeldung.