# Интеграция Baserow с ToolJet - визуальные приложения на API

> Без единой строки бэкенд-кода ToolJet подключается к Baserow через REST API и database-токен: собираем формы, таблицы и запросы CRUD за минуты, а не недели.

Source: https://opennix.org/docs/baserow/integrations/tooljet/


ToolJet - open-source low-code платформа для сборки внутренних приложений и админ-панелей; подключение к Baserow идёт через обычный REST API и database (API) токен, поэтому формы, таблицы и запросы CRUD над данными Baserow собираются визуально, без написания серверного кода и без Premium-функций.

## Зачем подключать ToolJet к Baserow

ToolJet ускоряет сборку внутренних инструментов: формы ввода данных, экраны со статусами заявок, простые CRM и системы учёта - вместо недель разработки уходят часы, потому что запросы к Baserow настраиваются в визуальном редакторе, а не пишутся вручную. Подключение работает по тому же принципу, что и другие интеграции Baserow: [database (API) токен](/docs/baserow/webhook-api/personal-api-tokens/) открывает доступ к REST API, и ToolJet обращается к таблицам обычными HTTP-запросами.

## Что потребуется

- Аккаунт Baserow (облачный или self-hosted).
- Аккаунт ToolJet Cloud или локальная установка ToolJet.
- [Database (API) токен](/docs/baserow/webhook-api/personal-api-tokens/) Baserow с доступом к нужной базе.
- [Идентификаторы таблиц](/docs/baserow/webhook-api/database-and-table-id/), к которым нужен доступ.

## Поддерживаемые операции

ToolJet предоставляет полный набор CRUD-операций (создание, чтение, изменение, удаление) для таблиц Baserow:

| Операция | Что делает | Типичный сценарий |
|---|---|---|
| **List fields** | Возвращает названия и типы всех полей таблицы | Динамические формы, проверка схемы данных |
| **List rows** | Возвращает строки таблицы с опциональными фильтрами | Отображение данных в таблицах, отчёты |
| **Get row** | Возвращает конкретную строку по идентификатору | Детальный просмотр записи, форма редактирования |
| **Create row** | Добавляет новую строку в таблицу | Отправка форм, создание записей |
| **Update row** | Изменяет существующую строку | Редактирование записей, смена статусов |
| **Move row** | Меняет позицию строки в таблице | Изменение порядка задач, приоритеты |
| **Delete row** | Удаляет строку из таблицы | Архивирование записей, очистка данных |

### Обязательные параметры

- **Table ID** - находится в [документации Baserow REST API](/docs/baserow/webhook-api/database-api/) для конкретной базы.
- **Row ID** - уникальный идентификатор [строки](/docs/baserow/rows/overview-of-rows/).
- **Before ID** (только для Move row) - идентификатор строки, перед которой нужно вставить перемещаемую; пусто значит переместить в конец.
- **Records** - значения полей в формате JSON (для Create row и Update row).

## Как подключить Baserow к ToolJet

### Шаг 1. Добавление Baserow как источника данных

1. В конструкторе приложений ToolJet откройте вкладку **Data sources** в левой боковой панели.
2. Найдите **Baserow** в модальном окне выбора источника данных и выберите его.
3. Выберите окружение - Development, Staging или Production.
4. Вставьте [database (API) токен](/docs/baserow/webhook-api/personal-api-tokens/) Baserow.
5. Укажите тип установки Baserow:
   - **Baserow Cloud** - для аккаунта на baserow.io.
   - **Self-Host** - укажите базовый URL своего инстанса (например, `https://api.yourcompany.com`).
6. Нажмите **Save**, чтобы сохранить подключение.

ToolJet шифрует чувствительные поля, включая API-токен, перед сохранением в собственной базе данных.

### Шаг 2. Создание запросов к Baserow

Запрос выполняет одну операцию - получение строк, создание строки и так далее:

1. В панели редактора запросов нажмите значок **+** и выберите сохранённый источник данных Baserow.
2. Выберите операцию из выпадающего списка и заполните нужные параметры (Table ID, Row ID и другие).
3. Нажмите **Run**, чтобы проверить запрос, и посмотрите ответ в панели предпросмотра.
4. Свяжите результат запроса с таблицей, формой или графиком компонента; запускайте запрос по клику на кнопку или отправке формы.

## Примеры типовых запросов

### Получение всех строк таблицы

Операция **List rows** с идентификатором таблицы и, при необходимости, параметрами фильтрации и сортировки - подходит для заполнения таблиц и выпадающих списков в интерфейсе.

![Запрос List rows к таблице Baserow в конструкторе ToolJet](/images/baserow/integrations/tooljet-list-rows.png)

### Создание новой записи из формы

Операция **Create row** с идентификатором целевой таблицы; значения полей записи сопоставляются с полями формы через привязку вида `{{ components.form1.data }}` - так форма сохраняет данные напрямую в Baserow.

![Запрос Create row в ToolJet с полями формы, привязанными к записи Baserow](/images/baserow/integrations/tooljet-create-row.png)

### Изменение записи по действию пользователя

Операция **Update row** с идентификатором таблицы и идентификатором строки вида `{{ table1.selectedRow.id }}`; в Records указываются только те поля, которые нужно изменить.

![Запрос Update row в ToolJet с привязкой к выбранной строке Baserow](/images/baserow/integrations/tooljet-update-row.png)

### Удаление выбранных записей

Операция **Delete row** с идентификатором таблицы и идентификатором строки вида `{{ table1.selectedRow.id }}` - обычно привязывается к кнопке удаления с подтверждением.

## Сценарии использования

- **CRM для отдела продаж** - учёт контактов, сделок и истории активности поверх данных Baserow, с подключением почтовых сервисов и календарей.
- **Экран учёта заявок** - интерфейс поддержки, где сотрудники видят, назначают и закрывают тикеты, хранящиеся в Baserow.
- **Учёт складских остатков** - отслеживание запасов, обработка заказов и работа с поставщиками, с подключением внешних API доставки и оплаты.
- **Внутренние отчётные экраны** - вывод ключевых показателей из нескольких таблиц Baserow в виде графиков и фильтров для команды.
- **Трекер проектов** - доски задач, сроки и распределение ресурсов на основе таблиц Baserow.

## Часто задаваемые вопросы

**Чем ToolJet отличается от других интеграций Baserow?** ToolJet собирает визуальные приложения с пользовательским интерфейсом, тогда как n8n или Zapier автоматизируют фоновые процессы без интерфейса. Используйте ToolJet для форм и внутренних экранов, а платформы автоматизации - для фоновых сценариев без участия пользователя.

**Можно ли подключить несколько баз Baserow в одном приложении ToolJet?** Да. Добавьте несколько источников данных Baserow с разными database-токенами, чтобы обращаться к разным рабочим пространствам или аккаунтам - каждый источник появится отдельным пунктом при создании запроса.

**Нужны ли навыки программирования, чтобы использовать ToolJet с Baserow?** Нет, но базовое понимание логики запросов упрощает работу. Большинство задач решается через визуальный интерфейс; простой JavaScript может понадобиться только для сложных преобразований данных.

**Как найти Table ID для запросов ToolJet?** Откройте базу данных Baserow, нажмите на значок с тремя точками и выберите пункт с [документацией REST API](/docs/baserow/webhook-api/database-api/) - там перечислены [идентификаторы таблиц](/docs/baserow/webhook-api/database-and-table-id/), названия полей и структура данных. У каждой таблицы уникальный числовой идентификатор, например `12345`.

**Насколько безопасны данные Baserow при использовании ToolJet?** ToolJet шифрует API-токены перед сохранением, а передача данных идёт по HTTPS. Для максимальной приватности используйте self-hosted версии Baserow и ToolJet в собственной инфраструктуре.

## Похожие материалы

Токен для подключения создаётся так же, как для других интеграций - смотрите [«Database (API) токены»](/docs/baserow/webhook-api/personal-api-tokens/) и [обзор REST API Baserow](/docs/baserow/webhook-api/database-api/). Если вместо визуальных приложений нужна автоматизация фоновых сценариев без интерфейса, обратите внимание на интеграции с [n8n](/docs/baserow/integrations/n8n/), [Make](/docs/baserow/integrations/make/) или [Zapier](/docs/baserow/integrations/zapier/).