Как записать значение в реквизит формы 1С: от ручного ввода до программных методов

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

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

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

1. Ручная запись значения через интерфейс формы

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

Чтобы записать значение вручную:

• 📝 Откройте форму документа, справочника или отчёта в режиме "1С:Предприятие" (не в конфигураторе!).
• 🖱️ Найдите нужное поле (реквизит) на форме и кликните по нему левой кнопкой мыши.
• ⌨️ Введите значение с клавиатуры или выберите из выпадающего списка (если реквизит — это перечисление или справочник).
• 💾 Сохраните документ или элемент справочника кнопкой Записать или ОК.

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

⚠️ Внимание: При ручном вводе значения в реквизит, который является ссылкой на другой объект (например, справочник "Контрагенты"), всегда используйте кнопку выбора (...) или начинайте ввод с первых символов названия. В противном случае система может создать дубликат вместо ссылки на существующий элемент.

2. Программная запись через свойство Значение

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

Рассмотрим пример для управляемой формы документа ЗаказПокупателя, где нужно записать значение в реквизит СуммаДокумента:

Процедура ЗаписатьСумму(Значение)
ЭтотОбъект.Объект.СуммаДокумента = Значение;
КонецПроцедуры

Для обычной формы (устаревший формат) код будет выглядеть иначе:

Процедура ЗаписатьСумму(Значение)
ЭлементыФормы.СуммаДокумента.Значение = Значение;
КонецПроцедуры

Ключевые различия:

• 🔹 В управляемых формах обращаемся к объекту через ЭтотОбъект.Объект.
• 🔹 В обычных формах работаем напрямую с коллекцией ЭлементыФормы.
• 🔹 Для реквизитов, которые являются табличными частями, требуется указать строку: ЭтотОбъект.Объект.Товары[0].Количество = 10;.

⚠️ Внимание: При программной записи значения в реквизит, который участвует в расчётах или событиях (например, ПриИзменении), код может вызвать рекурсивный вызов обработчиков. Чтобы избежать зацикливания, используйте флаг блокировки:

Процедура УстановитьСуммуБезСобытий(Значение)
БылВызов = Ложь;
Если НЕ БылВызов Тогда
БылВызов = Истина;
ЭтотОбъект.Объект.СуммаДокумента = Значение;
КонецЕсли;
КонецПроцедуры

3. Запись значений через метод УстановитьЗначениеРеквизита()

Метод УстановитьЗначениеРеквизита() предоставляет более гибкий способ работы с реквизитами, особенно когда имя реквизита формируется динамически или когда требуется записать значение в реквизит родительского объекта (например, из формы подчинённого справочника).

Синтаксис метода:

УстановитьЗначениеРеквизита(<ИмяРеквизита>, <Значение>[, <ИмяОбъекта>])

Примеры использования:

• 📌 Запись в реквизит текущего объекта:

  ЭтотОбъект.Объект.УстановитьЗначениеРеквизита("ДатуДокумента", ТекущаяДата());

• 📌 Запись в реквизит родительского документа из формы табличной части:

  ЭтотОбъект.Объект.УстановитьЗначениеРеквизита("СуммаДокумента", 1000, "Владелец");

Преимущества метода:

• 🔧 Работает с динамическими именами реквизитов (например, когда имя хранится в переменной).
• 🔄 Позволяет обходить ограничения видимости реквизитов в некоторых контекстах.
• 🛡️ Автоматически обрабатывает преобразование типов (например, строку в число).

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

Табличные части документов и справочников требуют особого подхода при записи значений. Здесь нельзя просто обратиться к реквизиту по имени — необходимо указать конкретную строку таблицы. Рассмотрим два основных сценария: запись в новую строку и изменение существующей.

Добавление новой строки с заполнением реквизитов:

НоваяСтрока = ЭтотОбъект.Объект.Товары.Добавить();
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Монитор 24\"");
НоваяСтрока.Количество = 2;
НоваяСтрока.Цена = 15000;

Изменение существующей строки:

Для Каждого Строка Из ЭтотОбъект.Объект.Товары Цикл
Если Строка.Номенклатура.Наименование = "Клавиатура" Тогда
Строка.Количество = 5;
КонецЕсли;
КонецЦикла;

Типичные ошибки при работе с табличными частями:

• 🚫 Попытка обратиться к несуществующей строке (например, ЭтотОбъект.Объект.Товары[10], когда строк всего 5).
• 🚫 Забывают вызвать метод Добавить() перед заполнением новой строки.
• 🚫 Не учитывают, что индексация строк начинается с 0, а не с 1.

5. Запись значений с обработкой событий

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

Пример: автоматически рассчитывать СуммаСНДС при изменении СуммаБезНДС:

Процедура СуммаБезНДСПриИзменении(Элемент)
Если ЗначениеЗаполнено(ЭтотОбъект.Объект.СуммаБезНДС) Тогда
ЭтотОбъект.Объект.СуммаСНДС = ЭтотОбъект.Объект.СуммаБезНДС * 1.2;
КонецЕсли;
КонецПроцедуры

Важно помнить о последовательности выполнения событий:

1. Сначала срабатывает ПриИзменении у элемента формы.
2. Затем — ПриИзменении у реквизита объекта (если он существует).
3. При записи документа вызывается ПередЗаписью.
4. После успешной записи — ПриЗаписи.

Если вам нужно отменить запись значения при некорректном вводе, используйте параметр Отказ в обработчике ПередЗаписью:

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

6. Массовая запись значений через обработки

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

Пример обработки для массового обновления реквизита Статус у документов ЗаказПокупателя:

Процедура ОбновитьСтатусЗаказов()
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ЗаказПокупателя.Ссылка КАК Ссылка
|ИЗ
|   Документ.ЗаказПокупателя КАК ЗаказПокупателя
|ГДЕ
|   ЗаказПокупателя.Дата МЕЖДУ &ДатаНачала И &ДатаОкончания";

Запрос.УстановитьПараметр("ДатаНачала", НачалоМесяца(ТекущаяДата()) - 30);
Запрос.УстановитьПараметр("ДатаОкончания", КонецМесяца(ТекущаяДата()) - 30);

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
Док = Выборка.Ссылка.ПолучитьОбъект();
Док.Статус = Перечисления.СтатусыЗаказов.Выполнен;
Док.Записать();
КонецЦикла;
КонецПроцедуры

Оптимизация массовых операций:

• 🔄 Используйте Объект.Записать(РежимЗаписиДокумента.Проведение) для документов, чтобы избежать повторного проведения.
• 📊 Для больших выборок (тысячи записей) разбейте обработку на пакеты по 100–200 объектов, чтобы не блокировать базу.
• 🔒 Заключайте массовые операции в транзакцию:

  НачатьТранзакцию();
  Попытка
  // Код обновления
  ЗафиксироватьТранзакцию();
  Исключение
  ОтменитьТранзакцию();
  Сообщить(ОписаниеОшибки());
  КонецПопытки;

⚠️ Внимание: Массовые операции с прямым обновлением данных через запрос (ОБНОВИТЬ) работают быстрее, но обходят все обработчики событий и триггеры. Используйте их только когда уверены, что это не нарушит логику работы системы. Пример опасного кода:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ РАЗРЕШИТЬ ОБНОВЛЕНИЕ
|   ОБНОВИТЬ Документ.ЗаказПокупателя
|   УСТАНОВИТЬ Статус = &Статус
|   ГДЕ Дата МЕЖДУ &ДатаНачала И &ДатаОкончания";
Запрос.Выполнить();

7. Особенности записи в реквизиты форм отчётов и обработок

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

Основные правила:

• 📊 Для параметров отчёта используйте коллекцию Параметры:

  Отчет.Параметры.УстановитьЗначениеПараметра("ДатаНачала", НачалоМесяца(ТекущаяДата()));

• 🛠️ В обработках реквизиты формы доступны через ЭтотОбъект, но их значения теряются при закрытии формы:

  ЭтотОбъект.РеквизитФормы = "Новое значение";

• 💾 Чтобы сохранить значения между сеансами, используйте ХранилищеНастроек или ХранилищеЗначений.

Пример сохранения и восстановления настроек формы обработки:

Процедура ПриОткрытии()
Настройки = ПолучатьИзХранилищаНастроек("НастройкиМоейОбработки");
Если Настройки <> Неопределено Тогда
ЭтотОбъект.ПоследнийФильтр = Настройки.Фильтр;
ЭтотОбъект.ПоказыватьИтоги = Настройки.ПоказыватьИтоги;
КонецЕсли;
КонецПроцедуры

Процедура СохранитьНастройки()
Настройки = Новый Структура;
Настройки.Вставить("Фильтр", ЭтотОбъект.ПоследнийФильтр);
Настройки.Вставить("ПоказыватьИтоги", ЭтотОбъект.ПоказыватьИтоги);
ПоместитьВХранилищеНастроек(Настройки, "НастройкиМоейОбработки");
КонецПроцедуры

8. Типичные ошибки и их решения

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

Если вы столкнулись с ошибкой, которой нет в таблице, воспользуйтесь отладчиком 1С:

ЭтотОбъект.Объект["Дату создания"] = ТекущаяДата();

ЭтотОбъект.Объект.УстановитьЗначениеРеквизита("Дату создания", ТекущаяДата());

ТекущаяСтрока = ЭтотОбъект.Объект.Товары[0]; // Первая строка табличной части "Товары"
ТекущаяСтрока.ДополнительныеРеквизиты.Характеристика = "Цвет: чёрный";

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

Процедура КоличествоПриИзменении(Элемент)
Если Элемент.Значение < 0 Тогда
Сообщить("Ошибка!");
Элемент.ОтменитьИзменения();
КонецЕсли;
КонецПроцедуры