Как вывести реквизит на форму в 1С: 5 способов + примеры кода

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

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

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

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

• 🔧 Ручное добавление через конструктор формы — самый простой метод для начинающих. Подходит для статичных форм с фиксированным набором полей.
• 💻 Программное создание элементов в модуле формы. Используется для динамического формирования интерфейса (например, в зависимости от прав пользователя).
• 📋 Вывод реквизитов табличных частей. Актуально для документов и справочников с вложенными данными.
• 🔄 Связывание с динамическими списками. Применяется для отображения данных из запросов или внешних источников.
• 🔗 Использование расширений форм. Позволяет модифицировать существующие формы без изменения конфигурации.

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

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

2. Ручное добавление реквизита через конструктор формы

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

1. Откройте конфигуратор и найдите нужный объект (например, документ ЗаказПокупателя).
2. Перейдите на вкладку Формы и откройте основную форму объекта (обычно это ФормаДокумента или ФормаОбъекта).
3. В верхнем меню выберите Конструктор формы → Добавить реквизит.
4. В открывшемся окне выделите нужный реквизит (например, Контрагент) и нажмите ОК.
5. 1С автоматически создаст элемент формы и свяжет его с реквизитом. Сохраните изменения (Ctrl+S).

После этих действий на форме появится поле для ввода контрагента. Однако здесь есть несколько нюансов:

• 🔹 Если реквизит имеет тип СправочникСсылка, 1С автоматически создаст Поле ввода с выбором, где пользователь сможет выбрать значение из справочника.
• 🔹 Для реквизитов типа Дата будет создан элемент Поле календаря.
• 🔹 Если реквизит обязательный (установлено свойство Заполнение = Обязательное), поле на форме будет подсвечено красным, если оно пустое.

Если после добавления реквизита поле не отображается или работает некорректно, проверьте:

⚠️ Внимание: Убедитесь, что реквизит не скрыт свойством Видимость = Ложь в модуле формы. Также проверьте, не переопределён ли обработчик события ПриСозданииНаСервере, который мог программно скрыть элемент.

3. Программное создание элементов формы в модуле

Когда нужно динамически управлять отображением реквизитов (например, показывать поля только для определённых ролей или в зависимости от значений других полей), используется программное создание элементов. Рассмотрим пример добавления поля для реквизита СуммаДокумента через код:

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

// Создаём поле для реквизита "СуммаДокумента"
ЭлементФормы = Элементы.Добавить("СуммаДокументаПоле", Тип("ПолеВвода"), Истина);
ЭлементФормы.Позиция = Новый Позиция(100, 50, 200, 25); // Координаты и размер
ЭлементФормы.Данные = Новый ДанныеФормы("Объект.СуммаДокумента", Тип("Число"));
ЭлементФормы.Заголовок = "Сумма документа (руб.)";
ЭлементФормы.ТолькоЧтение = Ложь;

КонецПроцедуры

В этом примере:

• 📌 Элементы.Добавить — метод создания нового элемента на форме.
• 📌 Новый Позиция — задаёт координаты и размер поля (X, Y, ширина, высота).
• 📌 ДанныеФормы — связывает элемент с реквизитом объекта.
• 📌 ТолькоЧтение = Ложь — разрешает редактирование поля.

Программное создание элементов удобно, когда нужно:

• 🔸 Добавлять поля динамически (например, в зависимости от типа документа).
• 🔸 Менять свойства элементов "на лету" (цвет, видимость, доступность).
• 🔸 Создавать сложные композитные элементы (группы полей, закладки).

Ошибки при программном создании элементов часто связаны с:

• 🚫 Неправильным указанием пути к реквизиту (например, "Объект.НесуществующийРеквизит").
• 🚫 Конфликтом имён элементов (если имя уже существует, произойдёт ошибка).
• 🚫 Несоответствием типов (например, попытка вывести реквизит типа Дата в поле ПолеВвода вместо ПолеКалендаря).

4. Вывод реквизитов табличных частей

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

1. Открыть форму объекта в конфигураторе.
2. Добавить элемент ТаблицаФормы через конструктор или программно.
3. Связать таблицу с табличной частью объекта:

ЭлементФормы = Элементы.Добавить("ТоварыТаблица", Тип("ТаблицаФормы"));
ЭлементФормы.Данные = Новый ДанныеФормы("Объект.Товары", Тип("ТабличнаяЧастьОбъекта.Товары"));

После этого нужно настроить колонки таблицы. Это можно сделать:

• 🔧 Через конструктор таблицы (правая кнопка по таблице → Конструктор таблицы).
• 💻 Программно в модуле формы:

&НаКлиенте
Процедура ПриОткрытии(Отказ)

Таблица = Элементы.ТоварыТаблица;
КолонкаНоменклатура = Таблица.Колонки.Добавить("Номенклатура");
КолонкаНоменклатура.Данные = Новый ДанныеФормыКолонки("Объект.Товары.Номенклатура", Тип("СправочникСсылка.Номенклатура"));
КолонкаНоменклатура.Заголовок = "Товар";

КолонкаКоличество = Таблица.Колонки.Добавить("Количество");
КолонкаКоличество.Данные = Новый ДанныеФормыКолонки("Объект.Товары.Количество", Тип("Число"));

КонецПроцедуры

Важные моменты при работе с табличными частями:

• 📌 Колонки таблицы должны соответствовать реквизитам табличной части (имя и тип).
• 📌 Для справочников (СправочникСсылка) используйте ПолеВводаСВыбором в колонке.
• 📌 Если табличная часть большая, настройте постраничный вывод (РежимОтображения = РежимОтображенияТаблицы.Страницы).

5. Связывание реквизитов с динамическими списками

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

// Создаём динамический список
Список = ДинамическиеСписки.СоздатьСписок();
Список.ИсточникДанных = Новый ИсточникДанныхКоллекцияЗначений(Объект.СвязанныеДокументы);

// Настраиваем отображение
Список.АвтоЗагрузка = Истина;
Список.КоличествоЗагружаемыхСтрок = 100;

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

КонецПроцедуры

Преимущества динамических списков:

• 🔹 Гибкая фильтрация данных без перезагрузки формы.
• 🔹 Возможность сортировки и группировки прямо в интерфейсе.
• 🔹 Поддержка постраничной загрузки для больших объёмов данных.

Типичные ошибки:

6. Типичные ошибки и как их избежать

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

• 🚨 Поле не отображается на форме
  Причина: элемент скрыт свойством Видимость = Ложь или неверно указаны координаты (Позиция). Решение: проверьте свойства элемента в отладчике (Отладка → Осмотр).
• 🚨 Данные не сохраняются
  Причина: реквизит не привязан к элементу формы или тип данных не совпадает. Решение: убедитесь, что в свойстве Данные указан правильный путь (например, "Объект.Реквизит").
• 🚨 Ошибка "Тип не совпадает"
  Причина: попытка вывести реквизит типа Дата в поле ПолеВвода вместо ПолеКалендаря. Решение: используйте соответствующий тип элемента формы.
• 🚨 Медленная загрузка формы
  Причина: на форме слишком много элементов или динамических списков без фильтров. Решение: разбейте форму на закладки или настройте отложенную загрузку данных.

Чтобы минимизировать ошибки, следуйте этим рекомендациям:

⚠️ Внимание: Всегда проверяйте привязку реквизитов к элементам формы в режиме 1С:Предприятие (не только в конфигураторе!). Иногда ошибки проявляются только при реальной работе с данными.

Также полезно использовать отладчик 1С для проверки значений реквизитов и свойств элементов. Например, чтобы узнать, почему поле не обновляется, поставьте точку останова в обработчике ПриИзменении и посмотрите, какие данные приходят в элемент.

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

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

• 🎯 Группируйте связанные поля
  

  Используйте элементы ГруппаФормы или Закладка, чтобы логически разделить реквизиты (например, "Реквизиты документа" и "Дополнительная информация").

• 🎯 Настраивайте подсказки
  

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

• 🎯 Используйте условное оформление
  

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

&НаКлиенте
Процедура ПриОткрытии(Отказ)

Если Объект.ЭтоНовый() Тогда
Элементы.Контрагент.ЦветФона = ВебЦвета.СветлоЖелтый; // Подсветка для нового документа
КонецЕсли;

КонецПроцедуры

• 🎯 Ограничивайте права доступа
  

  Скрывайте или делайте поля ТолькоЧтение для пользователей без прав редактирования:

Элементы.СуммаДокумента.ТолькоЧтение = Не ПраваДоступа.РедактироватьСумму();

Для больших форм с множеством реквизитов рекомендуется:

• 📉 Использовать ленточный интерфейс (группы команд) вместо вывода всех полей сразу.
• 📉 Настраивать динамическую видимость элементов (например, показывать поле "Адрес доставки" только если выбран тип заказа "С доставкой").
• 📉 Применять кэширование данных для часто используемых справочников (например, Номенклатура или Контрагенты).

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

ЭтотОбъект.ОбновитьФорму();

&НаСервере
Процедура РассчитатьИтоговуюСумму()

Сумма = 0;
Для Каждого Строка Из Объект.Товары Цикл
Сумма = Сумма + Строка.Сумма;
КонецЦикла;

Элементы.ИтоговаяСумма.Значение = Сумма;

КонецПроцедуры

Элементы.Контрагент.ОбязательноеЗаполнение = Истина;

&НаСервере
Процедура ПередЗаписью(Отказ, РежимЗаписи)

Если ЗначениеЗаполнено(Объект.Контрагент) = Ложь Тогда
Сообщить("Не заполнен контрагент!", СтатусСообщения.Важное);
Отказ = Истина;
КонецЕсли;

КонецПроцедуры