> ## 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>

## Создание с помощью ИИ

Откройте ИИ-чат на правой боковой панели Таблицы и опишите, что вам нужно.

ИИ сделает всё сам: выберет подходящий триггер и нужные действия, сопоставит Поля и автоматически настроит весь рабочий процесс.

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

Получает Записи из Таблицы и возвращает их в виде массива. Используйте результаты на последующих шагах, чтобы перебирать Записи в цикле, передавать данные скрипту или использовать их в других действиях.

## Конфигурация

| Настройка     | Обязательно | Описание                                                                                                                            |
| ------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Таблица       | Да          | Таблица, к которой выполняется запрос                                                                                               |
| Представление | Нет         | Ограничивает результат Записями, видимыми в определённом Представлении (наследует фильтры, сортировку и скрытые Поля Представления) |
| Фильтр        | Нет         | Дополнительные условия фильтра, применяемые поверх фильтра Представления                                                            |
| Skip          | Нет         | Количество Записей, пропускаемых от начала (для пагинации)                                                                          |
| Take          | Нет         | Максимальное количество возвращаемых Записей (для пагинации)                                                                        |

## Как настроить

1. Добавьте действие **Получить Записи** в рабочий процесс.
2. Выберите **Таблицу**, к которой нужно выполнить запрос. Если Таблица находится в другой Базе, используйте [межбазовый доступ](/ru/basic/automation/actions/records/cross-base).
3. (Необязательно) Выберите **Представление**, чтобы унаследовать настройки его фильтра, сортировки и видимости Полей.
4. (Необязательно) Добавьте условия **Фильтра**, чтобы сузить результаты. Например, `Статус` равен `Активно`, а `Дата выполнения` — раньше сегодняшней.
5. (Необязательно) Задайте **Skip** и **Take** для пагинации. Например, Skip 0 и Take 100, чтобы получить первые 100 Записей.
6. Сохраните действие. При запуске рабочего процесса результаты будут доступны последующим шагам в виде массива.

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

Результат представляет собой **массив Записей**. Каждая Запись в массиве содержит:

* **Идентификатор Записи** — уникальный идентификатор.
* **Значения всех Полей** — каждое Поле Таблицы (или Представления, если оно выбрано).

### Использование результатов на следующем шаге

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

## Пагинация

Если не задать **Skip** и **Take**, действие вернёт Записи в пределах системного ограничения по умолчанию. Для больших Таблиц используйте пагинацию, чтобы управлять размером результата:

| Настройка | Назначение                           | Пример                      |
| --------- | ------------------------------------ | --------------------------- |
| Skip      | Сколько Записей пропустить от начала | `0` (начать с начала)       |
| Take      | Сколько Записей вернуть              | `100` (вернуть 100 Записей) |

Чтобы обработать всю большую Таблицу, можно использовать несколько шагов «Получить Записи» с возрастающими значениями Skip или реализовать пагинацию в скрипте.

## Когда использовать

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

## Советы

* **Используйте фильтры.** Чем точнее фильтр, тем меньше Записей возвращается и тем быстрее выполняется действие.
* **Ограничивайте результаты с помощью Take.** Если нужны только первые 10 Записей, задайте для Take значение 10. Не нужно получать тысячи Записей, если требуется лишь несколько.
* **Выберите Представление**, которое уже фильтрует и сортирует нужные данные. Это упрощает конфигурацию Автоматизации.
* **Не загружайте всю Таблицу**, если действительно не нужны все Записи. Большие наборы результатов обрабатываются дольше и потребляют больше ресурсов, особенно в сочетании с циклом.
* Действие «Получить Записи» не изменяет данные — оно доступно только для чтения.
* Если запрос не вернул ни одной Записи, последующие шаги, обращающиеся к результатам, получат пустой массив. Убедитесь, что рабочий процесс корректно обрабатывает такую ситуацию (например, не отправляет письмо «Вот ваши результаты», если результатов нет).
* Фильтры действия «Получить Записи» работают так же, как фильтры Представления: условия можно объединять логикой AND/OR.
* При использовании межбазового доступа запрос выполняется с разрешениями создателя рабочего процесса. Если создатель потеряет доступ к целевой Базе, шаг завершится ошибкой.

## Связанные материалы

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