[Componentes] - Listas

Para que servem os componentes de "Listas"?

Os componentes contidos dentro do campo de "Listas" são componentes utilizados para atualizar ou para consumir os dados das listas criadas pelo usuário na aba de "Listas".

• Recuperar valor de Lista a partir do campo

O componente "Recuperar valor de Lista a partir do campo" serve para recuperarmos um dado contido na lista utilizando um determinado campo enviado para a análise como referência. Ao colocar a caixinha na árvore de regras e clicar na parte branca os campos passíveis de edição serão mostrados do lado esquerdo da tela, abaixo da listagem dos componentes, conforme imagem abaixo:

Conforme exemplificado, este componente serve para buscar um determinado valor (definido dentro do campo "Campo" da caixinha) em uma lista já criada pelo usuário (selecionada no campo "Lista"). O campo selecionado como referência para busca sempre será buscado na primeira coluna da lista, e caso localizado irá retornar o valor correspondente de uma determinada coluna (que deve ser selecionada no campo "Coluna Recuperada"). Segue um exemplo de utilização abaixo para contextualizar a aplicação em que deseja-se buscar o limite transacional de um cliente a partir de uma lista:

Configuração do componente de lista: O campo sendo buscado na Lista VIP de PIX é o CPF do cliente, e caso o documento seja encontrado iremos buscar e retornar o valor correspondente ao CPF do usuário.	A partir do momento que a caixinha esteja configurada, deseja-se verificar se o valor da transação é maior que o valor limite que está configurado na lista VIP. Caso seja, a transação será reprovada, caso contrário, será aprovada.

• Recuperar valor de Lista

Assim como o componente "Recuperar valor de Lista a partir do campo", o componente "Recuperar valor de Lista" serve para recuperarmos um dado contido na lista utilizando um determinado campo como referência. A principal diferença aqui é não não existe restrição à somente os campos enviados na payload, fazendo com que seja possível buscar por códigos de identificação que sejam customizados. 

Criando novamente um cenário hipotético em que deseja-se buscar o limite de um determinado cliente em uma VIP list de PIX, porém agora o campo identificador do cliente serão os campos de "documento do cliente" e "ID do cliente" concatenados. Neste cenário é possível buscar o limite na lista utilizando a caixinha "Recuperar valor de Lista" implenentando a seguinte estrutura:

Configuração do componente em que seleciona-se a Lista em que estamos buscando o dado e qual a coluna deseja-se que seja retornada.	Exemplo de implementação em que deseja-se verificar se o valor da transação é maior do que o limite do cliente. Para realizar a busca na lista está sendo utilizado como referência o valor de documento do cliente concatenado com o ID do cliente.

• Lista inclui:

O componente "Lista inclui" é utilizado quando deseja-se verificar se determinado dado existe ou não em uma dada lista. A configuração do componente é bastante simples e pede que seja referenciada somente qual lista deverá ser utilizada como base para a verificação, conforme exemplo abaixo:

Configuração do componente "Lista inclui", em que define-se qual lista será usada como referência na busca.	Neste cenário hipotético deseja-se verificar se o cliente que está sendo identificado pela combinação de "documento do cliente" e "ID do cliente" está contido em uma blocklist ou não. Desta maneira o input no componente de consulta na lista é a concatenação entre documento e ID.

Este componente é comumente utilizado para fazer a verificação se o cliente está contido em VIP List ou Blocklist. Além disso é de boa prática que, sempre que for utilizar as caixas de "Recuperar valor de lista" e "Recuperar valor de Lista a partir do campo" incluir anteriormente esta verificação se o usuário está incluso na lista ou não, como no exemplo abaixo:

Neste exemplo é possível verificar a implementação do componente "Lista Inclui" dentro do transacional, demonstrando uma boa prática.  

1. Primeiro verifica-se se o cliente consta ou não na lista VIP. Caso não conste, a transação do usuário será reprovada;
2. Caso o usuário esteja contido na lista VIP, será feita a segunda validação, que é buscar efetivamente o limite deste usuário dentro da lista VIP;
3. Se o valor da transação for maior que o valor do limite do usuário, a transação será reprovada. Caso o valor seja menor, a transação será aprovada.

• Lista inclui campos:

O componente "Lista inclui campos" é utilizado quando deseja-se verificar se determinado dado existe ou não em uma dada lista utilizando como referência um determinado campo enviado para a análise. A configuração do componente é bastante simples e pede que seja referenciada somente qual lista deverá ser utilizada como base para a verificação e qual campo dentre os enviados para a análise será utilizado como a chave de busca, conforme exemplo abaixo:

Neste exemplo deseja-se verificar se o documento do cliente está contido na lista VIP de PIX.	Assim como no exemplo implementado anteriormente, neste exemplo é feita a verificação se o documento do usuário está contido na lista VIP de PIX. Caso esteja contido, é feita a verificação se o valor da transação é maior que o limite do usuário. Se for, a transação é reprovada, caso contrário, a transação é aprovada.