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.