Nesse artigo você encontrará as seguintes informações:
Introdução às ferramentas
Gatilhos
Função de incremento
Dormir
Definir variável
Definir várias variáveis
Obter Variável
Obter Variáveis Múltiplas
Agregadores
Transformadores
Nossa seção de ferramentas inclui vários módulos úteis que podem aprimorar seu cenário.
Gatilhos
Gatilho básico
Permite criar um gatilho personalizado e definir seus pacotes de entrada.
Bundle (pacote) | Crie pacotes personalizados adicionando itens de matriz. A matriz consiste nos pares name-value . |
Você pode usá-lo, por exemplo, para contatos ou qualquer outra lista programada para ser enviada para um endereço de e-mail especificado (módulos "E-mail > Enviar um e-mail", "Gmail > Enviar um e-mail") ou como um simples lembrete a ser acionado sempre que você querer.
Função "Increment"
Retorna um valor "incremented" (acrescentado) em 1 após a operação de cada módulo. É possível configurar o módulo para resetar o valor:
Depois de um ciclo;
Após a execução de um cenário;
Nunca.
Exemplo
Um dos usos do módulo é implementar uma chamada atribuição "Round Robin" de tarefas/leads/emails/etc para usuários em um grupo.
O algoritmo escolhe os designados de um grupo em alguma ordem lógica, geralmente indo do topo para o final de uma lista. Quando chega ao final, começa novamente no topo da lista e continua fazendo isso até terminar (como na distribuição de cartas de baralho).
O cenário a seguir envia um e-mail para o primeiro destinatário após cada execução de cenário ímpar e para o segundo destinatário após cada execução de cenário par.
Configure o módulo para nunca redefinir o valor.
Existem duas condições usadas após o módulo "router" (roteador):
1. Ímpar – defina a condição usando a função matemática do módulo que é igual a "1".
Não se esqueça de alterar o operador "Equal to" do padrão "Text operators" o "Numeric operators".
2. Par – defina a condição usando a função matemática do módulo que é igual a "0".
Dormir
Permite atrasar o fluxo do cenário em até 300 segundos (5 minutos).
Delay (atraso) | Insira o número de segundos que o cenário será pausado. |
Esta função pode ser útil, por exemplo, se você deseja reduzir a carga do servidor de serviço de destino, simular um comportamento mais humano ao enviar SMS ou e-mails em massa.
Se você deseja pausar o fluxo por períodos de tempo mais longos, sugerimos dividir seu cenário em dois cenários:
O primeiro cenário hospedaria a parte antes da pausa;
O segundo cenário hospedaria a parte depois dela.
O primeiro cenário armazenaria todas as informações necessárias, junto com o registro de data e hora atual. O segundo cenário verificaria, periodicamente, o armazenamento de dados em busca de registros com carimbo de data/hora, anterior ao atraso pretendido, recuperaria os registros, finalizaria o processamento dos dados e removeria os registros do armazenamento de dados.
Definir variável
Cria uma variável que pode ser mapeada por outros módulos na rota ou pelo módulo "Get Variable" para cada rota do cenário.
Variable name (nome variável) | Digite o nome da variável. Este nome será exibido ao mapear a variável em outros módulos. |
Variable lifetime (vida útil variável) | One cycle (um ciclo) A variável é válida apenas para um ciclo. Útil quando vários webhooks em uma execução de cenário são recebidos (mais webhooks = mais ciclos).
One execution (uma execução) A variável é válida para uma execução. Uma execução pode conter mais ciclos. |
Variable value (valor variável) | Insira o valor da variável. |
Definir várias variáveis
Cria múltiplas variáveis que podem ser mapeadas por outros módulos na rota ou pelo módulo "Get Multiple Variables" para cada rota no cenário em uma única operação.
Os principais benefícios do módulo Definir múltiplas variáveis são:
Um módulo "Set multiple variables" pode substituir toda uma série de módulos "Set variable".
Um módulo "Set multiple variables" consome apenas uma única operação.
Variables | Adicione várias variáveis que você deseja definir.
Variable name Digite o nome da variável. Este nome será exibido ao mapear a variável em outros módulos.
Variable value Insira o valor da variável. |
Variable lifetime | One cycle A variável é válida apenas para um ciclo. Útil quando vários webhooks em uma execução de cenário são recebidos (mais webhooks = mais ciclos).
One execution A variável é válida para uma execução. Uma execução pode conter mais ciclos. |
Possíveis usos dos módulos "Set/Get (múltiplos) variáveis":
Para armazenar um valor calculado para uso posterior, mesmo em uma rota diferente. Especialmente nos casos em que o valor é usado em vários módulos e a fórmula para calcular o valor é excessivamente complexa.
Para depurar uma fórmula. Se uma fórmula usada em um módulo não fornecer um resultado correto, copie a fórmula e cole-a em um módulo "Set Variable" que você insere antes do módulo relevante. Desconecte o(s) módulo(s) após o módulo "Set Variable" e execute o cenário. Verifique a saída do módulo "Set Variable", ajuste/simplifique a fórmula, execute o cenário novamente e continue até que o problema seja resolvido.
Obter Variável
Recupera um valor que foi criado, anteriormente, pelo módulo "Set Variable".
Observe que este módulo pode ler uma variável que foi definida em qualquer lugar do cenário. O único requisito é que o módulo Tools > "Set Variable" seja executado antes (tempo) do módulo Tools > "Get Variable".
Consulte a documentação do módulo Roteador para obter informações sobre a ordem em que as rotas são processadas.
Obter Variáveis Múltiplas
Recupera valores que foram criados anteriormente pelo módulo "Set Multiple Variables" em uma única operação.
Os principais benefícios do módulo Definir múltiplas variáveis são:
Um módulo "Get multiple variables" pode substituir toda uma série de módulos "Get variables".
Um módulo "Get multiple variables" consome apenas uma única operação.
Variables | Adicione várias variáveis que deseja obter.
Variable name Mapeie a variação do nome da variável que você deseja obter. |
Possíveis usos dos módulos "Set/Get (múltiplos) variáveis":
Para armazenar um valor calculado para uso posterior, mesmo em uma rota diferente. Especialmente nos casos em que o valor é usado em vários módulos e a fórmula para calcular o valor é excessivamente complexa.
Para depurar uma fórmula. Se uma fórmula usada em um módulo não fornecer um resultado correto, copie a fórmula e cole-a em um módulo "Set Variable" que você insere antes do módulo relevante. Desconecte o(s) módulo(s) após o módulo "Set Variable" e execute o cenário. Verifique a saída do módulo "Set Variable", ajuste/simplifique a fórmula, execute o cenário novamente e continue até que o problema seja resolvido.
Agregators
Table Aggregator (agregador de tabela)
Mescla valores dos campos selecionados de pacotes recebidos em um único pacote usando uma coluna especificada e um separador de linha (que permite criar uma tabela).
Source module | Selecione o módulo do qual você deseja agregar campos. |
Aggregated fields | Selecione os campos do módulo selecionado acima, cujos valores você deseja agregar em um pacote. |
Column separator | Selecione ou insira o tipo de separador que separará as colunas de valor do campo no pacote resultante. |
Row separator | Selecione ou insira o tipo de separador que separará as linhas de valor do campo no pacote resultante. |
Group by | Defina uma expressão contendo um ou mais itens mapeados. Os dados agregados serão então separados em Grupos com o mesmo valor da expressão.
Cada grupo gera um pacote separado contendo uma chave com a expressão avaliada e o texto agregado. Ao fazer isso, você pode usar a "Key" como um filtro nos módulos subsequentes. |
Text Aggregator (agregador de texto)
Mescla valores dos campos selecionados de pacotes recebidos em um único pacote.
Exemplo
Você pode usar a ferramenta agregadora de texto para inserir mais valores (por exemplo, nomes de clientes ou notas) em um único pacote e enviar um e-mail contendo todos os valores no corpo do e-mail ou no assunto do e-mail.
Agregador Numérico (numeric Aggregator)
Este módulo permite recuperar valores numéricos, aplicar uma das funções selecionadas (SUM, AVG, COUNT, MAX,...) e retornar o resultado em um pacote.
Exemplo
O módulo soma os valores sob o parâmetro de número.
Transformers (transformadores)
Compor uma String
Converte qualquer valor em um tipo de dados string (texto). Isso torna o mapeamento mais fácil ao mapear dados binários, por exemplo.
Converter a Encoding of the Text (codificação do texto)
Converte o texto de entrada inserido (ou dados binários) na codificação selecionada.
Input data | Digite o conteúdo que você deseja converter. |
Input data codepage | Digite o tipo de codificação de dados de entrada. Isso é importante para a forma binária dos dados. |
Output data codepage | Selecione a codificação de destino de seus dados. |
Switch
Verifica o valor de entrada para uma correspondência com a lista de valores fornecida. Retorna a saída com base no resultado.
Input | Insira a expressão que deseja avaliar. |
Cases | Se a entrada contiver um valor inserido no campo "Pattern", o valor inserido no campo "Output" será retornado. Se a condição não for atendida, nenhuma saída será retornada OU o valor do campo "Else" (abaixo) será retornado. |
Else | Insira o valor que é retornado quando os critérios definidos no campo "Cases" não são atendidos. |
Executar um Cenário
Status: "PLANNED" - consulte a seção "Solução alternativa" abaixo.
Solução alternativa
Empregue o módulo HTTP > "Make a request" no cenário principal para chamar o outro cenário. Empregue o módulo Webhooks > "Custom webhook" no outro cenário para receber a chamada. Empregue o módulo Webhooks > "Webhook response" no outro cenário para retornar a resposta.
Parar / Lançar (um erro)
Em alguns casos, você pode querer interromper forçosamente a execução do cenário após a fase de reversão ou confirmação. Ou também interromper o processamento de uma rota e, opcionalmente, armazená-la na fila de execuções incompletas.
Pronto! Agora você já sabe tudo sobre as ferramentas do Toolzz Connect.