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

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

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

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

Архитектура дополнительных реквизитов в платформе 1С

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

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

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

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

Подготовка окружения и получение объекта метаданных

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

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

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

Алгоритм создания нового дополнительного реквизита

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

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

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

Пример кода для базового создания выглядит следующим образом:

ПланХарактеристик = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения;
НовыйЭлемент = ПланХарактеристик.СоздатьЭлемент();
НовыйЭлемент.Вид = ВидыДополнительныхРеквизитовИСведений.ДополнительныйРеквизит;
НовыйЭлемент.Имя = "ДопРеквизит_Тестовый";
НовыйЭлемент.Синоним = "Тестовый реквизит";
НовыйЭлемент.Записать();

Настройка типов данных и свойств поля

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

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

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

Нюансы составных типов

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

Рассмотрим пример настройки составного типа для поля, которое может содержать либо строку, либо число:

НовыйЭлемент.Тип = Новый ОписаниеТипов(
"Строка, Число",
,
Новый КвалификаторыСтроки(50),
Новый КвалификаторыЧисла(15, 2)
);
НовыйЭлемент.Многострочный = Ложь;
НовыйЭлемент.Редактирование = Истина;

Привязка реквизитов к объектам конфигурации

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

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

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

Свойство	Тип данных	Описание	Обязательность
Имя	Строка	Уникальный идентификатор реквизита	Да
Синоним	Строка	Отображаемое название в интерфейсе	Да
Вид	Перечисление	Реквизит или Сведение	Да
Тип	ОписаниеТипов	Допустимые типы значений	Да
Владельцы	СписокЗначений	Объекты, к которым привязан реквизит	Нет

Обработка ошибок и обновление интерфейса

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

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

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

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

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

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

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

В чем разница между ДополнительнымРеквизитом и ДополнительнымСведением?

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

Как сделать реквизит видимым только для определенной группы пользователей?

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

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

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