Основной реквизит формы 1С: что это и как работает в конфигураторе

Когда вы работаете с формами в 1С:Предприятие, термин «основной реквизит» может вызвать путаницу — особенно у новичков. С одной стороны, в конфигураторе есть обычные реквизиты формы, а с другой — этот загадочный «основной». Чем они отличаются? Почему один реквизит становится «основным», а другой — нет? И как это влияет на поведение формы при открытии или сохранении?

На практике основной реквизит формы определяет, какой объект данных будет привязан к форме по умолчанию. Это не просто техническая деталь — от него зависит, как форма будет взаимодействовать с базой данных, какие методы будут доступны при программировании, и даже как пользователь увидит данные на экране. Например, в форме документа «РеализацияТоваровУслуг» основным реквизитом обычно является сам документ, а в форме справочника «Номенклатура» — элемент справочника.

В этой статье мы разберём:

🔹 Что такое основной реквизит и зачем он нужен в формах 1С
🔹 Как он отличается от обычных реквизитов и параметров формы
🔹 Где и как настраивается в конфигураторе (с пошаговыми примерами)
🔹 Типичные ошибки при работе с основными реквизитами и как их избежать

А также рассмотрим практические кейсы — от простых форм справочников до сложных документов с вложенными табличными частями.

1. Определение: что такое основной реквизит формы в 1С

В 1С:Предприятие 8 любая форма (будь то форма документа, справочника или отчёта) строится на основе объекта конфигурации. Основной реквизит формы — это ссылка на тот объект данных, с которым форма работает напрямую. Проще говоря, он отвечает на вопрос: «Что именно редактирует или отображает эта форма?»

Например:

📄 В форме документа ПоступлениеТоваров основным реквизитом будет сам документ ДокументОбъект.ПоступлениеТоваров.
📋 В форме элемента справочника Контрагенты — это элемент справочника СправочникОбъект.Контрагенты.
📊 В форме отчёта ОборотноСальдоваяВедомость основным реквизитом может быть объект ОтчетОбъект.ОборотноСальдоваяВедомость.

Технически основной реквизит формы — это свойство объекта УправляемаяФорма или ОбычнаяФорма, которое определяет контекст данных. Именно через него форма получает доступ к методам объекта (например, Записать(), Провести()) и его реквизитам (например, Дата, Номер, Контрагент).

⚠️ Внимание: Если в форме не указан основной реквизит, она не сможет автоматически загружать или сохранять данные. Например, при открытии формы документа без основного реквизита вы получите ошибку «Не указан объект формы».

2. Отличия основного реквизита от обычных реквизитов и параметров

Чтобы избежать путаницы, разберём три ключевых понятия:

Тип реквизита	Назначение	Пример	Где настраивается
Основной реквизит	Определяет объект данных, с которым работает форма. Всегда один на форму.	`ДокументОбъект.ЗаказПокупателя`	Свойство `ОсновнойРеквизит` в палитре свойств формы
Обычный реквизит	Дополнительные данные формы, не связанные напрямую с объектом. Может быть несколько.	`ТекущийПользователь`, `ФильтрПоДате`	Вкладка «Реквизиты» в дереве формы
Параметр	Внешние данные, передаваемые форме при открытии (например, для фильтрации).	`ПериодНачала`, `ТолькоАктивные`	Вкладка «Параметры» в дереве формы

Ключевое отличие основного реквизита — он автоматически связывает форму с объектом базы данных. Например, если в форме документа основным реквизитом является ДокументОбъект.РеализацияТоваров, то:

🔄 При открытии формы она загрузит данные конкретного документа.
💾 При нажатии «Записать» изменения применятся именно к этому документу.
🛠️ В коде формы вы сможете обращаться к методам документа (например, Объект.Провести()).

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

💡

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

3. Как настроить основной реквизит формы в конфигураторе

Рассмотрим пошаговую инструкцию на примере формы документа ЗаказПокупателя.

Откройте форму в конфигураторе:
- 🔧 Перейдите в дерево меток конфигурации: Объекты → Документы → ЗаказПокупателя → Формы.
- 📄 Откройте форму документа (например, ФормаДокумента).
Проверьте текущий основной реквизит:
- 🔍 В палитре свойств формы найдите свойство ОсновнойРеквизит.
- 📌 По умолчанию там должно быть значение Объект (это и есть ссылка на документ).

Измените основной реквизит (если нужно):

🖱️ Кликните по полю ОсновнойРеквизит и выберите другой объект из списка (если требуется).
⚠️ Обычно менять его не нужно — 1С автоматически подставляет правильный объект при создании формы.

☑️ Проверка основного реквизита формы

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

Выполнено: 0 / 4

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

// Пример кода создания формы с указанием основного реквизита
Форма = Новый Форма();
Форма.ОсновнойРеквизит = Новый ОписаниеТипов("СправочникОбъект.Номенклатура");
Форма.Открыть();

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

4. Практические примеры использования основного реквизита

Разберём несколько реальных сценариев, где понимание основного реквизита критично.

Пример 1: Форма документа с табличной частью

В документе РеализацияТоваровУслуг основным реквизитом является сам документ. Но табличная часть Товары — это реквизит объекта, а не формы. Почему?

📌 Основной реквизит (Объект) даёт доступ ко всем данным документа, включая табличные части.
📊 Табличная часть Товары хранится внутри объекта, поэтому её не нужно дублировать как реквизит формы.

Пример 2: Форма списка справочника

В форме списка справочника Контрагенты основным реквизитом часто является СправочникОбъект.Контрагенты. Но здесь есть нюанс:

🔍 Форма списка обычно работает с коллекцией элементов, а не с одним объектом.
🔄 Основной реквизит в этом случае используется для доступа к методам менеджера справочника (например, Объект.Новый(), Объект.НайтиПоНаименованию()).

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

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

Пример 3: Форма отчёта с параметрами

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

Тип формы	Основной реквизит	Пример использования
Форма документа	`ДокументОбъект.РеализацияТоваров`	Редактирование полей документа, проведение, печать.
Форма элемента справочника	`СправочникОбъект.Номенклатура`	Изменение наименования, артикула, цены номенклатуры.
Форма списка	`СправочникОбъект.Контрагенты`	Фильтрация, добавление новых элементов, групповые операции.
Форма отчёта	Часто отсутствует	Отображение данных по заданным параметрам (даты, организация).

5. Типичные ошибки при работе с основными реквизитами

Даже опытные разработчики иногда допускают ошибки при настройке основных реквизитов. Вот самые распространённые:

Несовпадение типов:
🚫 Ошибка: Указан тип ДокументСсылка.ЗаказПокупателя вместо ДокументОбъект.ЗаказПокупателя.

✅ Решение: Всегда используйте объектный тип (с суффиксом Объект).
Отсутствие основного реквизита:
🚫 Ошибка: Форма не сохраняет изменения, так как не знает, какой объект редактировать.

✅ Решение: Проверьте свойство ОсновнойРеквизит в палитре свойств.
Путаница с реквизитами формы и объекта:
🚫 Ошибка: Добавлен реквизит СуммаДокумента в форму вместо того, чтобы брать его из объекта (Объект.СуммаДокумента).

✅ Решение: Используйте данные объекта через основной реквизит, а не дублируйте их.

💡

Основной реквизит формы должен всегда соответствовать типу редактируемого объекта. Если вы работаете с документом — это должен быть ДокументОбъект, со справочником — СправочникОбъект.

Ещё одна частая проблема — попытка изменить основной реквизит динамически в коде. Например:

// ❌ Некорректный подход (приведёт к ошибке)
Форма.ОсновнойРеквизит = Новый ОписаниеТипов("ДокументОбъект.ДругойДокумент");

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

6. Как основной реквизит влияет на программирование формы

Понимание основного реквизита упрощает написание кода для формы. Рассмотрим ключевые моменты:

Доступ к данным объекта

Через основной реквизит вы получаете доступ ко всем свойствам и методам объекта. Например:

// Получение даты документа ДатаДокумента = Объект.Дата; // Проведение документа Объект.Провести(); // Проверка заполненности реквизита Если НЕ Объект.Контрагент.Пустая() Тогда // Действия с контрагентом

КонецЕсли;

События формы

Многие события формы (например, ПередЗаписью, ПриСозданииНаСервере) автоматически получают параметр Объект, который ссылается на основной реквизит. Например:

Процедура ПередЗаписью(Отказ, Объект)
// Объект здесь - это основной реквизит формы
Если Объект.СуммаДокумента <= 0 Тогда
Отказ = Истина;
Сообщить("Сумма документа должна быть больше 0!");
КонецЕсли;
КонецПроцедуры

Работа с табличными частями

Если объект имеет табличные части (например, Товары в документе РеализацияТоваровУслуг), к ним тоже можно обращаться через основной реквизит:

// Добавление строки в табличную часть
НоваяСтрока = Объект.Товары.Добавить();
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Товар 1");
НоваяСтрока.Количество = 10;

💡

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

7. Частые вопросы и проблемы с основными реквизитами

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

Вопрос: Можно ли в одной форме использовать два основных реквизита?

🚫 Нет. Форма может иметь только один основной реквизит. Если вам нужно работать с несколькими объектами, создайте:

🔄 Отдельные формы для каждого объекта.
📊 Общую форму с параметрами, которые будут определять, какой объект загружать.

Вопрос: Почему при открытии формы вылетает ошибка «Не указан объект формы»?

🔍 Эта ошибка означает, что:

🔧 Либо не задан основной реквизит формы.
🔗 Либо при открытии формы не передан объект (например, вы вызвали Форма.Открыть() без параметров).

✅ Решение: Проверьте:

Указан ли основной реквизит в свойствах формы.
Передаётся ли объект при открытии формы (например, Форма.Открыть(ДокументОбъект.ЗаказПокупателя.ПолучитьФорму())).

Вопрос: Как передать в форму объект, если основной реквизит не подходит?

💡 Если вам нужно работать с объектом, тип которого не совпадает с основным реквизитом формы, используйте:

📌 Параметры формы — передайте объект как параметр.
🔄 Реквизиты формы — создайте реквизит с нужным типом и заполните его при открытии.

Пример:

// Передача объекта через параметр
ПараметрыФормы = Новый Структура();
ПараметрыФормы.Вставить("ТекущийДокумент", ДокументОбъект.ЗаказПокупателя);
Форма.Открыть(,, ПараметрыФормы);

8. Заключение: когда и как использовать основной реквизит

Подведём итоги:

🎯 Основной реквизит формы — это «мост» между формой и объектом данных (документом, справочником, отчётом).
🔧 Он настраивается один раз в конфигураторе и не изменяется динамически.
📊 Через него форма получает доступ к методам и данным объекта (например, Объект.Записать(), Объект.Дата).
⚠️ Ошибки с основным реквизитом приводят к проблемам с сохранением данных или открытием формы.

Если вы только начинаете разрабатывать в 1С, запомните простое правило: основной реквизит формы должен совпадать с типом объекта, который она редактирует. Для документа — это ДокументОбъект, для справочника — СправочникОбъект, и так далее.

Для опытных разработчиков понимание основного реквизита открывает дополнительные возможности:

🛠️ Оптимизация кода за счёт прямого доступа к объекту через Объект.
🔄 Упрощение работы с событиями формы (например, ПередЗаписью).
📊 Гибкая настройка интерфейса в зависимости от типа объекта.

💡

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

FAQ: Ответы на частые вопросы

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

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

🔹 Что делать, если в форме нужно отобразить данные из другого объекта?

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

🔹 Почему при записи формы изменения не сохраняются?

Наиболее вероятные причины:

❌ Не указан основной реквизит формы.
❌ Основной реквизит имеет неправильный тип (например, ДокументСсылка вместо ДокументОбъект).
❌ В коде не вызывается метод Объект.Записать().

Проверьте настройки формы в конфигураторе и код обработки события ПередЗаписью.

🔹 Как проверить, какой основной реквизит у формы?

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

🔹 Нужно ли указывать основной реквизит в формах отчётов?

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

Основной реквизит формы в 1С: разбираем понятие на практике