Импорт данных из файла

Загрузка данных из файла - это первый шаг большинства воронок. В этом руководстве разберём, какие форматы поддерживаются, как подготовить файл, настроить процессор загрузки и решить типичные проблемы.

Поддерживаемые форматы

Формат	Расширение	Описание
CSV	.csv	Текстовый формат с разделителями (запятая, точка с запятой, табуляция)
Excel	.xlsx	Формат Microsoft Excel (только xlsx, не xls)
JSON	.json	Массив объектов в формате JSON

Подготовка файла

CSV-файл

Для корректной загрузки CSV-файл должен соответствовать следующим требованиям:

• Кодировка: UTF-8 (рекомендуется). Также поддерживаются Windows-1251 и CP866.
• Заголовки: первая строка должна содержать названия колонок.
• Разделитель: запятая (,), точка с запятой (;) или табуляция. Система определяет разделитель автоматически.
• Кавычки: если значение содержит разделитель, оно должно быть заключено в двойные кавычки.

Пример корректного CSV-файла:

inn;name;city
7712345678;ООО Ромашка;Москва
7798765432;ООО Василёк;Санкт-Петербург
5001234567;ЗАО Подсолнух;Новосибирск

Excel-файл

• Используйте формат .xlsx (не .xls).
• Данные должны находиться на первом листе книги.
• Первая строка должна содержать заголовки колонок.
• Избегайте объединённых ячеек и сложного форматирования.
• Убедитесь, что числовые колонки (ИНН, КПП) отформатированы как текст, чтобы ведущие нули не были потеряны.

JSON-файл

Файл должен содержать массив объектов:

[
  {"inn": "7712345678", "name": "ООО Ромашка", "city": "Москва"},
  {"inn": "7798765432", "name": "ООО Василёк", "city": "Санкт-Петербург"}
]

Каждый объект станет отдельным пакетом данных.

Настройка процессора “Загрузка файла”

Шаг 1. Добавьте процессор на холст

Перетащите процессор “Загрузка файла” (File Upload) из палитры на холст визуального редактора.

Шаг 2. Загрузите файл

1. Кликните на узел процессора, чтобы открыть панель настроек.
2. Нажмите кнопку “Загрузить файл” или перетащите файл в область загрузки.
3. Дождитесь завершения загрузки. Система покажет превью первых строк.

Шаг 3. Проверьте распознавание колонок

После загрузки система автоматически определит:

• Разделитель (для CSV)
• Названия колонок (из заголовков)
• Типы данных (текст, число, дата)

Проверьте таблицу превью: все колонки должны быть распознаны корректно.

Шаг 4. Настройте маппинг колонок (при необходимости)

Если названия колонок содержат пробелы, кириллицу или специальные символы, рекомендуется задать псевдонимы (alias) - короткие латинские имена, которые будут удобны для использования в переменных:

Исходная колонка	Псевдоним
ИНН компании	inn
Наименование	name
Город	city

Псевдонимы будут использоваться в переменных: {{file-upload.inn}}, {{file-upload.name}}.

Шаг 5. Настройте дополнительные параметры

• Пропуск строк: если в файле есть дополнительные строки перед данными, укажите количество строк для пропуска.
• Кодировка: если автоопределение не сработало, выберите кодировку вручную.
• Лимит строк: максимальное количество строк для обработки. Полезно при тестировании.

Шаг 6. Сохраните настройки

Нажмите “Сохранить”. Процессор готов к работе.

Просмотр импортированных данных

После выполнения процессора загрузки вы можете просмотреть результаты:

1. Кликните на узел процессора.
2. Выберите “Просмотр данных” (или перейдите на вкладку “Данные”).
3. Данные отобразятся в табличном виде.

В таблице доступны:

• Сортировка по любой колонке (клик на заголовок)
• Пагинация для больших объёмов данных
• Поиск по содержимому

Типичные проблемы и решения

Кириллица отображается некорректно (кракозябры)

Причина: файл сохранён в кодировке Windows-1251, а система ожидает UTF-8.

Решение:

• В настройках процессора вручную выберите кодировку Windows-1251.
• Либо пересохраните файл в UTF-8 в текстовом редакторе.

ИНН отображается как число (без ведущих нулей)

Причина: Excel автоматически преобразует длинные числа.

Решение:

• Перед импортом в Excel отформатируйте колонку ИНН как “Текст”.
• Или используйте CSV-формат, где эта проблема не возникает.

Пустые строки или лишние данные

Причина: в файле есть пустые строки между данными или служебные строки в конце.

Решение:

• Удалите пустые строки из файла.
• Или используйте фильтр inn IS NOT NULL на следующем процессоре.

Файл слишком большой

Причина: превышен лимит размера файла.

Решение:

• Разделите файл на несколько частей.
• Удалите ненужные колонки, чтобы уменьшить размер.
• Используйте CSV вместо Excel (CSV обычно значительно меньше по размеру).

Разделитель определён неверно

Причина: файл использует нестандартный разделитель.

Решение: в настройках процессора вручную укажите символ-разделитель.

Советы

• Всегда проверяйте превью данных после загрузки, прежде чем запускать воронка.
• Используйте понятные латинские названия колонок или задайте псевдонимы.
• Для тестирования загрузите файл с 3-5 строками, убедитесь в корректности, затем загрузите полный файл.
• Если данные поступают регулярно, стандартизируйте формат файла, чтобы не менять настройки каждый раз.

Что дальше

• Создание первого воронки - как использовать загруженные данные в воронке
• Настройка процессора - подробнее о параметрах конфигурации
• Решение проблем - общее руководство по диагностике