Сравнение с Ручной перенос: копипаста, CSV-скрипты, посредники
Универсальный импорт из Excel: форматы, диапазон, формулы, подчинённые таблицы, статистика
Ручной перенос: копипаста, CSV-скрипты, посредники
Универсальный импорт Интеграма переносит данные из Excel, CSV, JSON или по ссылке прямо в базу — в новую или существующую таблицу. Лист и диапазон Excel выбираются мышкой по превью 60×40 ячеек, колонки раскладываются по полям перетаскиванием, значения помечаются ссылками на справочники, расчётные поля считаются формулами на JavaScript. Перед записью импорт показывает статистику по колонкам (пустые, нераспознанные, минимум, максимум, для чисел — среднее и сумма) и предпросмотр со счётчиком ошибок. Записи создаются порциями по 1000; обновления существующих строк импорт не делает — это инструмент первичной загрузки и допоставок новых данных.
Универсальная загрузка — встроенная страница Интеграма с конвейером из трёх шагов: подать данные → «Проверить» → «Загрузить». Она закрывает весь путь «файл → база» без посредников: от вставки скопированного диапазона до нормализации связанных таблиц. Подать данные можно тремя способами: вставить диапазон из буфера обмена, выбрать файл (CSV и любые текстовые, JSON — массив объектов сам превращается в таблицу, Excel XLSX/XLSM/XLSB/XLS) или указать ссылку — файл скачает сервер, что обходит запрет браузера на запросы к чужим доменам. Для текстовых файлов настраиваются кодировка (UTF-8 или Windows-1251 — спасает от «кракозябр» в выгрузках старых систем) и разделители полей и строк; по умолчанию они определяются автоматически.
Ручной перенос против универсального импорта
| Критерий | Вручную (копипаста, скрипты) | Универсальный импорт |
|---|---|---|
| Подача файла | Копипаста или самописный скрипт под каждый формат | Буфер, файл или ссылка: CSV, JSON, XLSX/XLSM/XLSB/XLS |
| Кодировки | «Кракозябры» Windows-1251 лечатся вручную | Переключатель UTF-8 / Windows-1251, перепарс на лету |
| Выборка нужного куска | Диапазон копируется на глаз | Мышкой по превью листа: стартовая ячейка и границы |
| Ошибки формата | Обнаруживаются после записи, по отчётам | До записи: счётчики нераспознанных значений и ошибок в предпросмотре |
| Связанные таблицы | Родителя для каждой строки ищут вручную | Родитель поиском или колонкой файла; недостающие создаются |
| Повторная загрузка | Вся ручная работа заново | Сохранённая настройка: разметка, формулы, лист и диапазон Excel |
Контекст
Ручной перенос Excel в базу — копипастой или одноразовыми скриптами — обычно выглядит так:
- значения едут при вставке: разделители, кодировки, «кракозябры» Windows-1251 вместо кириллицы;
- дубли: один и тот же клиент или товар вставлен дважды, и замечают это по отчётам;
- ошибки формата всплывают после записи — дата «31.02.2026» или текст в числовой колонке обнаруживаются, когда уже испортили выборку;
- связанные данные из одной «простыни» раскладываются руками: родителя для каждой строки ищут поиском;
- повторная выгрузка за следующий месяц — это заново вся ручная работа.
Как это решает Интеграм
Универсальный импорт проводит файл через конвейер с контролем до записи:
- данные подаются в поле ввода: вставкой из буфера, выбором файла или ссылкой на файл;
- для Excel выбираются лист и диапазон мышкой: клик — стартовая ячейка, Shift+клик — правая и нижняя границы; данные правее и ниже стартовой ячейки попадут в загрузку;
- колонки файла раскладываются по полям таблицы перетаскиванием; значения помечаются ссылками на справочники, расчётным полям назначаются формулы;
- кнопка «Проверить» считает статистику по колонкам и строит предпросмотр со счётчиками строк и ошибок;
- «Загрузить» отправляет записи порциями по 1000 с прогрессом «обработано N (P%)».
Вопросы и ответы
Как загрузить Excel в Интеграм?
Откройте универсальную загрузку, вставьте скопированный диапазон или выберите файл, затем укажите таблицу — новую («Создать новую таблицу из файла») или существующую. Для Excel выберите лист и диапазон мышкой, разложите колонки по полям, нажмите «Проверить» — статистика и предпросмотр покажут результат ещё до записи, после чего нажмите «Загрузить».
Какие форматы файлов поддерживает импорт?
CSV и любые текстовые файлы, JSON (массив объектов превращается в таблицу) и Excel: XLSX, XLSM, XLSB и старый XLS. Кодировка — UTF-8 или Windows-1251; разделители полей и строк настраиваются или определяются автоматически.
Чем формулы импорта отличаются от формул Excel?
Это JavaScript-выражения, а не Excel-функции: СЦЕПИТЬ и ЕСЛИ не работают — вместо них конкатенация и тернарный оператор. Колонка подставляется в квадратных скобках: [Кол-во]*[Цена] — число; '[Фамилия]' + ' ' + '[Имя]' — склейка текста, текстовые значения берутся в кавычки; [Сумма] > 0 ? [Сумма] : 0 — условие. Формулы считаются уже на этапе «Проверить», ошибочные выражения видны в предпросмотре и попадают в счётчик ошибок.
Импорт обновляет существующие записи или только создаёт новые?
Только создаёт. Сопоставления с существующими строками по ключевой колонке в универсальном импорте нет — обновление данных делается другими средствами системы. Защита от дублей при создании новой таблицы — флаг уникальности первой колонки.
Как загрузить данные в подчинённую таблицу?
Родителя укажите поиском по значению или #ID — тогда все записи уйдут в одну родительскую запись, — или номером колонки файла, откуда брать родителя или его ID: записи разложатся по разным родителям за одну загрузку. Галка «Создавать родителя, если его нет» создаст недостающих родителей автоматически.
Что показывает статистика перед загрузкой?
По каждой колонке: сколько значений пустых и сколько не распознано типом, минимум и максимум, а для числовых колонок — среднее и сумма. Предпросмотр добавляет итоги: всего строк, ошибок, пустых ячеек, пропущено пустых; пустые строки пропускаются целиком, длинные выгрузки листаются по 1000 строк.
Источники
- templates/upload.html — исходник универсальной загрузки (ideav/crm) — Исходный код страницы импорта: форматы, сетка выбора диапазона, формулы, статистика. Фактура статьи сверена по нему.
- Нормализация данных из таблиц Excel в Интеграме — vc.ru — Пошаговый разбор загрузки в подчинённые таблицы: проекты → этапы → задачи, сцепленный ключ, ВПР.