Salesforce-Abfrageaktivität

Einführung

Eine Salesforce Abfrage-Aktivität, die ihre Salesforce-Verbindung verwendet, fragt Daten von Salesforce ab und ist dazu gedacht, als Quelle für Daten in einem Vorgang verwendet zu werden.

Erstellen einer Salesforce-Abfrageaktivität

Eine Instanz einer Salesforce Abfrage-Aktivität wird aus einer Salesforce-Verbindung unter Verwendung des Aktivitätstyps Abfrage erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene Salesforce Abfrage-Aktivität kann von diesen Orten aus bearbeitet werden:

• Der Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).

• Der Komponenten-Registerkarte im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Registerkarte).

Konfigurieren einer Salesforce-Abfrageaktivität

Befolgen Sie diese Schritte, um eine Salesforce Abfrage-Aktivität zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein und wählen Sie Objekte aus
  Geben Sie einen Namen für die Aktivität ein und wählen Sie das/die zu abfragenden Objekt(e) aus.

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

• Schritt 3: Überprüfen der Datenschemas
  Alle Anforderungs- oder Antwortschemas, die vom Endpunkt generiert werden, werden angezeigt.

Schritt 1: Geben Sie einen Namen ein und wählen Sie Objekte aus

In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen das/die zu abfragenden Objekt(e) aus.

• Name: Geben Sie einen Namen ein, um die Salesforce Abfrage-Aktivität zu identifizieren. Der Name muss für jede Salesforce Abfrage-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

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

  • Kopieren: Klicken Sie auf das Kopieren der Aktivitätskonfiguration-Symbol, um die vorhandene Konfiguration sowohl dieses Schrittes als auch Schritt 2 in Ihre 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 Einfügen der Aktivitätskonfiguration-Symbol, 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.

    Tipp

    Die Schaltflächen Kopieren und Einfügen können auch über verschiedene Instanzen der Salesforce Abfrage-Aktivität hinweg verwendet werden.

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

  • Suchen: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol , um Objekte vom Salesforce-Endpunkt neu zu laden. Dies ist nützlich, wenn Sie kürzlich Objekte zu Salesforce hinzugefügt haben, die in der Liste Objekt(e) auswählen noch nicht 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 zur Liste auf der rechten Seite hinzuzufügen. Es kann nur ein primäres Objekt aus der Liste auf der linken Seite ausgewählt werden.

    Hinweis

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

    • Die Salesforce-Verbindung könnte nicht erfolgreich sein. 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 den folgenden Fehler beim Abrufen von Daten während der Aktivitätskonfiguration verursachen:

      Ungültiger Benutzername, Passwort, Sicherheitstoken; oder Benutzer gesperrt. [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.

• Wählen Sie verwandte Objekt(e): Optional können Sie, um untergeordnete oder übergeordnete Objekte in die Abfrage einzubeziehen, das Kontrollkästchen neben jedem verwandten Objekt aktivieren. Dies wird als Beziehung-Abfrage bezeichnet.

  Hinweis

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

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol , um die Felder in den verwandten Objekten für diese Aktivität vom Salesforce-Endpunkt neu zu laden. Vorhandene Auswahlen in Wählen Sie verwandte Objekt(e) bleiben nur erhalten, wenn diese Objekte in Schritt 2 verwendet werden. Alle Objekte, die in Schritt 2 nicht verwendet werden, haben ihre Auswahl aufgehoben.

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

• Speichern & Beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Nächster Schritt: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

• Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht 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 Auswählen von Feldern und Festlegen von Bedingungen oder manuell durch direktes Eingeben einer Abfrageanweisung. Sie müssen die Abfrage testen, um sicherzustellen, dass sie gültig ist, bevor Sie zum nächsten Schritt fortfahren.

• Felder auswählen und Bedingungen erstellen: Dieser Abschnitt zeigt die Felder für das/die ausgewählte(n) Objekt(e), die im Salesforce-Endpunkt verfügbar sind. Objekte, die im vorherigen Schritt ausgewählt wurden, werden fett dargestellt.

  • Suchen: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Felder zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastendruck gefiltert.

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

  • Felder auswählen: Wählen Sie die Kontrollkästchen der Felder aus, die Sie in die Abfrage einbeziehen möchten, um sie automatisch zur SOQL-Anweisung auf der rechten Seite hinzuzufügen. Sofern 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 Abfrageanweisung 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. Für Informationen zur Strukturierung einer benutzerdefinierten SOQL-Anweisung siehe die Dokumentation von Salesforce zu SOQL SELECT-Syntax.

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

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

• Einfügen: Klicken Sie auf das Einfügen der Aktivitätskonfiguration-Symbol, um eine vorhandene Konfiguration einzufügen, die von 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.

  Tipp

  Die Schaltflächen Kopieren und Einfügen können auch in verschiedenen Instanzen der ServiceMax Abfrage-Aktivität verwendet werden.

• Abfrage testen: Klicken Sie auf diese Schaltfläche, um zu validieren, ob die Abfrage gültig ist. Wenn die Abfrage nicht gültig ist, werden relevante 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 untenstehenden Felder als Eingabe, um die Klausel zu erstellen, oder geben Sie die Klausel manuell im unteren Textfeld ein. Nach dem Hinzufügen einer WHERE-Klausel müssen Sie zuerst die Abfrage 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/die entsprechenden Operatoren auszuwählen. Die Liste der verfügbaren Operatoren hängt vom Datentyp des ausgewählten Feldes ab.

    Vergleich
    =	Gleich
    !=	Ungleich
    <	Weniger als
    <=	Weniger als oder gleich
    >	Größer als
    >=	Größer als oder gleich
    LIKE	Wie
    IN	IN
    NOT IN	NICHT IN
    INCLUDES	Gilt nur für Mehrfachauswahl-Listen
    EXCLUDES	Gilt nur für Mehrfachauswahl-Listen

    Logisch
    AND	WAHR, wenn sowohl der linke als auch der rechte Ausdruck WAHR sind
    OR	WAHR, wenn entweder der linke oder der rechte Ausdruck WAHR ist
    NOT	WAHR, wenn der rechte Ausdruck FALSCH ist

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

    Vorsicht

    Bei der 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 Testabfrage-Schaltfläche), da globale Variablen ihren Wert zur Laufzeit erhalten (siehe Definieren Sie einen Standardwert in Globalen Variablen).

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

  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.

• Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 3: Überprüfen der Datenschemas

In diesem Schritt werden alle Anforderungs- oder Antwortschemas, die von dem Endpunkt generiert wurden, angezeigt:

• Datenschema: Das Antwortdatenschema wird angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemas später während des Transformations-Mappings erneut angezeigt, wo Sie Zielfelder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

  Die Version der Salesforce-API, die verwendet wird, hängt von der Jitterbit-Agent-Version ab, die Sie verwenden. Siehe Voraussetzungen und unterstützte API-Versionen für Links zur Dokumentation über die Schemafelder.

  Hinweis

  Um ein Datenschema in einer bestehenden Aktivität zu aktualisieren, müssen Sie erneut durch jeden Konfigurationsschritt der Aktivität fortschreiten und mindestens eine Änderung vornehmen (z. B. ein Zeichen am Ende des Namens der Aktivität hinzufügen oder entfernen), um eine Aktualisierung des Schemas 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: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Salesforce Abfrage-Aktivität konfiguriert haben, können Sie diese in einem Vorgang verwenden, wie unten beschrieben. Nach dem Ausführen eines Vorgangs, der eine Salesforce-Aktivität auf einem privaten Agenten enthält, können Sie die Erfolgs- und Fehlermeldungsdateien des Vorgangs herunterladen.

Vorgang abschließen

Nachdem Sie eine Salesforce Abfrage-Aktivität konfiguriert haben, schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Werkzeuge als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Weitere Informationen finden Sie im Aktivitätsaktionsmenü in Connector-Grundlagen.

Salesforce Abfrage-Aktivitäten können als Quelle mit diesen Vorgangsmustern verwendet werden:

• Archivmuster
• Transformationsmuster
• Zwei-Ziel-Archivmuster (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.

Operationen, die eine Salesforce-Aktivität enthalten, können nur eine Salesforce-Aktivität haben und dürfen keine anderen Aktivitäten enthalten, außer denjenigen, die mit den API, Datenbank, Dateifreigabe, FTP, HTTP, Lokalen Speicher, Temporären Speicher oder Variablen verbunden sind.

Eine Salesforce-Aktivität kann nur als Schritt in einer einzigen Operation verwendet werden. Das bedeutet, dass Sie dieselbe Aktivität nicht mehrfach innerhalb anderer Operationen referenzieren können. Stattdessen können Sie eine Kopie einer Salesforce-Aktivität erstellen, um sie an anderer Stelle zu verwenden (siehe Komponentenwiederverwendung).

Andere Muster sind bei der Verwendung von Salesforce Abfrage-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite Betriebsvalidität.

Innerhalb einer Transformation, wenn die Option verwendet wird, ein Schema zu spiegeln, das von einer Nicht-Bulk-Salesforce-Aktivität bereitgestellt wird, wird das resultierende gespiegelte Schema automatisch mit einem zusätzlichen Wurzelknoten namens records erstellt, wobei die Kindknoten das Schema spiegeln. Wenn Felder innerhalb der Kindknoten zugeordnet werden, wird der Knoten zu einem Schleifenknoten, um alle Datensätze durchlaufen zu können (siehe Schleifenknoten unter Datenstrukturen).

Operationen, die Salesforce-Aktivitäten verwenden, können auch Betriebsaktionen konfiguriert haben, die bei einem SOAP-Fehler ausgelöst werden — einem Fehler, der aus einem falschen Nachrichtenformat, der Verarbeitung von Headern oder Inkompatibilität resultiert. Betriebsaktionen können so konfiguriert werden, dass sie eine Operation ausführen oder eine Email senden, nachdem ein SOAP-Fehler aufgetreten ist. Für Anweisungen zum Auslösen einer Aktion bei einem SOAP-Fehler siehe Betriebsaktionen.

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, deployen und führen Sie Sie die Operation aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.

Erfolgs- und Fehlermeldungsdateien anzeigen

Wenn Sie eine Operation mit einer Salesforce-Aktivität auf einem privaten Agenten ausführen, stehen Erfolgs- und Fehlermeldungsdateien zum Download auf der Seite für Laufzeitoperationen der Management-Konsole zur Verfügung. Wählen Sie die relevante Operation in der Tabelle Laufzeitoperationen aus und klicken Sie auf die Registerkarte Aktivitätsprotokolle im unteren Bereich des Bildschirms, um Download-Links für die Dateien anzuzeigen, sofern verfügbar:

• Erfolgsdatei herunterladen: Wenn Sie die Operation auf einem privaten Agenten ausführen, klicken Sie auf den Download-Link, um die Erfolgsdatensätze als CSV-Datei zu speichern.

• Fehlerdatei herunterladen: Wenn Sie die Operation auf einem privaten Agenten ausführen, klicken Sie auf den Download-Link, um die Fehlermeldungen als CSV-Datei zu speichern.