Programação de funções

Funções de programação

Deluge , ou Data Enriched Language for the Universal Grid Environment, é uma linguagem de criação de scripts on-line integrada ao Zoho Creator. Isso ajuda a adicionar diferentes tipos de lógica de negócios à função e a torná-los mais eficientes. Toda a camada de banco de dados é abstraída e você mapeia somente os argumentos com campos, enquanto cria os scripts no Deluge. Consulte também Deluge Script - Guia de referência

Público-alvo

  • Usuários de CRM com permissões Gerenciar automação
  • Programadores com conhecimento no Deluge Script

Disponibilidade

Permissão de perfil necessária: Gerenciar automação

Programar funções

A programação de funções no Deluge Script inclui as seguintes três etapas:

  • Programe uma função.
  • Associe uma função a uma regra de fluxo de trabalho.
  • Teste a integração da função.

Para programar uma função

  1. Vá para Configuração > Automação > Ações > Função.
  2. Na página Funções de Fluxo de Trabalho, clique em Configurar função.
  3. Na página Configurar função, clique no link Escrever sua própria função.
    Write your Custom Function
  4. Na página Funções personalizadas, conclua o seguinte:
    • Especifique o nome e a descrição da função.
    • Escolha o módulo a ser associado à função e clique no link Editar argumentos.
      Custom Function
    • Agora, mapeie o argumento com o nome do campo ou valor personalizado no módulo CRM.
      Custom Function
    • Clique em Concluído.
  5. Escreva a função desejada no Deluge Script Editor. Clique em Salvar & Executar Script para validar o código.
    Write your Deluge Script
    Se não houver erros, o script está pronto para ser associado à regra de fluxo de trabalho.
  6. Clique em Salvar.

Para associar uma função a uma regra de fluxo de trabalho

  1. Vá para Configuração > Automação > Regras de Fluxo de Trabalho.
  2. Na página Regras de Fluxo de Trabalho, clique em Criar Regra.
  3. Na guia Criar Nova Regra, especifique os parâmetros da regra de fluxo de trabalho.
  4. Selecione a função, em Ações Instantâneas.
  5. Agora, selecione a função a ser acionada.
  6. Clique em Salvar.

Para testar a integração da função

  1. Adicione dados de teste no CRM de acordo com os critérios da sua regra de fluxo de trabalho.
  2. Em seu aplicativo, verifique os dados recebidos do Zoho CRM pela função.
  3. Se houver um erro ou incompatibilidade de dados, modifique o código da função no Zoho CRM.
  4. Continue esse teste até obter os dados necessários do Zoho CRM para o seu aplicativo.

Notas importantes

  • Você pode associar até 6 funções (1 ação instantânea e 5 ações baseadas no tempo) por regra de fluxo de trabalho.
  • Você pode transferir dados para um máximo de 10 campos de CRM do Zoho CRM para aplicativos de terceiros usando a função.
  • É possível recuperar dados de outros aplicativos para o Zoho CRM usando funções.
  • Você deve atualizar o tíquete de API regularmente, de acordo com os limites de aplicativos de terceiros.
  • Você não receberá qualquer notificação de e-mail, se a integração da função parou de funcionar devido a qualquer problema em uma API de terceiros.
  • Se houver alguma falha no processo, a função, primeiro, enviará uma notificação então o sistema Zoho CRM enviará uma segunda notificação depois de 15 minutos. Depois disso, o sistema não enviará quaisquer notificações para esse acionador de fluxo de trabalho em particular.
  • Se você exceder a contagem máxima por dia, o sistema não enviará as notificações restantes da função para aplicativos de terceiros e notificará a falha ao administrador. 
  • O Zoho CRM enviará os dados no seguinte formato padrão para os campos Data e Date e Hora para aplicativos de terceiros:
    • Data: aaaa-MM-dd
    • Data e Hora: aaaa-MM-dd hh:mm

Compreensão do Deluge Script Builder

O Deluge Script Builder ajuda a programar funções usando uma interface do usuário de arrastar & soltar e a executar a função no CRM. Ele permite converter a complexa lógica do aplicativo em códigos simples do Deluge, sem lembrar a sintaxe e as funções de script do Deluge. Ele contém os seguintes componentes:

  • Código do Delug Script
  • Tarefas do Deluge
    • Condições
    • Diversos
    • Depurar
    • Manipulação de lista
    • Manipulação de mapa
    • Dados da Web
    • Manipulação de XML
  • Execução de códigos

Lista de tarefas do Deluge

Exemplo

Cenário de negócios: implemente o campo de valor na conta pai quando o potencial de status for "fechamento conquistado"

Resumo

Valor acumulado de cada potencial (o status é fechamento conquistado) até o campo Receita Total (campo personalizado) para a conta relacionada. Se o cliente comprar 10 vezes, você pode ver a receita total pela página Conta, em vez de puxar um relatório vinculando potenciais a contas. Com base na receita do cliente, depois, você pode classificá-los como clientes tipo A, tipo B ou tipo C.

Etapas de programação

void workflowspace.Rollup_the_Potential_Amount_to_Accounts(int AccountId, string SumUpField) 

  • void é o tipo de retorno que não retornará nada
  • workflowspace é o namespace no criador, como uma pasta para agrupar funções
  • Rollup_the_Potential_Amount_to_Accounts é o nome da função
  • AccountId é um parâmetro que mantém o ID de conta no CRM
  • SumUpField é outro parâmetro, o qual mantém o rótulo de campo na conta para a qual o valor da soma é atualizado durante o acionamento da regra de fluxo de trabalho.

{    accountID1 = (input.AccountId).toString();

  • Aqui estamos fundindo o ID da conta a uma string    

resp = zoho.crm.searchRecordsByPDC("Potentials", ("accountid"), accountID1);

  • Isso está integrado ao método do Deluge Script, o qual obterá os registros ao pesquisar os valores do campo.
  • Aqui especificamos para pesquisar o tipo de registro de potencial rgw que corresponda ao ID de conta com o valor transmitido como um parâmetro.    

total = 0.0;

  • Inicializando uma variável local para calcular a soma do valor.

for each rec in resp

  • Iteração de todos os potenciais retornados pela chamada de método acima.

{       

stage = (rec.get("Stage")).toLowerCase();

  • Buscando o valor do campo do estágio de cada potencial.

if (stage.contains("won"))

  • Verificando se o valor do estágio contém "conquistado" para cada potencial. Se verdadeiro, ele entrará na próxima linha, caso contrário, irá para o próximo potencial possível.

{           

total = (total  +  (rec.get("Amount")).toDecimal());

  • Agora, adicionando o valor do campo de quantidade à variável local       

}    }   

updateResp = zoho.crm.updateRecord(("Accounts"), accountID1, { input.SumUpField : total });

}

  • Esse método atualizará o registro no CRM. Mencionamos o tipo de registro como a conta que corresponde ao ID de conta do campo com o valor transmitido com a variável local, que atualmente mantém o valor somado.

Programa completo

void workflowspace.Rollup_the_Potential_Amount_to_Accounts(int AccountId, string SumUpField)
{
accountID1 = (input.AccountId).toString();
resp = zoho.crm.searchRecordsByPDC("Potentials", ("accountid"), accountID1);
info resp;
total = 0.0;
for each rec in resp
{
stage = (rec.get("Stage")).toLowerCase();
if (stage.contains("won"))
{
total = (total + (rec.get("Amount")).toDecimal());
}
}
updateResp = zoho.crm.updateRecord(("Accounts"), accountID1, { input.SumUpField : total });
}

Follow these steps to configure the function:

  1. Faça login no Zoho CRM.
  2. Vá para  Configuração > Automação > Regras de Fluxo de Trabalho.
  3. Selecione Negociações na lista suspensa Módulo. Insira o nome e a descrição para a regra de fluxo de trabalho.
    Custom Function
  4. Escolha quando deseja executar a regra. Selecione a opção Criar ou Editar sob a execução com base em uma ação de registro.
    Custom Function
  5. Clique em Concluído.
  6. Escolha para quais registros deseja executar a regra. Selecione a opção Registros Correspondentes à condição e defina o critério como "Estágio contém fechamentos conquistados"
    Custom Function
  7. Clique em Concluído.
  8. Agora, escolha a função como Ação Instantânea
    Custom Function
  9. Na janela pop-up Configurar função, clique no link Funções Personalizadas.
  10. Na página Funções Personalizadas, clique em Configurar para a função Implantar Valor de Potencial na Conta.
  11. Selecione Potencial como o módulo.
  12. Especifique os valores para os argumentos, conforme mencionado abaixo:
    • AccountId: escolha a coluna "AccountId" na lista de campos.
    • SumUpField: especifique o campo no módulo de contas para soma.
    • Clique no link "Especificar valor personalizado" e digite o nome de campo.
  13. Salve a configuração. Isto agora permitirá atualizar automaticamente a soma da receita gerada por todos os potenciais de uma conta no módulo da conta.

Share this post : FacebookTwitter

Ainda não consegue encontrar o que você está procurando?

Escreva para nós: support@zohocrm.com