Массовый импорт комплектующих в справочники конфигуратора: как сопоставлять поля

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

Сначала составьте инвентарь справочников

Перечислите реально участвующие справочники и их роль в выборе. Для каждого нужны поля, типы, обязательность, множественность и связи с другими сущностями. Не переносите внутренние ID рабочего проекта в публичную инструкцию. В учебном примере достаточно нейтральных названий «Модуль», «Объём» и «Совместимая серия».

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

Отдельно проверьте вычисляемые и служебные поля. Их не следует автоматически делать доступными для перезаписи из произвольного файла. Права оператора импорта ограничивают нужными сущностями и действиями. Возможность загрузить таблицу не должна означать возможность изменить всю структуру справочника.

Штатный импорт и пользовательский загрузчик различаются

Документация 1С-Битрикс описывает штатный XML-импорт Highload-блоков с настройками структуры и внешнего ключа. Это не подтверждает наличие готового универсального загрузчика любых таблиц с произвольными колонками. Если задаче нужно сопоставление из другого формата, его контракт и реализация проверяются отдельно.

Сначала оцените, можно ли использовать существующий поддерживаемый инструмент без потери требований. Пользовательский интерфейс оправдан, когда оператору нужен другой формат, предварительный просмотр или специфические правила связей. Не стоит писать параллельный импорт только потому, что стандартный экран выглядит техническим.

Если структура справочника уже существует, импорт данных не должен незаметно переименовывать таблицу или менять типы полей. Операции над схемой и над записями разделяют. Иначе обычная загрузка комплектующих способна сломать потребителей, которые ожидают прежнюю модель.

Устойчивый ключ важнее названия комплектующего

Для повторного обновления нужен ключ, который однозначно связывает строку файла с записью. Название может меняться, содержать разное оформление или совпадать у двух позиций. Если обновлять только по нему, переименование создаст дубль, а совпадение затронет не тот компонент.

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

Если у старых записей устойчивого ключа нет, первичное сопоставление становится отдельной подготовительной задачей. Можно дать оператору подтверждение неоднозначных соответствий на ограниченном наборе. Нельзя объявлять точным автоматический поиск по похожему имени без проверки.

Сопоставление колонок должно быть проверяемым

Покажите оператору имя исходной колонки, несколько учебных значений и целевое поле с типом. Это помогает заметить, что колонка «Объём» содержит текст с единицами, а поле ожидает число. Автоматическое предложение допустимо как помощь, но окончательное соответствие должно быть видно до запуска.

Не допускайте случайного назначения двух колонок одному полю без правила объединения. Для множественных значений заранее определите разделитель, экранирование и смысл пустой ячейки. Строка с разделителем внутри названия не должна неожиданно превратиться в две комплектующие.

Сохраняемый профиль сопоставления полезен для повторяющихся файлов, но проверяет версию шаблона. Если поставщик переименовал или переставил колонки, прежний профиль не должен молча читать другую информацию. Сопоставление по позиции без контроля заголовков особенно уязвимо к таким изменениям.

Пустое значение требует отдельной семантики

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

Для множественного поля различайте пустой список и не переданное поле. Для числового параметра отличайте 0 от отсутствия. Для связи отличайте неизвестный код от намеренного удаления привязки. Такие различия нужно проверить на учебных примерах, потому что визуально пустая ячейка скрывает несколько смыслов.

Если оператору нужен полный режим замены, обозначьте его явно и покажите последствия до запуска. Частичный импорт и полное обновление нельзя выбирать скрытым флажком с неясной подписью. Особенно опасно смешивать их в одном файле без построчного договора.

Проверяйте связи до изменения записей

Комплектующая может ссылаться на серию, производителя или правило совместимости. Сначала разрешите эти ссылки и найдите неоднозначности. Создание недостающего справочника автоматически допустимо только при согласованном правиле. Иначе опечатка в названии породит новую серию и разорвёт выбор в конфигураторе.

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

Не превращайте ошибку одной ссылки в молчаливое обнуление совместимости. Запись может сохраниться и исчезнуть из всех допустимых сочетаний, хотя оператор увидит общий успех. Ошибка должна быть связана со строкой файла и конкретным полем, чтобы её можно было исправить.

Предварительный просмотр должен показывать изменения

До записи полезен diff: прежнее значение и предлагаемое новое для затронутых полей. Оператор видит, сколько записей создаётся, обновляется, пропускается и отклоняется. Если ожидалось обновление десяти позиций, а план предлагает создать сотню, это сигнал неверного ключа или сопоставления.

Предпросмотр не должен сам изменять справочник. Повтор его запуска с тем же файлом должен давать тот же план при неизменном исходном состоянии. Если данные изменились между просмотром и применением, нужна повторная проверка или согласованная защита от устаревшего плана.

Для больших наборов показывайте сводку и доступные детали ошибок, а не огромную необозримую таблицу. Но возможность найти конкретную строку сохраняется. Общий счётчик «ошибок 5» без объяснения не позволяет оператору подготовить исправленный файл.

Повтор и частичный сбой

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

Выберите границу принятия: весь пакет или отдельные записи. Транзакционность зависит от архитектуры и объёма; статья не обещает её автоматически. Но оператор должен видеть конечное состояние, а конфигуратор не должен использовать смесь, которая нарушает согласованные связи.

Журнал хранит идентификатор учебного пакета, результаты строк и причины ошибок без лишних секретов. Полный исходный файл может иметь собственные ограничения хранения. Для публичного примера достаточно синтетического набора, который воспроизводит типы и связи.

Проверьте конфигуратор после загрузки

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

Добавьте отрицательное сочетание, которое должно быть запрещено. Если импорт очистил связь или перепутал код серии, конфигуратор может начать разрешать несовместимые позиции. Поэтому проверка должна подтверждать как доступность правильного выбора, так и сохранение ограничений.

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

Подробный пример повторного импорта

Создайте учебный файл с тремя компонентами и устойчивыми кодами. Первый новый, второй уже существует с изменяемым названием, третий содержит ошибочную связь. Предпросмотр должен предложить создание, обновление и отказ соответственно. До записи проверьте, что изменяемое имя не стало новым ключом.

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

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

Как проверить смену шаблона таблицы

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

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

Проверьте кодировку и символы в названиях. Кириллица должна сохраниться, кавычки не должны ломать разбор, а разделитель внутри значения должен обрабатываться по формату. Нельзя молча вырезать символы так, что два разных компонента превращаются в одинаковое имя.

Восстановление после остановки

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

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

После восстановления снова выполните пробную сборку с изменённым компонентом и запрещённым сочетанием. Это закрывает связь между технической загрузкой и пользовательской совместимостью. Сохранённые строки сами по себе ещё не доказывают правильную работу выбора.

Результат предварительного просмотра должен оставаться доступным оператору до подтверждения, чтобы он мог сравнить план с исходным файлом и остановить ошибочное сопоставление.

Если профиль импорта сохраняется, укажите его назначение и допустимый шаблон файла. Другой оператор должен понимать, к какому справочнику он относится. Понятное имя профиля предотвращает случайную загрузку одинаковых колонок в другую сущность.

Связанные разборы

Для смежных решений пригодятся материалы: Товары из 1С на сайте: подготовка каталога к обмену | S-WEBS24. Общий обмен с учётной системой определяет границы данных. Для справочников конфигуратора отдельно нужны стабильные ключи, порядок зависимостей и правила повторного импорта.

Вопросы по теме

Можно ли обновлять по названию?

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

Доказывает ли успешный импорт работу конфигуратора?

Нет. Нужна пробная сборка с проверкой новых вариантов и запрещённых сочетаний.

Документация и источники

• 1С-Битрикс: импорт Highload-блока: Штатный XML-импорт имеет настройку внешнего ключа; произвольное сопоставление колонок требует отдельного контракта.
• 1С-Битрикс: работа с инфоблоками: Поля и свойства служат моделью контента; пример статьи не утверждает наличие готового универсального импортёра.