Терминология Ants&Apps
Сценарий
Это последовательность действий, по которым будет осуществляться обработка ваших данных внутри Ants&Apps. Другими словами - алгоритм, который по шагам будет выполнять Ants&Apps, выполняя одно действие за другим.
Сценарий — это совокупность действий, где все начинается с триггера - инициатора действия. Точно также, когда вы выстраиваете маршрут на карте, и кнопка “В путь” - означает, что движение начато.
Карточка - шаг
Сценарий состоит из карточек - шагов. Каждый шаг выполняется Ants&Apps как отдельное действие, передавая какие-то входные данные и получая обработанные данные на выходе.
Например, шаг - “Действие - получить список входящих писем”.
Данные на входе — это информация о вашем аккаунте
Данные на выходе - список последних эмайл сообщений.
Также, карточка может быть и некий логический шаг, который выполняется внутри Ants&Apps, как например “Delay” (пауза)
Его данные на входе - время, на какое нужно отложить последующие карточки в сценарии
На выходе будет получено подтверждение, что пауза выполнена успешно.
Действие
Действием (action) в Ants&Apps называется такой шаг, в котором данные передаются или принимаются за пределы Ants&Apps. С технической стороны каждое такое действие осуществляется методом API (Application programming interface / программный интерфейс приложения) - и поэтому,
Действием можно назвать любой запрос к API.
Например, для получения данных какой-то таблицы Google Sheets, находящейся на вашем аккаунте, необходимо выполнить запрос к сервисам Google - который в результате вернет данные ее содержания.
Либо для того, чтобы отправить эмайл сообщение через Gmail (или другой системы) - Ants&Apps необходимо отправить запрос - команду в этот сервис.
Триггеры
Чтобы ваш сценарий был обработан Ants&Apps - что-то должно сообщить нам об этом. Для этого существуют инициаторы действия - так называемые Триггеры.
Триггер, это некое событие, которое возникает за пределами Ants&Apps. Например, публикация сообщения в социальной сети.
Обычно, большинство сценариев используют именно триггеры для начала своей работы.
На практике это означает следующее:
- Когда (триггер) было получено новое эмайл сообщение
- Выполнить какое-то действие.
Триггером может служить не только какое-то событие за пределами Ants&Apps, но также и внутреннее событие, например запуск сценария по расписанию или ручной запуск.
Внешние триггеры бывают двух видов: webhooks и встроенные.
Webhook
Многие современные веб сервисы (например, как Facebook, Trello, PayPal) - позволяют настроить возможность “подписаться на обновления”. Это означает, что при определенных настройках, вы можете подписаться и получать уведомления со стороны такого сервиса, как только это событие произошло.
Логично, что при публикации сообщения в Facebook, он первый знает, что такое событие произошло. И (если настроено) может передать данные об этом событии по указанному URL адресу.
Так происходит обмен между онлайн системами, где одна сообщает о новом событии, а принимающая сторона может теперь делать какие-то свои действия используя эту информацию в реальном времени.
Таким образом, webhook это такой формат триггера, где стороннее приложение самостоятельно сообщает Ants&Apps о новом событии.
Встроенный триггер (native trigger)
Также есть большое количество сервисов, которые не предоставляют собственную отправку событий в реальном времени - поэтому, следить за такими изменениями можно только со своей стороны.
Для этого, в Ants&Apps разработаны универсальные встроенные триггеры, которые вы можете настроить для любого сервиса и отслеживать изменения.
Технически, встроенный триггер работает следующим образом:
- С определенной периодичностью (например, 1 раз в минуту)
- Ants&Apps делает запрос (действие) для получения данных
- Если в этих данных были найдены изменения - то тогда триггер сработает и передаст найденные изменения на следующий шаг в вашем сценарии
Технически, Ants&Apps сравнивает известные данные предыдущего запроса с текущем - и на основании сравнения делает выводы.
Таких изменений может быть три вида:
- Insert (создать) - появилась новая запись / строка / эмайл, которого раньше не было
- Update (обновление) - такая запись была и раньше, но ее содержание теперь отличается
- Delete (удаление) - такая запись была раньше, но теперь она не найдена
Временной триггер (time schedule)
Это полезный триггер, когда нужно запускать сценарий с определенной периодичностью или по расписанию. Например, каждый час в рабочие дни или в каждый первый день месяца.
В настройках временного триггера вы указываете периодичность, в которую будет запускаться ваш сценарий.
Как только настоящее время совпадет с вашими настройками, сценарий будет запущен.
Ручной (click)
Часто бывают ситуации, в которых запуск сценария не зависит от какого-либо внешнего события, либо от времени. Задача заключается в том, чтобы просто запустить сценарий тогда, когда нужно.
Для этого используется ручной запуск “Click”.
Для того, чтобы запустить сценарий вручную, необходимо выбрать триггер “Click” и после того, как вы завершили настройку сценария - нажать кнопку “Run” на панели справа.
Сценарий запустится и будет отображать журнал событий (log), чтобы вы могли следить за процессом в реальном времени.
Приложение (App)
Ants&Apps это платформа, которая объединяет различные онлайн сервисы между собой. Такой способ коммуникации между онлайн приложениями называется API. Каждый такой сервис может быть различные ресурсы, из которых он состоит.
Например, Gmail — это не только почта, ваши входящие и исходящие эмайл сообщения, но и метки (labels) - которые тоже представляют из себя отдельных ресурс, из которого состоит Gmail.
С каждым таким ресурсом можно “коммуницировать” различными способами. Например, добавлять новые элементы, изменять их или удалять.
Карточка под названием App — это один интегрированный метод коммуникации со сторонним сервисом.
IF фильтр
Фильтр — это карточка, которая принимает значения и проверяет их по указанным вами настройкам.
Технически, фильтр принимает некое условие, например “это число больше, чем 10” и в качестве ответа выдает значение Да или Нет.
В Ants&Apps, эти значения отображаются как True (истина) или False (ложь), что очень удобно применять, когда вам нужно проверить какое-то значение.
Например, при получении данных, вы можете проверить находится ли дата в будущем или в прошлом. И на основании этой проверки - делать различные действия.
Iterator (итератор)
В Ants&Apps мы имеем дело с различными типами данных. Самые распространенные из них это - числа, строки (обычный текст), массивы (списки) и объекты (структурированные списки).
Например:
- Число — как 10 или десятично, как 5.25
- Строка — это просто текст, слово, словосочетание или даже большой длинный текст
Массивы:
- Это перечень элементов, собранный в “коллекцию”
- В программировании также называется, как array или list
- Альтернативно, массив можно воспринимать как спискок. Например - фрукты: банан, апельсин, яблоко. Все фрукты вместе — это массив.
Объекты:
- Это структурированный массив.
- В программировании называется, как object, array, dictionary
- Альтернативно, объект можно воспринимать как многоквартирный дом, где каждая квартира — это объект, обладающий атрибутами. Например - площадь, этаж, количество комнат и т.д. Следовательно, “дом” — это массив (в нем только квартиры), а каждая “квартира” — это объект (потому что имеет атрибуты)
Итератор в Ants&Apps применяется как к массивам, так и к объектам и позволяет сделать цикл обработки по каждому элементу.
На примере массива фруктов, итератор позволяет вам выполнять действия с каждым фруктом отдельно. Т.е. итератор на входе получает “фрукты”, а выдает только один фрукт.
Таким образом, если вам нужно обработать каждый фрукт (например, положить его в контейнер) то методом итератора, вы будете брать каждый фрукт отдельно и только его класть в контейнер.
Это работает точно также и с реальными данными. Например, у вас есть таблица Google Sheets, и ее данные — это строки. Следовательно, совокупность строк — это массив (в котором каждый элемент - это строка).
Используя итератор, получится, что вы будете выполнять действие по каждой строке отдельно.
Объекты, обрабатываются точно в таком же режиме, только имеют другие, структурированные, тем самым более сложные данные.
Пауза (Delay)
Полезный инструмент для того, чтобы сделать паузу внутри вашего сценария.
На практике нам не всегда нужно, чтобы весь сценарий сработал моментально. Обычно, требуется выполнить определенную задержку - сделать временную паузу перед тем, как продолжить.
Например, если вам приходят запросы на электронную почту, на них отвечают ваши коллеги, но чтобы не потерять связь с клиентом - ему можно отправить автоматический ответ, если в течение часа ему никто не ответил.
Это достижимо при помощи Паузы, которая технически “отложит” последующие шаги / действия на указанный срок и выполнит их через какое-то время.
Стоп (Stop)
Данное действие фактически означает остановку сценария. Эта полезная функция поможет вам не только экономить трафик, но и квоты вашего сценария.
Если в вашем сценарии используется итератор, который получает некий массив элементов и обрабатывает каждый из них с целью найти искомый, то после его нахождения, есть смысл остановить сценарий и перестать обрабатывать остальные элементы.
Например, если у вас есть массив “фрукты”, состоящий из «яблоко, апельсин и банан». И вам необходимо найти цитрус. То итератор будет обрабатывать каждый фрукт пока они не закончатся в этом списке. На самом деле, цитрус - апельсин был найден на втором месте и обрабатывать банан уже нет практического смысла. Следовательно, вы можете указать в сценарии что после успешного нахождения - выполнить команду Stop.
Строчные формулы (Inline-Formulas)
В Ants&Apps вы можете использовать строчные формулы для обработки данных, не создавая отдельные шаги для этого. Таким образом, ваш сценарий будет удобно читать и воспринимать его структуру.
Структура таких формул напоминает стандартные формулы Excel, которые можно использовать внутри ячеек таблицы.
В случае Ants&Apps - логика работы формул идентичная. Формулы можно указывать внутри ячейки настроек. И следовательно, преобразовывать данные так как это нужно для вашего сценария.
Например:
- При получении нового эмайл сообщения в Gmail
- Прибавить к дате письма 2 дня и создать мероприятия в Google Calendar
В данном примере прибавление дней к дате может быть осуществлено при помощи строчных формул, которые сделают эту работу.
Базовая структура личного кабинета и редактора сценариев (Ants&Apps Editor)
Dashboard
Домашняя страница личного кабинета, отображает главные показатели состояния вашего аккаунта в Ants&Apps.
What Do You Want to Automate Today? Вспомогательная форма, чтобы быстро создать сценарий из соединения двух приложений. Выберите два приложения, и нажмите кнопку “Create a new Ant Scenario”. В таком случае, Ants&Apps автоматически подготовит для вас сценарий, который вы сможете отредактировать перед запуском.
Секция “Current period usage” отображает ваш текущий тарифный план. Структура тарифных планов в Ants&Apps позволяет вам комбинировать разные тарифные планы в одно и тоже время. Это значит, что вы можете использовать платную подписку, и параллельно купить тариф “за результат” - оба тарифа будут использоваться последовательно. Ants&Apps будет использовать ваши доступные тарифы по принципу ближайшего завершения. Более подробно, в какой последовательности будут использоваться ваши активные планы, вы можете посмотреть в разделе - “Payments”.
“Latest runs” и “Upcoming schedules” отображают соответственно прошлые и будущие активности по вашим сценариям. При нажатии на кнопку Details вы можете открыть журнал записей (log), который покажет более подробную информацию, какие действия выполнил Ants&Apps в процессе обработки вашего сценария.
My Ants
Основной раздел личного кабинета, в котором находятся все ваши сценарии. Для удобства панель разделена на основные вкладки: Active, Drafts, Trash. Которые отображают соответственно: активные сценарии, черновики и удаленные.
Активные сценарии, это те сценарии, которые запущены и обрабатываются Ants&Apps. Когда сценарий находится в активном состоянии, возможность его редактирования отключена. Чтобы редактировать сценарий, предварительно его необходимо выключить. Данная мера безопасности создана для более корректной обработки данных.
Черновики - те сценарии, которые вы можете редактировать в любой момент и вносить изменения. Как только вы будете готовы его запустить, нажмите “ANT status = Running” в режиме редактирования.
Удаленные сценарии — это те, которые вы удалили. Однако, это не означает, что сценарий удален навсегда. Вы всегда можете восстановить сценарий нажав на кнопку Restore - тогда сценарий будет перемещен обратно в черновики. При нажатии на Destroy - сценарий будет удален навсегда и это действие невозможно отменить или вернуть.
Ant
Просмотр и редактирование сценария осуществляется в Ants&Apps Editor — это редактор сценария, в котором вы можете вносить изменения и менять настройки вашего сценария.
Структура Ants&Apps Editor разделена на следующие блоки:
Верхняя панель отображает возможность переключения в режим разработчика и запуск сценария в работу.
Центральная панель - отображает шаги вашего сценария, настройки каждого шага и возможность добавлять / удалять новые шаги.
Правая панель - вспомогательная, которая состоит из помощника, лога, и других элементов, которые будут полезны в работе со сценарием.
Шаги (карточки)
В начале работы с Ants&Apps Editor, либо при создании нового сценария, на центральной панели всегда будет доступно два основных шага - триггер и первое действие.
Вы можете изменять триггер и его настройки в любой момент. Для этого, нажмите иконку карандаша и выберите опцию “Replace Trigger”. Затем, можно выбрать триггер заново - тем самым, заменив его на любой другой.
Все последующие шаги — это действия, которые могут быть как внешние (API, actions), так и внутренние (Filters, Delay, Iterator ...). Для того, чтобы добавить новый шаг в ваш сценарий используйте иконку с символом плюс, которая всегда находится внизу карточек. Эта функция вставит новый шаг в ваш сценарий, на место которого вы можете выбрать то действие, которое необходимо для работы вашего сценария.
Карточки действий всегда можно удалить, нажав иконку карандаша и выбрав опцию “Delete”.
Также, на карточках триггера и действий всегда доступна вспомогательная функция - помощник, которая обозначается иконкой знака вопроса. При нажатии, на правой панели откроется помощник, который отобразит вспомогательную информацию о вашем текущем триггере или действии.
Помощник (helper)
Для использования помощника нажмите на иконку книжки на панели справа. Помощник — это вспомогательная информация о сценарии, конкретном действии в вашем сценарии, а также сопроводительная документация выбранного вами активности (action).
Альтернативно, помощник можно открыть, нажав на иконку знака вопроса на самой карточке шага сценария - это придаст помощнику контекст и он сможет ответить вам более точно на ваш вопрос.
Errors
Эта панель отображает общий статус вашего сценария. При нажатии, технически Ants&Apps проверяет правильность настроек каждого шага в вашем сценарии. И если были найдены какие-то ошибки, то вы увидите их в этой панели.
Log
Журнал записей. Отображает информацию о каждом выполнении сценария в прошлом. При помощи журнала вы можете посмотреть детализированную информацию о том, какие шаги выполнил Ants&Apps в процессе обработки вашего сценария.
Когда Ants&Apps выполняет ваш сценарий - каждый такой цикл записывается в лог. Внутри каждого цикла Ants&Apps выполняет действия по каждому шагу вашего сценария - и по каждому такому шагу записывает итоговую информацию об успешности его выполнения.
Run
Запуск — это специальный режим ручного запуска сценария. В случае, когда триггером вашего сценария является ручной Click, вы можете воспользоваться этой панелью, чтобы запустить сценарий в один клик.
При нажатии на кнопку Turn On в панели Run - сценарий будет запущен вручную и все записи журнала будут отображаться в реальном времени.
Found an Issue
Сообщение об ошибке — это форма обратной связи, при помощи которой вы можете написать в службу поддержки, если вы нашли какую-то ошибку в Ants&Apps.
Chat
Кнопка вызова чата. При нажатии откроет чат со специалистом.
Журнал записей (Log)
Журнал записей. Отображает информацию о циклах работы всех ваших сценариев. Здесь доступна вся информация о ходе обработки каждого цикла. Для более детального описания, нажмите кнопку Details напротив интересующего вас цикла.
Для наглядности, каждый цикл имеет свой статус. Это итоговое состояние, которое описывает конкретный цикл.
Статусы:
- Running - сценарий выполняется прямо сейчас
- Hibernated - сценарий в спящем режиме (как правило в случае использования функции Delay)
- Pending - в стадии ожидания - сценарий будет выполнен в будущем
- Finished, success - выполнение сценария успешно завершено и без ошибок
- Aborted manually - приостановлен вручную (при ручном запуске)
- Finished, errors - выполнение сценария завершено, но есть ошибки
Детализация (Detailed Log View)
На этой странице описано каждое действие, которое было обработано Ants&Apps во время цикла. По каждому шагу вашего сценария, Ants&Apps записывает информацию о результате выполнения, в том числе и об ошибках, если они были найдены в ходе работы.
Permissions
Раздел разрешения отображает информацию о ваших подключенных аккаунтах сторонних приложений. Т.е. те разрешения, которые в процессе добавления аккаунта, вы предоставили права Ants&Apps для выполнения действий от вашего лица.
Вы можете отозвать такие разрешения самостоятельно в любой момент. Для этого, нажмите на кнопку Revoke - которая удалит информацию о вашем разрешении и у Ants&Apps больше не будет доступа к вашим данным. При такой отмене, следует учитывать, что все связанные сценарии будут автоматически выключены.
Features Store
Есть сервисы, коммуникация с которыми осуществляется только на платной основе. Такие сервисы могут быть как Google Translate, Google Vision и многие другие. Т.е. сам сервис предоставляет возможность коммуникации с ним только на платной основе.
Чтобы воспользоваться такими дополнениями, изначально необходимо подключить нужные дополнения через Features Store.
Чтобы выбрать нужное вам дополнение, мы рекомендуем действовать с обратной стороны. Когда вы настроили такое платное действие в вашем сценарии, но на этот момент у вас оно не активировано - Ants&Apps выдаст сообщение об этом и поможет разобраться какую именно опцию нужно активировать.
В Features Store вы можете выбрать нужные для вашей работы дополнения и оформить их покупку прямо внутри личного кабинета Ants&Apps. Для этого отметьте галочками нужные дополнения, выберите количество и нажмите кнопку Продолжить.
Уточнение: в сфере онлайн сервисов, стоимость подобных действий, как правило составляет меньше цента за одно действие. Поэтому цены указаны не за одно действие, а за целый пакет. Который обычно включает от сотен до десятков тысяч действий.
My Account
Профиль. Возможность редактирования настроек вашего профиля и настройки пользователя.
На этой странице вы можете изменить формат отображения даты и времени, а также указать часовой пояс.
Payments
Данный раздел отображает всю информацию о ваших тарифных планах. Все тарифы отображаются в том порядке, в каком они будут расходоваться в процессе обработки ваших сценариев.
В случае, если у вас подключены и есть активные дополнения - они отобразятся справа.
Для покупки дополнительной подписки или тарифного плана за результат, воспользуйтесь панелью покупки - вверху страницы.
Какие есть виды тарифов и какой тариф выбрать вам?
Чтобы пользоваться Ants&Apps выберите тарифный план, который наиболее подходит для ваших задач. В зависимости от планируемого формата использования, вы можете выбирать как оплату за результат (pay as you go) либо подписку с установленным объемом действий (actions)
В Ants&Apps мы понимаем, что бизнес динамичен и задачи постоянно меняются. Именно для этого, мы разработали систему, в которой вы можете комбинировать тарифы между собой без ограничений.
Для тарифов free и subscription используются циклы. В начале каждого цикла, в зависимости от выбранного плана, вашему аккаунту присваиваются действия (actions), объем трафика и места. Цикл начинается с вашей даты начала его использования.
Free
Это бесплатный базовый тариф, который предоставляется каждому пользователю ежемесячно.
Т.е. независимо от того, используете вы какой либо из платных тарифов или нет, каждый месяц вы получаете дополнительные бесплатные действия (actions), объем трафика и места.
PAYG
Оплата за результат. Означает покупку определенного количества действий. Этот тарифный план идеально подходит в случае, если вы не планируете запускать сценарий по расписанию, или вы не хотите зависеть от ежемесячных платежей.
Этот тарифный план также является хорошим дополнением в комбинации с подпиской. Например, если в летний сезон у вас планируется повышение трафика и ваш сценарий будет работать чаще, то чтобы из-за этого не менять подписку и не переплачивать - вы можете скомпенсировать это докупив определенное дополнительное количество действий.
Subscription
Ежемесячная подписка на Ants&Apps лучше всего решает задачи полной автоматизации. Подписка сама по себе означает автоматическую ежемесячную оплату согласно выбранному тарифу.
Таким образом, вы можете полностью автоматизировать взаимодействие с Ants&Apps и продление использования сервиса будет происходить автоматически.