A tarefa searchRecods é usado para obter registros de um módulo personalizado, com critérios especificados e o nome do módulo.
<variable>=zoho.crm.searchRecords(<module_name>, <criteria>, <page>,<per_page>,<search_value>, <connection>);
<variable> especifica a resposta retornada pelo Zoho CRM. Ele representa os valores buscados no nomes da API e o seus respectivos campos.
<module_name> nome da API do módulo Zoho CRM de onde os registros serão obtidos.
<criteria> Declaração condicional com o seguinte formato:
(<colName>: <operator>: <colValue>)
O <colName> representa o nome do rótulo do campo CRM e <colValue> representa seu respectivo valor. O <operador> pode conter o seguinte:
equals
starts_with
Você pode pesquisar um máximo de 10 critérios (com colunas iguais ou diferentes) no formato:
((<colNome>: <operador>: <colValor>) e (<colNome>: <operador>: <colValor>) .. .)
Nota: Se uma coluna contém valores nulos, zoho.crm.searchRecords NÃO os relata em uma instrução <>.
<page>Obter a lista de registros com base nas página.
<per_page>Obter a lista de registros disponíveis por página.
<search_value> Pesquisa usando parâmetros.
Para pesquisar registros usando parâmetros além de critérios. As chaves aplicáveis são:
- converted: Para obter a lista de registros convertidos. Os valores aplicáveis para esta chave são:
– true: obtém apenas registros convertidos
– false: (valor padrão) – obtém apenas registros não convertidos
– both: obter todos os registros - approved: Para obter a lista de registros aprovados.
-true: (valor padrão) – obter apenas registros aprovados
-false: obtém apenas registros que não são aprovados
-both: obter todos os registros
<connection> Nome da conexão.
Pesquisar registros com um endereço de e-mail específico em um módulo personalizado
Buscando todos os registros com endereço de e-mail como @outsmart.com.br de um módulo personalizado denominado CurstomModule1 de fora do Zoho CRM
pesquisa = zoho.crm.searchRecords("Contacts", "Email:equals:@outsmart.com.br");
info pesquisa ;
return "";
<pesquisa> variável que conterá a resposta retornada pelo Zoho CRM. Representa os detalhes do registro solicitado
<Contacts>representa o nome do rótulo do módulo Zoho CRM, onde os registros ser serão pesquisados
<Email:equals:@outsmart.com.br> representa os critérios
Contas de pesquisa que começam com um alfabeto específico
O exemplo abaixo vai buscar todas a contas que começam com a letra ” C “.
pesquisa = zoho.crm.searchRecords("Accounts", "(Account_Name:starts_with:C)");
info pesquisa ;
return "";
<pesquisa> é a variável que conterá a resposta retornada pelo Zoho CRM. Representa os detalhes do registro solicitado.
<Accounts> é o texto que representa o nome do módulo Zoho CRM, onde os registros serão pesquisados.
<Account_Name:starts_with:C> texto que representa os critérios
Para obter o Website dos registros executamos um for each, conforme abaixo:
pesquisa = zoho.crm.searchRecords("Accounts", "(Account_Name:starts_with:C)");
for each registro in pesquisa
{
info registro.get("Website") ;
}