К статье
Практический материал

Другое · 6 мин

Как добавить реквизит в обработку 1С

Практичная инструкция по добавлению реквизита в обработку 1С: где создать поле, как настроить форму и проверить работу без риска для конфигурации.

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

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

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

Когда добавление реквизита оправдано

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

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

Временное поле на формеДостаточно для фильтра или флага в рамках одной сеанса

Проверьте, нужно ли значение после закрытия обработки

Поле объекта обработкиПодходит для хранения и передачи данных между процедурами

Убедитесь, что тип реквизита соответствует задаче

Изменение стандартной обработкиТребует осторожности и желательного расширения конфигурации.

Проверьте права на конфигурацию и наличие резервной копии

Где хранится реквизит: объект или форма

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

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

Порядок действий
  1. 1
    Открыть обработку в конфигураторе
  2. 2
    Создать реквизит объекта или формы с нужным типом
  3. 3
    Разместить реквизит на форме и настроить вид
  4. 4
    Написать код заполнения и проверки
  5. 5
    Проверить синтаксис и протестировать в режиме предприятия

Как добавить реквизит в форму обработки

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

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

1c
&НаКлиенте
Процедура МояКнопкаНажатие(Элемент)
    Объект.МойРеквизит = "Значение";
КонецПроцедуры

Код для заполнения и сохранения

В модуле формы или объекта напишите процедуру, которая заполняет реквизит при открытии обработки, выборе значения в другом поле или нажатии кнопки. Для управляемых форм используйте события «ПриОткрытии», «ПриИзменении» или команды формы.

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

)

Проверка результата и ограничения

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

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

Типичные ошибки
01
Обращение к реквизиту формы как к реквизиту объекта — значение не видно в коде
02
Забыть разместить реквизит на форме — поле есть, но пользователь не может его заполнить
03
Прямая правка стандартной обработки без резервной копии — риск потери при обновлении

Частые ошибки и безопасность

Самая частая ошибка — создать реквизит формы, но обращаться к нему как к реквизиту объекта. Тогда в коде будет пустое значение или ошибка компиляции. Другая ошибка — забыть указать тип или не разместить поле на форме, из-за чего реквизит есть в конфигурации, но не виден пользователю.

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

Итог

Что важно запомнить

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

Нужно ли программировать, чтобы добавить реквизит?

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

Можно ли добавить реквизит в уже опубликованную обработку?

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

Отличие реквизита формы от реквизита объекта

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

Что проверить после добавления реквизита

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