Airtable
Чтение, создание и обновление записей Airtable в процессах Pailot
Airtable — облачная таблица с полями как у базы данных: сетка, канбан, календарь. Блок ходит в API (Application Programming Interface — программный интерфейс) базы: читает, создаёт и обновляет записи.
С Airtable в Pailot вы можете:
- Получать список записей таблицы — лимит и формула фильтра
- Читать одну запись по ID
- Создавать записи пакетом (массив с объектом
fields)
- Обновлять одну запись или несколько сразу
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Можно включить режим триггера: процесс запускается при изменении таблицы. Секреты — в переменных окружения рабочего пространства.
Список записей таблицы Airtable.
| Параметр | Тип | Обязательный | Описание |
|---|
baseId | string | Да | ID базы Airtable |
tableId | string | Да | ID таблицы |
maxRecords | number | Нет | Максимум записей в ответе |
filterFormula | string | Нет | Формула фильтра (например, (\{Field Name\} = 'Value')) |
| Параметр | Тип | Описание |
|---|
records | json | Массив записей Airtable |
metadata | json | Служебные данные: смещение страницы и число записей |
Одна запись таблицы по ID.
| Параметр | Тип | Обязательный | Описание |
|---|
baseId | string | Да | ID базы Airtable |
tableId | string | Да | ID или имя таблицы |
recordId | string | Да | ID записи |
| Параметр | Тип | Описание |
|---|
record | json | Запись: id, createdTime и fields |
metadata | json | Служебные данные, включая число записей |
Создать новые записи в таблице.
| Параметр | Тип | Обязательный | Описание |
|---|
baseId | string | Да | ID базы Airtable |
tableId | string | Да | ID или имя таблицы |
records | json | Да | Массив записей; у каждой — объект fields |
fields | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
records | json | Массив созданных записей |
metadata | json | Служебные данные операции |
Обновить существующую запись по ID.
| Параметр | Тип | Обязательный | Описание |
|---|
baseId | string | Да | ID базы Airtable |
tableId | string | Да | ID или имя таблицы |
recordId | string | Да | ID записи |
fields | json | Да | Объект: имена полей и новые значения |
| Параметр | Тип | Описание |
|---|
record | json | Обновлённая запись: id, createdTime и fields |
metadata | json | Служебные данные: число записей и имена изменённых полей |
Обновить несколько существующих записей.
| Параметр | Тип | Обязательный | Описание |
|---|
baseId | string | Да | ID базы Airtable |
tableId | string | Да | ID или имя таблицы |
records | json | Да | Массив записей; у каждой — id и объект fields |
| Параметр | Тип | Описание |
|---|
records | json | Массив обновлённых записей |
metadata | json | Служебные данные: число записей и ID обновлённых |
