Buscar Registros

Compatibilidad de proyectos

Windows | Multiplataforma

Información general

Descripción	método API	Ruta de la API
Busca uno o más registros de un objeto de Salesforce estándar o personalizado (por ejemplo, Cliente potencial u Oportunidad) utilizando criterios de filtro.	Obtener	/buscarRegistros

Entrada

Parámetro	Descripción	Tipo de datos
Seleccionar objeto	Nombre de la API del objeto de Salesforce en el que buscar (estándar o personalizado). Dependiendo del objeto elegido en este campo, la actividad se rellena con campos de propiedad específicos de ese objeto.	String
Dónde	Añade un filtro utilizando el Creador de filtros o escribe una expresión SOQL WHERE. Por ejemplo, LastModifiedDate >= '2014-10-12'	String
Campos	Lista de campos separados por comas que se devolverán en la respuesta	String
IncluirEliminados	Indica si los registros eliminados deben incluirse en los resultados de la búsqueda	Booleano
Últimos valores nulos	Indica si los registros con valores nulos deben ordenarse en último lugar	Booleano
Ordenar por	Lista de campos separados por comas para ordenar los resultados	String
Máximo de registros	Número máximo de registros que se devolverán en una sola respuesta	Int32
Devolver recuento total	Indica si se debe devolver el número total de registros coincidentes	Entero

Salida

Parámetro	Descripción	Tipo de datos
Respuesta	Resultados de búsqueda que contienen los registros y metadatos de Salesforce coincidentes	Objeto

Nota:

• En los flujos de trabajo de la API, se devuelve un único objeto de respuesta como salida. Cualquier campo obligatorio puede extraerse directamente de este objeto.
• En los flujos de trabajo de RPA, algunos parámetros de salida pueden diferir, pero los valores necesarios pueden recuperarse del objeto de respuesta incluso si no se exponen explícitamente.

Uso de la consulta

El CEQL (filtro "Dónde") proporciona una forma estándar de buscar en todos los conectores. Muchos proveedores de API admiten algún tipo de búsqueda en sus API, pero cada uno aborda la búsqueda de manera diferente. En lugar de pedirle que investigue cómo consultar cada recurso en un proveedor, hemos normalizado su experiencia de búsqueda. Traduce tus consultas a la sintaxis de búsqueda del proveedor de la API. Las consultas se crean con la selección de campos de conectores de consultas disponibles. Cada conector permite diferentes componentes de la consulta, pero en la mayoría de las situaciones puedes usar algunas partes comunes.

Referencia de consulta

Componente de la consulta	Sintaxis	Ejemplo	Descripción
CEQL consulta la expresión "dónde"	1<field><operator><value> <AND/OR> 2<field><operator><value> 3...	Departamento! = 'Adquisiciones' AND Nombre = 'John'	La expresión o expresiones que especifican qué buscar y qué objetos devolver en nuestro conjunto de resultados. Consulta la sección Operadores CEQL válidos a continuación. Se compone de un lado izquierdo (LHS), un operador y un lado derecho (RHS).

Operadores CEQL válidos

Operador	Descripciones
AND	VERDADERO si todas las condiciones separadas por Y son VERDADERAS
O	VERDADERO si alguna de las condiciones separadas por OR es VERDADERA
=	Igual a
!=	No es igual a
<	Menor que
>	mayor que
<=	menor que o igual a
>=	mayor que o igual a
LIKE	VERDADERO si el operando coincide con un patrón
IN	VERDADERO si el operando es igual a uno en una lista de expresiones
IS NULL	VERDADERO si se encuentra un valor NULL
LIMIT	Limitar el número de registros al número especificado

Ejemplos

Operador	Ejemplo
Operador igual (=)	Name='Edge Communications'
Operador AND	Name=’Account Name’ AND Industry=’Electronics’
Operadores OR y mayor que (>)	LastModifiedDate>'2018-01-15T00:00:00.000Z' AND (Name='Account Name' OR Industry='Apparel')
Operador LIKE	Name LIKE 'Acc%'
Operador mayor que o igual a (> =)	AnnualRevenue >= 100000