Модуль DB
DB модуль в APInita позволяет использовать локальную базу данных для операций записи, чтения, обновления и удаления строк:
Название шага - произвольное название, например "Читаем данные" или "Записываем данные".
База данных - название базы, предварительно созданной в разделе "Базы данных", с которой будет происходить взаимодействие;
Действие - действие, которое будет выполнено.
Рассмотрим каждое действие более детально.
Добавить строку
При добавлении строк возможно заполнение ячеек столбцов от A до Z. Максимальное количество символов в каждой ячейке равняется 100. Ячейки доступны для поиска и последующих операций чтения, обновления, удаления. В качестве ответа возвращается уникальный ID строки и значения ячеек A-Z.
Получить строки
Для чтения строк доступно 3 способа:
- Поиск строки по ID - поиск происходит по уникальному ID строки, указанному в поле "Значение";
- Поиск строк по значению столбцов - регистронезависимый поиск происходит по значениям столбцов используя условия заданные в поле "Значение". Например столбец a - имя, b - фамилия, с - дата рождения:
- Точное соответствие:
a == "Александр" - Отрицание "не":
a != "Александр" - Условие "или":
a == "Александр" or a == "Саша" - Условие "и":
a == "Александр" and b == "Петров" - Совмещенные условия:
(a == "Александр" or a == "Саша") and (b == "Петров" or c == "10.01.24")
- Точное соответствие:
- Получить строки (1-100) - выбираются строки из диапазона, указанному в поле "Значение". Указать можно как конкретное значение, например 10, так и диапазон, например 10-50.
Найденные данные возвращаются в массиве rows и ограничены 100 записями. Для большей выборки использется действие "Получить количество строк".
Выборка из таблицы - порядок чтения данных, с начала или конца таблицы.
Обновить строки
Для обновления строк действуют те же правила, что и для действия "Получить строки". Так же в данном действии присутствуют столбцы A-Z для обновления значений. Обновляются только заполненные столбцы. Чтобы стереть значение конкретного столбца, нужно указать значение NULL.
Удалить строки
Для удаления строк действуют те же правила, что и для действия "Получить строки". Удаляются строки, которые соответствуют установленной выборке.
Получить количество строк
Действие позволяет получить количество данных в базе и возвращает массив:
[
'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 адреса;