Другое · 8 мин
Дополнительный реквизит в 1С: программное добавление и работа со значением
Программное добавление дополнительных реквизитов в 1С: когда можно обойтись кодом, а когда требуется Конфигуратор, проверка и риски.
Дополнительный реквизит в 1С — это поле, которое не входит в базовый состав объекта конфигурации, но может быть привязано к справочнику, документу или другому объекту для хранения специфических данных. Такие реквизиты часто используются, когда типовая конфигурация не покрывает отраслевую потребность, а менять стандартную структуру нецелесообразно.
Важно разделять две задачи: создание самого реквизита в метаданных и заполнение его значения в конкретном объекте. Программно можно сравнительно легко записать значение уже существующего дополнительного реквизита, а создать новый реквизит в структуре конфигурации из обычного режима 1С:Предприятие обычно нельзя.
Любые изменения метаданных требуют осторожности: некорректное добавление или удаление реквизита может привести к ошибкам при обновлении конфигурации, потере данных или нарушению работы отчетов. Перед работой рекомендуется сделать резервную копию информационной базы и проверить изменения на отдельной тестовой копии.
Отличие создания реквизита от заполнения значения
Создание дополнительного реквизита означает изменение структуры объекта: в конфигурации появляется новое поле с именем, типом и настройками доступности. Это действие относится к разработке конфигурации и выполняется средствами Конфигуратора, а не обычным пользователем в рабочей базе.
Заполнение значения — это операция с данными уже существующего реквизита. Например, при создании документа программа может присвоить дополнительному реквизиту значение из другого поля, справочника или вычислить его по правилам. Такое программное заполнение допустимо в обычном режиме, если у пользователя есть права на запись по объекту.
Если требуется именно добавить поле в структуру, а не просто записать в него данные, программный путь в рабочей базе обычно недоступен. Нужно либо вносить изменение через конфигурацию, либо использовать альтернативные механизмы, такие как регистры сведений или планы видов характеристик, в зависимости от задачи.
Проверьте наличие поля в свойствах объекта и права на запись.
Убедитесь, что конфигурация открыта для изменения и не на обновлении без прав разработчика.
Позволяет добавлять реквизиты без изменения поставляемой конфигурации.
Когда программное добавление возможно, а когда нужен Конфигуратор
В обычном режиме 1С:Предприятие программа оперирует уже существующей метаданной структурой. Создание нового дополнительного реквизита через встроенный язык в рабочей базе ограничено и зависит от релиза платформы, типа конфигурации и режима работы с блокировкой объектов.
Если конфигурация находится в режиме поддержки или поставляется как типовой продукт, прямое изменение метаданных может быть заблокировано или привести к потере изменений при обновлении. В таких случаях правильнее использовать расширение конфигурации или обратиться к разработчику.
В управляемых приложениях и при работе с собственными конфигурациями у разработчика больше свободы, но даже тогда добавление реквизита лучше планировать на этапе настройки конфигурации, а не выполнять массово в рабочей базе без тестирования.
Порядок добавления через Конфигуратор и использование в коде
В Конфигураторе открывается объект, которому требуется дополнительный реквизит, например справочник или документ. В разделе дополнительных реквизитов создаётся новая запись с уникальным именем, выбирается тип данных и настраивается доступность для форм и программного доступа.
После сохранения конфигурация компилируется, база обновляется, и реквизит становится доступным в объектах. В коде 1С обращение к значению обычно выполняется по имени реквизита как к свойству объекта, если конфигурация предоставляет такой доступ.
Программное заполнение может выглядеть как присваивание значения при создании или записи объекта, а чтение — как получение свойства перед проведением, печатью или расчётом. Точные имена свойств и способы доступа зависят от конфигурации, поэтому перед написанием кода стоит проверить объект в синтакс-помощнике или отладчике.
- 1Сделайте резервную копию информационной базы.
- 2Откройте конфигурацию в Конфигураторе и проверьте права на изменение метаданных.
- 3Добавьте дополнительный реквизит к нужному объекту и укажите тип данных.
- 4Скомпилируйте конфигурацию и обновите базу.
- 5Проверьте доступность реквизита в форме и программном коде на тестовой копии.
Пример работы со значением дополнительного реквизита в коде
Когда реквизит уже существует, программа может присвоить ему значение в момент создания документа или элемента справочника. Например, перед записью объекта проверяется заполнение основного поля, и если условие выполняется, дополнительному реквизиту задаётся нужное значение.
Чтение значения используется для отборов, расчётов и формирования печатных форм. Если реквизит не заполнен, программа должна обрабатывать случае неопределённого значения, чтобы избежать ошибок при сравнении или арифметических операциях.
Код должен быть защищён от ситуации, когда реквизит отсутствует в объекте из-за несоответствия версии конфигурации. Перед обращением к свойству целесообразно проверять наличие поля или использовать конструкции обработки исключений, если они поддерживаются в используемом релизе.
Если ЗначениеЗаполнено(Объект.БазовоеПоле) Тогда Объект.ДополнительныйРеквизит = ВычислитьЗначение(); КонецЕсли;Проверка результата и ограничения
После добавления реквизита и изменения кода нужно проверить, что поле отображается в форме объекта, сохраняется при записи и корректно вычитывается в отчётах. Если значение не сохраняется, причиной могут быть отсутствие прав, блокировка записи или отсутствие реквизита в форме.
Ограничения связаны с режимом поддержки конфигурации, типом лицензии и разделением прав. Некоторые конфигурации запрещают программное изменение метаданных в рабочей базе, а некоторые виды реквизитов доступны только для чтения в зависимости от настроек.
Как проверить результат
Поле видно и доступно для заполнения
Поле отсутствует или недоступно
Значение записывается и корректно вычитывается
Значение теряется после записи или возвращает неопределённое
Реквизит участвует в отборах и выводах
Отчёты выдают ошибки или не видят поле
Не следует пытаться добавлять критические для учёта реквизиты только программно без согласования с ответственным за конфигурацию. Это может нарушить целостность данных и усложнить последующее обновление типовых решений.
Частые ошибки и альтернативы
Одна из частых ошибок — попытка создать новый реквизит прямо в рабочей базе через код, хотя платформа это не поддерживает для выбранной конфигурации. Это приводит к ошибкам компиляции или отсутствию поля после перезапуска.
Другая ошибка — игнорирование резервного копирования перед изменением метаданных. Если изменение выполнено некорректно, восстановить работоспособность базы без копии может быть сложно или невозможно.
Если программное добавление реквизита слишком ограничено, альтернативой может быть регистр сведений, план видов характеристик или отдельный справочник свойств. Эти механизмы позволяют хранить дополнительные данные без изменения базовой структуры объектов и часто легче поддерживаются при обновлениях.
Что важно запомнить
Создание реквизита — задача Конфигуратора, а программно в 1С обычно удобно только заполнять и читать уже существующие дополнительные реквизиты с учётом прав и резервного копирования.
Можно ли добавить дополнительный реквизит только кодом в обычном режиме 1С?
Обычно нет: в режиме 1С:Предприятие программа работает с уже созданной структурой метаданных. Новое поле в конфигурации чаще всего добавляется в Конфигураторе, а затем используется в коде.
Что делать, если конфигурация типовой и закрыта от изменений?
Используйте расширение конфигурации или альтернативное хранение данных, например регистр сведений, чтобы не нарушать условия поддержки и не потерять изменения при обновлении.
Как проверить, что программно заполненное значение сохранилось?
Откройте объект после записи, убедитесь, что поле отображается в форме, и попробуйте прочитать его в отчёте или обработке. Если значение отсутствует, проверьте права и наличие реквизита в форме.
Какие риски при программном изменении метаданных?
Основные риски — ошибки при обновлении конфигурации, потеря данных и блокировка записи. Работу нужно вести на тестовой копии с резервной копией базы.