Добавление колонки реквизита программно в 1С

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

Реализация данного механизма требует глубокого понимания работы с объектами метаданных в режиме выполнения. Вам предстоит использовать классы Метаданные, ОбъектМетаданных и РеквизитОбъектаМетаданных для модификации структуры документа или справочника.

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

Подготовка окружения и проверка прав доступа

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

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

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

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

Получение объекта метаданных для модификации

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

Код для получения объекта выглядит следующим образом. Мы обращаемся к коллекции документов и ищем элемент с именем "РеализацияТоваровУслуг". Если объект не найден, дальнейшее выполнение процедуры не имеет смысла, и скрипт должен быть прерван.

ИмяОбъекта = "РеализацияТоваровУслуг";
ОбъектМетаданных = Метаданные.Документы[ИмяОбъекта];

Если ОбъектМетаданных = Неопределено Тогда
Сообщить("Объект метаданных не найден!");
Возврат;
КонецЕсли;

После получения объекта необходимо определить, к какой именно части мы будем добавлять реквизит. В большинстве случаев требуется расширение табличной части, например, "Товары". Для этого нужно получить ссылку на объект табличной части через свойство ТабличныеЧасти основного объекта метаданных.

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

Создание нового реквизита и настройка свойств

Основной этап работы — это непосредственное создание экземпляра реквизита и наполнение его свойствами. Для этого используется конструктор Новый РеквизитОбъектаМетаданных. Вы должны указать уникальное имя для новой колонки, которое будет использоваться в коде и запросах впоследствии.

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

• 📦 Для хранения текстовой информации используйте тип Строка с указанием длины.
• 💰 Для денежных сумм и количеств обязательна настройка типов Число с соответствующей точностью.
• 📅 Даты и время требуют типа Дата с указанием части даты (Дата, Время или ДатаВремя).
• 🔗 Для ссылок на другие объекты используется составной тип Ссылка.

Помимо типа, часто требуется настроить дополнительные свойства, такие как Заголовок (видимое имя колонки в форме), Комментарий и флаг Использование. Если реквизит должен быть виден пользователю, свойство Использование должно быть установлено в значение Истина.

Добавление реквизита в табличную часть документа

После того как объект реквизита создан и настроен, его необходимо добавить в коллекцию реквизитов целевой табличной части. Метод Реквизиты.Добавить() возвращает ссылку на добавленный элемент, через которую можно продолжить настройку, если это необходимо.

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

НовыйРеквизит = ТабличнаяЧасть.Реквизиты.Добавить();
НовыйРеквизит.Имя = "СерийныйНомерДоп";
НовыйРеквизит.Заголовок = "Доп. серийный номер";
НовыйРеквизит.Тип = Новый ОписаниеТипов("Строка", , Новый КвалификаторыСтроки(50));
НовыйРеквизит.Использование = Истина;

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

Сохранение изменений и обновление конфигурации

Финальным этапом является фиксация всех внесенных изменений. Для этого вызывается метод Записать() у объекта метаданных. В зависимости от контекста выполнения (тонкий клиент, толстый клиент или сервер), процесс записи может иметь свои особенности.

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

Метод	Описание действия	Требует перезагрузки
Записать()	Сохраняет изменения объекта в базу метаданных	Часто требуется
ПерезагрузитьМетаданные()	Принудительно обновляет кэш метаданных	Нет
ПолучитьМетаданные()	Считывает актуальное состояние из БД	Нет
Удалить()	Удаляет объект из метаданных	Да

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

⚠️ Внимание: Если вы работаете в клиент-серверном варианте, запись метаданных возможна только из толстого клиента или через специальную обработку на сервере. Тонкий клиент имеет ограниченные права на модификацию структуры.

Обработка ошибок и откат изменений

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

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

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

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

Анализ логов сервера и журнала регистрации 1С поможет выявить причину неудачи. Частыми причинами являются блокировки таблиц со стороны СУБД или нехватка дискового пространства.

Часто задаваемые вопросы (FAQ)

Можно ли добавить колонку программно в облачной версии 1С (1С:Линк)?

В облачных сервисах типа 1С:Линк или 1С:Фреш прямое изменение метаданных программно из пользовательского режима, как правило, запрещено политиками безопасности провайдера. Для внесения изменений требуется доступ в конфигуратор, который предоставляется только владельцам тарифов с соответствующими правами, либо через механизмы расширений (Extensions), если платформа поддерживает их динамическую загрузку.

Нужно ли обновлять конфигурацию базы данных после добавления реквизита?

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

Как добавить реквизит с типом "Ссылка" на конкретный справочник?

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

Влияет ли добавление колонки на производительность системы?

Само по себе добавление одной колонки незначительно влияет на производительность. Однако, если вы добавляете реквизит в табличную часть документа, в котором уже миллионы строк, процесс изменения структуры таблицы в СУБД (ALTER TABLE) может занять considerable время и временно заблокировать работу с этим документом. Планируйте такие операции на время наименьшей нагрузки.

Можно ли удалить добавленную программно колонку таким же способом?

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