В процессе сопровождения и доработки типовых конфигураций 1С часто возникает задача полного перевода системы на поддержку с использованием расширений. Одна из типовых проблем — наличие объектов метаданных, измененных непосредственно в конфигурации. Рассмотрим частый случай: в типовое перечисление были добавлены новые значения, и теперь необходимо вынести эту доработку в расширение, чтобы "закрыть замочки" и упростить дальнейшие обновления.
Проанализируем ситуацию: у нас есть измененное перечисление, которое активно используется в документах, справочниках и других объектах. Задача — убрать изменения из основной конфигурации, не потеряв при этом данные. Разберем два основных подхода к решению этой задачи: современный, доступный на новых версиях платформы, и классический, более трудоемкий, но универсальный.
Начнем с наиболее предпочтительного и наименее трудозатратного метода. Начиная с версии платформы 1С:Предприятие 8.3.14, появилась замечательная возможность добавлять собственные значения в перечисления, заимствованные из основной конфигурации. Это кардинально упрощает нашу задачу.
Важные условия для применения этого способа:
Если эти условия выполняются, то процесс переноса доработки становится элементарным. Разберем его по шагам.
В чем главное преимущество? Тип данных реквизитов в базе не меняется. Мы не создаем новый объект, а лишь дополняем существующий. Это означает, что не требуется никакой обработки по переносу и замене данных. Все ссылки в документах, регистрах и справочниках останутся корректными. После обновления конфигурации базы данных система будет видеть как типовые значения, так и ваши, добавленные через расширение.
Иногда после выполнения описанных выше шагов можно столкнуться с ситуацией, когда новые значения перечисления есть в системе, но не отображаются в выпадающих списках на формах. Почему так происходит?
Причина чаще всего кроется в том, что список выбора для поля формы заполняется не автоматически, а программно. Разработчики типовых конфигураций могут ограничивать список доступных значений в зависимости от каких-либо условий. В этом случае нам потребуется дополнительно расширить логику формы.
Как это исправить:
&После или &Вместо.СтандартнаяОбработка) вашими новыми значениями из перечисления.Этот способ следует использовать, если условия для современного подхода не выполняются (например, используется старая версия платформы или режим совместимости). Он полностью соответствует логике, предложенной на форуме, и является гораздо более трудоемким и рискованным.
Внимание! План, при котором вы просто заменяете измененную конфигурацию на типовую версию с сайта ИТС, приведет к безвозвратной потере данных! При удалении значений перечисления из конфигурации платформа удалит все записи, которые на них ссылались. Поэтому этап миграции данных является обязательным.
Разберем процесс по шагам.
В расширении создаем новое перечисление. Назовем его, например, моё_СтатусыЗаказов. В него необходимо скопировать все значения из исходного перечисления: и типовые, и добавленные вами. Важно, чтобы имена и синонимы совпадали для упрощения дальнейшей миграции.
Необходимо найти все места, где используется старое перечисление. Для этого используйте глобальный поиск по конфигурации или инструмент "Найти ссылки на объект". Нам нужно составить полный список документов, справочников, регистров (сведений и накопления), в реквизитах которых используется наше измененное перечисление.
Это самый ответственный этап. Нужно создать специальную обработку, которая пройдет по всем объектам из списка, найденного на предыдущем шаге, и для каждой записи заменит ссылку со старого значения перечисления на аналогичное значение из нового перечисления. Чтобы ускорить написание кода, можно использовать Консоль кода + ИИ-помощник (GigaChat).
Ключевой момент при такой замене — использование режима ОбменДанными.Загрузка = Истина. Этот режим позволяет записывать объекты, отключая многие проверки целостности, бизнес-логику в обработчиках событий (ПередЗаписью, ПриЗаписи) и автоматическое проведение документов. Это необходимо для выполнения "технической" перезаписи данных без побочных эффектов.
Посмотрим на примерный код для одного из объектов, например, документа "ЗаказКлиента".
Процедура ПеренестиДанныеПоДокументам()
// Создаем соответствие между старыми и новыми значениями
СоответствиеЗначений = Новый Соответствие;
Для Каждого Значение Из Метаданные.Перечисления.СтароеПеречисление.ЗначенияПеречисления Цикл
Попытка
СоответствиеЗначений.Вставить(
Перечисления.СтароеПеречисление[Значение.Имя],
Перечисления.моё_НовоеПеречисление[Значение.Имя]
);
Исключение
Сообщить("Не найдено соответствие для значения: " + Значение.Имя);
КонецПопытки;
КонецЦикла;
// Выбираем все документы, которые нужно обработать
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| ЗаказКлиента.Ссылка
|ИЗ
| Документ.ЗаказКлиента КАК ЗаказКлиента
|ГДЕ
| ЗаказКлиента.СтарыйРеквизитСтатус <> ЗНАЧЕНИЕ(Перечисление.ПустаяСсылка)";
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
Попытка
ОбъектДокумент = Выборка.Ссылка.ПолучитьОбъект();
// Получаем старое значение
СтароеЗначение = ОбъектДокумент.СтарыйРеквизитСтатус;
// Находим новое значение по соответствию
НовоеЗначение = СоответствиеЗначений[СтароеЗначение];
Если НовоеЗначение <> Неопределено Тогда
ОбъектДокумент.НовыйРеквизитСтатус = НовоеЗначение; // Предполагается, что вы временно добавили новый реквизит
// Записываем объект в режиме обмена данными
ОбменДанными.Загрузка = Истина;
ОбъектДокумент.Записать(); // Используем нужный режим записи
ОбменДанными.Загрузка = Ложь;
Иначе
Сообщить("Не удалось найти новое значение для " + СтароеЗначение + " в документе " + Выборка.Ссылка);
КонецЕсли;
Исключение
ОбменДанными.Загрузка = Ложь;
Сообщить("Ошибка при обработке документа " + Выборка.Ссылка + ": " + ОписаниеОшибки());
КонецПопытки;
КонецЦикла;
КонецПроцедуры
Такую логику нужно будет повторить для каждого типа объекта, использующего перечисление. Чтобы не добавлять временные реквизиты, можно сразу изменять тип реквизита в расширении и выполнять миграцию, но это более сложный сценарий.
После того как обработка отработала и вы убедились (с помощью отчетов и выборочной проверки), что все данные перенесены корректно, можно приступать к завершению. Для этого необходимо в расширении изменить тип всех реквизитов, которые раньше ссылались на старое перечисление, на ваше новое перечисление. После этого в основной конфигурации можно удалять добавленные значения. Обязательно сделайте резервную копию базы перед этими действиями!
Проанализировав оба подхода, можно сделать однозначный вывод. Если ваша версия платформы и режим совместимости конфигурации 8.3.14 или выше, всегда используйте первый способ — добавление значений в заимствованное перечисление. Это быстро, безопасно и не требует сложных манипуляций с данными.
Второй, классический способ — это мощный, но опасный инструмент. Он остается актуальным для старых систем или для более сложных сценариев рефакторинга метаданных. Прибегая к нему, помните о необходимости тщательного планирования, полного резервного копирования базы данных и многократной проверки результатов миграции перед тем, как удалять старые объекты или данные из основной конфигурации.