Сравнение с Ручной перенос: копипаста, CSV-скрипты, посредники

Универсальный импорт из Excel: форматы, диапазон, формулы, подчинённые таблицы, статистика

Ручной перенос: копипаста, CSV-скрипты, посредники

Обложка статьи: Универсальный импорт из Excel

Универсальный импорт Интеграма переносит данные из 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» или текст в числовой колонке обнаруживаются, когда уже испортили выборку;
  • связанные данные из одной «простыни» раскладываются руками: родителя для каждой строки ищут поиском;
  • повторная выгрузка за следующий месяц — это заново вся ручная работа.

Как это решает Интеграм

Универсальный импорт проводит файл через конвейер с контролем до записи:

  1. данные подаются в поле ввода: вставкой из буфера, выбором файла или ссылкой на файл;
  2. для Excel выбираются лист и диапазон мышкой: клик — стартовая ячейка, Shift+клик — правая и нижняя границы; данные правее и ниже стартовой ячейки попадут в загрузку;
  3. колонки файла раскладываются по полям таблицы перетаскиванием; значения помечаются ссылками на справочники, расчётным полям назначаются формулы;
  4. кнопка «Проверить» считает статистику по колонкам и строит предпросмотр со счётчиками строк и ошибок;
  5. «Загрузить» отправляет записи порциями по 1000 с прогрессом «обработано N (P%)».

Вопросы и ответы

Как загрузить Excel в Интеграм?

Откройте универсальную загрузку, вставьте скопированный диапазон или выберите файл, затем укажите таблицу — новую («Создать новую таблицу из файла») или существующую. Для Excel выберите лист и диапазон мышкой, разложите колонки по полям, нажмите «Проверить» — статистика и предпросмотр покажут результат ещё до записи, после чего нажмите «Загрузить».

Какие форматы файлов поддерживает импорт?

CSV и любые текстовые файлы, JSON (массив объектов превращается в таблицу) и Excel: XLSX, XLSM, XLSB и старый XLS. Кодировка — UTF-8 или Windows-1251; разделители полей и строк настраиваются или определяются автоматически.

Чем формулы импорта отличаются от формул Excel?

Это JavaScript-выражения, а не Excel-функции: СЦЕПИТЬ и ЕСЛИ не работают — вместо них конкатенация и тернарный оператор. Колонка подставляется в квадратных скобках: [Кол-во]*[Цена] — число; '[Фамилия]' + ' ' + '[Имя]' — склейка текста, текстовые значения берутся в кавычки; [Сумма] > 0 ? [Сумма] : 0 — условие. Формулы считаются уже на этапе «Проверить», ошибочные выражения видны в предпросмотре и попадают в счётчик ошибок.

Импорт обновляет существующие записи или только создаёт новые?

Только создаёт. Сопоставления с существующими строками по ключевой колонке в универсальном импорте нет — обновление данных делается другими средствами системы. Защита от дублей при создании новой таблицы — флаг уникальности первой колонки.

Как загрузить данные в подчинённую таблицу?

Родителя укажите поиском по значению или #ID — тогда все записи уйдут в одну родительскую запись, — или номером колонки файла, откуда брать родителя или его ID: записи разложатся по разным родителям за одну загрузку. Галка «Создавать родителя, если его нет» создаст недостающих родителей автоматически.

Что показывает статистика перед загрузкой?

По каждой колонке: сколько значений пустых и сколько не распознано типом, минимум и максимум, а для числовых колонок — среднее и сумма. Предпросмотр добавляет итоги: всего строк, ошибок, пустых ячеек, пропущено пустых; пустые строки пропускаются целиком, длинные выгрузки листаются по 1000 строк.

Источники