CSV — текстовый файл с таблицей. Он удобен для передачи размеров, но сам по себе не задаёт единый стандарт мебельной деталировки. Один сервис ждёт запятые, другой — точки с запятой; набор и порядок колонок также различаются. Поэтому файл, который открывается в Excel, не обязательно подходит для автоматического импорта в конкретный редактор.
Здесь разобран именно наш шаблон CSV. Если файл получен из другой программы и его структура отличается, можно приложить исходную спецификацию для ручной проверки. Не нужно насильно переименовывать поля, смысл которых вам неясен.
Начните с заголовка и разделителя
Первая строка перечисляет поля в определённом порядке. Наш загрузчик ожидает запятую как разделитель и следующие заголовки:
code,name,length,width,quantity,thickness,material,decor,grain,edgeTop,edgeRight,edgeBottom,edgeLeft
Переводить их на русский, менять регистр или переставлять колонки для автоматического импорта не нужно. Внутри таблицы названия деталей и декоров могут быть русскими. Если программа экспорта использовала точку с запятой, структура не совпадёт с шаблоном, даже когда все значения выглядят правильными.
Проще всего скачать готовый файл, заменить пример своими строками и сохранить его с тем же разделителем. После экспорта проверьте начало файла в текстовом редакторе: оно должно оставаться таблицей, а не превратиться в одну длинную колонку с другим разделителем.
Как выглядит корректная строка детали
В примере две прямоугольные полки 600 × 400 мм толщиной 16 мм. Рисунок не ограничен, выбраны нижняя и левая стороны на схеме редактора. Декор «Белый» здесь учебный: для реального заказа нужно согласовать конкретный материал.
"P1","Полка","600","400","2","16","ЛДСП","Белый","none","0","0","1","1"
Каждое значение находится в своей колонке. Количество относится к одной позиции; не нужно одновременно ставить 2 и повторять ту же строку два раза, если в заказе всего две полки. Размеры указаны в миллиметрах без слов и обозначений единиц.
Значения кромки 0 и 1 показывают выбор стороны. Они не задают толщину ленты. После импорта уточните её параметры в полном проекте. Для направления рисунка допустимы none, length и width; произвольное слово «вдоль» автоматический загрузчик не распознает.
Кодировка и кавычки
Используйте UTF-8, чтобы русские названия сохранились при передаче. Наш экспорт добавляет служебный маркер UTF-8 в начало файла, и загрузчик его учитывает. Если вместо русских букв видны искажённые символы, сначала проверьте кодировку, а не редактируйте каждое название вручную.
Значение с запятой заключают в двойные кавычки. Кавычку внутри такого значения удваивают. Это правило позволяет отличить запятую внутри названия от границы между колонками. Готовый экспорт редактора выполняет такое оформление автоматически.
Не добавляйте примечания отдельными текстовыми строками в конец CSV. Загрузчик ожидает там детали с тем же набором колонок. Комментарии к заказу лучше передать в предназначенном для этого поле или в полном JSON проекта.
Что означает сообщение об ошибке
| Сообщение или симптом | Что проверить |
|---|---|
| Нужны колонки шаблона | Заголовки, их порядок и запятую-разделитель |
| Неверное число колонок | Пропущенное значение или неоформленную запятую в тексте |
| Неверные кавычки | Закрытие строкового значения и удвоение внутренних кавычек |
| Неверное направление текстуры | Значения none, length, width |
| Ошибка количества | Положительное целое число и общий объём |
| Один код у разных деталей | Размеры, материал и обработку позиций с этим кодом |
Исправляйте причину в исходной таблице и экспортируйте новую версию. Если исправить только временный CSV, следующая выгрузка снова вернёт ошибку. После изменения проверьте не только проблемную строку, но и количество импортированных позиций.
Какие ограничения действуют в редакторе
Автоматически импортируются файлы до 200 000 байт, не более 50 позиций и 200 деталей суммарно. Числа должны находиться в допустимых пределах интерфейса, а количество — быть целым. Названия и коды ограничены по длине, чтобы документ можно было безопасно и понятно отображать.
Эти ограничения относятся к предварительному браузерному инструменту. Они не означают отказ от более крупной производственной спецификации. Такой файл можно передать специалисту через заявку; допустимый размер вложения в форме указан рядом с загрузкой.
При технической ошибке не стоит удалять половину заказа только ради успешного импорта. Сохраните исходный документ и выберите ручную проверку, если он не подходит под возможности инструмента.
Чего CSV не передаёт
Простой шаблон описывает прямоугольные заготовки, основные размеры и выбранные стороны. Он не заменяет подробную схему присадки, фигурный контур и весь набор параметров проекта. Для сохранения полной работы редактора используйте JSON; для отверстий и сложных узлов приложите чертежи.
Также нужно уточнить, относятся размеры к готовой детали или заготовке до кромления. CSV не должен скрывать эту договорённость. После загрузки проверьте соответствующий параметр проекта и остальные настройки перед отправкой.
Последняя проверка после загрузки
Сравните число позиций, общее количество и несколько контрольных размеров с исходником. Посмотрите на выбранные стороны кромления и направление рисунка в редакторе. Успешное чтение файла подтверждает его формат, но не правильность конструкции шкафа.
Если требуется помощь, приложите исходный CSV и опишите, что именно не совпало. На странице требований к файлу собраны правила, а в редакторе расчёта можно сразу проверить исправленный документ.
Проверьте CSV в редакторе
Загрузите таблицу по шаблону и сверьте размеры, количество и выбранные стороны.
