Busca registro com critérios – zoho.crm.searchRecords

Busca registro com critérios – zoho.crm.searchRecords

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") ;
    }

Deixe um comentário