Модуль DB
DB модуль в APInita позволяет использовать локальную базу данных для операций записи, чтения, обновления и удаления строк:
Название шага - произвольное название, например "Читаем данные" или "Записываем данные".
База данных - название базы, предварительно созданной в разделе "Базы данных", с которой будет происходить взаимодействие;
Действие - действие, которое будет выполнено.
Общая информация
Каждая база данных содержит в себе столбцы:
id - int, уникальный идентификатор строки;
created_at - datetime, дата и время создания записи;
updated_at - datetime, дата и время обновления записи;
a-j - string, 10 столбцов, текст, ограничение 100 символов ("Иван");
k–o - int, 5 столбцов, целые числа, ограничение до 11 цифр (11327);
p–t - float, 5 столбцов, дробные числа (0.25, 1958.00);
u–y - datetime, 5 столбцов, дата и время (2025-01-01 12:30:00);
z - text, длинный текст, ограничение до 5000 символов, только хранение информации;
search - используется в условии с оператором LIKE для поиска значений столбцов по вхождению ("Ивано*"), ограничение до 1000 символов.
Все столбцы, кроме z - имеют возможность фильтрации, а search - поиска. Доступные операторы: =, !=, <, >, <=, >=, AND, OR, LIKE. Каждое значение должно быть заключено в кавычки: "значение". Примеры:
- Точное соответствие (=):
a = "Александр" - Отрицание "не" (!=):
a != "Александр" - Условие "или" (or):
a = "Александр" OR a = "Саша" - Условие "и" (and):
a = "Александр" AND g = "Петров" - Условие "больше/меньше" (>/<):
k > 100 AND k < 150 - Совмещенные условия:
(a = "Александр" OR a = "Саша") AND (g = "Петров" OR u = "2025-01-01 12:30:00") -
Поиск по вхождению:
search LIKE "телефон AND куляко* OR прораб"
Возможен только один LIKE в условии. Скобки внутри значения недопустимы. Приоритет отдается оператору AND (сначала "телефон AND куляко*", потом "OR прораб"). Вхождение слов - от 3 символов, обозначается *.
В каждом действии, кроме добавления новой строки, присутствуют поля:
- Условие - заполняется при необходимости.
- Выборка из таблицы - порядок чтения данных, с начала или конца таблицы.
Добавить строку
При добавлении строк возможно заполнение ячеек столбцов от A до Z. В качестве ответа возвращается информация о созданном объекте.
Получить строки
Найденные данные возвращаются в массиве rows и ограничены 100 записями. Для большей выборки использется действие "Получить количество строк".
Обновить строки
Обновление данных столбцов по заданным условиям. Обновляются только заполненные столбцы. Возвращет rows массив в каждом из которых id обновленной записи.
Удалить строки
Удаление строк по заданном условию. Возвращет rows массив в каждом из которых id удаленной записи.
Получить количество строк
Действие позволяет получить количество данных в базе и возвращает массив:
[
'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). Пример условия:
a = "Иван" LIMIT 100, 200Другие модули
- HTTP - исходящий запрос;
- Webhook - входящий запрос;
- Response - ответ на входящий запрос;
- Iterator - цикл для работы с массиом (набором) данных;
- IF - создание условий;
- JS - написание собственной логики обработки данных на языке JavaScript;
- Mail - отправка почты с Email адреса;
- AI - взаимодействие с нейросетью и создание ИИ-ассистентов;
- PDF - генератор PDF документов;
