[Componentes] - Avançadas

Para que servem os componentes "Avançados"?

Os componentes contidos dentro do campo "Avançados" são componentes utilizados para fazer validações mais rebuscadas que não seriam facilmente feitas com as demais caixinhas ou então para encurtar validações que ficariam extensas quando feitas da maneira convencional.



  • Campo do Evento Condicional

O componente "Campo do Evento Condicional" permite simplificar as validações de "Se/Portanto" que utilizam um critério simples de comparação de texto ou número. Um exemplo seria no cenário em que deseja-se aprovar um determinado usuário com um CPF já conhecido. 

Os inputs necessários no componente são: Campo enviado na análise que deseja-se utilizar na comparação, qual é a comparação que deve ser feita (igual a ou então diferente de) e qual o valor que o campo deve ser comparado. Além disso, a caixinha aceita dois filhos: O primeiro filho é o componente que será executado caso a condição analisada retorne um valor "verdadeiro", já o segundo filho será executado quando a condição analisada retorne "falso".

Um exemplo de utilização seria:

Configuração da caixa "Campo do Evento Condicional" em que o documento do cliente está sendo analisado para verificar se é igual a "123.456.789-09". Aqui está um exemplo da estrutura analisada na árvore de regras, em que está sendo avaliado se o CPF do cliente é igual a "123.456.789-09". Se o CPF for igual ao dígito mencionado, o cliente será aprovado, caso contrário será reprovado.

  • Comparação de Campo do Evento

De modo alternativo ao componente de "Campo do Evento Condicional", é possível utilizar a caixinha de "Comparação de Campo do Evento" para fazer comparações simplificadas sem a necessidade de utilizar as caixinhas de comparação. O componente aceita comparações de "Igual a" e "Diferente de" baseado nos campos enviados na payload para análise. Um exemplo de preenchimento e utilização pode ser visto abaixo:

Configuração da caixa "Comparação de Campo do Evento" em que o documento do cliente está sendo analisado para verificar se é igual a "123.456.789-09". Este é um exemplo da estrutura que deve ser implementada para utilização da caixinha de Comparação de Campo do Evento.

  • Contador do Campo do Evento

O componente de "Contador do Campo de Evento" é utilizado para fazer uma contagem baseada em critérios definidos nas configurações da caixinha. É possível definir como critério os campos enviados na payload da análise, campos estáticos (valores já definidos, sejam eles digitados ou então alguma variável personalizada predefinida), status da análise e o período de tempo em que está sendo levado em conta. Além disso, caso não seja necessário match em 100% das variáveis ou constantes utilizadas, é possível definir quantas variáveis são o match mínimo aceitavel para que ocorra a contagem.

    • Configuração do componente

A configuração da caixinha de contado do Cmapo do Evento é um pouco mais complexa do que a das caixinhas triviais, e portanto está sendo dedicada uma sessão específica para apresentar o tema:


O primeiro campo disponível para edição ao iniciar a configuração do componente de "Contador de Campo do Evento" é justamente chamado "Campo", em que é possível selecionar uma variável da payload e definir esta variável como um dos critérios a ser analisado. No exemplo ao lado é selecionada a variável "Documento do Titular da Conta de Origem". Deste modo, toda transação que passar pelo motor de regras será analisada e a caixinha contará quantas vezes o titular daquela dada conta origem da transacção em questão transacionou. Caso seja necessário incluir mais uma variável como critério, é necessário clicar no botão "Adicionar Novo".
Este é um exemplo em que uma variável adicionar foi incluída como critério no componente. Neste cenário, somente ocorrerá a contagem quando forem localizadas transações no histórico em que tanto o documento do titular da conta origem quando o documento do titular da conta destino coincidam com os documentos envolvidos na transação analisada no momento presente.
Caso seja necessário, é também possível incluir um campo estático como critério para efetuar a contagem. No exemplo ao lado mantiveram-se os critérios de repetição de documento tanto do titular da conta origem quanto titular da conta destino porém foi incluído um novo critério como campo estático. Neste cenário, o critério incluído foi o sentido da transação, que deve ser somente "sent", ou seja, transações enviadas (cash out). Adicionando este critério, serão contadas todas as transações históricas em que o titular da conta de origem e o titular da conta de destino forem os mesmos da transação sendo avaliada no presente momento e que tiveram um fluxo de transação de cash out, independentemente de qual seja o fluxo da transação vigente. No cenário em que existam variáveis customizadas, é possível também utilizá-las como critério ao clicar no botão azul "123" ao lado do valor da variável.
Indo para baixo dentro da configuração do componente é possível escolher quantos campos deverão dar match para que ocorra a contagem. No exemplo ao lado ficou definido como "3", ou seja, todos os 3 critérios criados deverão coincidir para que haja a adição na contagem. Além disso foi definido que somente as transações Aprovadas automaticamente deverão ser contadas e o período levado em conta deverá ser de 7 dias.

 

Utilizando a configuração da caixinha que foi exemplificada na tabela acima têm-se os seguintes critérios:

  1. Documento do titular da conta origem;
  2. Documento do titular da conta destino;
  3. Fluxo da transação de cash out;
  4. Transações aprovadas automaticamente;
  5. Período analisado são os últimos 7 dias.

Caso ocorra um PIX que seja enviado para o motor de regras e seja detectada uma transação no histórico em que todos os critérios mencionados acima dêem match, a caixinha irá adicionar ao contador e gerar o output "1", sinzalizando que no histórico de 7 dias foi encontrada uma transação que todos os critérios coincidiram. Um exemplo de implementação do componente na regra é:


No exemplo acima, caso hajam mais de 5 transações no histórico que atendam todos os critérios mencionados previamente, a transação será reprovada, caso contrário será aprovada.

Um ponto importante é que a caixinha de contador não contabiliza a transação vigente, ela contabiliza somente o histórico transacional.