Salesforce Abfrageaktivität

Einführung

Eine Salesforce -Query-Aktivität fragt Daten von einem Salesforce Endpoint ab und soll als Quelle zum Bereitstellen von Daten für einen 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 Abfrageaktivität

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

• Schritt 1: Namen eingeben und Objekte auswählen Geben Sie einen Namen für die Aktivität ein und wählen Sie das/die abzufragende(n) Objekt(e) aus.
• Schritt 2: Felder auswählen und Bedingungen erstellen Erstellen Sie die Abfrage entweder automatisch, indem Sie Felder auswählen und Bedingungen angeben, oder manuell, indem Sie eine Abfrage direkt eingeben. Sie müssen die Abfrage testen, um sicherzustellen, dass sie gültig ist, bevor Sie mit dem nächsten Schritt fortfahren.
• Schritt 3: Überprüfen Sie die Datenschemata Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt.

Schritt 1: Namen eingeben und Objekte auswählen

In diesem Schritt geben Sie der Aktivität einen Namen und wählen das bzw. die abzufragenden Objekte aus.

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

• Objekt(e) auswählen: In diesem Abschnitt werden die im Salesforce Endpoint verfügbaren Objekte angezeigt:

  • Ansicht: Verwenden Sie das Dropdown-Menü, um die Objektliste nach allen Objekten, Standardobjekten oder benutzerdefinierten Objekten zu filtern. Standardmäßig werden alle Objekte angezeigt.

  • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Objektliste zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

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

  • Objekt(e) auswählen: Die Liste der Objekte wird in einer Spalte auf der linken Seite angezeigt. Klicken Sie auf das Objekt, um es der Liste auf der rechten Seite hinzuzufügen. Aus der Liste auf der linken Seite kann nur ein primäres Objekt ausgewählt werden.

    Notiz

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

    • Die Salesforce 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 dennoch erfolgreich sein. Wenn Sie diesen Fehler während der Aktivitätskonfiguration erhalten und Sonderzeichen im Passwort verwenden, versuchen Sie, das Passwort zu ändern.

• Verwandte Objekte auswählen Um optional untergeordnete oder übergeordnete Objekte in die Abfrage einzuschließen, aktivieren Sie das Kontrollkästchen neben jedem einzuschließenden verwandten Objekt. Dies wird als Abfrage bezeichnet.

  Hinweis

  Die Auswahl verwandter Objekte ist auf unmittelbare Kinder und Vorfahren bis zu 5 Ebenen beschränkt. Dies schließt Eltern eines Kindes ein, nicht jedoch ein Kind eines Kindes oder ein weiteres Kind eines Elternteils.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol um Felder in den zugehörigen Objekten für diese Aktivität vom Salesforce Endpoint neu zu laden. Vorhandene Auswahlen in Zugehörige Objekte auswählen bleiben nur bestehen, wenn diese Objekte in Schritt 2 verwendet werden. Bei allen Objekten, die in Schritt 2 nicht verwendet werden, wird die Auswahl gelöscht.

• Feldvorschau: Um Felder für ein bestimmtes Objekt in der Vorschau anzuzeigen, klicken Sie direkt auf den Objektnamen unter Verwandte(s) Objekt(e) auswählen. Beachten Sie, dass die Aktivierung der Feldvorschau unabhängig davon ist, welche Feld-Kontrollkästchen ausgewählt sind. Das heißt, Sie können Felder für Objekte in der Vorschau anzeigen, unabhängig davon, ob sie ausgewählt sind oder nicht.

• 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 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 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.

Schritt 2: Felder auswählen und Bedingungen erstellen

In diesem Schritt erstellen Sie die Abfrage entweder automatisch, indem Sie Felder auswählen und Bedingungen angeben, oder manuell, indem Sie eine Abfrage direkt eingeben. Sie müssen die Abfrage testen, um sicherzustellen, dass sie gültig ist, bevor Sie mit dem nächsten Schritt fortfahren.

• Felder auswählen und Bedingungen erstellen: In diesem Abschnitt werden Felder für die ausgewählten Objekte angezeigt, die im Salesforce Endpoint verfügbar sind. Objekte, die im vorherigen Schritt ausgewählt wurden, werden fett dargestellt.

  • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Felder zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die aufgelisteten Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.
  • Alles auswählen: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie mit diesem Kontrollkästchen alle sichtbaren Felder auf einmal auswählen (Objekte und reduzierte Felder werden nicht ausgewählt).
  • Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die in die Abfrage aufgenommen werden sollen, damit sie automatisch zur SOQL-Anweisung rechts hinzugefügt werden. Wenn Sie nicht das Suchfeld 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 Abfrage im oberen rechten Textfeld automatisch mit dem Objekt und den ausgewählten Feldern ausgefüllt. Um eine benutzerdefinierte SOQL-Anweisung zu verwenden, nehmen Sie bei Bedarf Änderungen in diesem Textfeld vor. Informationen zum Strukturieren einer benutzerdefinierten SOQL-Anweisung finden Sie in der Salesforce-Dokumentation zur SOQL SELECT-Syntax.

• Gelöschte Zeilen einschließen: Aktivieren Sie dieses Kontrollkästchen, um Zeilen einzuschließen, die in Salesforce als gelöscht markiert sind. (Dies gilt sowohl während des Testens der Abfrage als auch während der Laufzeit.)

• 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 eine Stichprobe von 10 Datensätzen, die aus der Abfrage abgerufen wurden, in einer Tabelle angezeigt, die der unten gezeigten ähnelt. Wenn die Abfrage nicht gültig ist, werden entsprechende Fehlermeldungen angezeigt. Die Abfrage muss gültig sein, um die Schaltfläche Weiter zu aktivieren.

  

• WHERE-Klausel (optional): Um eine WHERE-Klausel hinzuzufügen, verwenden Sie die Felder unten als Eingabe, um die Klausel zu konstruieren, oder geben Sie die Klausel manuell in das untere Textfeld ein. Nachdem Sie eine WHERE-Klausel hinzugefügt haben, müssen Sie die Abfrage zuerst mit der Schaltfläche Abfrage testen testen, um die Schaltfläche Weiter zu aktivieren.

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

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

    ------------	---------------------------- ----------------------
    Vergleich
    =	Ist gleich
    !=	Ungleich
    \<	Kleiner als
    \<=	Kleiner als oder gleich
    >	Größer als
    >=	Größer als oder gleich
    GEFÄLLT MIR	Gefällt mir
    IN	IN
    NICHT DRIN	NICHT DRIN
    ENTHÄLT	Gilt nur für Auswahllisten mit Mehrfachauswahl
    SCHLIESST AUS	Gilt nur für Auswahllisten mit Mehrfachauswahl
    Logisch
    UND	WAHR, wenn sowohl der linke als auch der rechte Ausdruck WAHR sind
    ODER	WAHR, wenn entweder der linke oder der rechte Ausdruck WAHR ist
    NICHT	WAHR, wenn der richtige Ausdruck FALSCH ist

  • Wert: Geben Sie den gewünschten Wert für die Dropdown-Auswahl ein. Wenn der Wert eine Zeichenfolge ist, schließen Sie ihn in einfache Anführungszeichen ein, damit er dem von Salesforce verwendeten Format entspricht.

    Vorsicht

    Wenn Sie globale Variablen in einer WHERE-Klausel verwenden, müssen Sie einen Standardwert angeben, damit die Abfrage zum Testen gültig ist (mit der Schaltfläche Abfrage testen), da globale Variablen ihren Wert zur Laufzeit erhalten (siehe Einen Standardwert definieren in Globale Variablen).

  • Hinzufügen: Klicken Sie auf das Link zum automatischen Erstellen der Klausel basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert. Die automatisch erstellte Klausel wird im unteren Textfeld angezeigt.

  Tipp

  Um der Klausel mehrere Bedingungen hinzuzufügen, wiederholen Sie den Vorgang, indem Sie weitere Auswahlmöglichkeiten 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 hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• 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. Wenn Sie eine WHERE-Klausel hinzugefügt haben, müssen Sie die Abfrage mit der Schaltfläche Abfrage testen testen, um die Schaltfläche Weiter zu aktivieren.

• Ä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.

Schritt 3: Überprüfen der Datenschemata

In diesem Schritt werden alle vom Endpoint generierten Anforderungs- oder Antwortschemata angezeigt:

• Datenschema: Das Schema wird 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.

  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 Query-Aktivität konfiguriert haben, können Sie sie wie unten beschrieben in einer Operation verwenden. Nachdem Sie eine 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 Query-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Sobald eine Salesforce -Abfrage-Aktivität 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 Query-Aktivitäten können mit diesen Operation als Quelle verwendet werden:

• Archivmuster
• Transformation
• Zwei-Ziel-Archivmuster (entweder als erste oder zweite Quelle)
• Zwei-Transformationsmuster (als erste oder zweite Quelle)

Wenn eine Salesforce -Abfrage als Quellaktivität verwendet wird, ist eine Zielaktivität erforderlich.

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 Query-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Operation Validity 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.