Добавление реквизита в форму 1С: полное руководство для разработчиков

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

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

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

1. Подготовка: где и как создавать реквизиты

Перед тем как добавлять реквизит в форму, нужно понять, где он должен храниться в структуре метаданных. Реквизиты могут принадлежать:

• 📌 Справочникам (например, Номенклатура.АртикулПоставщика)
• 📄 Документам (например, РеализацияТоваровУслуг.ДатаОтгрузки)
• 🗃️ Регистрам (например, РегистрНакопления.ОстаткиТоваров.Резерв)
• 🖥️ Самой форме (если реквизит нужен только для отображения и не хранится в базе)

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

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

2. Создание реквизита в конфигураторе: пошаговая инструкция

Рассмотрим процесс на примере добавления реквизита в справочник Контрагенты. Аналогичные действия применимы к документам, регистрам и другим объектам.

1. Откройте конфигуратор и перейдите в дерево метаданных: Объекты → Справочники → Контрагенты.

2. В панели свойств справочника найдите вкладку "Реквизиты" и нажмите кнопку "Добавить".

3. Задайте параметры реквизита:

   • 🔹 Имя: ИННКПП (латиницей, без пробелов)
   • 🔹 Синоним: "ИНН/КПП" (отображается пользователям)
   • 🔹 Тип: Строка(23) (12 символов для ИНН + 1 символ разделителя + 10 символов для КПП)
   • 🔹 Длина: 23 (автоматически подставится при выборе типа)

Сохраните изменения (кнопка "ОК" или Ctrl+S).

После создания реквизита в метаданных его нужно добавить в форму. Для этого:

5. Откройте форму справочника: в дереве метаданных кликните правой кнопкой по Контрагенты → "Формы" → выберите нужную форму (обычно ФормаЭлемента).

6. В дизайнере формы перетащите новый реквизит из панели "Реквизиты" в нужное место (например, на закладку "Реквизиты").

7. Настройте отображение: задайте подпись, длину поля, при необходимости добавьте условное оформление.

Имя реквизита указано латиницей

Тип данных соответствует целям (строка, число, дата и т.д.)

Реквизит добавлен в нужную форму

Права доступа настроены для ролей пользователей-->

3. Программное добавление реквизита: когда без кода не обойтись

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

Пример кода для добавления реквизита в форму документа РеализацияТоваровУслуг:

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

// Создаём новый реквизит
НовыйРеквизит = ДокументОбъект.Реквизиты.Добавить();
НовыйРеквизит.Имя = "СуммаСоСкидкой";
НовыйРеквизит.Синоним = "Сумма со скидкой";
НовыйРеквизит.Тип = Новый Тип("Число", 10, 2);

// Сохраняем изменения
ДокументОбъект.Записать();

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

Для добавления реквизита непосредственно в форму (без изменения метаданных объекта) используйте следующий подход:

// Получаем форму документа
Форма = ПолучитьФорму("Документ.РеализацияТоваровУслуг.ФормаДокумента");

// Добавляем реквизит формы
РеквизитФормы = Форма.Реквизиты.Добавить("ТекущаяДата");
РеквизитФормы.Тип = Новый Тип("Дата");

// Настраиваем элемент управления
ЭлементФормы = Форма.ЭлементыФормы.Добавить("ТекущаяДатаПоле", Тип("ПолеФормы"));
ЭлементФормы.Данные = Новый ДанныеФормы(РеквизитФормы);
ЭлементФормы.Подпись = "Текущая дата";

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

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

4. Типовые ошибки и их решения

Даже опытные разработчики сталкиваются с проблемами при добавлении реквизитов. Рассмотрим самые распространённые ошибки и способы их устранения.

Ошибка	Причина	Решение
Реквизит не отображается в форме	Не добавлен в элементы управления или скрыт условием	Проверьте свойство Видимость и привязку к реквизиту в дизайнере формы
Данные не сохраняются	Реквизит не добавлен в объект метаданных (только в форму)	Создайте реквизит в справочнике/документе, а не только в форме
Ошибка "Неопределённое поле" при открытии формы	Опечатка в имени реквизита или несоответствие типов	Проверьте регистр символов и тип данных в метаданных и коде
Реквизит доступен только для чтения	Не настроены права доступа в ролях	Откройте Администрирование → Настройка прав и проверьте разрешения

Критическая ошибка: если вы добавили реквизит в форму, но забыли создать его в метаданных объекта, данные будут теряться при закрытии формы. Это одна из самых распространённых причин потери информации в 1С!

Ещё одна частая проблема — конфликты имён. Если вы создаёте реквизит с именем, которое уже используется в форме (например, Сумма), система может не выдавать ошибку, но поведение формы станет непредсказуемым. Всегда проверяйте уникальность имён!

5. Настройка отображения и поведения реквизита

Добавление реквизита — только половина дела. Чтобы он работал корректно, нужно настроить:

• 🎨 Внешний вид: цвет, шрифт, выравнивание
• 🔒 Права доступа: кто может редактировать реквизит
• 🔄 Логику работы: автозаполнение, проверка значений
• 📊 Участие в отчётах: включение в печатные формы и аналитику

Пример настройки условного оформления (подсветки поля, если значение превышает лимит):

1. В дизайнере формы выделите элемент управления реквизитом.

2. В панели свойств найдите "Условное оформление" → "Добавить".

3. Задайте условие: Значение > 100000.

4. Выберите цвет фона (например, жёлтый) и цвет текста (красный).

Для настройки прав доступа:

1. Откройте Администрирование → Настройка прав → Роли.

2. Выберите роль (например, МенеджерПоПродажам).

3. В разделе "Права на реквизиты" найдите ваш реквизит и установите флаги Чтение и/или Изменение.

6. Работа с реквизитами в управляемых формах

Управляемые формы (введённые в 1С 8.2) имеют особенности работы с реквизитами. Здесь важно понимать разницу между:

• 📎 Реквизитами формы — существуют только во время работы формы
• 🗄️ Реквизитами объекта — хранятся в базе данных

Пример добавления реквизита в управляемую форму документа:

// В модуле объекта (документа)
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Добавляем реквизит формы (не хранится в базе)
ЭтотОбъект.РеквизитыФормы.Вставить("ТекущийКурсДоллара", Новый Число(75.5));

// Настраиваем элемент управления
ЭлементыФормы.ТекущийКурсДоллара.Видимость = Истина;
ЭлементыФормы.ТекущийКурсДоллара.Значение = ЭтотОбъект.РеквизитыФормы.ТекущийКурсДоллара;
КонецПроцедуры

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

Если вам нужно добавить реквизит, который будет храниться в базе, но не хочется изменять типовые конфигурации, используйте механизм "Дополнительные реквизиты и сведения":

1. Откройте справочник или документ в пользовательском режиме.

2. Перейдите в Все действия → Изменить форму.

3. Нажмите "Дополнительные реквизиты" → "Добавить".

4. Заполните свойства нового реквизита и сохраните.

💡

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

7. Оптимизация производительности при работе с реквизитами

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

• ⚡ Используйте реквизиты формы для временных данных вместо реквизитов объекта
• 🗑️ Удаляйте неиспользуемые реквизиты — они занимают место в метаданных
• 🔍 Настраивайте индексы для реквизитов, по которым часто ищут данные
• 📦 Группируйте реквизиты по закладкам, чтобы уменьшить время загрузки формы

Пример создания индекса для реквизита в конфигураторе:

1. Откройте объект метаданных (например, справочник Номенклатура).

2. Перейдите на вкладку "Индексы".

3. Нажмите "Добавить" и выберите реквизиты для индексирования (например, Артикул и Код).

4. Установите флаг "Уникальность", если значения не должны повторяться.

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

Как проверить, какие реквизиты замедляют форму?

Используйте Технологический журнал (настройка в конфигураторе: Администрирование → Поддержка и обслуживание → Настройка технологического журнала). Включите события "Форма" и "Запрос" — это поможет выявить медленные операции.

8. Примеры реальных задач и их решения

Разберём несколько практических кейсов, с которыми часто сталкиваются разработчики.

Задача 1: Нужно добавить поле "Дата следующего звонка" в справочник Контрагенты, чтобы менеджеры могли планировать обратные связи.

Решение:

1. Создайте реквизит ДатаСледующегоЗвонка типа Дата в справочнике.
2. Добавьте его в форму элемента справочника.
3. Настройте напоминание через механизм бизнес-процессов или регламентные задания.

Задача 2: В документе ПоступлениеТоваров нужно отображать текущий курс валюты, но не хранить его в базе.

Решение:

1. Добавьте реквизит формы ТекущийКурсВалюты типа Число(10,4).
2. В обработчике ПриОткрытии заполняйте его актуальным значением через запрос к справочнику Валюты.
3. Сделайте поле только для чтения, чтобы пользователи не могли его изменить.

Задача 3: Нужно добавить флаг "ВИП-клиент" в справочник Контрагенты и автоматически присваивать скидку 10% таким клиентам в документах.

Решение:

1. Создайте реквизит ВИПКлиент типа Булево.
2. В модуле документа РеализацияТоваровУслуг добавьте обработчик ПередЗаписью, который будет проверять флаг и устанавливать скидку.
3. Пример кода:

   Процедура ПередЗаписью(Отказ)
   Если Контрагент.ВИПКлиент Тогда
   Скидка = 10;
   КонецЕсли;
   КонецПроцедуры

💡

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

⚠️ Внимание: При добавлении реквизитов в типовые конфигурации (например, 1С:Бухгалтерия или 1С:УТ) используйте механизм расширений или внешних обработок. Прямое изменение типовых объектов приведёт к проблемам при обновлении!

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

Как добавить реквизит в форму, если нет доступа к конфигуратору?

Если у вас нет прав на изменение конфигурации, используйте:

1. Дополнительные реквизиты и сведения (для справочников и документов).
2. Внешние обработки, которые добавляют элементы управления в форму динамически.
3. Расширения конфигурации (если они разрешены в вашей базе).

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

Почему после добавления реквизита в форму он не сохраняется?

Это происходит в двух случаях:

1. Реквизит добавлен только в форму, но не в объект метаданных (справочник/документ).
2. Нарушены права доступа — проверьте роли пользователей.

Решение: создайте реквизит в самом объекте (не только в форме) и настройте права на изменение.

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

Да, для этого:

1. Откройте печатную форму в режиме 1С:Предприятие.
2. Нажмите "Изменить форму" (если разрешено).
3. Добавьте новый элемент управления и привяжите его к существующему реквизиту или вычисляемому полю.

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

Как сделать реквизит обязательным для заполнения?
Есть несколько способов:
1. В конфигураторе: в свойствах реквизита установите флаг "Обязательное заполнение".
2. В форме: в обработчике ПередЗаписью добавьте проверку:

   Если ЗначениеЗаполнено(Реквизит) = Ложь Тогда
   Предупреждение("Заполните поле 'Название реквизита'!");
   Отказ = Истина;
   КонецЕсли;

3. Через условное оформление: подсвечивайте пустые обязательные поля красным.
Как перенести реквизиты при обновлении конфигурации?

При обновлении типовых конфигураций (1С:Бухгалтерия, 1С:УТ и др.) пользовательские реквизиты могут потеряться. Чтобы этого избежать:

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

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