Импорт CSV / JSON
Раздел позволяет одним файлом загрузить в систему всю базу клиентов, автомобилей или историю прошлых ремонтов — так, чтобы не вводить каждую карточку руками. Файл можно взять из Excel, старой программы или любой другой системы учёта. Умный режим поможет, даже если у файла нестандартные заголовки столбцов.
Как открыть
Нижняя панель → вкладка Ещё → пункт Импорт.
Также можно войти со страницы склада: кнопка Загрузить файл в разделе «Склад» тоже ведёт на этот же экран.
Прямой адрес в браузере (если кабинет открыт на компьютере): app.carsexp.com/import.
Что на экране
Экран устроен сверху вниз:
- Строка заголовка — название «Импорт CSV / JSON» и иконка-вопросик (шаблон формата).
- Переключатель типа данных — три кнопки: Клиенты / Авто / История.
- Подсказка — серая строчка под переключателем, объясняет, какие поля принимает выбранный тип.
- Кнопка «Загрузить файл» — выбрать файл с диска.
- Большое текстовое поле — вставить CSV или JSON прямо текстом.
- Кнопка «Настроить колонки» — умный режим, если у файла нестандартные заголовки.
- Подсказка под «Настроить колонки» — серый мелкий текст «Файл с любыми заголовками? Распознаем колонки и сопоставим с полями вручную.» — показывается, пока маппинг не открыт (исчезает после нажатия).
- Карточка сопоставления колонок — появляется только после нажатия «Настроить колонки».
- Строка шаблонов маппинга — появляется там же; кнопки «Шаблоны» и «Сохранить шаблон».
- Кнопки действий — «Предпросмотр» и «Импортировать» рядом.
- Карточка результата — появляется после нажатия любой из двух кнопок действий.
Каждая кнопка и действие
| Элемент | Где | Что делает | Кому доступно |
|---|---|---|---|
| Иконка ? (подсказка-шаблон) | Правый верхний угол заголовка | Открывает диалог «Шаблон CSV» — показывает правильный заголовок и пример строки для выбранного типа данных | Все |
| Кнопка Клиенты (переключатель) | Вверху экрана | Переключает режим на импорт клиентов; сбрасывает введённые данные и маппинг | Все |
| Кнопка Авто (переключатель) | Вверху экрана | Переключает режим на импорт автомобилей; сбрасывает введённые данные и маппинг | Все |
| Кнопка История (переключатель) | Вверху экрана | Переключает режим на импорт истории прошлых ремонтов; сбрасывает данные | Все |
| Кнопка Загрузить файл | Под подсказкой | Открывает системный проводник для выбора файла форматов CSV, JSON, TXT или XLSX (Excel); содержимое файла автоматически подставляется в текстовое поле; XLSX конвертируется в CSV автоматически | Все |
| Текстовое поле (большое, с подсказкой «Вставьте CSV или JSON сюда…») | Центр экрана | Вводить или вставлять (Ctrl+V) данные напрямую; если изменить текст после настройки колонок — настройка сбросится | Все |
| Кнопка Настроить колонки (иконка-ползунки) | Под текстовым полем | Отправляет вставленный текст на анализ; система определяет заголовки столбцов и предлагает автоматически подобранное сопоставление с полями; открывает карточку маппинга | Все |
| Подсказка «Файл с любыми заголовками? Распознаем колонки и сопоставим с полями вручную.» | Под кнопкой «Настроить колонки», только пока маппинг не открыт | Пояснение; исчезает, как только карточка маппинга открыта | Все |
| Карточка «Сопоставьте колонки файла с полями» | Появляется после «Настроить колонки» | Показывает число найденных колонок и строк, образец первой строки данных; для каждого поля системы — выпадающий список выбора колонки файла | Все |
| Выпадающий список поля (например «Гос. номер», «VIN», «Имя / название» и т. д.) | Внутри карточки маппинга | Выбрать, какой столбец файла соответствует данному полю системы; вариант «— не импортировать —» означает пропустить это поле | Все |
| Кнопка Шаблоны (иконка закладка) | Строка под карточкой маппинга; отображается только если карточка маппинга открыта И есть хотя бы один сохранённый шаблон | Открывает меню с названиями сохранённых шаблонов маппинга; выбор шаблона автоматически проставляет соответствия колонок | Все |
| Пункт меню с названием шаблона | Выпадает из кнопки «Шаблоны» | Применяет сохранённый ранее шаблон маппинга (заполняет выпадающие списки колонок) | Все |
| Кнопка Сохранить шаблон (иконка дискета) | Строка под карточкой маппинга | Открывает диалог сохранения — просит ввести название шаблона; после сохранения шаблон появится в кнопке «Шаблоны» | Все |
| Кнопка Предпросмотр (иконка глаз) | Нижняя часть экрана, левая | Отправляет данные на проверку без реального сохранения; показывает карточку с числом строк, сколько будет добавлено, сколько пропущено, и первые строки результата | Все |
| Кнопка Импортировать (иконка скачать с галочкой) | Нижняя часть экрана, правая | Реально добавляет данные в базу; показывает карточку с итогом: Всего / Добавлено / Пропущено | Все |
Поля в диалоге шаблона (открывается иконкой ?)
| Элемент | Где | Что делает | Кому доступно |
|---|---|---|---|
| Текст «Заголовок (первая строка):» + пример заголовка | Тело диалога «Шаблон CSV» | Показывает правильный первый ряд CSV для выбранного типа данных; текст можно выделить и скопировать | Все |
| Текст «Пример:» + пример строки данных | Тело диалога «Шаблон CSV» | Показывает пример заполненной строки; текст можно выделить и скопировать | Все |
| Кнопка Копировать | Диалог «Шаблон CSV», нижняя часть | Копирует пример строки данных в буфер обмена и закрывает диалог; внизу экрана появляется уведомление «Скопировано» | Все |
| Кнопка Вставить пример | Диалог «Шаблон CSV», нижняя часть | Вставляет пример сразу в текстовое поле экрана и закрывает диалог; удобно чтобы понять формат и заменить тестовые данные своими | Все |
Поля в диалоге сохранения шаблона
| Элемент | Где | Что делает | Кому доступно |
|---|---|---|---|
| Поле «Название шаблона (напр. Tekmetric)» | Диалог «Сохранить шаблон» | Ввести имя шаблона, под которым он появится в списке «Шаблоны»; поле не может быть пустым — при пустом значении шаблон не сохраняется | Все |
| Кнопка Отмена | Диалог «Сохранить шаблон» | Закрывает диалог без сохранения | Все |
| Кнопка Сохранить | Диалог «Сохранить шаблон» | Сохраняет шаблон на этом устройстве; шаблоны хранятся отдельно для каждого типа данных (Клиенты / Авто / История) | Все |
Диалоги и подэкраны
Диалог «Шаблон CSV»
Открывается нажатием иконки-вопросика в правом верхнем углу заголовка. Показывает правильный формат файла для выбранного в данный момент типа данных (Клиенты, Авто или История). Содержит:
- Подзаголовок «Заголовок (первая строка):» и пример заголовочной строки CSV (можно выделить пальцем и скопировать).
- Подзаголовок «Пример:» и пример строки с реальными данными (тоже выделяется).
- Кнопку Копировать — копирует пример строки в буфер обмена, диалог закрывается, внизу экрана мелькает «Скопировано».
- Кнопку Вставить пример — закрывает диалог и сразу вставляет пример в текстовое поле на экране. Удобно: пример показывает правильный формат, замените данные на свои и нажимайте «Предпросмотр».
Карточка «Сопоставьте колонки файла с полями»
Появляется на экране (не в отдельном диалоге) после нажатия Настроить колонки. Система анализирует вставленный текст и показывает:
- Строку вида «Найдено колонок: 5 · 120 строк» — количество столбцов и строк данных в файле.
- Для каждого поля системы — метку поля слева и выпадающий список справа. В списке — все заголовки из файла плюс вариант «— не импортировать —». Система сама пытается угадать правильное соответствие; вы можете поправить вручную.
- Образец первой строки данных — в одну строку через «·», чтобы было видно, что реально лежит в колонках.
Поля для режима Клиенты: Имя / название, Телефон, E-mail.
Поля для режима Авто: Гос. номер, VIN, Марка, Модель, Год, Пробег, Топливо, Цвет, Двигатель, Владелец (имя), Телефон владельца, E-mail владельца. (Авто и владелец могут быть в одной строке файла — система свяжет их.)
Поля для режима История: Гос. номер, VIN, Дата, Описание работ, Сумма.
Карточка результата
Появляется под кнопками действий после нажатия Предпросмотр или Импортировать. Содержит:
- Иконка и заголовок: «Предпросмотр» (синяя иконка глаза) если это был предпросмотр, или «Импортировано» (зелёная галочка) если данные реально добавлены.
- Три цветных плашки: Всего (серая) — сколько строк в файле, Добавлено (зелёная) — сколько успешно, Пропущено (жёлтая, если больше нуля) — сколько пропущено.
- Расшифровка пропущенных (серым, мелко): «уже в базе» (дубли) и «пустые строки».
- Список ошибок красным — если какие-то строки не удалось разобрать.
- Раздел «Первые строки:» — несколько строк из обработанных данных, чтобы убедиться, что всё распозналось правильно.
Что если…
Поле «Загрузить файл» не срабатывает или файл не открывается
Система принимает только файлы с расширением .csv, .json, .txt или .xlsx. Файлы других форматов (например .ods, .xls) не пройдут. Попробуйте сохранить таблицу из Excel заново, выбрав формат CSV или XLSX.
После «Импортировать» в «Добавлено» стоит 0, всё в «Пропущено»
Вероятно, все строки уже есть в базе (дубли) или файл содержит только пустые строки. Проверьте «Предпросмотром» — в разделе «Первые строки:» должны быть ваши данные. Убедитесь, что первая строка файла — заголовок, а не данные.
Кнопка «Настроить колонки» не реагирует
Сначала вставьте или загрузите данные — поле должно быть непустым. Если поле заполнено, а кнопка не нажимается — идёт фоновая работа (в шапке экрана видна синяя полоска загрузки), подождите секунду.
Шаблонов маппинга нет в списке / кнопка «Шаблоны» не видна
Кнопка «Шаблоны» появляется только когда есть хотя бы один сохранённый шаблон. Сначала настройте соответствие колонок и нажмите «Сохранить шаблон». Шаблоны хранятся на этом конкретном устройстве и не переносятся на другие телефоны или браузеры.
Вверху появляется сообщение «Не удалось загрузить аналитику. Проверьте вход и сеть»
Проверьте подключение к интернету и попробуйте снова. Если не помогает — попробуйте выйти из кабинета и войти снова.
Вопрос-ответ
У меня таблица Excel, а здесь написано CSV. Что делать?
Просто загрузите файл кнопкой Загрузить файл и выберите ваш .xlsx-файл — система сама переведёт его в нужный формат. Если хотите вставить текстом — откройте Excel, выберите «Сохранить как» → формат CSV, потом откройте получившийся файл в «Блокноте» и скопируйте текст.
В: Я боюсь сломать базу. Как проверить перед загрузкой?
О: Нажмите Предпросмотр — данные не сохранятся, только покажет, сколько строк прочитано, сколько новых и сколько уже есть в базе. Убедитесь, что числа выглядят правильно, и только потом нажимайте Импортировать.
В: В файле колонки называются не так, как ожидает система — например «ФИО» вместо «name».
О: Нажмите Настроить колонки — система сама попробует угадать соответствие, но вы можете поправить любое поле в выпадающих списках. Если такой формат используется постоянно — сохраните настройку кнопкой Сохранить шаблон и в следующий раз просто выберете его из «Шаблоны».
В: Можно ли загрузить авто вместе с владельцем одним файлом, чтобы не грузить отдельно клиентов и отдельно машины?
О: Да. Переключитесь на вкладку Авто и добавьте в файл колонки «Владелец (имя)», «Телефон владельца» и «E-mail владельца» — система создаст клиента и сразу привяжет к нему автомобиль.
В: Почему кнопки «Предпросмотр» и «Импортировать» серые и не нажимаются?
О: Текстовое поле пустое — вставьте данные или загрузите файл. Также кнопки блокируются на время выполнения запроса (видна синяя полоска в шапке) — подождите, пока она исчезнет.
В: Сохранённые шаблоны исчезли после того, как я открыл кабинет с другого телефона.
О: Шаблоны маппинга хранятся только на том устройстве, где были сохранены. Настройте соответствие колонок заново и сохраните шаблон уже на новом устройстве.