Масштабируемый импорт Excel на БСП

Время чтения: 10 минут  |  Уровень: Начинающие разработчики  |  Платформа: 8.3.25+

Представьте: вы получаете ТЗ на импорт прайса из Excel. 12 колонок, 9 справочников, 10 000 строк. Архитектор говорит: «Только БСП, никаких самописных обработчиков».

Эта статья — готовый рецепт, как настроить масштабируемый импорт, который:

• Не сломается при добавлении новой колонки
• Понятен техподдержке без вашего участия
• Проходит статический анализ без дублирования кода
• Сохраняет нервы пользователя (двухэтапная проверка)
• Чётко различает: пустое значение ≠ ошибка

Общая схема работы

Ниже описан полный цикл обработки данных от выбора файла до записи в регистр:

Три сценария сопоставления

Сценарий 1: Пустая колонка в файле (бизнес-норма)

Пример: строка файла с незаполненными полями Покупатель и Магазин:

Логика обработки:

• ЗначениеЗаполнено(Покупатель) = Ложь
• ПолучитьСсылкуПоРезультатуСопоставления() сразу возвращает Неопределено
• В список неоднозначностей НЕ попадает (это не ошибка!)
• В итоговой таблице: Покупатель = ПустаяСсылка

Сценарий 2: Объекта нет в базе

Допустим, контрагент с ИНН 7701234567 не существует в базе:

Логика обработки:

• ЛЕВОЕ СОЕДИНЕНИЕ не находит соответствия → СтрокаРезультата = Неопределено
• СопоставленоКорректно() фиксирует отсутствие записи
• Добавляется в СписокНеоднозначностей
• В интерфейсе БСП пользователь видит: <не найдено: 7701234567>

Действия пользователя:

• Создать нового контрагента
• Исправить ИНН в файле
• Выбрать существующего из списка

Сценарий 3: Неоднозначность (несколько объектов)

В базе две позиции с названием "Футболка Nike" (разные артикулы):

Логика обработки:

• Запрос с группировкой возвращает Количество = 2
• СопоставленоКорректно() фиксирует множественное соответствие
• Добавляется в СписокНеоднозначностей
• Пользователь видит обе позиции и выбирает правильную

Элементы объектной архитектуры в процедурном коде

Хотя 1С — процедурный язык, в решении применяются принципы ООП, которые делают код поддерживаемым:

Пример инкапсуляции — настройка поиска для колонки:

// Настройка поиска для колонки
Настройка = Новый Структура;
Настройка.Вставить("ТекстЗапроса", ТекстЗапроса);
Настройка.Вставить("КлючПоиска", КлючПоиска);
Настройка.Вставить("ИмяКолонкиМакета", ИмяКолонкиМакета);

Пример основной процедуры сопоставления:

//универсальный шаблон
//цель, чтобы при других доработках его не нужно было менять
//далее ее можно сделать общей для всех загрузок чуть чуть доработав, но пока такой цели не было.
Процедура СопоставитьЗагружаемыеДанные(
    АдресЗагружаемыхДанных,
    АдресТаблицыСопоставления,
    СписокНеоднозначностей,
    ПолноеИмяТабличнойЧасти,
    ДополнительныеПараметры) Экспорт

    ТаблицаСопоставления = ПолучитьИзВременногоХранилища(
        АдресТаблицыСопоставления);
    ЗагружаемыеДанные = ПолучитьИзВременногоХранилища(
        АдресЗагружаемыхДанных);

    Результаты = ВыполнитьЗапросСопоставления(ЗагружаемыеДанные);

    Для Каждого СтрокаДанных Из ЗагружаемыеДанные Цикл
        НоваяСтрока = ТаблицаСопоставления.Добавить();
        ЗаполнитьЗначенияСвойств(НоваяСтрока, СтрокаДанных);
        ОбработатьСтрокуСопоставления(
            НоваяСтрока,
            СтрокаДанных,
            Результаты,
            СписокНеоднозначностей);
    КонецЦикла;

    ПоместитьВоВременноеХранилище(
        ТаблицаСопоставления, АдресТаблицыСопоставления);

КонецПроцедуры

Интерфейс пользователя: двухэтапная проверка

Этап 1: Предварительное сопоставление

Пользователь видит «сырые» данные из файла и результаты автоматического сопоставления. Ошибки выделены цветом, неоднозначности помечены специальным значком.

Этап 2: Финальное подтверждение

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

Зачем это нужно:

• Снижает когнитивную нагрузку: сначала «nайти ошибки», потом «подтвердить результат»
• Даёт возможность исправить данные до записи в регистр
• Формирует аудиторский след: что было в файле → что попало в базу

Чек-лист внедрения

Шаг 1: Скачайте шаблон в статье

Шаг 2: Запустите тестовую загрузку в типовой демо-базе

Шаг 3: Как адаптировать под свой объект — 4 точки изменений

Всё остальное — универсальный каркас, который не трогают.

Шаг 4: Протестируйте граничные случаи

Создайте тестовый файл с 5 строками:

• [ ] Все колонки заполнены, все объекты есть в базе — ожидаем успех
• [ ] Одна колонка пустая — ожидаем: не ошибка
• [ ] Объект не найден в базе — ожидаем: попадание в неоднозначности
• [ ] Неоднозначность: несколько объектов с одинаковым названием — ожидаем: выбор пользователем
• [ ] Обязательное поле пустое — ожидаем: ошибка при финальной загрузке

Шаг 5: Документируйте для пользователей

• [ ] Создайте инструкцию: как скачать шаблон, какие колонки обязательные
• [ ] Добавьте скриншоты интерфейса с пояснениями
• [ ] Укажите контакты техподдержки для вопросов по неоднозначностям

Шаг 6: Запросите код-ревью

• [ ] Покажите обработку коллеге: понятна ли логика без ваших комментариев?
• [ ] Прогоните через встроенный анализатор: нет ли дублирования?
• [ ] Убедитесь, что все запросы параметризованы (защита от инъекций)

У вас работает масштабируемый импорт на БСП, который:

• Принимает архитектура
• Понимает техподдержка
• Не ломается при изменениях
• Бережёт нервы пользователей

Перед применением ознакомьтесь с документацией на ИТС, а так же со статьей.

Спасибо за внимание!

P.S

Предусмотрено несколько вариантов доната с разными ценовыми опциями, чтобы каждый мог поддержать автора в соответствии со своими возможностями и уровнем вовлечённости.