Busca Registro com Critérios - zoho.crm.searchRecords

A tarefa searchRecords é usada para obter registros de um módulo personalizado, com critérios especificados e o nome do módulo.

Sintaxe

<variable> = zoho.crm.searchRecords(<module_name>, <criteria>, <page>, <per_page>, <search_value>, <connection>);

Parâmetros

• <variable> - Resposta retornada pelo Zoho CRM com os valores buscados
• <module_name> - Nome da API do módulo Zoho CRM
• <criteria> - Declaração condicional no formato: (<colName>:<operator>:<colValue>)
• <page> - Obter a lista de registros com base na página
• <per_page> - Número de registros disponíveis por página
• <search_value> - Pesquisa usando parâmetros adicionais
• <connection> - Nome da conexão

Operadores Disponíveis

• equals - Busca valores iguais
• starts_with - Busca valores que começam com

Parâmetros de Busca

• converted - Obter registros convertidos (true/false/both)
• approved - Obter registros aprovados (true/false/both)

Exemplo

// Buscar contatos pelo sobrenome
busca = zoho.crm.searchRecords("Contacts", "(Last_Name:equals:Silva)", 1, 10);
info busca;

// Buscar com múltiplos critérios
busca = zoho.crm.searchRecords("Contacts", "((Last_Name:equals:Silva) and (Email:starts_with:joao))", 1, 10);
info busca;

Nota: Você pode pesquisar um máximo de 10 critérios (com colunas iguais ou diferentes). Se uma coluna contém valores nulos, zoho.crm.searchRecords NÃO os relata em uma instrução <>.