Datensätze durchsuchen

Projektkompatibilität

Windows | Plattformübergreifend

Überblick

Beschreibung	API-Methode	API-Pfad
Suchen Sie einen oder mehrere Datensätze eines standardmäßigen oder benutzerdefinierten Salesforce-Objekts (z. B. Lead oder Opportunity) mithilfe von Filterkriterien.	Abrufen	/searchRecords

Eingabe

Parameter	Beschreibung	Datentyp
Objekt auswählen	API-Name des Salesforce-Objekts, das durchsucht werden soll (Standard oder benutzerdefiniert). Abhängig vom in diesem Feld ausgewählten Objekt wird die Aktivität mit Eigenschaftsfeldern aufgefüllt, die für dieses Objekt spezifisch sind.	string
Wo	Fügen Sie einen Filter mit dem Filtergenerator hinzu oder geben Sie einen SOQL where-Ausdruck ein. Zum Beispiel LastModifiedDate >= '2014-10-12'	string
Felder	Durch Kommas getrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen	string
Gelöschte einschließen	Gibt an, ob gelöschte Datensätze in die Suchergebnisse aufgenommen werden sollen	boolean
NULL zuletzt	Gibt an, ob Datensätze mit NULL-Werten zuletzt sortiert werden sollen	boolean
Sortieren nach	Kommagetrennte Liste von Feldern, nach denen die Ergebnisse sortiert werden sollen	string
Max. Datensätze	Maximale Anzahl von Datensätzen, die in einer einzelnen Antwort zurückgegeben werden sollen	Int32
Gesamtanzahl zurückgeben	Gibt an, ob die Gesamtzahl der übereinstimmenden Datensätze zurückgegeben werden soll	Integer

Ausgabe

Parameter	Beschreibung	Datentyp
Antwort	Suchergebnisse, die die übereinstimmenden Salesforce-Datensätze und -Metadaten enthalten	Objekt

Hinweis:

• In API-Workflows wird als Ausgabe ein einzelnes Antwortobjekt zurückgegeben. Alle Pflichtfelder können direkt aus diesem Objekt extrahiert werden.
• In RPA-Workflows können sich einige Ausgabeparameter unterscheiden, aber die erforderlichen Werte können weiterhin aus dem Antwortobjekt abgerufen werden, auch wenn sie nicht explizit verfügbar gemacht werden.

Verwenden der Abfrage

Der CEQL-Filter „Where“ bietet eine Standardmethode für die Suche über alle Connector hinweg. Viele API-Anbieter unterstützen eine bestimmte Form der Suche in ihren APIs, aber jeder hat einen anderen Ansatz für die Suche. Anstatt Sie recherchieren zu lassen, wie jede Ressource bei einem Anbieter abgefragt wird, haben wir Ihre Sucherfahrung normalisiert.

CEQL übersetzt Ihre Abfragen in die Suchsyntax des API-Anbieters. Sie erstellen Abfragen mit der verfügbaren Auswahl an Feldern für Abfrage-Connectors. Jeder Connector lässt unterschiedliche Komponenten der Abfrage zu, aber in den meisten Situationen können Sie einige gemeinsame Teile verwenden.

Abfragereferenz

Komponente abfragen	Syntax	Beispiel	Beschreibung
CEQL-Abfrage des " where -Ausdrucks	1<field><operator><value> <AND/OR> 2<field><operator><value> 3...	Department!='Procurement' AND Name='John'	Der Ausdruck oder die Ausdrücke, die angeben, was gesucht werden soll und welche Objekte in unserer Ergebnismenge zurückgegeben werden sollen. Siehe Abschnitt Gültige CEQL-Operatoren weiter unten. Sie besteht aus einer linken Seite (LHS), einem Operator und einer rechten Seite (RHS).

Gültige CEQL-Operatoren

Operator	Beschreibungen
AND	TRUE, wenn alle durch UND getrennten Bedingungen TRUE sind
ODER	TRUE, wenn eine der durch OR getrennten Bedingungen TRUE ist
=	gleich
!=	ungleich
<	weniger als
>	größer als
<=	weniger als oder gleich
>=	größer als oder gleich
LIKE	TRUE, wenn der Operand einem Muster entspricht
IN	TRUE, wenn der Operand gleich einem aus einer Liste von Ausdrücken
IS NULL	TRUE, wenn ein NULL-Wert gefunden wird
LIMIT	Anzahl der Datensätze auf die angegebene Anzahl begrenzen

Beispiele

Operator	Beispiel
Gleich-Operator (=)	Name='Edge Communications'
UND-Operator	Name=’Account Name’ AND Industry=’Electronics’
OR- und Größer-als-Operatoren (>)	LastModifiedDate>'2018-01-15T00:00:00.000Z' AND (Name='Account Name' OR Industry='Apparel')
LIKE-Operator	Name LIKE 'Acc%'
Größer als oder gleich (>=)-Operator	AnnualRevenue >= 100000