---
title: "Як імпортувати дані з файлу?"
description: "Завантажте рядки з CSV або Excel у нову або існуючу таблицю Custom Data через майстер Імпорт даних."
---

# Як імпортувати дані з файлу?

Майстер **Імпорт даних** дозволяє завантажити рядки з CSV або Excel у нову або існуючу таблицю. Дані записуються лише після кроку **Перегляд перед імпортом** — до підтвердження ви бачите попередній перегляд і можете обрати режим додавання або повної заміни.

## Коли знадобиться

- Потрібно перенести довідник із Excel або CSV.
- Хочете оновити таблицю новим набором рядків із файла.
- Треба створити таблицю одразу з колонок файла.

## Що важливо знати

- **Джерело** — крок, де ви завантажуєте **Файл (.csv, .xls, .xlsx)**; перший рядок має містити назви колонок.
- **Куди імпортувати** — існуюча таблиця або **Створити нову модель з імпорту**.
- **Зіставлення** — відповідність колонок файлу полям таблиці.
- **Режим запису** — **Додати до поточних записів** або **Очистити модель і імпортувати заново**.
- **Перегляд перед імпортом** — таблиця з попереднім переглядом; кнопка **Імпортувати {count} записів** або **Видалити {clearCount}, потім імпортувати {importCount}**.

## Перед початком

- [x] Ви у **Меню → Користувацькі дані**.
- [x] Файл у форматі CSV, XLS або XLSX; перший рядок — заголовки колонок.
- [x] Для імпорту в існуючу таблицю — поля таблиці відповідають даним у файлі (або ви готові зіставити їх на кроці **Зіставлення**).

## Покрокова інструкція

1. Відкрийте **Імпорт даних** — зі стартового екрана (**З файла (Excel/CSV)**), з порожнього стану таблиці (**Імпортувати дані**) або з тулбара таблиці (**Імпорт**).
2. На кроці **Оберіть джерело імпорту**:
   - Оберіть **Файл (.csv, .xls, .xlsx)**.
   - Завантажте файл — система зчитає колонки для наступних кроків.
3. На кроці **Куди імпортувати**:
   - **Імпортувати в існуючу модель** — оберіть таблицю зі списку.
   - **Створити нову модель з імпорту** — задайте **Назва моделі**, **Опис**, **Група**; перевірте **Поля нової моделі** (назви та типи з файла).
4. На кроці **Зіставте колонки файлу з полями моделі**:
   - Для кожного **Поле моделі** оберіть **Колонка з файлу**.
   - За потреби вкажіть **За замовчуванням** для порожніх комірок.
5. На кроці **Режим запису** (лише для існуючої таблиці):
   - **Додати до поточних записів** — нові рядки додаються, наявні не змінюються.
   - **Очистити модель і імпортувати заново** — спочатку видаляються всі поточні рядки; підтвердіть у діалозі **Підтвердження небезпечного імпорту**.
6. На кроці **Перегляд перед імпортом**:
   - Перевірте підсумок (скільки рядків буде додано або замінено).
   - Перегляньте попередній перегляд; виправте **Невалідні рядки**, якщо імпорт заблоковано.
   - Натисніть **Імпортувати {count} записів** або **Видалити {clearCount}, потім імпортувати {importCount}**.
7. На кроці **Результат імпорту** перегляньте підсумок і натисніть **Переглянути дані** або **Редагувати модель**.

## Що відбувається після

Рядки з’являються в таблиці записів. Нова таблиця — у списку **Таблиці**; існуюча — оновлена згідно з обраним режимом запису.

## Як переконатися, що все вдалось

- На кроці **Результат імпорту** — **Імпорт завершено** і очікувана кількість **Додано**.
- У таблиці записів — **Рядків у таблиці** відповідає очікуваному числу.
- Невалідні рядки з файла не потрапили в таблицю (або ви їх виправили до імпорту).

## Інші способи

- Імпорт з Google Sheets — окремий сценарій: [Імпорт з Google Sheets](/uk/customdata/how-to/import-from-google-sheets.md).
- Створення таблиці з файла без окремого редактора — оберіть **Створити нову модель з імпорту** на кроці **Куди імпортувати**.

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

- [Імпорт з Google Sheets](/uk/customdata/how-to/import-from-google-sheets.md)
- [Створити таблицю](/uk/customdata/how-to/create-model.md)
- [Переглянути записи таблиці](/uk/customdata/how-to/view-model-records.md)
- [Експортувати дані моделі](/uk/customdata/how-to/export-model-data.md)