Модуль DB
DB модуль в APInita позволяет использовать локальную базу данных для операций записи, чтения, обновления и удаления строк:
Название шага - произвольное название, например "Читаем данные" или "Записываем данные".
База данных - название базы, предварительно созданной в разделе "Базы данных", с которой будет происходить взаимодействие;
Действие - действие, которое будет выполнено.
Рассмотрим каждое действие более детально.
Добавить строку
При добавлении строк возможно заполнить столбцы от A до Z. Максимальная длина каждого столбца равна 255 символов. Столбец A является доступным для поиска и последующих операций чтения, обновления, удаления. В качестве ответа возвращается уникальный ID строки и добавленные столбцы A-Z.
Получить строки
Для чтения строк доступно 3 способа:
- Поиск строки по ID - поиск происходит по уникальному ID строки, указанному в поле "Значение";
- Поиск строк по значению A столбц - поиск происходит по значению столбца A, указанному в поле "Значение";
- Получить строки (1-100) - выбираются строки из диапазона, указанному в поле "Значение". Указать можно как конкретное значение, например 10, так и диапазон, например 10-50.
Найденные данные возвращаются в массиве rows и ограничены 100 записями. Для большей выборки использется действие "Получить количество строк".
Выборка из таблицы - порядок чтения данных, с начала или конца таблицы.
Обновить строки
Для обновления строк действуют те же правила, что и для действия "Получить строки". Так же в данном действии присутствуют столбцы A-Z для обновления значений. Обновляются только заполненные столбцы. Чтобы стереть значение конкретного столбца, нужно указать значение NULL.
Удалить строки
Для удаления строк действуют те же правила, что и для действия "Получить строки". Удаляются строки, которые соответствуют установленной выборке.
Получить количество строк
Действие позволяет получить количество данных в базе и возвращает массив:
[
'a' => 'Иван',
'total' => 220,
'pages' => 3,
'iterator' => [
'1-100',
'100-100',
'200-100',
],
]Поле "Значение" - позволяет указать условие для выборки данных из столбца А.
Например, мы указали значение "Иван", поэтому в выходном массиве в ключе "a" видим значение "Иван", total отображает суммарное количество записей (220) с этим значением, pages - количество страниц (3) разделенных по 100, а iterator - сформированный массив, который можно передать в модуль Iterator для получения всех 220 записей, используя при этом действие "Получить строки (1-100)", подставляя значение из каждой новой итерации для получения записей с 1 по 100 (1-100), с 101 по 200 (100-100) и с 201 по 220 (200-100).
Другие модули
- HTTP - исходящий запрос;
- Webhook - входящий запрос;
- Response - ответ на входящий запрос;
- Iterator - цикл для работы с массиом (набором) данных;
- IF - создание условий;
- PHP - написание собственной логики обработки данных;
- JS - написание собственной логики обработки данных на языке JavaScript;
- Mail - отправка почты с Email адреса;