Что такое мэппинг в 1С и как настроить сопоставление данных

Мэппинг (от англ. mapping — «сопоставление») в 1С — это процесс установления соответствия между данными разных систем, форматов или конфигураций. Когда информационная база 1С обменивается данными с сайтом, другой конфигурацией, банковским клиентом или внешним сервисом, структуры данных почти никогда не совпадают один в один: поля называются по-разному, типы отличаются, часть реквизитов существует только в одной из систем. Мэппинг описывает, какое поле источника в какое поле приёмника попадает и как его нужно преобразовать.

Практически мэппинг встречается в трёх формах: правила конвертации данных (ПКО, ПКС) в типовой обработке «Конвертация данных» и механизме EnterpriseData, сопоставление объектов при синхронизации через планы обмена, а также ручное сопоставление полей при загрузке данных из табличных документов и файлов. Во всех случаях суть одна — задать таблицу соответствий, по которой система переносит значения без потерь и дублей.

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

Где именно применяется мэппинг в 1С

Чаще всего с мэппингом сталкиваются при синхронизации двух конфигураций — например, «Управление торговлей» и «Бухгалтерия предприятия». Типовая синхронизация уже содержит готовые правила сопоставления справочников и документов, но при доработке конфигураций (добавлении своих реквизитов) эти правила приходится расширять вручную.

Второй типовой сценарий — обмен с внешними системами: сайтом на CMS, CRM, маркетплейсами, WMS или банковскими сервисами. Здесь мэппинг описывает соответствие между структурой 1С и форматом обмена (XML, JSON, CommerceML). Например, поле «Артикул» в 1С может соответствовать полю sku в JSON-запросе к API маркетплейса.

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

Ключевые понятия: ПКО, ПКС и сопоставление объектов

В механизме конвертации данных мэппинг строится на двух базовых сущностях. ПКО — правило конвертации объектов — определяет соответствие между типами: например, справочник «Контрагенты» источника переносится в справочник «Контрагенты» приёмника, а документ «Реализация товаров и услуг» — в «Реализация (акты, накладные)». Для каждого ПКО задаётся способ поиска объекта в приёмнике — по уникальному идентификатору или по комбинации полей поиска (ИНН + КПП, код, наименование).

ПКС — правило конвертации свойств — работает внутри ПКО и описывает отдельные поля: реквизит «Наименование» источника записывается в реквизит «Наименование» приёмника, «ИНН» — в «ИНН» и так далее. Если типы значений различаются, в ПКС указывают правило конвертации значения или произвольный алгоритм на встроенном языке.

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

Как настроить мэппинг при типовой синхронизации

Типовые конфигурации на БСП (библиотеке стандартных подсистем) содержат готовые настройки синхронизации. Минимальная последовательность выглядит так: в разделе «Администрирование» — «Синхронизация данных» включается нужный вид обмена, создаётся настройка, указывается префикс базы и параметры подключения. После первого выгруженного пакета система переходит к этапу сопоставления.

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

1. 1
   Сделайте резервную копию обеих баз и проверьте настройку на копиях
2. 2
   Включите синхронизацию данных в разделе «Администрирование» и создайте настройку обмена
3. 3
   Выгрузите начальный пакет данных из базы-источника
4. 4
   На этапе сопоставления проверьте автоматические связи и вручную свяжите спорные объекты
5. 5
   Загрузите данные и сверьте количество и содержимое ключевых справочников
6. 6
   Проведите контрольный документ в источнике и убедитесь, что он корректно появился в приёмнике

Мэппинг через конвертацию данных и произвольные алгоритмы

Когда типовых правил не хватает — например, конфигурации сильно доработаны или обмен идёт с нестандартной системой, — используют конфигурацию «Конвертация данных» (для правил обмена в формате XML) или механизм EnterpriseData с XDTO-пакетами. В конвертации данных разработчик создаёт собственные ПКО и ПКС, а для нестандартных преобразований пишет алгоритмы: обработчики «Перед выгрузкой», «При загрузке», «После загрузки».

Типичный пример произвольного мэппинга — склейка и разборка полей. В источнике адрес хранится одной строкой, а в приёмнике — структурированно по полям КЛАДР (индекс, регион, город, улица). В обработчике ПКС строка разбирается и распределяется по нужным реквизитам. Обратная ситуация — несколько реквизитов источника собираются в одно поле приёмника — решается так же.

При работе с внешними API мэппинг часто реализуют напрямую в коде: структура или соответствие 1С заполняется из реквизитов объекта, сериализуется в JSON и отправляется через HTTP-соединение. При чтении ответа выполняется обратное сопоставление полей. Такой подход гибок, но требует аккуратной обработки типов: даты, булевы значения и числовые форматы в JSON и 1С представлены по-разному.

Соответствие = Новый Соответствие;
Соответствие.Вставить("sku", Объект.Артикул);
Соответствие.Вставить("name", Объект.Наименование);
Соответствие.Вставить("price", Объект.Цена);
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, Соответствие);
ТелоЗапроса = ЗаписьJSON.Закрыть();

Как проверить, что мэппинг настроен правильно

Проверка начинается с контрольных цифр: количество элементов в ключевых справочниках источника и приёмника после обмена должно совпадать с учётом отборов. Для документов полезно сверить итоговые суммы по выбранному периоду — расхождение укажет на потерянные или задвоенные объекты.

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

Типичные ошибки и ограничения

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

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

FAQ: частые вопросы о мэппинге в 1С