Как объединить расширение с конфигурацией в 1С — пошагово

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

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

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

1. Подготовка к объединению: что нужно проверить перед началом

Первый шаг — аудит расширения и основной конфигурации. Без этого этапа высок риск пропустить критичные изменения или столкнуться с конфликтами объектов. Начните с анализа:

📋 Списка объектов в расширении: откройте расширение в конфигураторе (Конфигурация → Открыть расширение) и экспортируйте список изменённых объектов через Файл → Сохранить данные конфигурации в файл. Это поможет отследить, какие элементы требуют переноса.
🔍 Зависимостей: проверьте, не использует ли расширение внешние обработки, библиотеки или дополнительные расширения. Их тоже придётся интегрировать или заменить аналогами в основной конфигурации.
⚙️ Конфликтов имён: если в расширении и основной конфигурации есть объекты с одинаковыми именами (например, общие модули или реквизиты), их придётся переименовывать или объединять вручную.
📊 Данных пользователей: некоторые расширения хранят данные в регистрах сведений или справочниках. Убедитесь, что эти данные не будут утеряны при объединении (например, настройки интерфейса или пользовательские параметры).

Особое внимание уделите управляемым формам. Если расширение модифицирует форму документа или справочника, а в основной конфигурации эта форма тоже изменялась (например, в новом релизе), при объединении может произойти конфликт версий. В таком случае платформа предложит выбрать, какую версию формы сохранить — вашу (из расширения) или типовую. Здесь нет универсального совета: иногда правильнее сохранить типовую форму и перенести изменения вручную, а иногда — наоборот.

⚠️ Внимание: Если расширение использует Подписки на события (например, ПередЗаписью или ПриОткрытии), их придётся переносить в основную конфигурацию вручную. Автоматизированные инструменты (вроде Сравнение и объединение конфигураций) не всегда корректно обрабатывают такие конструкции.

2. Способы объединения расширения с конфигурацией: плюсы и минусы каждого

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

Способ	Когда использовать	Плюсы	Минусы
Ручной перенос	Мелкие доработки (1–5 объектов), уникальные изменения	Максимальный контроль, нет риска потери данных	Долго, требует опыта
Сравнение и объединение конфигураций	Средние и крупные доработки (от 5 объектов)	Автоматизация, визуализация конфликтов	Может пропустить подписки на события или динамические изменения
Выгрузка/загрузка через DT	Перенос между разными базами или версиями	Сохраняет структуру данных, подходит для сложных конфигураций	Требует настройки правил обмена
Специализированные обработки (например, Универсальный обмен данными)	Массовое объединение или регулярные обновления	Гибкость, возможность автоматизации	Нужно настраивать под конкретную задачу

Наиболее универсальным и рекомендуемым способом является использование инструмента "Сравнение и объединение конфигураций". Он входит в стандартный набор средств конфигуратора и позволяет визуально контролировать процесс слияния. Однако для сложных случаев (например, если расширение добавляет новые справочники или документы) может потребоваться комбинация методов.

Если вы работаете с распределённой информационной базой (РИБ), перед объединением убедитесь, что изменения не конфликтуют с правилами обмена. В некоторых случаях проще перенести расширение в центральную базу, а затем распределить изменения по узлам.

💡

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

3. Пошаговая инструкция: объединение через "Сравнение и объединение конфигураций"

Этот метод подходит для большинства случаев и позволяет минимизировать риски. Следуйте инструкции:

Откройте основную конфигурацию в режиме Конфигуратор и сохраните её резервную копию (Файл → Сохранить данные конфигурации в файл).
Перейдите в Конфигурация → Сравнить, объединить с конфигурацией из файла и выберите файл расширения (.cf или .epf).
В окне сравнения вы увидите три колонки:
- 📄 Основная конфигурация (слева),
- 📄 Расширение (справа),
- 🔄 Результат объединения (по центру).

Платформа автоматически выделит цветом различия между объектами.

Для каждого конфликтующего объекта выберите, какую версию оставить:

🟢 Зелёная стрелка влево — оставить версию из основной конфигурации,
🔴 Красная стрелка вправо — взять версию из расширения,
🔵 Синяя стрелка вниз — объединить изменения вручную (для модулей и форм).

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

Особое внимание уделите объектам с пометкой [Изменено] в колонке результата. Это означает, что платформа не смогла автоматически объединить изменения, и вам придётся редактировать их вручную. Например, если в расширении и основной конфигурации модифицирован один и тот же метод модуля, 1С предложит выбрать одну из версий или объединить код самостоятельно.

Создана резервная копия конфигурации|Закрыты все пользовательские сеансы|Проверены зависимости расширения|Экспортирован список изменённых объектов|Подготовлены права доступа для тестирования-->

Критическая особенность: если расширение добавляло новые реквизиты в справочники или документы, после объединения эти реквизиты станут частью основной конфигурации. Однако данные, которые уже были записаны в эти реквизиты через расширение, могут оказаться недоступны, пока не будет выполнено обновление структуры базы данных (Администрирование → Обновление конфигурации базы данных).

4. Ручной перенос изменений: когда без него не обойтись

Автоматизированные инструменты не всегда справляются с динамическими изменениями, такими как:

📜 Подписки на события (ПодписатьсяНаСобытие()),
🎨 Динамическое изменение форм через ПолучитьФорму(),
🔗 Внешние обработки или отчёты, подключённые через расширение,
📊 Модификации отчётов или обработок, которые не отображаются в дереве конфигурации.

В таких случаях придётся переносить изменения вручную. Алгоритм действий:

Откройте расширение в конфигураторе и экспортируйте модули, которые содержат критичные изменения (Файл → Сохранить данные модуля в файл).
В основной конфигурации найдите аналогичные модули (например, модуль документа или общий модуль) и вставьте код из расширения, адаптировав его под новую структуру.
Для подписок на события используйте механизм ПодпискиНаСобытия в основной конфигурации. Например, если расширение добавляло обработчик события ПередЗаписью для документа, перенесите этот код в модуль документа или в общий модуль с соответствующей подпиской.

Пример переноса подписки на событие:

// В модуле документа "РеализацияТоваровУслуг" Процедура ПередЗаписью(Отказ, РежимЗаписи) Экспорт // Код из расширения Если НЕ ЗначениеЗаполнено(Объект.Контрагент) Тогда Сообщить("Не указан контрагент!"); Отказ = Истина; КонецЕсли;

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

Если расширение добавляло новые команды в формы (например, кнопку "Печать дополнительного отчёта"), их придётся переносить через редактор формы. Для этого:

Откройте форму в основной конфигурации (Конфигурация → Формы → [Имя формы]).
Добавьте новую команду в коллекцию Команды.
Настройте действие команды (например, вызов обработки).
Разместите кнопку на форме через редактор.

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

5. Типичные ошибки и как их избежать

Даже опытные разработчики сталкиваются с проблемами при объединении расширений. Вот наиболее распространённые ошибки и способы их предотвращения:

🔄 Потеря данных в новых реквизитах: Если расширение добавляло реквизиты в справочники или документы, после объединения эти реквизиты станут parte основной конфигурации, но данные в них могут "исчезнуть" до обновления структуры базы. Решение: перед объединением экспортируйте данные через Выгрузка данных XML, а после — загрузите их обратно.
🚫 Конфликты имён общих модулей: Если в расширении и основной конфигурации есть модули с одинаковыми именами, платформа может перезаписать один из них. Решение: переименуйте модуль в расширении до объединения или объедините код вручную.
📉 Падение производительности: После объединения некоторые обработки могут начать работать медленнее из-за изменения структуры данных. Решение: протестируйте критичные операции (например, проведение документов) на тестовой базе.
🔌 Неработающие подписки на события: Если подписки перенесены некорректно, события могут не срабатывать. Решение: проверьте наличие процедур-обработчиков в модулях и правильность вызова ПодписатьсяНаСобытие().

Ещё одна частая проблема — несовместимость версий платформы. Если расширение разрабатывалось на 1С:Предприятие 8.3.18, а основная конфигурация работает на 8.3.20, некоторые методы или свойства могут быть устаревшими. Перед объединением проверьте журнал изменений платформы на предмет несовместимостей.

Что делать, если после объединения не работает форма?

Если после объединения форма документа или справочника не открывается или выдаёт ошибку, причины могут быть следующими:

1. Конфликт версий формы: платформа сохранила не ту версию (типовую или из расширения). Решение: откройте форму в конфигураторе и вручную перенесите изменения из расширения.

2. Отсутствие реквизитов: если расширение добавляло реквизиты, которые используются в форме, но они не были перенесены в основную конфигурацию. Решение: проверьте состав реквизитов объекта.

3. Ошибки в модуле формы: при ручном объединении кода могли быть пропущены важные процедуры. Решение: сравните модули формы из расширения и основной конфигурации.

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

6. Тестирование после объединения: чек-лист для проверки

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

📋 Все доработки из расширения работают корректно,
🔄 Не нарушена логика типовой конфигурации,
📊 Данные пользователей не потеряны,
🛡️ Нет ошибок при открытии форм или проведении документов.

Минимальный набор тестов:

Функциональные тесты: проверьте все сценарии, которые затрагивало расширение. Например, если расширение добавляло новую печатную форму, убедитесь, что она формируется без ошибок.
Тесты производительности: сравните скорость выполнения критичных операций (проведение документов, построение отчётов) до и после объединения.
Тесты интеграции: если расширение взаимодействовало с внешними системами (например, через HTTP-сервисы или COM-соединение), проверьте, что обмен данными работает.
Тесты прав доступа: убедитесь, что роли пользователей не потеряли права на новые объекты (например, на реквизиты, добавленные из расширения).

Для автоматизации тестирования можно использовать:

🤖 Скрипты на 1Script (например, через Vanessa-ADD),

📝 Тестовые сценарии в 1С:Тест-центр (если он подключён),

🔍 Ручную проверку ключевых операций (например, проведение документов за прошлые периоды).

💡
Если после объединения вы обнаружили критическую ошибку, не пытайтесь исправить её "на лету". Откат к резервной копии и повторное объединение с учётом ошибок сэкономят время.

Особое внимание уделите регламентным заданиям. Если расширение добавляло новые задания (например, для автоматической отправки отчётов), убедитесь, что они:

📅 Зарегистрированы в списке регламентных заданий (Администрирование → Регламентные задания),

⏰ Имеют корректный график выполнения,

👤 Назначены правильным пользователям или ролям.

7. Альтернативные подходы: когда объединение нецелесообразно

В некоторых случаях объединять расширение с конфигурацией не нужно. Рассмотрите альтернативные варианты:

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

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

🔄 Использование механизма "Конфигурации поставщика": Если вы поддерживаете несколько клиентов с похожими доработками, имеет смысл вынести общие изменения в отдельную конфигурацию-поставщика и подключать её как зависимость.

Преимущества отказа от объединения:

✅ Проще обновлять типовую конфигурацию (не нужно повторять объединение после каждого релиза).

✅ Меньше рисков нарушить работоспособность основной конфигурации.

✅ Гибкость: можно отключать или модифицировать расширение без изменения основной конфигурации.

Однако у этого подхода есть и минусы:

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

❌ Ограничения функциональности: некоторые механизмы (например, модификация системных отчётов) сложно реализовать через расширения.

Если вы решили оставить расширение, но хотите упростить его поддержку, используйте версионный контроль (например, через Git и OneScript). Это поможет отслеживать изменения и быстро откатываться к предыдущим версиям.

⚠️ Внимание: Если вы работаете с облачной версией 1С (например, 1С:Fresh), возможности по модификации конфигурации ограничены. В этом случае объединение расширения может быть единственным способом внедрить доработки. Уточните ограничения в документации вашего тарифа.

FAQ: Частые вопросы по объединению расширений в 1С

Можно ли объединить расширение с конфигурацией, если они на разных версиях платформы?

Технически да, но это чревато ошибками. Если расширение разрабатывалось на более старой версии 1С:Предприятие, некоторые методы или свойства объектов могли измениться. Рекомендуется:

Обновить расширение до актуальной версии платформы.

Проверить совместимость кода с новой версией (например, через Проверка конфигурации в конфигураторе).

Объединять на тестовой базе и тщательно тестировать результат.

Что делать, если после объединения пропали данные в новых реквизитах?

Это типичная проблема, если новые реквизиты добавлялись через расширение. Данные не пропадают физически, но становятся недоступны, пока не будет обновлена структура базы данных. Решение:

Выполните Администрирование → Обновление конфигурации базы данных.

Если данные критичны, предварительно экспортируйте их через Выгрузка данных XML и загрузите обратно после обновления.

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

Как перенести подписки на события из расширения в основную конфигурацию?

Подписки на события (ПодписатьсяНаСобытие()) не переносятся автоматически. Вам нужно:

Найти в расширении все вызовы ПодписатьсяНаСобытие() (обычно они находятся в модуле приложения или общих модулях).

Перенести эти вызовы в соответствующие модули основной конфигурации.

Убедиться, что обработчики событий (процедуры, на которые вешается подписка) также перенесены и доступны в новом контексте.

Пример:

// В модуле приложения основной конфигурации Процедура ПриНачалеРаботыСистемы() ПодписатьсяНаСобытие("Документ.РеализацияТоваровУслуг", "ПередЗаписью", "ОбщийМодуль.МоиОбработчики", "ПередЗаписьюРеализации");
КонецПроцедуры

Можно ли отменить объединение расширения с конфигурацией?

Нет, отменить объединение "назад" нельзя — это необратимая операция. Однако вы можете:

Восстановить конфигурацию из резервной копии (если она была сделана до объединения).

Вручную удалить все изменения, перенесённые из расширения (долго и рискованно).

Создать новое расширение и перенести в него критичные доработки из основной конфигурации.

Именно поэтому резервное копирование — обязательный этап перед любыми манипуляциями с конфигурацией.

Как объединить несколько расширений в одну конфигурацию?

Если у вас несколько расширений, их можно объединить последовательно:

Объедините первое расширение с основной конфигурацией.

Сохраните результат как новую базовую конфигурацию.

Объедините второе расширение с полученной конфигурацией, и так далее.

Альтернативный вариант — предварительно объединить расширения между собой (если это возможно), а затем перенести результат в основную конфигурацию. Для этого:

Создайте новую пустую конфигурацию.

Поочерёдно объедините её с каждым расширением.

Объедините полученную конфигурацию с основной.

Обратите внимание на конфликты имён: если в разных расширениях есть объекты с одинаковыми именами, их придётся переименовывать или объединять вручную.

Объединение расширения с конфигурацией 1С: полное руководство для разработчиков и администраторов

1. Подготовка к объединению: что нужно проверить перед началом

2. Способы объединения расширения с конфигурацией: плюсы и минусы каждого

3. Пошаговая инструкция: объединение через "Сравнение и объединение конфигураций"

4. Ручной перенос изменений: когда без него не обойтись

5. Типичные ошибки и как их избежать

6. Тестирование после объединения: чек-лист для проверки

7. Альтернативные подходы: когда объединение нецелесообразно

FAQ: Частые вопросы по объединению расширений в 1С

📖 Читайте также