Salesforce Service Cloud Bulk Query-Aktivität in Jitterbit Studio

Einführung

Eine Salesforce Service Cloud Bulk Query-Aktivität verwendet ihre Salesforce Service Cloud-Verbindung und fragt eine große Anzahl von Datensätzen aus Salesforce Service Cloud ab. Sie ist als Quelle gedacht, um Daten in einen Vorgang bereitzustellen.

Die Bulk Query-Aktivität sollte nur verwendet werden, wenn man keine Transformation benötigt, um Daten vor dem Erreichen des Ziels zu ändern, da Salesforce Service Cloud Bulk-Aktivitäten nicht mit Transformationen verwendet werden können. Falls eine Transformation erforderlich ist, verwenden Sie die Salesforce Service Cloud Query-Aktivität.

Die Salesforce Service Cloud Bulk-Aktivitäten verwenden die SOAP-basierte Salesforce Bulk API. Weitere Informationen finden Sie unter Voraussetzungen und unterstützte API-Versionen.

Erstellen einer Salesforce Service Cloud Bulk Query-Aktivität

Eine Instanz einer Salesforce Service Cloud Bulk Query-Aktivität wird aus einer Salesforce Service Cloud-Verbindung mit ihrem Aktivitätstyp Bulk Query 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 Service Cloud Bulk Query-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 Bulk Query-Aktivität

Führen Sie diese Schritte aus, um eine Salesforce Service Cloud Bulk Query-Aktivität zu konfigurieren:

• Schritt 1: Name eingeben und Objekte auswählen
  Geben Sie einen Namen für die Aktivität ein und wählen Sie die Objekte aus, die per Bulk Query abgefragt werden sollen.

• Schritt 2: Felder auswählen und Bedingungen erstellen
  Erstellen Sie die Abfrageanweisung entweder automatisch durch Auswahl von Feldern und Angabe von Bedingungen oder manuell durch direkte Eingabe einer Abfrageanweisung.

Schritt 1: Name eingeben und Objekte auswählen

In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen die Objekte aus, die per Bulk Query abgefragt werden sollen.

• Endpunkt-Menü: 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 Service Cloud Bulk Query-Aktivität zu identifizieren. Der Name muss für jede Salesforce Service Cloud Bulk Query-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

• Objekt(e) auswählen: Dieser Bereich zeigt Objekte an, die in der Salesforce Service Cloud-Verbindung verfügbar sind:

• Kopieren: Klicken Sie auf das Symbol Aktivitätskonfiguration kopieren, um die vorhandene Konfiguration dieses Schritts und von Schritt 2 in die Zwischenablage zu kopieren. Das Kopieren ist nur möglich, nachdem eine Abfrage in Schritt 2 mit der Schaltfläche Abfrage testen validiert wurde.

• Einfügen: Klicken Sie auf das Symbol Aktivitätskonfiguration einfügen, um eine vorhandene Konfiguration einzufügen, die aus diesem Schritt oder Schritt 2 kopiert wurde. Wenn Sie versuchen, eine Abfrage einzufügen, wird ein Bestätigungsdialog angezeigt, der darauf hinweist, dass alle vorhandenen Konfigurationen in den Schritten 1 und 2 überschrieben werden.

• Ansicht: Verwenden Sie das Dropdown-Menü, um die Liste der Objekte, die Bulk Query unterstützen, auf alle Objekte, Standardobjekte oder benutzerdefinierte Objekte zu filtern. Standardmäßig werden alle Objekte angezeigt.

• Suche: Geben Sie einen beliebigen Spaltenwert in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol , um Objekte vom Salesforce Service Cloud-Endpunkt neu zu laden. Dies ist hilfreich, wenn Sie kürzlich Objekte zu Salesforce Service Cloud hinzugefügt haben, die in der Liste Objekt(e) auswählen noch nicht sichtbar sind.

• Objekt(e) auswählen: Klicken Sie auf ein Objekt aus der Liste der Objekte, um es auszuwählen. Es kann nur ein Objekt ausgewählt werden.

  Hinweis

  Wenn die Liste nicht mit verfügbaren Objekten gefüllt wird, ist die Salesforce Service Cloud-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

• Speichern und beenden: Klicken Sie auf diese Schaltfläche, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Weiter: Klicken Sie auf diese Schaltfläche, 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 auf diese Schaltfläche, 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.

Schritt 2: Felder auswählen und Bedingungen erstellen

In diesem Schritt erstellen Sie die Abfrageanweisung entweder automatisch durch Auswahl von Feldern und Angabe von Bedingungen oder manuell durch direkte Eingabe einer Abfrageanweisung. Sie müssen die Abfrage testen, um sicherzustellen, dass sie gültig ist, bevor Sie zum nächsten Schritt übergehen.

• Felder auswählen und Bedingungen erstellen: Dieser Abschnitt zeigt Felder für die ausgewählten Objekte an, die am Salesforce Service Cloud-Endpunkt verfügbar sind. Objekte, die im vorherigen Schritt ausgewählt wurden, werden fett dargestellt.

  • Suche: Geben Sie einen beliebigen Spaltenwert in das Suchfeld ein, um die Liste der Felder zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Die aufgelisteten Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.

  • Alle auswählen: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie dieses Kontrollkästchen verwenden, um alle sichtbaren Felder auf einmal auszuwählen (Objekte und reduzierte Felder werden nicht ausgewählt).

  • Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die Sie in die Abfrage einbeziehen möchten, um sie automatisch zur SOQL-Anweisung auf der rechten Seite hinzuzufügen. Wenn Sie das Suchfeld nicht verwenden, können Sie auch ein ganzes Objekt auswählen, um alle seine Felder auf einmal auszuwählen.

• SOQL-Anweisung: Wenn Sie Felder auswählen, wird die Abfrageanweisung im Textfeld oben rechts automatisch mit dem Objekt und den ausgewählten Feldern gefüllt. Um eine benutzerdefinierte SOQL-Anweisung zu verwenden, nehmen Sie nach Bedarf Änderungen in diesem Textfeld vor. Informationen zur Strukturierung einer benutzerdefinierten SOQL-Anweisung finden Sie in der Dokumentation von Salesforce Service Cloud zur SOQL SELECT-Syntax.

• Kopieren: Klicken Sie auf das Symbol Aktivitätskonfiguration kopieren, um die vorhandene Konfiguration dieses Schritts und von Schritt 1 in die Zwischenablage zu kopieren. Das Kopieren ist nur nach der Validierung einer Abfrage mit der Schaltfläche Abfrage testen möglich.

• Einfügen: Klicken Sie auf das Symbol Aktivitätskonfiguration einfügen, um eine vorhandene Konfiguration einzufügen, die aus diesem Schritt oder Schritt 1 kopiert wurde. Wenn Sie versuchen, eine Abfrage einzufügen, wird ein Bestätigungsdialog angezeigt, der darauf hinweist, dass alle vorhandenen Konfigurationen in den Schritten 1 und 2 überschrieben werden.

• Abfrage testen: Klicken Sie auf diese Schaltfläche, um zu überprüfen, ob die Abfrage gültig ist. Wenn die Abfrage gültig ist, wird ein Beispiel von 10 Datensätzen aus der Abfrage in einer Tabelle angezeigt, die der unten gezeigten ähnelt. Die Abfrage muss gültig sein, um die Schaltfläche Weiter zu aktivieren. Wenn die Abfrage nicht gültig ist, werden relevante Fehlermeldungen angezeigt.

• WHERE-Klausel (Optional): Um eine WHERE-Klausel hinzuzufügen, verwenden Sie die folgenden Felder als Eingabe, um die Klausel zu konstruieren, oder geben Sie die Klausel manuell in das untere Textfeld ein. Nach dem Hinzufügen einer WHERE-Klausel müssen Sie die Abfrage zunächst mit der Schaltfläche Abfrage testen testen, um die Schaltfläche Weiter zu aktivieren.

• Objekt: Feld: Verwenden Sie das Dropdown-Menü, um ein Feld aus den ausgewählten Objekten auszuwählen.

  • Operator: Verwenden Sie das Dropdown-Menü, um den entsprechenden Operator auszuwählen. Die Liste der verfügbaren Operatoren hängt vom Datentyp des ausgewählten Feldes ab.

    Vergleich
    =	Gleich
    !=	Nicht gleich
    <	Kleiner als
    <=	Kleiner als oder gleich
    >	Größer als
    >=	Größer als oder gleich
    LIKE	Ähnlich
    IN	IN
    NOT IN	NOT IN
    INCLUDES	Gilt nur für Mehrfachauswahl-Picklists
    EXCLUDES	Gilt nur für Mehrfachauswahl-Picklists

    Logisch
    AND	TRUE, wenn beide linke und rechte Ausdrücke TRUE sind
    OR	TRUE, wenn entweder der linke oder der rechte Ausdruck TRUE ist
    NOT	TRUE, wenn der rechte Ausdruck FALSE ist

  • Wert: Geben Sie den gewünschten Wert ein, der mit den Dropdown-Auswahlen verwendet werden soll. Wenn der Wert eine Zeichenkette ist, schließen Sie den Wert in einfache Anführungszeichen ein, um das von Salesforce verwendete Format zu entsprechen.

    Vorsicht

    Bei Verwendung von globalen Variablen in einer WHERE-Klausel müssen Sie einen Standardwert angeben, damit die Abfrage für Tests gültig ist (mit der Schaltfläche Abfrage testen), da globale Variablen ihren Wert zur Laufzeit erhalten (siehe Standardwert definieren in Globale Variablen).

  • Hinzufügen: Klicken Sie auf den Link , um die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert zu konstruieren. Die automatisch konstruierte Klausel wird im unteren Textfeld angezeigt.

  Tipp

  Um mehrere Bedingungen zur Klausel hinzuzufügen, wiederholen Sie den Vorgang, indem Sie zusätzliche Auswahlen hinzufügen. Beachten Sie, dass Sie möglicherweise einen logischen Operator wie AND oder OR hinzufügen müssen, um die zusätzlichen Bedingungen zu berücksichtigen.

• 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 Änderungen, um die Konfiguration zu schließen, ohne die an 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 Bulk Query-Aktivität können Sie diese wie unten beschrieben in einem Vorgang verwenden. Nach der Ausführung eines Vorgangs mit einer Salesforce Service Cloud-Aktivität auf einem privaten Agent können Sie die Erfolgs- und Fehlerdateien des Vorgangs herunterladen.

Den Vorgang abschließen

Nach der Konfiguration einer Salesforce Service Cloud Bulk Query-Aktivität 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 Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

Salesforce Service Cloud Bulk Query-Aktivitäten können als Quelle mit dem Salesforce Bulk Source Pattern verwendet werden. Andere Muster sind bei Verwendung von Salesforce Service Cloud Bulk Query-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite Vorgangsvalidität.

Vorgänge, die eine Salesforce Service Cloud-Aktivität enthalten, können nur eine Salesforce Service Cloud-Aktivität haben und dürfen keine anderen Aktivitäten enthalten, außer denen, die mit den Connectoren API, Datenbank, Dateifreigabe, FTP, HTTP, Lokaler Speicher, Temporärer Speicher oder Variable verbunden sind.

Eine Salesforce Service Cloud-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 Service Cloud-Aktivität zur Verwendung an anderer Stelle erstellen (siehe Komponentenwiederverwendung).

Darüber hinaus muss das dateibasierte Ziel, das im Vorgang verwendet wird, ein flaches Dateiformat mit einem Header und nur die folgenden Datentypen verwenden:

• Base64
• Boolean
• Datumsformate
• Double
• Integer
• Salesforce Service Cloud ID
• String

Vorgänge, die Salesforce Service Cloud-Aktivitäten verwenden, können auch Vorgangsaktionen haben, die bei einem SOAP-Fehler ausgelöst werden – ein Fehler, der sich aus einem falschen Nachrichtenformat, einer Kopfzeilenverarbeitung oder einer Inkompatibilität ergibt. Vorgangsaktionen können so konfiguriert werden, dass sie einen Vorgang ausführen oder eine E-Mail senden, nachdem ein SOAP-Fehler auftritt. Anweisungen zum Auslösen einer Aktion bei 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 diesen temporären Speicherort dann in der Skriptfunktion.

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen Sie ihn aus und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.

Erfolgs- und Fehlerdateien anzeigen

Wenn Sie einen Vorgang mit einer Salesforce Service Cloud-Aktivität auf einem privaten Agent ausführen, sind Erfolgs- und Fehlerdateien auf der Runtime-Seite der Management Console zum Download verfügbar. Wählen Sie den relevanten Vorgang 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 den Vorgang auf einem privaten Agent ausführen, klicken Sie auf den Link Herunterladen, um die Erfolgsdatensätze als CSV-Datei zu speichern.

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