Rechercher les enregistrements

Compatibilité du projet

Windows | Multiplate-forme

Vue d'ensemble (Overview)

Description	méthode API	Chemin d'accès à l'API
Recherchez un ou plusieurs enregistrements d'un objet Salesforce standard ou personnalisé à l'aide de critères de filtre.	Obtenir	/rechercher des enregistrements

Entrée

Paramètre	Description	Type de données
Sélectionner un objet	Nom d'API de l'objet Salesforce à rechercher (standard ou personnalisé). Selon l'objet choisi dans ce champ, l'activité est remplie avec des champs de propriété spécifiques à cet objet.	string
Où	Ajoutez un filtre à l'aide du Générateur de filtres ou saisissez une expression SOQL OÙ. Par exemple : LastModifiedDate >= '2014-10-12'	string
Champs	Liste de champs séparés par des virgules à renvoyer dans la réponse	string
Inclure les suppressions	Indique si les enregistrements supprimés doivent être inclus dans les résultats de la recherche	boolean
Dernières valeurs Null	Indique si les enregistrements avec des valeurs Null doivent être triés en dernier	boolean
Trier par	Liste de champs séparés par des virgules par laquelle trier les résultats	string
Nombre maximal d’enregistrements	Nombre maximal d’enregistrements à renvoyer dans une seule réponse	Int32
Renvoyer le nombre total	Indique si le nombre total d’enregistrements correspondants doit être renvoyé	Integer

Sortie

Paramètre	Description	Type de données
Réponse	Rechercher les résultats contenant les enregistrements et les métadonnées Salesforce correspondants	Objet

Remarque :

• Dans les workflows d’API, un seul objet de réponse est renvoyé en tant que sortie. Tous les champs obligatoires peuvent être extraits directement de cet objet.
• Dans les workflows RPA, certains paramètres de sortie peuvent différer, mais les valeurs nécessaires peuvent toujours être récupérées à partir de l'objet de réponse même s'ils ne sont pas explicitement exposés.

Utilisation de la requête

Le CEQL (filtre « Où ») fournit un moyen standard de rechercher parmi tous les connecteurs. De nombreux fournisseurs d'API prennent en charge une forme de recherche dans leurs API, mais chacun aborde la recherche différemment. Plutôt que de vous demander de rechercher comment interroger chaque ressource auprès d’un fournisseur, nous avons normalisé votre expérience de recherche. Il traduit vos requêtes dans la syntaxe de recherche du fournisseur d'API. Vous composez des requêtes avec la sélection du champ des connecteurs de requête disponibles. Chaque connecteur autorise différents composants de la requête, mais dans la plupart des situations, vous pouvez utiliser des parties communes.

Référence de la requête

Composant de requête	Syntaxe	Exemple	Description
Requête CEQL l'expression « où »	1<field><operator><value> <AND/OR> 2<field><operator><value> 3...	Department!=’Procurement’ AND Name=’John’	L’expression ou les expressions spécifiant les éléments à rechercher et les objets à renvoyer dans notre ensemble de résultats. Reportez-vous à la section Opérateurs CEQL valides ci-dessous. Elle est constituée d'un côté gauche (LHS), d'un opérateur et d'un côté droit (RHS).

Opérateurs CEQL valides

Opérateur	Descriptions
AND	TRUE si toutes les conditions séparées par AND sont TRUE
OU	TRUE si l’une des conditions séparées par OR est TRUE
=	Égale à
!=	Pas égale à
<	inférieure à
>	supérieure à
<=	Inférieur ou égale
>=	Supérieur ou égal à
LIKE	TRUE si l'opérande correspond à un modèle
IN	TRUE si l'opérande est égal à l'un des éléments d'une liste d'expressions
IS NULL	TRUE si une valeur NULL est trouvée
LIMIT	Limiter le nombre d'enregistrements au nombre spécifié

Exemples

Opérateur	Exemple
Opérateur égal (=)	Name='Edge Communications'
Opérateur ET	Name=’Account Name’ AND Industry=’Electronics’
Opérateurs OU et Supérieur à (>)	LastModifiedDate>'2018-01-15T00:00:00.000Z' AND (Name='Account Name' OR Industry='Apparel')
Opérateur LIKE	Name LIKE 'Acc%'
Opérateur Supérieur ou égal à (>=)	AnnualRevenue >= 100000