> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Отримання записів

> Отримуйте записи з таблиці з необов’язковими фільтрами та пагінацією

<Tip>
  Наполегливо рекомендуємо створювати автоматизації за допомогою дії «Запуск сценарію», оскільки вона охоплює всі типи дій, зокрема ті, які інакше довелося б створювати вручну. Просто опишіть свої вимоги ШІ в чаті.

  Зверніть увагу: якщо ви додасте дії вручну, ШІ надалі не розпізнаватиме й не змінюватиме їх.
</Tip>

## Створення за допомогою ШІ

Відкрийте AI Chat на правій бічній панелі таблиці й опишіть бажаний результат.

ШІ зробить усе: вибере правильний тригер і відповідні дії, зіставить поля й автоматично налаштує весь робочий процес.

Достатньо один раз описати мету — і робочий процес готовий без ручного налаштування.

Отримує записи з таблиці й повертає їх як масив. Використовуйте результати в наступних кроках, щоб перебирати записи в циклі, передавати дані сценарію або використовувати їх в інших діях.

## Налаштування

| Параметр   | Обов’язковий | Опис                                                                                                              |
| ---------- | ------------ | ----------------------------------------------------------------------------------------------------------------- |
| Таблиця    | Так          | Таблиця, до якої надсилається запит                                                                               |
| Перегляд   | Ні           | Обмежує результати записами, видимими в певному Перегляді (успадковує його фільтри, сортування та приховані поля) |
| Фільтр     | Ні           | Додаткові умови фільтрації, що застосовуються поверх фільтра Перегляду                                            |
| Пропустити | Ні           | Кількість записів, які потрібно пропустити від початку (для пагінації)                                            |
| Взяти      | Ні           | Максимальна кількість записів, які потрібно повернути (для пагінації)                                             |

## Як налаштувати

1. Додайте до робочого процесу дію **Отримати записи**.
2. Виберіть **Таблицю**, до якої потрібно надіслати запит. Якщо таблиця розташована в іншій Базі, скористайтеся [Міжбазовим доступом](/uk/basic/automation/actions/records/cross-base).
3. (Необов’язково) Виберіть **Перегляд**, щоб успадкувати його налаштування фільтра, сортування та видимості полів.
4. (Необов’язково) Додайте умови **Фільтра**, щоб звузити результати. Наприклад, `Статус` дорівнює `Активний`, а `Дата виконання` — раніше за сьогодні.
5. (Необов’язково) Задайте **Пропустити** й **Взяти** для пагінації. Наприклад, «Пропустити» 0 і «Взяти» 100, щоб отримати перші 100 записів.
6. Збережіть дію. Під час виконання робочого процесу результати будуть доступні наступним крокам як масив.

## Результат: робота з отриманими даними

Результат — це **масив записів**. Кожен запис у масиві містить:

* **Ідентифікатор Запису** — унікальний ідентифікатор.
* **Усі значення полів** — кожне поле таблиці (або Перегляду, якщо його вибрано).

### Використання результатів у наступному кроці

* **Посилання на один запис:** якщо очікується лише один результат (або потрібен перший), можна безпосередньо посилатися на поля першого запису за допомогою засобу вибору змінних **+**.
* **Перебір усіх записів:** додайте дію [Цикл (пакетна обробка)](../logic/loop-run) після «Отримати записи» й виберіть масив результатів як джерело даних. Усередині циклу посилайтеся на поля кожного елемента.
* **Обробка в сценарії:** передайте масив кроку [Запуск сценарію](/uk/basic/automation/actions/ai/ai-script) для власної обробки, фільтрації або перетворення.

## Пагінація

Якщо не задавати **Пропустити** й **Взяти**, дія поверне записи в межах стандартного системного ліміту. Для великих таблиць використовуйте пагінацію, щоб керувати розміром результату:

| Параметр   | Призначення                            | Приклад                       |
| ---------- | -------------------------------------- | ----------------------------- |
| Пропустити | Скільки записів пропустити від початку | `0` (почати від початку)      |
| Взяти      | Скільки записів повернути              | `100` (повернути 100 записів) |

Щоб обробити всю велику таблицю, можна використати кілька кроків «Отримати записи» зі збільшенням значення «Пропустити» або обробити пагінацію в сценарії.

## Коли використовувати

* **Пошук прострочених завдань для надсилання нагадувань.** Відфільтруйте завдання, у яких дата виконання раніше за сьогодні, а статус не дорівнює «Виконано». Переберіть результати в циклі й надішліть лист для кожного.
* **Збирання даних для щоденного зведення.** Отримайте всі записи, оновлені протягом останніх 24 годин, і сформуйте з них підсумковий лист.
* **Пошук пов’язаних записів перед створенням або оновленням.** Перш ніж створювати дублікат, перевірте, чи вже існує запис із такою самою адресою електронної пошти.
* **Передавання даних до дії ШІ.** Отримайте записи з довгими текстовими полями, а потім у циклі скористайтеся дією «Генерування за допомогою ШІ», щоб узагальнити або класифікувати кожен із них.
* **Синхронізація записів із зовнішньою системою.** Отримайте всі записи, що змінилися після останньої синхронізації, і передайте їх до CRM або сховища даних через HTTP-запити.

## Поради

* **Використовуйте фільтри.** Що точніший фільтр, то менше записів повертається й швидше виконується дія.
* **Обмежуйте результати параметром «Взяти».** Якщо потрібні лише перші 10 записів, задайте для «Взяти» значення 10. Не варто отримувати тисячі записів, якщо потрібні лише кілька.
* **Виберіть Перегляд**, який уже фільтрує й сортує потрібні дані. Це спростить конфігурацію автоматизації.
* **Не отримуйте всю таблицю**, якщо вам справді не потрібні всі записи. Великі набори результатів обробляються довше й використовують більше ресурсів, особливо в поєднанні з циклом.
* Дія «Отримати записи» не змінює даних — вона працює лише для читання.
* Якщо запит не поверне жодного запису, наступні кроки, що посилаються на результати, отримають порожній масив. Переконайтеся, що робочий процес належно обробляє цю ситуацію (наприклад, не надсилає лист зі словами «ось ваші результати», коли результатів немає).
* Фільтри в дії «Отримати записи» працюють так само, як фільтри Перегляду: умови можна поєднувати логікою І/АБО.
* Під час використання міжбазового доступу запит виконується з дозволами автора робочого процесу. Якщо автор втратить доступ до цільової Бази, крок завершиться помилкою.

## Пов’язані матеріали

* [Міжбазовий доступ](/uk/basic/automation/actions/records/cross-base) — надсилання запитів до таблиць в інших Базах
* [Цикл (пакетна обробка)](../logic/loop-run) — перебір масиву результатів
* [Створення запису](/uk/basic/automation/actions/records/create-record) — створення записів на основі отриманих даних
* [Оновлення запису](/uk/basic/automation/actions/records/update-record) — оновлення записів, знайдених дією «Отримати записи»