Инструмент «Итератор»

Инструмент «Итератор» преобразует массив объектов (строки) в отдельные элементы. 

«Строки» — это неограниченный набор данных внутри какой-либо сущности. Например, у сделки в CRM-системе есть позиции товаров. Представьте, что в Albato приходит одна сделка, при этом у неё может быть неограниченное количество товаров. У каждой позиции свои одинаковые поля: название, количество и прочее. Все эти поля приходят одним массивом. 

Каждая такая позиция товара и называется «Строка», а все вместе они — «Строки».

В связках «Итератор» будет обрабатывать отдельно каждый элемент массива. То есть шаги, которые есть в связке после «Итератора», запустятся столько раз, сколько вы получили элементов в массиве. Также к каждой сущности можно будет применять другие инструменты Albato.

Какую проблему решает «Итератор»

Например, мы хотим для каждого товара из сделки в «Битрикс24» создавать новый товар в «МойСклад», используя действие «Новый товар», но мы не можем знать заранее, сколько будет товаров в сделке. 

Чтобы создать в «МойСклад» столько товаров, сколько есть в сделке в «Битрикс24», мы сделали инструмент «Итератор». Он преобразовывает объекты в отдельные сущности, позволяя работать с каждой по отдельности. 

Перед действием «Мой Склад “Новый товар”» мы добавим «Итератор». В зависимости от количества товаров в сделке «Битрикс24», будет вызываться следующий шаг «Мой Склад “Новый товар”».

В итоге, если мы получим в сделке 5 товаров, 5 раз запустится действие «МойСклад “Новый товар”», и будет создано 5 товаров.

Пример настройки «Итератора» на примере CoinMarketCap

Разберем на примере передачи данных с сайта по отслеживанию цен на криптовалюты CoinMarketCup в Telegram. Наша задача: получать данные об изменении цены на выбранные криптовалюты в Telegram, и с помощью инструментов Albato задать фильтр, который будет передавать данные только если цена изменилась больше чем на 1%

Настройка инструмента Итератор выполняется также, как настройка любого другого инструмента в Albato. 

Перед нужным шагом нажмём «+», выберем пункт «Инструмент» → «Итератор»:

В поле «Итерируемая строка» выберем стороковую секцию из предыдущего шага CoinMarketCup — «Получить курсы криптовалют», которую необходимо преобразовать/разбить на отдельные элементы — курсы одной валюты.

В шаге «Telegram» укажем, какие переменные нужно передавать при отправке сообщения.

Готово, теперь при получении новых данных будут отправляться сообщения в Telegram. 

Данные об изменении курса из CoinMarketCup приходят не в самом удобном формате — в виде обычных чисел.

Здесь поможет инструмент Albato «Математическая операция». В его настройках укажем, где применить математическую операцию, «тип округления» и количество символов после запятой. 

Теперь математическая операция применяется к каждому элементу в массиве, и мы получаем данные в более читабельном виде. 

Осталось перед шагом «Математическая операция» добавить инструмент «Прервать связку при условии», чтобы передавать данные в Telegram только если изменения будут больше чем на 1%

В настройках инструмента добавим 2 условия через «ИЛИ».

Сохраним настройки. Теперь можно запускать связку. Данные будут приходить только по тем криптовалютам, у которых изменение за последний час больше чем на 1%.