Модуль 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 документов;