Инструменты

Инструментами в скриптах служат следующие блоки:

• Разгруппировать массив
• Ожидать обработку данных
• Вернуть данные
• Выполнить скрипт
• Фильтр

Разгруппировать массив

Блок разбирает массив на пакеты данных. Следующие блоки выполняются столько раз, сколько элементов внутри массива.

Служит для облегчения работы с массивами и позволяет использовать элементы массивов так, как если бы они были переменными. У блока одно поле для заполнения — массив (выбор из списка полученных данных на основе предыдущих блоков).

Пример:

1. В блоке в поле Массив на панели маппинга выбираем массив и нажимаем Тестировать. Данные массива отображаются в квадратных скобках.
2. На выходе получаем разгруппированные данные.

Ожидать обработку данных

Блок позволяет разделить скрипт на составные части, его составляющие не имеют доступа к данным друг друга. Он ждет окончания выполнения блоков столько раз, сколько необходимо при сборе данных до него, и запускает следующие один раз для расчета. Это позволяет сократить количество выполнений скрипта, а также поместить действия в один скрипт вместо нескольких.

Вернуть данные

Блок Вернуть данные возвращает данные в источник запроса. Работает с триггерами Ручной запуск и Вебхук.

Блок предназначен для получения данных из выполненных скриптов, запущенных вручную или с помощью Вебхука.

Параметры блока:

• формат запроса (JSON/текст)
• возвращаемые данные

При текстовом формате запроса возвращаемые данные указываются вручную или с помощью визуального маппинга. При JSON-формате запроса ключ необходимо ввести вручную, значение ключа можно указать вручную или маппингом.

При синхронном режиме работы блока Вебхук статус и данные, указанные в блоке Вернуть данные, при их наличии возвращаются сразу после выполнения скрипта.

Чтобы получить возвращаемые данные (при их наличии) при асинхронном режиме работы блока Вебхук, необходимо дождаться выполнения блока Вернуть данные и выполнить в инструменте GraphiQL указанный ниже GraphQL-запрос.

{
  automation{
    script{
      execution_result(uuid:"5053bb30-3eed-469c-a60a-7b554198ceee"){
        return_data
      }
    }
  }
}

Чтобы получить статусы при асинхронном режиме работы блока Вебхук, необходимо выполнить в инструменте GraphiQL указанный ниже GraphQL-запрос.

{
  automation{
    script{
      execution_result(uuid:"5053bb30-3eed-469c-a60a-7b554198ceee"){
        status
      }
    }
  }
}

Если в скрипт добавлено несколько блоков Вернуть данные, то срабатывает и возвращает данные в источник только первый из этих блоков.

Если скрипт с блоком Вернуть данные прекращает работу с ошибкой или останавливается, в источник возвращается информация о статусе выполнения.

Выполнить скрипт

Блок запускает выполнение выбранного скрипта.

Параметры:

• скрипт
• ожидаемые поля (если указаны в выбранном скрипте)

Родительский скрипт — это скрипт, который содержит блок Выполнить скрипт, запускающий выполнение дочернего скрипта. После запуска блок ожидает, когда дочерний скрипт полностью выполнится и вернет данные в родительский скрипт.

Блок возвращает информацию о выполнении дочернего скрипта:

• если дочерний скрипт выполнился успешно, но не возвращает данные, родительский скрипт получает только информацию о том, что дочерний скрипт выполнен
• если в дочернем скрипте возникает ошибка, родительский скрипт получает информацию об ошибке и останавливается

В качестве примера рассмотрим два скрипта:

• родительский скрипт «Отправить отчет», который отправляет ответственному лицу отчет с информацией о разнице между фактическими и плановыми продажами
• дочерний скрипт «Подсчитать отклонения», который рассчитывает отклонения фактических продаж от плановых по каждому магазину. Подсчет отклонений выделен в отдельный скрипт, чтобы к нему могли обращаться другие скрипты, а также для запуска из дашборда для отображения отклонений

Настроим эти скрипты:

1. Добавим в дочерний скрипт для подсчета отклонения в продажах блок Вернуть данные.
2. Настроим блок так, чтобы он возвращал идентификатор магазина и процент отклонения для тех магазинов, в которых отклонение от плановых продаж больше 20%.
3. Опубликуем дочерний скрипт.
4. В родительский скрипт добавим блок Выполнить скрипт.
5. В параметрах блока укажем дочерний скрипт.
6. Добавим блок Сформировать csv для формирования отчета.
7. В параметрах блока укажем нужные колонки и подставим в них данные с помощью маппинга. Также активируем переключатель Добавлять заголовки колонок
8. Протестируем блок.
9. Добавим в родительский скрипт блок Отправить письмо.
10. В параметрах блока укажем получателя, тему письма и сообщение.
11. Добавим в письмо отчет в виде вложения. Для этого подставим сформированный CSV-файл в соответствующее поле с помощью маппинга.
12. Опубликуем родительский скрипт и активируем его.
13. Видим, что скрипты выполнены: данные из дочернего скрипта переданы в родительский, отчет сформирован и отправлен.

Фильтр

Блок позволяет настроить логику скрипта и направить его по определенной ветке после проверки заданного условия.

Параметры:

• подключение (при обращении к БД)
• объекты сравнения
• условие

Чтобы настроить скрипт:

1. Укажите объекты сравнения в Поле.
2. Задайте условие фильтрации через выпадающий список.
3. Протестируйте блок с помощью кнопки Тестировать.

Чтобы добавить несколько условий для одной группы объектов, используйте кнопку И.

Чтобы создать дополнительную группу фильтров, используйте кнопку Или.

Чтобы удалить группу фильтров, нажмите кнопку Удалить.

Вы можете направить скрипт по нескольким веткам:

• чтобы добавить несколько условий и направить скрипт по разным веткам в зависимости от соответствия данных заданным условиям, добавьте в скрипт несколько блоков Фильтр
• чтобы направить по разным веткам скрипт с данными, полученными после проверки одного условия, сделайте нужное количество ответвлений от блока Фильтр

Для разных типов данных применимы разные условия:

Если выбранные типы условий невозможно сравнить, возникает ошибка.

Пример:

1. Указываем объекты сравнения и выбираем условие фильтрации в выпадающем списке.
2. Запускаем тестирование с помощью кнопки Тестировать. Все дальнейшие действия будут осуществляться с данными, полученными в результате фильтрации.
3. Добавляем блоки для дальнейшей работы с отфильтрованными данными.