Iterador

A ferramenta Iterador pega um array de objetos e divide em elementos separados para que você possa trabalhar com cada um individualmente.

Na Albato, cada objeto de um array é chamado de "String". O próprio array é chamado de "Strings". Um exemplo típico: um negócio no CRM com vários itens de linha. Cada item é uma String, e a lista completa de itens é o array Strings.

Cada item tem seus próprios campos, nome, quantidade e outros, e todos chegam juntos em um único array.

Exemplo:

{
"dealName":"Deal 1",
"items": [
    {
"name":"Product 1",
"quantity":"2"
    },
    {
"name":"Product 2",
"quantity":"5"
    }
  ]
}

Quando você adiciona o Iterador à sua automação, ele processa cada elemento individualmente. Cada etapa após o Iterador é executada uma vez por elemento. Portanto, se o array tiver dois itens, essas etapas serão executadas duas vezes.

Você também pode adicionar outras ferramentas da Albato após o Iterador para processar cada elemento com mais detalhes.

Quando Devo Usar o Iterador?

Imagine que você quer criar um item no Inflow para cada produto de um pedido do Bitrix24. O problema é que você não sabe quantos produtos cada pedido terá.

Coloque o Iterador antes da etapa Novo Item do Inflow. O Iterador vai dividir o pedido em produtos individuais, e a etapa do Inflow será executada uma vez para cada um. Cinco produtos no pedido significa cinco itens criados no Inflow.

Como Configurar o Iterador

Exemplo: CoinMarketCap e Telegram

Queremos receber uma mensagem no Telegram quando o preço de uma criptomoeda mudar, mas somente se a mudança for maior que 1%.

Primeiro, crie uma automação com CoinMarketCap e Telegram.

Clique no botão + para adicionar uma ferramenta.

Selecione o Iterador na lista.

Escolha a string do CoinMarketCap que você deseja dividir em elementos separados.

Na etapa do Telegram, selecione as variáveis a incluir na mensagem.

A automação está conectada de ponta a ponta. Um problema: o CoinMarketCap envia os valores de variação de preço como números brutos com muitas casas decimais.

Adicione a ferramenta Operação Matemática após o Iterador e antes da etapa do Telegram.

Nas configurações, escolha onde aplicar a operação, defina o tipo de arredondamento e selecione o número de casas decimais.

Agora cada valor é arredondado antes de chegar ao Telegram.

Por último, adicione um filtro antes da etapa do Telegram para enviar a mensagem somente quando a variação de preço for superior a 1%.

Configure a condição do filtro desta forma.

Salve e execute a automação.

As mensagens chegaram somente para as moedas que tiveram variação superior a 1%.

Conclusão

Agora você pode usar o Iterador para lidar com arrays de qualquer tamanho em suas automações, pedidos, negócios, feeds de preços ou qualquer outra lista de objetos.

Se tiver alguma dúvida, entre em contato com nosso suporte pelo chat em help.albato.com.